HarmonyOS 鸿蒙Next中基于RCP的网络请求开发实践

HarmonyOS 鸿蒙Next中基于RCP的网络请求开发实践 班级链接https://developer.huawei.com/consumer/cn/training/classDetail/c3a8c85a8f3f4b77b4767378981690f6?type=1?ha_source=hmosclass&ha_sourceId=89000248

在鸿蒙（HarmonyOS）应用开发中，网络通信是连接应用与云端服务的核心。虽然系统内置的NetworkKit提供了基础的HTTP能力，但在处理复杂网络场景时，其功能可能捉襟见肘。为此，鸿蒙推出了功能更强大的远程通信平台RCP。本文将系统介绍基于RCP的网络请求开发实践，帮助你构建更稳健、高效的应用网络层。

一、为什么选择RCP？

RCP相较于传统的HTTP模块，在易用性和功能性上均有显著提升。它并非简单的替代，而是面向更复杂场景的增强解决方案。

核心优势对比：

• 功能全面：RCP支持PATCH请求、请求拦截/取消、响应缓存、DNS定制、双向证书校验等，这些都是基础HTTP模块不具备或支持有限的功能。
• 设计先进：它采用会话（Session）管理机制，允许你为一系列请求配置统一的基地址、请求头、拦截器等，避免了重复配置。同时，其拦截器（Interceptor） 设计让你能在请求发出前和收到响应后插入统一逻辑（如添加Token、解析错误）。
• 易于调试：RCP支持捕获详细的网络跟踪信息和各阶段耗时数据，便于进行性能分析和问题排查。

二、开发准备与实践步骤

1. 环境与权限配置

在开始编码前，请确保你的DevEco Studio项目已支持API 5.0及以上版本。与所有网络请求一样，使用RCP也需要在 module.json5 文件中声明网络权限。

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      }
    ]
  }
}

2. 发起一个基础网络请求

使用RCP发起请求的核心流程围绕 Session、Request、Response 三个对象展开。

• 创建会话 (Session)：这是请求的上下文环境，可以共享配置。

  import { rcp } from '@kit.RemoteCommunicationKit';
  // 创建会话，可在此配置基地址、公共请求头等
  const session = rcp.createSession({
    baseAddress: 'https://api.example.com/v1/', // 统一的基础地址
    headers: { 'Content-Type': 'application/json' }
  });
  

• 构建并发送请求 (Request & Fetch)：在会话中创建具体的请求对象并执行。

  // 构建一个GET请求对象
  let getRequest = new rcp.Request('users/123', 'GET'); // 最终URL为 https://api.example.com/v1/users/123
  
  // 使用Promise链式调用发送请求
  session.fetch(getRequest)
    .then((response: rcp.Response) => {
      console.info(`请求成功，状态码: ${response.statusCode}`);
      console.info(`响应数据: ${JSON.stringify(response.body)}`);
    })
    .catch((err: BusinessError) => {
      console.error(`请求失败: ${err.message}`);
    });
  
  // 发送一个PATCH请求（RCP特有支持[citation:2]）
  let patchRequest = new rcp.Request('users/123', 'PATCH', 
                                     { 'accept': 'application/json' }, 
                                     { 'userName': '新名字' });
  session.fetch(patchRequest).then(...);
  

3. 实现高级功能

RCP的高级功能是其强大之处，以下是一些典型场景：

• 多表单/文件上传：使用 MultipartForm 对象可以方便地构建包含文本和文件的多部分表单数据。

  const multiForm = new rcp.MultipartForm({
    'avatar': { contentType: 'image/jpeg', 
                contentOrPath: '/local/path/to/photo.jpg' },
    'description': '这是我的个人头像'
  });
  let uploadRequest = new rcp.Request('upload', 'POST', {}, multiForm);
  

• 自定义DNS与安全：RCP允许深度定制网络行为，例如指定DNS服务器或忽略SSL证书校验（仅用于调试）。

  const sessionWithCustomDNS = rcp.createSession({
    requestConfiguration: {
      dns: {
        dnsRules: { 
          dnsServers: [{ ip: '8.8.8.8' }] // 使用谷歌DNS
        }
      },
      security: {
        tlsOptions: { 
          tlsVersion: 'TlsV1.3' // 指定TLS版本
        }
      }
    }
  });
  

• 使用拦截器统一处理：拦截器是RCP架构的亮点，适合处理鉴权、日志等全局逻辑。

  const myInterceptor: rcp.Interceptor = {
    intercept: async (chain: rcp.InterceptorChain) => {
      // 1. 在发送请求前，为所有请求添加Token
      let request = chain.request;
      request.headers['Authorization'] = `Bearer ${yourToken}`;
      
      // 2. 继续执行请求链
      let response = await chain.proceed(request);
      
      // 3. 收到响应后，可统一处理错误
      if (response.statusCode == 401) {
        // Token过期，跳转登录
      }
      return response;
    }
  };
  // 创建会话时传入拦截器数组
  const session = rcp.createSession({ interceptors: [myInterceptor] });
  

三、关键注意事项

1. Session复用与数量限制：这是RCP开发中最关键的陷阱。一个应用内最多只能同时存在16个Session对象，超出将导致后续请求失败。最佳实践是复用Session，而非为每个请求都创建新会话。
   • 方案一（简单应用）：创建一个全局Session单例供所有请求使用。
   • 方案二（复杂应用）：实现一个Session池（Pool） 来管理有限数量的Session，按需分配和回收，这是最推荐的做法。
2. 资源释放：虽然Session可以复用，但对于确定不再使用的Session，应主动调用其 close() 方法释放资源。同样，对于下载到本地文件的响应流，也需及时关闭。
3. 异常处理：网络请求充满不确定性，务必使用 try...catch 或Promise的 .catch() 方法包裹请求代码，并对不同错误码（如超时、无网络、服务器错误）设计友好的用户提示和重试机制。

总结

鸿蒙的RCP网络框架通过其会话管理、拦截器、丰富的配置项等设计，为开发者提供了企业级的网络通信解决方案。从简单的API调用到复杂的文件上传、安全通信，RCP都能胜任。掌握其核心在于理解 Session的生命周期管理 和 拦截器的运用，避免陷入Session数量限制的坑。