Http 超文本传输协议,是一个简单的请求-响应协议。它指定了客户端可能发送给服务器什么样的消息以及得到什么样的响应
import http from '@ohos.net.http'
let httpRequest = http.createHttp()
createHttp成功后,返回一个httpRequest对象,里面包括request、destroy、on和off方法
每一个HttpRequest对象对应一个http请求
用于订阅http响应头,此接口会比request请求先返回,可以根据业务需要订阅此消息
httpRequest.on('headerReceive', (header) => {
})
http模块支持常用的POST和GET等方法,封装在RequestMethod中。调用request方法发起网络请求,需要传入两个参数。第一个是请求的url地址,第二个是可选参数,类型为HttpRequestOptions
HttpRequestOptions
- method:请求方式
- extraData:发送请求的额外数据
- connectTimeout:连接超时时间
- readTimeout:读取超时时间
- header:Http请求头字段
HTTP支持的请求方式:
- GET:请求指定的页面信息,并返回响应主体
- POST:请求会向指定资源提交数据,请求服务器进行处理
- PUT:请求会向指定资源位置上传其最新内容
- CONNECT:HTTP/1.1协议预留的,能够将连接改为管道方式的代理服务器
- HEAD:类似于GET请求,返回响应头信息,但是不会返回响应主体
- DELETE:请求用于请求服务器删除所请求UR
- TRACE:请求服务器回显其收到的请求信息
- OPTIONS:请求用于客户端查看服务器的性能
使用Get请求,参数内容需要拼接到URL中进行发送
let url= "https://EXAMPLE_URL?param1=v1¶m2=v2";
let promise = httpRequest.request(url,{
// 请求方式
method: http.RequestMethod.GET,
// 可选,默认为60s
connectTimeout: 60000,
// 可选,默认为60s
readTimeout: 60000,
// 开发者根据自身业务需要添加header字段
header: {
'Content-Type': 'application/json'
}
})
POST请求参数需要添加到extraData里面
let url = "https://EXAMPLE_URL";
let promise = httpRequest.request(
// 请求url地址
url,
{
// 请求方式
method: http.RequestMethod.POST,
// 请求的额外数据。
extraData: {
"param1": "value1",
"param2": "value2",
},
// 可选,默认为60s
connectTimeout: 60000,
// 可选,默认为60s
readTimeout: 60000,
// 开发者根据自身业务需要添加header字段
header: {
'Content-Type': 'application/json'
}
});
data为网络请求返回的结果,err为请求异常时返回的结果。data的类型为HttpResponse
promise.then((data) => {
if (data.responseCode === http.ResponseCode.OK) {
console.info('Result:' + data.result);
console.info('code:' + data.responseCode);
}
}).catch((err) => {
console.info('error:' + JSON.stringify(err));
});
其中data.responseCode为http请求返回的状态码,如果状态码为http.ResponseCode.OK(即200),则表示请求成功
data.result为服务器返回的业务数据,可以根据自身业务场景解析此数据