引言在上一节课中我们学习了使用 Network Kit 的 HTTP 模块发起网络请求。本节课将介绍 HarmonyOS 提供的另一个网络通信工具——Remote Communication KitRCP。RCP 是远场通信服务提供了场景化 API与 Network Kit 的原子级 API 形成互补。本节课将通过图片列表应用开发掌握 RCP 模块 GET 请求的发起、服务端数据接收解析、数据与 UI 组件结合的完整流程。核心内容Network Kit 与 Remote Communication Kit 对比核心定位差异对比维度Network KitRemote Communication KitRCP定位网络服务基础组件远场通信场景化组件API 类型原子级 API场景化 API开发方式仅提供基础功能处理请求头、缓存、重定向等需求需开发者手动编写额外代码提前封装常用场景模板自带响应缓存、安全校验、拦截器等实用功能调用方式需在参数中手动指定请求方法直接调用get()/post()等场景化方法类比理解Network Kit 类似空白画布适合需要自定义全流程的开发场景RCP 类似带模板的表格常用场景已提前做好模板开发者直接填入关键信息即可使用。客户端连接管理的核心差异传统 HTTP 模块每次请求都需要重复执行「建立连接 → 握手 → 请求 → 断开连接」流程。RCP创建可复用的会话对象在应用运行时重复发起请求通信结束后统一销毁会话既提升请求效率也让代码更简洁易维护。RCP 核心业务流程RCP 模块提供会话管理能力完整流程分为三步客户端创建会话Session。客户端通过会话发起请求。客户端接收请求结果处理业务。客户端通过会话管理先创建会话再持续向服务端发送请求、接收响应可重复多次交互无需重复创建连接。创建会话Session开发核心接口通过createSession()接口创建会话对象该对象是所有后续 RCP 操作的核心基础封装了get()/post()等场景化请求方法。// 创建 session 对象支持可选配置参数 rcp.createSession(sessionConfiguration?: SessionConfiguration): Session; // 自定义请求头示例 const sessionConfig: rcp.SessionConfiguration { headers: { cache-control: no-cache, accept: text/html, accept-language: en } }; session rcp.createSession(sessionConfig);如果不需要自定义配置可以不传参数直接创建。通过SessionConfiguration可以自定义 URL、请求头 Headers 等参数请求头自带默认值也支持自定义修改。RCP 会话对象有数量限制可能创建失败因此必须增加异常捕获处理。export class RCPUtils { rcpSession?: rcp.Session; constructor() { this.rcpCreateSession(); } rcpCreateSession(): void { try { this.rcpSession rcp.createSession(); } catch (error) { // session 创建失败时的异常处理 // ... } } }需要合理复用管理 Session 对象避免重复创建占用资源。发起请求开发请求方法说明接口功能说明get()发送一个带有默认 HTTP 参数的 HTTP GET 请求post()发送一个带有默认 HTTP 参数的 HTTP POST 请求put()发送一个带有默认 HTTP 参数的 HTTP PUT 请求GET 请求示例let session rcp.createSession(); let promise session.get( https://developer.huawei.com/consumer/cn/doc, ).then((response: rcp.Response) { const statusCode response.statusCode; const headers response.headers; // 处理响应 });get()方法支持 1 个必选参数请求资源 URL、1 个可选参数指定数据接收位置。请求返回 Promise 对象响应结果response中包含statusCode响应状态码、headers响应头、body响应体等字段可供后续处理。RCP 完整开发流程图片列表应用实践完整流程开发准备 → 创建 Session 会话 → 发起请求 → 解析响应 → 错误处理 → 渲染页面 → 关闭会话步骤 1开发准备配置网络权限在module.json5中添加互联网访问权限配置方法与 Network Kit 完全一致。// module.json5 { module: { requestPermissions: [ { name: ohos.permission.INTERNET, reason: request images from network } ] } }导入 RCP 模块// RcpUtils.ets import { rcp } from kit.RemoteCommunicationKit;RCP 模块接口从 API version 6 开始支持。步骤 2创建 Session 会话调用rcp.createSession()方法创建session对象这是发起请求的前置核心操作所有请求都基于该对象执行。需要统一管理创建和销毁必须增加异常捕获处理。步骤 3发起请求调用session.get()传入图片列表接口的 URL 地址发起 GET 请求。this.rcpSession?.get(IMAGE_URL) .then((response: rcp.Response) { // 处理响应 }) .catch((error: Error) { // 错误处理 });步骤 4解析响应服务端返回 JSON 格式数据包含图片资源的 URL。响应格式由响应头的Content-Type决定如果Content-Type为json则响应内容为字符串通过JSON.parse()即可反序列化为应用可识别、UI 组件可使用的对象。.then((response: rcp.Response) { if (response.statusCode 200) { const jsonData response.body as string; const imageList JSON.parse(jsonData); this.imageData imageList; } })步骤 5错误处理网络请求可能出现异常需要做针对性异常处理避免应用无响应或崩溃影响用户体验。开发者可以根据应用风格自定义错误提示页面。.catch((error: Error) { console.error(Request failed: error.message); this.errorMessage 网络请求失败请检查网络连接; });步骤 6渲染页面将解析完成的数据渲染为图片列表逻辑与 Network Kit 的实现基本一致。步骤 7关闭会话不再需要发起网络请求时需要调用session.close()关闭会话释放底层占用的系统资源避免不必要的资源消耗。this.rcpSession?.close();RCP 是基于会话的通信模式只要会话未销毁就可以重复发起多次请求一般在应用退出时统一执行释放操作。原子化 HTTP 模块每次请求完成后就会立即销毁对象释放资源多次请求需要重复创建销毁RCP 复用会话的模式更高效但需要合理管理销毁时机避免资源泄露。总结本节课学习了 Remote Communication KitRCP的核心知识RCP 与 Network Kit 的对比Network Kit 是原子级 API需手动处理请求头、缓存等细节RCP 是场景化 API自带缓存、拦截器等功能开箱即用。RCP 的核心优势是基于会话的持久化连接管理可复用连接提升请求效率。RCP 核心业务流程创建会话Session→ 发起请求 → 接收响应处理业务。会话创建后可多次交互通信结束后统一销毁。核心接口createSession(config?)创建会话对象需捕获异常合理复用。session.get(url)/post()/put()场景化请求方法。response包含statusCode、headers、body等字段。完整开发流程开发准备权限配置 导入模块→ 创建 Session 会话 → 发起 GET 请求 → 解析 JSON 响应 → 错误处理 → 渲染页面 → 关闭会话释放资源。
引言在上一节课中我们学习了使用 Network Kit 的 HTTP 模块发起网络请求。本节课将介绍 HarmonyOS 提供的另一个网络通信工具——Remote Communication KitRCP。RCP 是远场通信服务提供了场景化 API与 Network Kit 的原子级 API 形成互补。本节课将通过图片列表应用开发掌握 RCP 模块 GET 请求的发起、服务端数据接收解析、数据与 UI 组件结合的完整流程。核心内容Network Kit 与 Remote Communication Kit 对比核心定位差异对比维度Network KitRemote Communication KitRCP定位网络服务基础组件远场通信场景化组件API 类型原子级 API场景化 API开发方式仅提供基础功能处理请求头、缓存、重定向等需求需开发者手动编写额外代码提前封装常用场景模板自带响应缓存、安全校验、拦截器等实用功能调用方式需在参数中手动指定请求方法直接调用get()/post()等场景化方法类比理解Network Kit 类似空白画布适合需要自定义全流程的开发场景RCP 类似带模板的表格常用场景已提前做好模板开发者直接填入关键信息即可使用。客户端连接管理的核心差异传统 HTTP 模块每次请求都需要重复执行「建立连接 → 握手 → 请求 → 断开连接」流程。RCP创建可复用的会话对象在应用运行时重复发起请求通信结束后统一销毁会话既提升请求效率也让代码更简洁易维护。RCP 核心业务流程RCP 模块提供会话管理能力完整流程分为三步客户端创建会话Session。客户端通过会话发起请求。客户端接收请求结果处理业务。客户端通过会话管理先创建会话再持续向服务端发送请求、接收响应可重复多次交互无需重复创建连接。创建会话Session开发核心接口通过createSession()接口创建会话对象该对象是所有后续 RCP 操作的核心基础封装了get()/post()等场景化请求方法。// 创建 session 对象支持可选配置参数 rcp.createSession(sessionConfiguration?: SessionConfiguration): Session; // 自定义请求头示例 const sessionConfig: rcp.SessionConfiguration { headers: { cache-control: no-cache, accept: text/html, accept-language: en } }; session rcp.createSession(sessionConfig);如果不需要自定义配置可以不传参数直接创建。通过SessionConfiguration可以自定义 URL、请求头 Headers 等参数请求头自带默认值也支持自定义修改。RCP 会话对象有数量限制可能创建失败因此必须增加异常捕获处理。export class RCPUtils { rcpSession?: rcp.Session; constructor() { this.rcpCreateSession(); } rcpCreateSession(): void { try { this.rcpSession rcp.createSession(); } catch (error) { // session 创建失败时的异常处理 // ... } } }需要合理复用管理 Session 对象避免重复创建占用资源。发起请求开发请求方法说明接口功能说明get()发送一个带有默认 HTTP 参数的 HTTP GET 请求post()发送一个带有默认 HTTP 参数的 HTTP POST 请求put()发送一个带有默认 HTTP 参数的 HTTP PUT 请求GET 请求示例let session rcp.createSession(); let promise session.get( https://developer.huawei.com/consumer/cn/doc, ).then((response: rcp.Response) { const statusCode response.statusCode; const headers response.headers; // 处理响应 });get()方法支持 1 个必选参数请求资源 URL、1 个可选参数指定数据接收位置。请求返回 Promise 对象响应结果response中包含statusCode响应状态码、headers响应头、body响应体等字段可供后续处理。RCP 完整开发流程图片列表应用实践完整流程开发准备 → 创建 Session 会话 → 发起请求 → 解析响应 → 错误处理 → 渲染页面 → 关闭会话步骤 1开发准备配置网络权限在module.json5中添加互联网访问权限配置方法与 Network Kit 完全一致。// module.json5 { module: { requestPermissions: [ { name: ohos.permission.INTERNET, reason: request images from network } ] } }导入 RCP 模块// RcpUtils.ets import { rcp } from kit.RemoteCommunicationKit;RCP 模块接口从 API version 6 开始支持。步骤 2创建 Session 会话调用rcp.createSession()方法创建session对象这是发起请求的前置核心操作所有请求都基于该对象执行。需要统一管理创建和销毁必须增加异常捕获处理。步骤 3发起请求调用session.get()传入图片列表接口的 URL 地址发起 GET 请求。this.rcpSession?.get(IMAGE_URL) .then((response: rcp.Response) { // 处理响应 }) .catch((error: Error) { // 错误处理 });步骤 4解析响应服务端返回 JSON 格式数据包含图片资源的 URL。响应格式由响应头的Content-Type决定如果Content-Type为json则响应内容为字符串通过JSON.parse()即可反序列化为应用可识别、UI 组件可使用的对象。.then((response: rcp.Response) { if (response.statusCode 200) { const jsonData response.body as string; const imageList JSON.parse(jsonData); this.imageData imageList; } })步骤 5错误处理网络请求可能出现异常需要做针对性异常处理避免应用无响应或崩溃影响用户体验。开发者可以根据应用风格自定义错误提示页面。.catch((error: Error) { console.error(Request failed: error.message); this.errorMessage 网络请求失败请检查网络连接; });步骤 6渲染页面将解析完成的数据渲染为图片列表逻辑与 Network Kit 的实现基本一致。步骤 7关闭会话不再需要发起网络请求时需要调用session.close()关闭会话释放底层占用的系统资源避免不必要的资源消耗。this.rcpSession?.close();RCP 是基于会话的通信模式只要会话未销毁就可以重复发起多次请求一般在应用退出时统一执行释放操作。原子化 HTTP 模块每次请求完成后就会立即销毁对象释放资源多次请求需要重复创建销毁RCP 复用会话的模式更高效但需要合理管理销毁时机避免资源泄露。总结本节课学习了 Remote Communication KitRCP的核心知识RCP 与 Network Kit 的对比Network Kit 是原子级 API需手动处理请求头、缓存等细节RCP 是场景化 API自带缓存、拦截器等功能开箱即用。RCP 的核心优势是基于会话的持久化连接管理可复用连接提升请求效率。RCP 核心业务流程创建会话Session→ 发起请求 → 接收响应处理业务。会话创建后可多次交互通信结束后统一销毁。核心接口createSession(config?)创建会话对象需捕获异常合理复用。session.get(url)/post()/put()场景化请求方法。response包含statusCode、headers、body等字段。完整开发流程开发准备权限配置 导入模块→ 创建 Session 会话 → 发起 GET 请求 → 解析 JSON 响应 → 错误处理 → 渲染页面 → 关闭会话释放资源。
)
