一、場(chǎng)景介紹

應(yīng)用通過(guò)HTTP發(fā)起一個(gè)數(shù)據(jù)請(qǐng)求，支持常見(jiàn)的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT方法。

二、 接口說(shuō)明

HTTP數(shù)據(jù)請(qǐng)求功能主要由http模塊提供。

使用該功能需要申請(qǐng)ohos.permission.INTERNET權(quán)限。

涉及的接口如下表，具體的接口說(shuō)明請(qǐng)參考API文檔。

熟悉[鴻蒙]文檔

三、request接口開(kāi)發(fā)步驟

1.從@ohos.net.http.d.ts中導(dǎo)入http命名空間。

2.調(diào)用createHttp()方法，創(chuàng)建一個(gè)HttpRequest對(duì)象。

3.調(diào)用該對(duì)象的on()方法，訂閱http響應(yīng)頭事件，此接口會(huì)比request請(qǐng)求先返回?？梢愿鶕?jù)業(yè)務(wù)需要訂閱此消息。

4.調(diào)用該對(duì)象的request()方法，傳入http請(qǐng)求的url地址和可選參數(shù)，發(fā)起網(wǎng)絡(luò)請(qǐng)求。

5.按照實(shí)際業(yè)務(wù)需要，解析返回結(jié)果。

6.調(diào)用該對(duì)象的off()方法，取消訂閱http響應(yīng)頭事件。

7.當(dāng)該請(qǐng)求使用完畢時(shí)，調(diào)用destroy()方法主動(dòng)銷毀。

// 引入包名
import http from '@ohos.net.http';

// 每一個(gè)httpRequest對(duì)應(yīng)一個(gè)HTTP請(qǐng)求任務(wù)，不可復(fù)用
let httpRequest = http.createHttp();
// 用于訂閱HTTP響應(yīng)頭，此接口會(huì)比request請(qǐng)求先返回。可以根據(jù)業(yè)務(wù)需要訂閱此消息
// 從API 8開(kāi)始，使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。 8+
httpRequest.on('headersReceive', (header) = > {
    console.info('header: ' + JSON.stringify(header));
});
httpRequest.request(
    // 填寫(xiě)HTTP請(qǐng)求的URL地址，可以帶參數(shù)也可以不帶參數(shù)。URL地址需要開(kāi)發(fā)者自定義。請(qǐng)求的參數(shù)可以在extraData中指定
    "EXAMPLE_URL",
    {
        method: http.RequestMethod.POST, // 可選，默認(rèn)為http.RequestMethod.GET
        // 開(kāi)發(fā)者根據(jù)自身業(yè)務(wù)需要添加header字段
        header: {
            'Content-Type': 'application/json'
        },
        // 當(dāng)使用POST請(qǐng)求時(shí)此字段用于傳遞內(nèi)容
        extraData: {
            "data": "data to send",
        },
        expectDataType: http.HttpDataType.STRING, // 可選，指定返回?cái)?shù)據(jù)的類型
        usingCache: true, // 可選，默認(rèn)為true
        priority: 1, // 可選，默認(rèn)為1
        connectTimeout: 60000, // 可選，默認(rèn)為60000ms
        readTimeout: 60000, // 可選，默認(rèn)為60000ms
        usingProtocol: http.HttpProtocol.HTTP1_1, // 可選，協(xié)議類型默認(rèn)值由系統(tǒng)自動(dòng)指定
    }, (err, data) = > {
        if (!err) {
            // data.result為HTTP響應(yīng)內(nèi)容，可根據(jù)業(yè)務(wù)需要進(jìn)行解析
            console.info('Result:' + JSON.stringify(data.result));
            console.info('code:' + JSON.stringify(data.responseCode));
            // data.header為HTTP響應(yīng)頭，可根據(jù)業(yè)務(wù)需要進(jìn)行解析
            console.info('header:' + JSON.stringify(data.header));
            console.info('cookies:' + JSON.stringify(data.cookies)); // 8+
        } else {
            console.info('error:' + JSON.stringify(err));
            // 取消訂閱HTTP響應(yīng)頭事件
            httpRequest.off('headersReceive');
            // 當(dāng)該請(qǐng)求使用完畢時(shí)，調(diào)用destroy方法主動(dòng)銷毀
            httpRequest.destroy();
        }
    }
);