未验证 提交 54bbb5bb 编写于 作者: O openharmony_ci 提交者: Gitee

!8981 【OpenHarmony开源贡献者计划2022】网络管理子系统.md 相关格式及表达问题

Merge pull request !8981 from king_he/0901-b
# 网络管理子系统<a name="ZH-CN_TOPIC_0000001162422291"></a>
- [简介](#section104mcpsimp)
- [目录](#section119mcpsimp)
- [使用说明](#section128mcpsimp)
- [接收指定网络的状态变化通知](#section1458213210369)
- [发起网络请求](#section750135512369)
- [相关仓](#section152mcpsimp)
## 简介<a name="section104mcpsimp"></a>
网络管理子系统,作为设备联网的必备组件,提供了对不同类型网络连接的统一管理,并提供了网络协议栈能力。应用可以通过调用API来获取数据网络的连接信息,查询和订阅数据网络的连接状态等,并可通过网络协议栈进行数据传输。
各个部件主要作用如下:
下图所示为网络管理子系统架构图。各个部件主要作用如下:
- 基础网络连接管理部件:主要功能是提供基础网络连接管理和对应的JS/Native API,包括不同网络连接优先级管理、网络连接信息查询、网络连接状态变化、DNS解析以及物理网络管理等。
- 网络协议栈部件:主要功能是提供基础的网络协议栈和对应的JS API,包括HTTP、HTTPS、TCP、UDP等基础网络协议栈能力。
......@@ -37,13 +30,13 @@ foundation/communication/
2. 调用createNetConnection方法,指定网络能力、网络类型和超时时间(可选,如不传入代表默认网络),创建一个NetConnection对象。
3. 调用该对象的on方法,传入type和callback,订阅关心的事件。
3. 调用该对象的on()方法,传入type和callback,订阅关心的事件。
4. 调用该对象的register方法,订阅指定网络状态变化的通知。
4. 调用该对象的register()方法,订阅指定网络状态变化的通知。
5. 当网络可用时,会收到netAvailable事件的回调。
6. 当不使用该网络时,可以调用该对象的unregister方法,取消订阅。
6. 当不使用该网络时,可以调用该对象的unregister()方法,取消订阅。
```
// 引入包名
......@@ -68,7 +61,7 @@ foundation/communication/
}));
// 订阅指定网络状态变化的通知
conn.register((err, data) => {});
// 当不使用该网络时,可以调用该对象的unregister方法,取消订阅
// 当不使用该网络时,可以调用该对象的unregister()方法,取消订阅
conn.unregister((err, data) => {});
```
......@@ -76,11 +69,11 @@ foundation/communication/
### 发起网络请求<a name="section750135512369"></a>
1. 从@ohos.net.http.d.ts中导入http命名空间。
2. 调用createHttp方法,创建一个HttpRequest对象。
3. 调用该对象的on方法,订阅http响应头,此接口会比request请求先返回。可以根据业务需要订阅此消息。
4. 调用该对象的request方法,传入http请求的url地址和可选参数,发起网络请求。
5. 开发者按照实际业务需要,解析返回结果。
6. 当该请求使用完毕时,调用destroy方法主动销毁。
2. 调用createHttp()方法,创建一个HttpRequest对象。
3. 调用该对象的on()方法,订阅http响应头,此接口会比request请求先返回。可以根据业务需要订阅此消息。
4. 调用该对象的request()方法,传入http请求的url地址和可选参数,发起网络请求。
5. 按照实际业务需要,解析返回结果。
6. 当该请求使用完毕时,调用destroy()方法主动销毁。
```
// 引入包名
......@@ -105,8 +98,8 @@ httpRequest.request(
extraData: {
"data": "data to send",
},
connectTimeout: 60000, // 可选,默认为60s
readTimeout: 60000, // 可选,默认为60s
connectTimeout: 60000, // 可选,默认为60000,即60s
readTimeout: 60000, // 可选,默认为60000,即60s
},(err, data) => {
if (!err) {
// data.result为http响应内容,可根据业务需要进行解析
......@@ -118,7 +111,7 @@ httpRequest.request(
} else {
console.info('error:' + err);
}
// 当该请求使用完毕时,调用destroy方法主动销毁。
// 当该请求使用完毕时,调用destroy()方法主动销毁。
httpRequest.destroy();
}
);
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册