HarmonyOS开发实战：网络请求能力-rcp

代码中的爱马仕

于 2024-07-02 13:53:50 发布

阅读量490

点赞数 13

分类专栏： HarmonyOS 鸿蒙 OpenHarmony 文章标签： harmonyos 华为前端鸿蒙鸿蒙开发程序员

本文链接：https://blog.csdn.net/DMZDAMS/article/details/140124933

版权

鸿蒙同时被 3 个专栏收录

158 篇文章 1 订阅

订阅专栏

OpenHarmony

156 篇文章 0 订阅

订阅专栏

HarmonyOS

152 篇文章 0 订阅

订阅专栏

rcp模块提供HTTP数据请求功能，请求性能如接口的易用性、性能、功耗方面，对比Network Kit HTTP网络API，rcp采用面向对象和场景的设计，API使用更简单、更灵活，满足不同场景的使用需求，具备更好的扩展性和更优的性能。支持如场景化网络API、网络代理、自定义DNS解析、自定义证书校验、服务器身份校验等特性。

场景描述

RCP网络库提供数据请求功能涉及到的使用场景可参考如下：

场景一：调用rcp库实现基础的网络请求能力

场景二：对标http原生库能力使用post、get请求将多个文件采用表单形式上传至服务端做处理

场景三：当根证书校验失败，请求使用自签名证书不支持/无法通过校验或证书过期需要重新修改证书时，通过rcp网络请求能力忽略证书校验

场景四：为验证服务端和客户端之间的身份和数据完整性，确保通信的安全性

场景五：不同的系统、不同的框架使用的域名解析机制不同，用户使用域名连接系统时，需要配置使用统一解析域名作为入口处理请求

场景六：请求时判断用户是否登录、判断用户是否有权限访问资源、处理cookie方式，调用rcp请求实现拦截器能力

方案描述

场景一：

调用rcp库实现基础的网络请求能力

效果图

方案

创建session会话后，调用模块支持的各类HTTP数据发送方式（FETCH、GET、POST、PUT等）

核心代码

rcpTest(){

let testUrl = "https://www.xxx.com"

//定义通信会话对象

const sessionWithSecurityConfig = rcp.createSession();

//get请求

sessionWithSecurityConfig.get(testUrl).then((response) => {

console.log("test---------" + response.toString());

//页面展示请求结果

AlertDialog.show(

{

title: 'request接口回调结果',

message: '请求网站：' + testUrl + '\n\n' + 'Callback Data: ' + response.toString(),

})

}).catch((err:BusinessError)=> {

AlertDialog.show(

{

title: 'request接口回调结果',

message: '请求失败，错误信息：' + err.data,

})

console.error("test err:" + JSON.stringify(err));

});

}

场景二：

使用时希望通过post、get请求将多个文件采用表单形式携带上传至服务端做对应处理

点击领取→【纯血版鸿蒙全套最新学习资料】（安全链接，放心点击）希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取~

方案

请求地址采用post方式上传文件时需要携带多个文件，可通过MultipartForm多表单参数实现当前场景

核心代码

let session = rcp.createSession();

let request = new rcp.Request('http://192.168.0.1:8080');

request.content = new rcp.MultipartForm({

file1: {

contentOrPath: {

content: new util.TextEncoder().encode('Text').buffer

}

},

file2: {

contentOrPath: {

content: new util.TextEncoder().encode('Text').buffer

}

},

});

try {

const resp = await session.fetch(request);

console.log("resp",JSON.stringify(resp))

expect(resp.statusCode).assertEqual(200);

} catch (e) {

expect(JSON.stringify(e)).assertEqual('99');

}

session.close();

场景三：

当根证书校验失败，请求使用自签名证书不支持/无法通过校验或证书过期需要重新修改证书时，希望通过rcp网络请求能力忽略证书校验

效果图

方案

rcp网络库中可通过设置参数Configuration.security设置为 'skip' 以绕过证书校验

核心代码

let testUrl = "https://www.example.com"



//session中证书有关能力设置

const securityConfig: rcp.SecurityConfiguration = {

remoteValidation : 'skip'

};



//发起请求

const session = rcp.createSession({ requestConfiguration: { security: securityConfig } });

session.get(testUrl).then((response) => {

console.log('res timeInfo : ' + JSON.stringify(response));



}).catch((err: BusinessError) => {

console.error("err:" + JSON.stringify(err));

});

场景四：

为验证服务端和客户端之间的身份和数据完整性，确保通信的安全性，使用rcp库能力实现双向证书绑定能力

效果图

方案

为实现双向证书绑定能力需要首先对服务端证书做校验，请求同时需要客户端证书做校验可在Configuration接口包含配置参数rcp.Configuration

核心代码


//证书内容读取

getContext(this).area = 0

let context: Context = getContext(this);

const keyPemConent = context.resourceManager.getRawFileContentSync('baidu.pem')



//通信url地址

let kHttpServerAddress = "https://www.baidu.com";



try {

//建立通信请求

const session = rcp.createSession();

const request = new rcp.Request(kHttpServerAddress, "GET");



//设置请求参数

request.configuration = {

security: {

certificate: {

content: keyPemConent,

type: "PEM"

}

}

}

console.info("configuration:" + JSON.stringify(request.configuration));



//fetch方式获取请求结果

const response = await session.fetch(request);

console.info("证书校验成功", JSON.stringify(response));

let content1 = `${kHttpServerAddress} 证书校验成功` + JSON.stringify(response);

} catch (err) {

console.error("证书校验失败" + JSON.stringify(err));

let content1 = `${kHttpServerAddress} 证书校验失败` + JSON.stringify(err);

let e: BusinessError = err as BusinessError;

console.error("testTag Get push token catch error:" + JSON.stringify(e));

}

场景五：

不同的系统、不同的框架使用的域名解析机制不同，用户使用域名连接系统时，需要配置使用统一解析域名作为入口处理请求

方案

如开发人员需要为HTTP请求配置域名系统（DNS），包括自定义DNS服务器或静态DNS规则，可在session对象中的DnsConfiguration参数处设置

核心代码

// 1、自定义DNS服务器

const customDnsServers: rcp.DnsServers = [

{ ip: "8.8.8.8" },

{ ip: "8.8.4.4", port: 53 },

];

const sessionWithCustomDns = rcp.createSession({ requestConfiguration: { dns: { dnsRules: customDnsServers } } });





// 2、自定义静态DNS能力

const staticDnsRules: rcp.StaticDnsRules = [

{ host: "example.com", port: 80, ipAddresses: ["192.168.1.1", "192.168.1.2"] },

{ host: "sub.example.com", port: 443, ipAddresses: ["192.168.2.1"] },

];

const sessionWithStaticDns = rcp.createSession({ requestConfiguration: { dns: { dnsRules: staticDnsRules } } });





// 3、配置HTTP请求的DNS

const dohConfig: rcp.DnsOverHttpsConfiguration = {

url: "https://dns.example.com/dns-query",

skipCertificatesValidation: true,

};

const sessionWithDoh = rcp.createSession({ requestConfiguration: { dns: { dnsOverHttps: dohConfig } } });

场景六：

请求时判断用户是否登录、判断用户是否有权限访问资源、处理cookie方式，调用rcp请求实现拦截器能力

方案

当前Api12配套版本上，rcp库中添加interceptors参数做对应的拦截器功能

核心代码


//定义拦截器

class ResponseCache {

private readonly cache: any = {};



getResponse(url: string): rcp.Response {

return this.cache[url];

}



setResponse(url: string, response: rcp.Response): void {

this.cache[url] = response;

}

}



class ResponseCachingInterceptor implements rcp.Interceptor {

constructor(private readonly cache: ResponseCache) {}



async intercept(context: rcp.RequestContext, next: rcp.RequestHandler): Promise<rcp.Response> {

const url = context.request.url.href;



const responseFromCache = this.cache.getResponse(url);

if (responseFromCache) {

return Promise.resolve(responseFromCache);

}



const promise = next.handle(context);

promise.then((resp)=>{

resp.statusCode = 200;

cache.setResponse(url, resp);

});

return promise;

}

}



//使用rcp库拦截器能力

const cache = new ResponseCache();

async function testInterceptor() {

const session = rcp.createSession({

interceptors: [new ResponseCachingInterceptor(cache)]

});

const response1 = await session.get('https://www.example.com');

const response2 = await session.fetch(request);

}