发送网络请求（C++）
===========

#### 约束与限制

发送网络请求能力支持Phone、2in1、Tablet、Wearable设备。并且从5.1.1(19)开始，新增支持TV设备；从6.1.0(23)开始，新增支持Car设备。

#### 如何使用fetchsync发起网络请求

发送同步HTTP请求，可设置请求头和请求体等参数，并返回来自服务器的HTTP响应。常用于获取资源，支持通过拦截器来处理请求和响应。

#### \[h2\]接口说明

具体API说明详见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#hms_rcp_fetchsync)。

| 接口名 | 描述 |
| :-- | :-- |
| [Rcp\_Response](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_response) \*HMS\_Rcp\_FetchSync([Rcp\_Session](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_session) \*session, [Rcp\_Request](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_request) \*request, uint32\_t \*errCode); | 发送HTTP请求，并直接返回来自服务器的HTTP响应。 |

#### \[h2\]使用示例

1.  CPP侧导入模块。
    
    #include "RemoteCommunicationKit/rcp.h"
    #include <stdio.h>
    
2.  CMakeLists.txt中添加以下lib。（具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/remote-communication-preparations#c-api开发准备)）。
    
    librcp\_c.so
    
3.  创建Request对象。"https://www.example.com"请根据实际情况替换为想要请求的URL地址。（实际使用时请将该代码块放入main函数或者其他函数区域内）。
    
    const char \*kHttpServerAddress = "https://www.example.com";
    Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
    
4.  创建会话。（实际使用时请将该代码块放入main函数或者其他函数区域内）。
    
    uint32\_t errCode = 0;
    Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
    
5.  发起请求，并处理返回结果。（实际使用时请将该代码块放入main函数或者其他函数区域内）。
    
    Rcp\_Response \*response = HMS\_Rcp\_FetchSync(session, request, &errCode);
    if (response != NULL) {
        printf("Response status: %d\\n", response->statusCode);
    } else {
        printf("Fetch failed: errCode: %u\\n", errCode);
    }
    
6.  清理response响应和request请求。最后关闭session。（实际使用时请将该代码块放入main函数或者其他函数区域内）。
    
    // 清理request
    HMS\_Rcp\_DestroyRequest(request);
    // 处理response，并清理response
    if (response != NULL) {
        response->destroyResponse(response);
    }
    // 关闭session
    errCode = HMS\_Rcp\_CloseSession(&session);
    // 处理errCode
    

#### 如何使用fetch发起异步网络请求

发送异步HTTP请求，可设置请求头和请求体等参数，并返回来自服务器的HTTP响应。常用于获取资源，支持通过拦截器来处理请求和响应。

#### \[h2\]接口说明

具体API说明详见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#hms_rcp_fetch)。

| 接口名 | 描述 |
| :-- | :-- |
| uint32\_t HMS\_Rcp\_Fetch([Rcp\_Session](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_session) \*session, [Rcp\_Request](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_request) \*request, const [Rcp\_ResponseCallbackObject](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/remote-communication-overview#rcp_responsecallbackobject) \*responseCallback); | 发送HTTP请求，并返回来自服务器的HTTP响应。使用responseCallback异步回调。 |

#### \[h2\]使用示例

1.  CPP侧导入模块。
    
    #include "RemoteCommunicationKit/rcp.h"
    #include <cstring>
    #include <stdio.h>
    #include <unistd.h>
    
2.  CMakeLists.txt中添加以下lib。（具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/remote-communication-preparations#c-api开发准备)）。
    
    librcp\_c.so
    
3.  创建Request对象。"https://www.example.com"请根据实际情况替换为想要请求的URL地址。（完整见步骤5）
    
    const char \*kHttpServerAddress = "https://www.example.com";
    Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
    
4.  创建会话。（完整见步骤5）
    
    uint32\_t errCode = 0;
    Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
    
5.  发起请求，并处理返回结果。最后关闭session。
    
    // 异步请求的响应处理回调，请用户自定义
    void ResponseCallback(void \*usrCtx, Rcp\_Response \*response, uint32\_t errCode)
    {
        (void \*)usrCtx;
        if (response != NULL) {
            printf("Response status: %d\\n", response->statusCode);
        } else {
            printf("Fetch failed: errCode: %u\\n", errCode);
        }
        // 注意清理响应
        if (response != NULL) {
            response->destroyResponse(response);
        }
    }
    
    int main() {
        const char \*kHttpServerAddress = "https://www.example.com";
        // 请求配置
        Rcp\_Configuration config;
        // 初始化配置参数
        (void)memset(&config, 0, sizeof(Rcp\_Configuration));
        // 重新设置自动重定向
        config.transferConfiguration.autoRedirect = true;
        // 重新设置请求超时配置参数
        config.transferConfiguration.timeout.transferMs = 1000 \* 10;
        config.transferConfiguration.timeout.connectMs = 1000 \* 10;
        Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
        request->method = RCP\_METHOD\_GET;
        request->configuration = &config;
        uint32\_t errCode = 0;
        // 创建session
        Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
        // 配置请求回调
        Rcp\_ResponseCallbackObject responseCallback = {ResponseCallback, NULL};
        // 发起fetch请求
        errCode = HMS\_Rcp\_Fetch(session, request, &responseCallback);
        // 等待fetch结果，仅是等待异步调用完成，开发者可根据自己实际场景处理回调。
        usleep(1000 \* 1000 \* 3);
        printf("Fetch completed, errCode: %u\\n", errCode);
        // 在退出前取消可能还在执行的requests
        errCode = HMS\_Rcp\_CancelSession(session);
        // 清理request
        HMS\_Rcp\_DestroyRequest(request);
        // 关闭session
        errCode = HMS\_Rcp\_CloseSession(&session);
        // 处理errCode
        return 0;
    }
    

#### 如何使用get发送网络请求

发送带有默认HTTP参数的HTTP GET请求，并返回来自服务器的HTTP响应。采用异步回调的方式进行处理，提高应用的响应性和效率。常用于从服务器获取数据。

#### \[h2\]使用示例

1.  CPP侧导入模块。
    
    #include "RemoteCommunicationKit/rcp.h"
    #include <cstring>
    #include <stdio.h>
    #include <unistd.h>
    
2.  CMakeLists.txt中添加以下lib。（具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/remote-communication-preparations#c-api开发准备)）。
    
    librcp\_c.so
    
3.  创建会话，会话发起get请求。“http://www.example.com”请根据实际情况替换为想要请求的URL地址。等待响应返回后，销毁request并关闭session。
    
    void ResponseCallback(void \*usrCtx, Rcp\_Response \*response, uint32\_t errCode)
    {
        (void \*)usrCtx;
        if (response != NULL) {
            printf("Response status: %d\\n", response->statusCode);
        } else {
            printf("Fetch failed: errCode: %u\\n", errCode);
        }
        // 注意清理响应
        if (response != NULL) {
            response->destroyResponse(response);
        }
    }
    
    int main() {
        const char \*kHttpServerAddress = "http://www.example.com";
        // 请求配置
        Rcp\_Configuration config;
        // 初始化配置参数
        (void)memset(&config, 0, sizeof(Rcp\_Configuration));
        // 重新设置自动重定向
        config.transferConfiguration.autoRedirect = true;
        // 重新设置请求超时配置参数
        config.transferConfiguration.timeout.transferMs = 1000 \* 10;
        config.transferConfiguration.timeout.connectMs = 1000 \* 10;
        Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
        request->method = RCP\_METHOD\_GET;
        request->configuration = &config;
        uint32\_t errCode = 0;
        // 创建session
        Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
        // 配置请求回调
        Rcp\_ResponseCallbackObject responseCallback = {ResponseCallback, NULL};
        // 发起请求
        errCode = HMS\_Rcp\_Fetch(session, request, &responseCallback);
        // 等待结果，仅是等待异步调用完成，开发者可根据自己实际场景处理回调。
        usleep(1000 \* 1000 \* 3);
        printf("Fetch completed, errCode: %u\\n", errCode);
        // 在退出前取消可能还在执行的requests
        errCode = HMS\_Rcp\_CancelSession(session);
        // 清理request
        HMS\_Rcp\_DestroyRequest(request);
        // 关闭session
        errCode = HMS\_Rcp\_CloseSession(&session);
        // 处理errCode
        return 0;
    }
    

#### 如何使用post发送网络请求

发送带有默认HTTP参数的HTTP POST请求，并返回来自服务器的HTTP响应。使用异步回调。常用于向服务器提交数据。与GET请求不同，POST请求将参数包含在请求主体中，适用于创建新资源、提交表单数据或执行某些操作。

#### \[h2\]使用示例

1.  CPP侧导入模块。
    
    #include "RemoteCommunicationKit/rcp.h"
    #include <cstdlib>
    #include <cstring>
    #include <stdio.h>
    #include <unistd.h>
    #include <thread>
    
2.  CMakeLists.txt中添加以下lib。（具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/remote-communication-preparations#c-api开发准备)）。
    
    librcp\_c.so
    
3.  创建会话，会话发起post请求。“http://www.example.com”请根据实际情况替换为想要请求的URL地址。等待响应返回后，销毁request并关闭session。
    
    void ResponseCallback(void \*usrCtx, Rcp\_Response \*response, uint32\_t errCode)
    {
        (void \*)usrCtx;
        if (response != NULL) {
            printf("Response status: %d\\n", response->statusCode);
        } else {
            printf("Fetch failed: errCode: %u\\n", errCode);
        }
        // 注意清理响应
        if (response != NULL) {
            response->destroyResponse(response);
        }
    }
    
    int main() {
        const char \*kHttpServerAddress = "http://www.example.com";
        const char \*content = "content";
        Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
        // 设置request参数
        request->method = RCP\_METHOD\_POST;
        request->content = (Rcp\_RequestContent \*)calloc(1, sizeof(Rcp\_RequestContent));
        request->content->type = RCP\_CONTENT\_TYPE\_STRING;
        request->content->data.contentStr.buffer = content;
        request->content->data.contentStr.length = strlen(content);
        // 请求配置
        Rcp\_Configuration config;
        // 初始化配置参数
        (void)memset(&config, 0, sizeof(Rcp\_Configuration));
        // 重新设置自动重定向
        config.transferConfiguration.autoRedirect = true;
        // 重新设置请求超时配置参数
        config.transferConfiguration.timeout.transferMs = 1000 \* 10;
        config.transferConfiguration.timeout.connectMs = 1000 \* 10;
        request->configuration = &config;
        uint32\_t errCode = 0;
        // 创建session
        Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
        // 配置请求回调
        Rcp\_ResponseCallbackObject responseCallback = {ResponseCallback, NULL};
        // 发起请求
        errCode = HMS\_Rcp\_Fetch(session, request, &responseCallback);
        // 等待fetch结果，仅是等待异步调用完成，开发者可根据自己实际场景处理回调。
        std::this\_thread::sleep\_for(std::chrono::milliseconds(1000 \* 1000 \* 3));
        printf("Fetch completed, errCode: %u\\n", errCode);
        // 清理request->content
        free(request->content);
        // 清理request
        HMS\_Rcp\_DestroyRequest(request);
        // 关闭session
        errCode = HMS\_Rcp\_CloseSession(&session);
        // 处理errCode
        return 0;
    }
    

#### 如何使用put发送网络请求

发送带有默认HTTP参数的HTTP PUT请求，并返回来自服务器的HTTP响应。使用异步回调。常用于向服务器更新资源。PUT请求将更新的数据发送到特定的URL，用于替换指定资源的全部内容。

#### \[h2\]使用示例

1.  CPP侧导入模块。
    
    #include "RemoteCommunicationKit/rcp.h"
    #include <cstdlib>
    #include <cstring>
    #include <stdio.h>
    #include <unistd.h>
    #include <thread>
    
2.  CMakeLists.txt中添加以下lib。（具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/remote-communication-preparations#c-api开发准备)）。
    
    librcp\_c.so
    
3.  创建会话，会话发起put请求。“http://www.example.com”请根据实际情况替换为想要请求的URL地址。等待响应返回后，销毁request并关闭session。
    
    void ResponseCallback(void \*usrCtx, Rcp\_Response \*response, uint32\_t errCode)
    {
        (void \*)usrCtx;
        if (response != NULL) {
            printf("Response status: %d\\n", response->statusCode);
        } else {
            printf("Fetch failed: errCode: %u\\n", errCode);
        }
        // 注意清理响应
        if (response != NULL) {
            response->destroyResponse(response);
        }
    }
    
    int main() {
        const char \*kHttpServerAddress = "http://www.example.com";
        const char \*content = "content";
        // 创建request，并设置request的参数
        Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
        request->method = RCP\_METHOD\_PUT;
        request->content = (Rcp\_RequestContent \*)calloc(1, sizeof(Rcp\_RequestContent));
        request->content->type = RCP\_CONTENT\_TYPE\_STRING;
        request->content->data.contentStr.buffer = content;
        request->content->data.contentStr.length = strlen(content);
        // 请求配置
        Rcp\_Configuration config;
        // 初始化配置参数
        (void)memset(&config, 0, sizeof(Rcp\_Configuration));
        // 重新设置自动重定向
        config.transferConfiguration.autoRedirect = true;
        // 重新设置请求超时配置参数
        config.transferConfiguration.timeout.transferMs = 1000 \* 10;
        config.transferConfiguration.timeout.connectMs = 1000 \* 10;
        request->configuration = &config;
        uint32\_t errCode = 0;
        // 创建session
        Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
        // 配置请求回调
        Rcp\_ResponseCallbackObject responseCallback = {ResponseCallback, NULL};
        // 发起fetch请求
        errCode = HMS\_Rcp\_Fetch(session, request, &responseCallback);
        // 等待结果，仅是等待异步调用完成，开发者可根据自己实际场景处理回调。
        std::this\_thread::sleep\_for(std::chrono::milliseconds(1000 \* 1000 \* 3));
        printf("Fetch completed, errCode: %u\\n", errCode);
        // 在退出前取消可能还在执行的requests
        errCode = HMS\_Rcp\_CancelSession(session);
        // 清理request content
        free(request->content);
        // 清理request
        HMS\_Rcp\_DestroyRequest(request);
        // 关闭session
        errCode = HMS\_Rcp\_CloseSession(&session);
        // 处理errCode
        return 0;
    }
    

#### 如何使用head发送网络请求

发送带有默认HTTP参数的HTTP HEAD请求，并返回来自服务器的HTTP响应。使用异步回调。类似GET请求，但只返回响应头，不返回实体内容。可以获取资源的元信息，如文件大小、修改日期等。

#### \[h2\]使用示例

1.  CPP侧导入模块。
    
    #include "RemoteCommunicationKit/rcp.h"
    #include <cstring>
    #include <stdio.h>
    #include <unistd.h>
    
2.  CMakeLists.txt中添加以下lib。（具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/remote-communication-preparations#c-api开发准备)）。
    
    librcp\_c.so
    
3.  创建会话，会话发起head请求。“http://www.example.com”请根据实际情况替换为想要请求的URL地址。等待响应返回后，销毁request并关闭session。
    
    void ResponseCallback(void \*usrCtx, Rcp\_Response \*response, uint32\_t errCode)
    {
        (void \*)usrCtx;
        if (response != NULL) {
            printf("Response status: %d\\n", response->statusCode);
        } else {
            printf("Fetch failed: errCode: %u\\n", errCode);
        }
        // 注意清理响应
        if (response != NULL) {
            response->destroyResponse(response);
        }
    }
    
    int main() {
        const char \*kHttpServerAddress = "http://www.example.com/head";
        Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
        request->method = RCP\_METHOD\_HEAD;
        // 请求配置
        Rcp\_Configuration config;
        // 初始化配置参数
        (void)memset(&config, 0, sizeof(Rcp\_Configuration));
        // 重新设置自动重定向
        config.transferConfiguration.autoRedirect = true;
        // 重新设置请求超时配置参数
        config.transferConfiguration.timeout.transferMs = 1000 \* 10;
        config.transferConfiguration.timeout.connectMs = 1000 \* 10;
        request->configuration = &config;
        uint32\_t errCode = 0;
        // 创建session
        Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
        // 配置请求回调
        Rcp\_ResponseCallbackObject responseCallback = {ResponseCallback, NULL};
        // 发起fetch请求
        errCode = HMS\_Rcp\_Fetch(session, request, &responseCallback);
        // 等待fetch结果，仅是等待异步调用完成，开发者可根据自己实际场景处理回调。
        usleep(1000 \* 1000 \* 3);
        printf("Fetch completed, errCode: %u\\n", errCode);
        // 在退出前取消可能还在执行的requests
        errCode = HMS\_Rcp\_CancelSession(session);
        // 清理request
        HMS\_Rcp\_DestroyRequest(request);
        // 关闭session
        errCode = HMS\_Rcp\_CloseSession(&session);
        // 处理errCode
        return 0;
    }
    

#### 如何使用delete发送网络请求

发送带有默认HTTP参数的HTTP DELETE请求，并返回来自服务器的HTTP响应，用于从服务器删除资源，通过向指定URL发送DELETE请求，可以删除该URL上对应的资源。使用异步回调。

#### \[h2\]使用示例

1.  CPP侧导入模块。
    
    #include "RemoteCommunicationKit/rcp.h"
    #include <cstring>
    #include <stdio.h>
    #include <unistd.h>
    
2.  CMakeLists.txt中添加以下lib。（具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/remote-communication-preparations#c-api开发准备)）。
    
    librcp\_c.so
    
3.  创建会话，会话发起delete请求。“http://www.example.com”请根据实际情况替换为想要请求的URL地址。等待响应返回后，销毁request并关闭session。
    
    void ResponseCallback(void \*usrCtx, Rcp\_Response \*response, uint32\_t errCode)
    {
        (void \*)usrCtx;
        if (response != NULL) {
            printf("Response status: %d\\n", response->statusCode);
        } else {
            printf("Fetch failed: errCode: %u\\n", errCode);
        }
        if (response != NULL) {
            response->destroyResponse(response);
        }
    }
    
    int main() {
        const char \*kHttpServerAddress = "http://www.example.com/delete";
        Rcp\_Request \*request = HMS\_Rcp\_CreateRequest(kHttpServerAddress);
        request->method = RCP\_METHOD\_DELETE;
        // 请求配置
        Rcp\_Configuration config;
        // 初始化配置参数
        (void)memset(&config, 0, sizeof(Rcp\_Configuration));
        // 重新设置自动重定向
        config.transferConfiguration.autoRedirect = true;
        // 重新设置请求超时配置参数
        config.transferConfiguration.timeout.transferMs = 1000 \* 10;
        config.transferConfiguration.timeout.connectMs = 1000 \* 10;
        request->configuration = &config;
        uint32\_t errCode = 0;
        // 创建session
        Rcp\_Session \*session = HMS\_Rcp\_CreateSession(NULL, &errCode);
        // 配置请求回调
        Rcp\_ResponseCallbackObject responseCallback = {ResponseCallback, NULL};
        // 发起fetch请求
        errCode = HMS\_Rcp\_Fetch(session, request, &responseCallback);
        // 等待fetch结果，仅是等待异步调用完成，开发者可根据自己实际场景处理回调。
        usleep(1000 \* 1000 \* 3);
        printf("Fetch completed, errCode: %u\\n", errCode);
        // 在退出前取消可能还在执行的requests
        errCode = HMS\_Rcp\_CancelSession(session);
        // 清理request
        HMS\_Rcp\_DestroyRequest(request);
        // 关闭session
        errCode = HMS\_Rcp\_CloseSession(&session);
        // 处理errCode
        return 0;
    }