OpenHarmony应用开发入门——OpenHarmony的网络能力

lywenjoy
发布于 2023-8-6 20:36
浏览
1收藏

OpenHarmony的网络模块主要提供了以下功能:

(1)HTTP数据请求

(2)WebSocket连接

(3)Socket连接

==标记==关于HTTP数据请求
应用通过HTTP发起一个数据请求,支持常见的GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT方法
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
HTTP数据请求功能主要由http模块提供。
使用该功能需要申请ohos.permission.INTERNET权限。
具体接口说明如下
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
开发步骤:
1.import需要的http模块。
2.创建一个HTTP请求,返回一个HttpRequest对象。
3.(可选)订阅HTTP响应头。
4.根据URL地址,发起HTTP网络请求。
5.(可选)处理HTTP响应头和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();
}
}
);
==标记==关于WebSocket连接
使用WebSocket建立服务器与客户端的双向连接
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
WebSocket连接功能主要由webSocket模块提供。使用该功能需要申请ohos.permission.INTERNET权限。具体接口说明如下
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
开发步骤
1.import需要的webSocket模块。
2.创建一个WebSocket连接,返回一个WebSocket对象。
3.(可选)订阅WebSocket的打开、消息、关闭、Error事件。
4.根据URL地址,发起WebSocket连接。
5.使用完WebSocket连接之后,主动断开连接。
import webSocket from ‘@ohos.net.webSocket’;

var defaultIpAddress = “ws://”;
let ws = webSocket.createWebSocket();
ws.on(‘open’, (err, value) => {
console.log(“on open, status:” + JSON.stringify(value));
// 当收到on(‘open’)事件时,可以通过send()方法与服务器进行通信
ws.send(“Hello, server!”, (err, value) => {
if (!err) {
console.log(“send success”);
} else {
console.log(“send fail, err:” + JSON.stringify(err));
}
});
});
ws.on(‘message’, (err, value) => {
console.log(“on message, message:” + value);
// 当收到服务器的“bye”消息时(此消息字段仅为示意,具体字段需要与服务器协商),主动断开连接
if (value === ‘bye’) {
ws.close((err, value) => {
if (!err) {
console.log(“close success”);
} else {
console.log("close fail, err is " + JSON.stringify(err));
}
});
}
});
ws.on(‘close’, (err, value) => {
console.log("on close, code is " + value.code + ", reason is " + value.reason);
});
ws.on(‘error’, (err) => {
console.log(“on error, error:” + JSON.stringify(err));
});
ws.connect(defaultIpAddress, (err, value) => {
if (!err) {
console.log(“connect success”);
} else {
console.log(“connect fail, err:” + JSON.stringify(err));
}
});
==标记==关于Socket连接
应用通过Socket进行数据传输,支持TCP和UDP两种协议
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
Socket连接主要由socket模块提供。具体接口说明如下
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区
开发步骤
UDP与TCP流程大体类似,下面以TCP为例:
1.import需要的socket模块。
2.创建一个TCPSocket连接,返回一个TCPSocket对象。
3.(可选)订阅TCPSocket相关的订阅事件。
4.绑定IP地址和端口,端口可以指定或由系统随机分配。
5.连接到指定的IP地址和端口。
6.发送数据。
7.Socket连接使用完毕后,主动关闭。
import socket from ‘@ohos.net.socket’

// 创建一个TCPSocket连接,返回一个TCPSocket对象。
let tcp = socket.constructTCPSocketInstance();

// 订阅TCPSocket相关的订阅事件
tcp.on(‘message’, value => {
console.log(“on message”)
let buffer = value.message
let dataView = new DataView(buffer)
let str = “”
for (let i = 0;i < dataView.byteLength; ++i) {
str += String.fromCharCode(dataView.getUint8(i))
}
console.log(“on connect received:” + str)
});
tcp.on(‘connect’, () => {
console.log(“on connect”)
});
tcp.on(‘close’, () => {
console.log(“on close”)
});

// 绑定IP地址和端口。
let bindAddress = {
address: ‘192.168.xx.xx’,
port: 1234, // 绑定端口,如1234
family: 1
};
tcp.bind(bindAddress, err => {
if (err) {
console.log(‘bind fail’);
return;
}
console.log(‘bind success’);
// 连接到指定的IP地址和端口。
let connectAddress = {
address: ‘192.168.xx.xx’,
port: 5678, // 连接端口,如5678
family: 1
};
tcp.connect({
address: connectAddress, timeout: 6000
}, err => {
if (err) {
console.log(‘connect fail’);
return;
}
console.log(‘connect success’);
// 发送数据
tcp.send({
data: ‘Hello, server!’
}, err => {
if (err) {
console.log(‘send fail’);
return;
}
console.log(‘send success’);
})
});
});
// 连接使用完毕后,主动关闭。取消相关事件的订阅。
setTimeout(() => {
tcp.close((err) => {
console.log(‘close socket.’)
});
tcp.off(‘message’);
tcp.off(‘connect’);
tcp.off(‘close’);
}, 30 * 1000);
==标记==相关例子:
1文件传输程序:使用socket编程实现文件的上传下载功能,客户端可以向服务器端发送文件,也可以从服务器端获取文件
2游戏服务器:使用socket编程实现游戏服务器,实现游戏玩家之间的通信
3聊天室:使用socket编程实现聊天室,实现多个玩家之间的聊天功能
4FTP服务器:使用socket编程实现一个FTP服务器,实现文件的上传下载功能
5Web服务器:使用socket编程实现一个Web服务器,实现HTTP协议的传输
6数据库服务器:使用socket编程实现一个数据库服务器,实现数据库中数据的存取
7邮件服务器:使用socket编程实现一个邮件服务器,实现邮件的收发功能
8网络扫描器:使用socket编程,实现一个网络扫描器,实现网络端口的扫描
9Telnet客户端:使用socket编程实现一个Telnet客户端,实现网络远程登录
10代理服务器:使用socket编程,实现一个代理服务器,实现对网络的中转访问

申请权限

使用网络管理模块的相关功能时,需要请求相应的权限
使用Stage模型的应用,需要在module.json5配置文件中声明权限
代码如下:
OpenHarmony应用开发入门——OpenHarmony的网络能力-鸿蒙开发者社区

收藏 1
回复
举报
回复
    相关推荐