HarmonyOS网络管理开发—HTTP与WebSocket 原创
HarmonyOS网络管理开发—HTTP与WebSocket
一、网络管理开发概述
网络管理模块主要提供以下功能:
● HTTP数据请求:通过HTTP发起一个数据请求。
● WebSocket连接:使用WebSocket建立服务器与客户端的双向连接。
● Socket连接:通过Socket进行数据传输。
约束与限制
使用网络管理模块的相关功能时,需要请求相应的权限。
权限名 | 说明 |
ohos.permission.GET_NETWORK_INFO | 获取网络连接信息。 |
ohos.permission.SET_NETWORK_INFO | 修改网络连接状态。 |
ohos.permission.INTERNET | 允许程序打开网络套接字,进行网络连接。 |
二、 HTTP数据请求
场景介绍
应用通过HTTP发起一个数据请求,支持常见的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT方法。
接口说明
HTTP数据请求功能主要由http模块提供。
使用该功能需要申请ohos.permission.INTERNET权限。
权限申请请参考访问控制(权限)开发指导。
涉及的接口如下表,具体的接口说明请参考API文档。
接口名 | 功能描述 |
createHttp() | 创建一个http请求。 |
request() | 根据URL地址,发起HTTP网络请求。 |
destroy() | 中断请求任务。 |
on(type: 'headersReceive') | 订阅HTTP Response Header 事件。 |
off(type: 'headersReceive') | 取消订阅HTTP Response Header 事件。 |
once('headersReceive')8+ | 订阅HTTP Response Header 事件,但是只触发一次。 |
request接口开发步骤
1. 从@ohos.net.http.d.ts中导入http命名空间。
2. 调用createHttp()方法,创建一个HttpRequest对象。
3. 调用该对象的on()方法,订阅http响应头事件,此接口会比request请求先返回。可以根据业务需要订阅此消息。
4. 调用该对象的request()方法,传入http请求的url地址和可选参数,发起网络请求。
5. 按照实际业务需要,解析返回结果。
6. 调用该对象的off()方法,取消订阅http响应头事件。
7. 当该请求使用完毕时,调用destroy()方法主动销毁。
三、 WebSocket连接
场景介绍
使用WebSocket建立服务器与客户端的双向连接,需要先通过createWebSocket()方法创建WebSocket对象,然后通过connect()方法连接到服务器。当连接成功后,客户端会收到open事件的回调,之后客户端就可以通过send()方法与服务器进行通信。当服务器发信息给客户端时,客户端会收到message事件的回调。当客户端不要此连接时,可以通过调用close()方法主动断开连接,之后客户端会收到close事件的回调。
若在上述任一过程中发生错误,客户端会收到error事件的回调。
接口说明
WebSocket连接功能主要由webSocket模块提供。使用该功能需要申请ohos.permission.INTERNET权限。具体接口说明如下表。
接口名 | 功能描述 |
createWebSocket() | 创建一个WebSocket连接。 |
connect() | 根据URL地址,建立一个WebSocket连接。 |
send() | 通过WebSocket连接发送数据。 |
close() | 关闭WebSocket连接。 |
on(type: 'open') | 订阅WebSocket的打开事件。 |
off(type: 'open') | 取消订阅WebSocket的打开事件。 |
on(type: 'message') | 订阅WebSocket的接收到服务器消息事件。 |
off(type: 'message') | 取消订阅WebSocket的接收到服务器消息事件。 |
on(type: 'close') | 订阅WebSocket的关闭事件。 |
off(type: 'close') | 取消订阅WebSocket的关闭事件 |
on(type: 'error') | 订阅WebSocket的Error事件。 |
off(type: 'error') | 取消订阅WebSocket的Error事件。 |
开发步骤
1. 导入需要的webSocket模块。
2. 创建一个WebSocket连接,返回一个WebSocket对象。
3. (可选)订阅WebSocket的打开、消息接收、关闭、Error事件。
4. 根据URL地址,发起WebSocket连接。
5. 使用完WebSocket连接之后,主动断开连接。
还不如来一个案例场景,