HarmonyOS学习日记(day7)

最新推荐文章于 2024-09-29 09:53:09 发布

saiki1281

最新推荐文章于 2024-09-29 09:53:09 发布

阅读量753

点赞数 13

文章标签：学习

本文链接：https://blog.csdn.net/saiki1281/article/details/141397245

版权

场景介绍

应用通过HTTP发起一个数据请求，支持常见的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、C

接口说明

HTTP数据请求功能主要由http模块提供。

使用该功能需要申请ohos.permission.INTERNET权限。

ONNECT方法。

request接口开发步骤

从@kit.NetworkKit中导入http命名空间。
调用createHttp()方法，创建一个HttpRequest对象。
调用该对象的on()方法，订阅http响应头事件，此接口会比request请求先返回。可以根据业务需要订阅此消息。
调用该对象的request()方法，传入http请求的url地址和可选参数，发起网络请求。
按照实际业务需要，解析返回结果。
调用该对象的off()方法，取消订阅http响应头事件。
当该请求使用完毕时，调用destroy()方法主动销毁。

// 引入包名
import { http } from '@kit.NetworkKit';
import { BusinessError } from '@kit.BasicServicesKit';

// 每一个httpRequest对应一个HTTP请求任务，不可复用
let httpRequest = http.createHttp();
// 用于订阅HTTP响应头，此接口会比request请求先返回。可以根据业务需要订阅此消息
// 从API 8开始，使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。 8+
httpRequest.on('headersReceive', (header) => {
console.info('header: ' + JSON.stringify(header));
});
httpRequest.request(
// 填写HTTP请求的URL地址，可以带参数也可以不带参数。URL地址需要开发者自定义。请求的参数可以在extraData中指定
"EXAMPLE_URL",
{
method: http.RequestMethod.POST, // 可选，默认为http.RequestMethod.GET
// 开发者根据自身业务需要添加header字段
header: {
'Content-Type': 'application/json'
},
// 当使用POST请求时此字段用于传递请求体内容，具体格式与服务端协商确定
extraData: "data to send",
expectDataType: http.HttpDataType.STRING, // 可选，指定返回数据的类型
usingCache: true, // 可选，默认为true
priority: 1, // 可选，默认为1
connectTimeout: 60000, // 可选，默认为60000ms
readTimeout: 60000, // 可选，默认为60000ms
usingProtocol: http.HttpProtocol.HTTP1_1, // 可选，协议类型默认值由系统自动指定
usingProxy: false, // 可选，默认不使用网络代理，自API 10开始支持该属性
caPath:'/path/to/cacert.pem', // 可选，默认使用系统预制证书，自API 10开始支持该属性
clientCert: { // 可选，默认不使用客户端证书，自API 11开始支持该属性
certPath: '/path/to/client.pem', // 默认不使用客户端证书，自API 11开始支持该属性
keyPath: '/path/to/client.key', // 若证书包含Key信息，传入空字符串，自API 11开始支持该属性
certType: http.CertType.PEM, // 可选，默认使用PEM，自API 11开始支持该属性
keyPassword: "passwordToKey" // 可选，输入key文件的密码，自API 11开始支持该属性
},
multiFormDataList: [ // 可选，仅当Header中，'content-Type'为'multipart/form-data'时生效，自API 11开始支持该属性
{
name: "Part1", // 数据名，自API 11开始支持该属性
contentType: 'text/plain', // 数据类型，自API 11开始支持该属性
data: 'Example data', // 可选，数据内容，自API 11开始支持该属性
remoteFileName: 'example.txt' // 可选，自API 11开始支持该属性
}, {
name: "Part2", // 数据名，自API 11开始支持该属性
contentType: 'text/plain', // 数据类型，自API 11开始支持该属性
// data/app/el2/100/base/com.example.myapplication/haps/entry/files/fileName.txt
filePath: `${getContext(this).filesDir}/fileName.txt`, // 可选，传入文件路径，自API 11开始支持该属性
remoteFileName: 'fileName.txt' // 可选，自API 11开始支持该属性
}
]
}, (err: BusinessError, data: http.HttpResponse) => {
if (!err) {
// data.result为HTTP响应内容，可根据业务需要进行解析
console.info('Result:' + JSON.stringify(data.result));
console.info('code:' + JSON.stringify(data.responseCode));
// data.header为HTTP响应头，可根据业务需要进行解析
console.info('header:' + JSON.stringify(data.header));
console.info('cookies:' + JSON.stringify(data.cookies)); // 8+
// 当该请求使用完毕时，调用destroy方法主动销毁
httpRequest.destroy();
} else {
console.error('error:' + JSON.stringify(err));
// 取消订阅HTTP响应头事件
httpRequest.off('headersReceive');
// 当该请求使用完毕时，调用destroy方法主动销毁
httpRequest.destroy();
}
}
);

在http模块中，多个请求可以使用同一个httpRequest对象，httpRequest对象不可以复用

当HTTP请求使用完毕时，需调用destroy方法主动销毁HttpRequest对象

关于请求返回的响应码ResponseCode

ResponseCode.OK的值为200，表示请求成功。一般用于GET与POST请求

ResponseCode.NOT_FOUND的值为404，表示服务器无法根据客户端的请求找到资源（网页）

esponseCode.INTERNAL_ERROR的值为500，表示服务器内部错误，无法完成请求

HEAD请求的响应格式与GET请求相同，只是响应主体为空，所以可以用于获取资源的元数据、检查资源是否存在。

DELETE请求可以请求服务器删除指定的资源。

POST请求向指定资源提交数据进行处理请求

method字段为GET时，extraData字段为HTTP请求可选参数的补充，参数内容会拼接到URL中进行发送。

readTimeout字段为读取超时时间，默认为60000ms。设置为0表示不会出现超时情况。

http请求支持get、post、put等常用的请求方式。

可以使用on('headersReceive')订阅请求响应头。

post请求的参数可以在extraData中指定。

执行createHttp成功后，返回一个httpRequest对象，里面包括request、destroy、on和off方法。

持久化存储

场景介绍

用户首选项为应用提供Key-Value键值型的数据处理能力，支持应用持久化轻量级数据，并对其修改和查询。当用户希望有一个全局唯一存储的地方，可以采用用户首选项来进行存储。Preferences会将该数据缓存在内存中，当用户读取的时候，能够快速从内存中获取数据，当需要持久化时可以使用flush接口将内存中的数据写入持久化文件中。Preferences会随着存放的数据量越多而导致应用占用的内存越大，因此，Preferences不适合存放过多的数据，也不支持通过配置加密，适用的场景一般为应用保存用户的个性化设置（字体大小，是否开启夜间模式）等。