鸿蒙开发网络管理：【 @ohos.net.http (数据请求)】

最新推荐文章于 2024-07-05 15:56:58 发布
最新推荐文章于 2024-07-05 15:56:58 发布
阅读量2k 收藏 30
点赞数 32
分类专栏： 鸿蒙开发学习笔录 文章标签： harmonyos http 网络 OpenHarmony 程序员 鸿蒙开发 网络协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/139773174
版权

数据请求

 说明：

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import http from '@ohos.net.http';

完整示例

import http from '@ohos.net.http';

// 每一个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": "data to send",
        },
        connectTimeout: 60000, // 可选，默认为60s
        readTimeout: 60000, // 可选，默认为60s
    }, (err, data) => {
        if (!err) {
            // data.result为http响应内容，可根据业务需要进行解析
            console.info('Result:' + data.result);
            console.info('code:' + data.responseCode);
            // data.header为http响应头，可根据业务需要进行解析
            console.info('header:' + JSON.stringify(data.header));
            console.info('cookies:' + data.cookies); // 8+
        } else {
            console.info('error:' + JSON.stringify(err));
            // 当该请求使用完毕时，调用destroy方法主动销毁。
            httpRequest.destroy();
        }
    }
);

http.createHttp

createHttp(): HttpRequest

创建一个http，里面包括发起请求、中断请求、订阅/取消订阅HTTP Response Header 事件。每一个HttpRequest对象对应一个Http请求。如需发起多个Http请求，须为每个Http请求创建对应HttpRequest对象。

系统能力：SystemCapability.Communication.NetStack

返回值：

类型说明
HttpRequest返回一个HttpRequest对象，里面包括request、destroy、on和off方法。

示例：

import http from '@ohos.net.http';
let httpRequest = http.createHttp();

HttpRequest

http请求任务。在调用HttpRequest的方法前，需要先通过[createHttp()]创建一个任务。

request

request(url: string, callback: AsyncCallback):void

根据URL地址，发起HTTP网络请求，使用callback方式作为异步方法。

需要权限：ohos.permission.INTERNET

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
urlstring是发起网络请求的URL地址。
callbackAsyncCallback<[HttpResponse]>是回调函数。

示例：

httpRequest.request("EXAMPLE_URL", (err, data) => {
    if (!err) {
        console.info('Result:' + data.result);
        console.info('code:' + data.responseCode);
        console.info('header:' + JSON.stringify(data.header));
        console.info('cookies:' + data.cookies); // 8+
    } else {
        console.info('error:' + JSON.stringify(err));
    }
});

request

request(url: string, options: HttpRequestOptions, callback: AsyncCallback):void

根据URL地址和相关配置项，发起HTTP网络请求，使用callback方式作为异步方法。

需要权限：ohos.permission.INTERNET

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
urlstring是发起网络请求的URL地址。
optionsHttpRequestOptions是参考[HttpRequestOptions]。
callbackAsyncCallback<[HttpResponse]>是回调函数。

示例：

httpRequest.request("EXAMPLE_URL",
{
    method: http.RequestMethod.GET,
    header: {
        'Content-Type': 'application/json'
    },
    readTimeout: 60000,
    connectTimeout: 60000
}, (err, data) => {
    if (!err) {
        console.info('Result:' + data.result);
        console.info('code:' + data.responseCode);
        console.info('header:' + JSON.stringify(data.header));
        console.info('cookies:' + data.cookies); // 8+
        console.info('header.Content-Type:' + data.header['Content-Type']);
        console.info('header.Status-Line:' + data.header['Status-Line']);
    } else {
        console.info('error:' + JSON.stringify(err));
    }
});

request

request(url: string, options? : HttpRequestOptions): Promise

根据URL地址，发起HTTP网络请求，使用Promise方式作为异步方法。

需要权限：ohos.permission.INTERNET

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
urlstring是发起网络请求的URL地址。
optionsHttpRequestOptions是参考[HttpRequestOptions]。

返回值：

类型说明
Promise<[HttpResponse]>以Promise形式返回发起请求的结果。

示例：

let promise = httpRequest.request("EXAMPLE_URL", {
    method: http.RequestMethod.GET,
    connectTimeout: 60000,
    readTimeout: 60000,
    header: {
        'Content-Type': 'application/json'
    }
});
promise.then((data) => {
    console.info('Result:' + data.result);
    console.info('code:' + data.responseCode);
    console.info('header:' + JSON.stringify(data.header));
    console.info('cookies:' + data.cookies); // 8+
    console.info('header.Content-Type:' + data.header['Content-Type']);
    console.info('header.Status-Line:' + data.header['Status-Line']);
}).catch((err) => {
    console.info('error:' + JSON.stringify(err));
});

destroy

destroy(): void

中断请求任务。

系统能力：SystemCapability.Communication.NetStack

示例：

httpRequest.destroy();

on(‘headerReceive’)

on(type: ‘headerReceive’, callback: AsyncCallback): void

订阅HTTP Response Header 事件。

 说明：  此接口已废弃，建议使用[on(‘headersReceive’)8+]替代。

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
typestring是订阅的事件类型，‘headerReceive’。
callbackAsyncCallback是回调函数。

示例：

httpRequest.on('headerReceive', (err, data) => {
    if (!err) {
        console.info('header: ' + JSON.stringify(data));
    } else {
        console.info('error:' + JSON.stringify(err));
    }
});

off(‘headerReceive’)

off(type: ‘headerReceive’, callback?: AsyncCallback): void

取消订阅HTTP Response Header 事件。

 说明：

  1. 此接口已废弃，建议使用[off(‘headersReceive’)8+]替代。
  2. 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
typestring是取消订阅的事件类型，‘headerReceive’。
callbackAsyncCallback否回调函数。

示例：

httpRequest.off('headerReceive');

on(‘headersReceive’)8+

on(type: ‘headersReceive’, callback: Callback): void

订阅HTTP Response Header 事件。

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
typestring是订阅的事件类型：‘headersReceive’。
callbackCallback是回调函数。

示例：

httpRequest.on('headersReceive', (header) => {
    console.info('header: ' + JSON.stringify(header));
});

off(‘headersReceive’)8+

off(type: ‘headersReceive’, callback?: Callback): void

取消订阅HTTP Response Header 事件。

 说明：  可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
typestring是取消订阅的事件类型：‘headersReceive’。
callbackCallback否回调函数。

示例：

httpRequest.off('headersReceive');

once(‘headersReceive’)8+

once(type: ‘headersReceive’, callback: Callback): void

订阅HTTP Response Header 事件，但是只触发一次。一旦触发之后，订阅器就会被移除。使用callback方式作为异步方法。

系统能力：SystemCapability.Communication.NetStack

参数：

参数名类型必填说明
typestring是订阅的事件类型：‘headersReceive’。
callbackCallback是回调函数。

示例：

httpRequest.once('headersReceive', (header) => {
    console.info('header: ' + JSON.stringify(header));
});

HttpRequestOptions

发起请求可选参数的类型和取值范围。

系统能力：以下各项对应的系统能力均为SystemCapability.Communication.NetStack。

参数名类型必填说明
method[RequestMethod]否请求方式。
extraDatastringObjectArrayBuffer8+
headerObject否HTTP请求头字段。默认{‘Content-Type’: ‘application/json’}。
readTimeoutnumber否读取超时时间。单位为毫秒（ms），默认为60000ms。
connectTimeoutnumber否连接超时时间。单位为毫秒（ms），默认为60000ms。

RequestMethod

HTTP 请求方法。

系统能力：以下各项对应的系统能力均为SystemCapability.Communication.NetStack。

名称值说明
OPTIONSOPTIONSHTTP 请求 OPTIONS。
GETGETHTTP 请求 GET。
HEADHEADHTTP 请求 HEAD。
POSTPOSTHTTP 请求 POST。
PUTPUTHTTP 请求 PUT。
DELETEDELETEHTTP 请求 DELETE。
TRACETRACEHTTP 请求 TRACE。
CONNECTCONNECTHTTP 请求 CONNECT。

ResponseCode

发起请求返回的响应码。

系统能力：以下各项对应的系统能力均为SystemCapability.Communication.NetStack。

名称值说明
OK200请求成功。一般用于GET与POST请求。
CREATED201已创建。成功请求并创建了新的资源。
ACCEPTED202已接受。已经接受请求，但未处理完成。
NOT_AUTHORITATIVE203非授权信息。请求成功。
NO_CONTENT204无内容。服务器成功处理，但未返回内容。
RESET205重置内容。
PARTIAL206部分内容。服务器成功处理了部分GET请求。
MULT_CHOICE300多种选择。
MOVED_PERM301永久移动。请求的资源已被永久的移动到新URI，返回信息会包括新的URI，浏览器会自动定向到新URI。
MOVED_TEMP302临时移动。
SEE_OTHER303查看其它地址。
NOT_MODIFIED304未修改。
USE_PROXY305使用代理。
BAD_REQUEST400客户端请求的语法错误，服务器无法理解。
UNAUTHORIZED401请求要求用户的身份认证。
PAYMENT_REQUIRED402保留，将来使用。
FORBIDDEN403服务器理解请求客户端的请求，但是拒绝执行此请求。
NOT_FOUND404服务器无法根据客户端的请求找到资源（网页）。
BAD_METHOD405客户端请求中的方法被禁止。
NOT_ACCEPTABLE406服务器无法根据客户端请求的内容特性完成请求。
PROXY_AUTH407请求要求代理的身份认证。
CLIENT_TIMEOUT408请求时间过长，超时。
CONFLICT409服务器完成客户端的PUT请求是可能返回此代码，服务器处理请求时发生了冲突。
GONE410客户端请求的资源已经不存在。
LENGTH_REQUIRED411服务器无法处理客户端发送的不带Content-Length的请求信息。
PRECON_FAILED412客户端请求信息的先决条件错误。
ENTITY_TOO_LARGE413由于请求的实体过大，服务器无法处理，因此拒绝请求。
REQ_TOO_LONG414请求的URI过长（URI通常为网址），服务器无法处理。
UNSUPPORTED_TYPE415服务器无法处理请求的格式。
INTERNAL_ERROR500服务器内部错误，无法完成请求。
NOT_IMPLEMENTED501服务器不支持请求的功能，无法完成请求。
BAD_GATEWAY502充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。
UNAVAILABLE503由于超载或系统维护，服务器暂时的无法处理客户端的请求。
GATEWAY_TIMEOUT504充当网关或代理的服务器，未及时从远端服务器获取请求。
VERSION505服务器请求的HTTP协议的版本。

HttpResponse

request方法回调函数的返回值类型。

系统能力：以下各项对应的系统能力均为SystemCapability.Communication.NetStack。

参数名类型必填说明
resultstringObjectArrayBuffer8+
responseCode[ResponseCode]number是
headerObject是发起http请求返回来的响应头。当前返回的是JSON格式字符串，如需具体字段内容，需开发者自行解析。常见字段及解析方式如下： - Content-Type：header[‘Content-Type’]； - Status-Line：header[‘Status-Line’]； - Date：header.Date/header[‘Date’]； - Server：header.Server/header[‘Server’]；
cookies8+Array是服务器返回的 cookies。
爱桥代码的程序媛
关注
  • 32
    点赞
  • 踩
  • 30
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS鸿蒙开发指南:基于ArkTS开发 网络管理
sybh的博客
01-10 935
应用通过HTTP发起一个数据请求，支持常见的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT方法。使用WebSocket建立服务器与客户端的双向连接，需要先通过createWebSocket方法创建WebSocket对象，然后通过connect方法连接到服务器。当连接成功后，客户端会收到open事件的回调，之后客户端就可以通过send方法与服务器进行通信。当服务器发信息给客户端时，客户端会收到message事件的回调。
基于 HarmonyOS 的 HTTPS 请求过程开发示例（ArkTS）
HarmonyOSDev的博客
11-09 1734
介绍 本篇 Codelab 基于网络模块以及 Webview 实现一次 HTTPS 请求，并对其过程进行抓包分析。效果如图所示： 相关概念 ●Webview：提供 Web 控制能力，Web 组件提供网页显示能力。 ●HTTP数据请求：网络管理模块，提供 HTTP 数据请求能力，支持 GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT 请求方法。 ●HTTPS：应用层协议，支持加密传输以及身份认证，保证数据的安全传输。 ●SSL：SSL（Secur
鸿蒙开发网络管理：【@ohos.request (上传下载)】
2301_76813281的博客
06-18 887
本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
鸿蒙应用开发之数据请求
刘小猿的博客
03-15 1687
以鸿蒙js开发环境为例，项目为背景，实现鸿蒙应用开发数据请求
鸿蒙next开发学习：网络状态监测应用规范
最新发布
maniu110的博客
07-05 707
比如网卡名称、IP地址、上传下载能力等等，鸿蒙提供了网络状态变化的监测api，可以随时根据需要捕获状态的改变。
http模块封装
2301_82231652的博客
05-29 979
http
鸿蒙NEXT开发实战：【网络管理-数据请求】
m0_62167422的博客
03-06 1308
本示例通过[@ohos.net.http]等接口，实现了根据URL地址和相关配置项发起http请求的功能。
【鸿蒙 HarmonyOS】网络请求
weixin_71403100的博客
02-21 5316
场景：应用通过HTTP发起一个数据请求，支持常见的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT方法。日常开发中HTTP请求使用会比较多，主要对HTTP请求进行总结记录。
HormonyOS第一课第七章习题答案
m0_55660474的博客
06-27 2726
使用http发起网络请求，需要以下哪种权限？B. method字段为GET时，extraData字段为HTTP请求可选参数的补充，参数内容会拼接到URL中进行发送。D. ResponseCode.GONE的值为404，表示客户端请求的资源已经不存在。C. GET请求可以向服务器获取资源，但GET请求不能够携带任何参数。B. 可以使用on('headersReceive')订阅请求响应头。A. http请求支持get、post、put等常用的请求方式。C. post请求的参数可以在extraData中指定。
HarmonyOS网络管理开发—HTTP与WebSocket
HarmonyOSDev的博客
10-07 712
使用WebSocket建立服务器与客户端的双向连接，需要先通过createWebSocket()方法创建WebSocket对象，然后通过connect()方法连接到服务器。当连接成功后，客户端会收到open事件的回调，之后客户端就可以通过send()方法与服务器进行通信。当客户端不要此连接时，可以通过调用close()方法主动断开连接，之后客户端会收到close事件的回调。调用该对象的on()方法，订阅http响应头事件，此接口会比request请求先返回。根据URL地址，建立一个WebSocket连接。
在鸿蒙（HarmonyOS）环境下，优雅的完成Http访问网路.zip
02-07
在鸿蒙（HarmonyOS）环境下，优雅地完成Http网络访问是每个开发者必须掌握的关键技能。鸿蒙系统作为华为推出的自主操作系统，旨在提供跨平台、全场景的无缝体验，其开发环境与传统的Android有所不同，因此在进行网络...
鸿蒙开发实战系列之三：网络请求(原生+ Retrofit)
dsbdsbdsb的博客
01-14 5604
鸿蒙开发实战系列之一：鸿蒙开发实战系列之一：圆角 鸿蒙开发实战系列之二：鸿蒙开发实战系列之二：事件总线EventBus/RxBus 前言 过了一个漫长的中秋+国庆假期，大家伙的鸿蒙内功修炼的怎么样了？难道像小蒙一样，都在吃吃喝喝中度过么，哎，罪过罪过，对不起那些鸡鸭鱼肉啊，赶紧回来写篇文章收收心，让我们一起看看，在鸿蒙中如何发送网络请求吧。 本文会从Java原生访问入手，进而再使用Retrofit访问网络，可以满足绝大部分开发者对于鸿蒙网络访问方面的代码需求，开始之前需要先做一下基础配置。 鸿蒙系统网络访问
关于express模块下request.on方法的详细说明
engineer_why的博客
05-07 693
简单来说，通过post方式，得到是消息体数据，从而操作消息体数据，而get方式，获取的是路由中的参数数据，可操作的则是路由中的参数。
鸿蒙OS开发实战：【网络管理HTTP数据请求】
2301_76813281的博客
03-31 1524
应用通过HTTP发起一个数据请求，支持常见的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT方法。
【HarmonyOS】HarmonyOS应用开发者高级认证题库
tttzzzqqq2018的博客
12-28 1万+
【题库】【HarmonyOS】HarmonyOS应用开发者高级认证题库
鸿蒙NAPI 异步回调使用callback方式示例
weixin_48091641的博客
04-16 995
cpp代码index.d.tsindex.ets。
鸿蒙应用开发-轻松获取http网络请求
weixin_48952056的博客
05-03 1461
我们以一个登陆请求为例分别展示封装前的代码和封装后的代码使用的API主要是createHttp()和request(),在创建请求前我们先开启网络权限打开目录entry/src/main/module.json5中的module.json5。
【愚公系列】2023年12月 HarmonyOS应用开发者高级认证（完美答案）
热门推荐
时光隧道
12-12 10万+
HarmonyOS应用开发者基础认证是华为面向广大开发者推出的一项认证计划，旨在帮助开发者提升应用开发能力，进一步推动HarmonyOS应用生态建设。该认证计划可以帮助开发者系统性地学习和掌握HarmonyOS应用开发的基础知识和技能，包括开发环境配置、应用开发、发布等方面。通过考核认证后，开发者可以获得华为官方颁发的认证证书，证明其在HarmonyOS应用开发方面的专业能力和水平，提升自身在招聘和职场等方面的竞争力。
鸿蒙 HarmonyOS4.0 Http数据请求封装详解
qq_68512683的博客
12-01 4265
鸿蒙 HarmonyOS4.0 Http数据请求封装详解
npm ERR! 400 Bad Request - GET https://repo.harmonyos.com/npm/@ohos%2fhpm-cli
03-24
我不确定这个问题的上下文，请问您能否提供更多的信息？是在使用 npm 安装 @ohos/hpm-cli 时遇到了错误码为 400 的 Bad Request 错误吗？可能是您的请求不符合服务器的要求，请检查您的网络连接和相关配置，或者尝试使用其他方式安装。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值