提交 025e7689 编写于 作者: O openharmony_ci 提交者: Yangys

!15866 monthly1018:断链修改

Merge pull request !15866 from 葛亚芳/cherry-pick-1678440024
# 网络共享
## 简介
网络共享管理分享设备已有网络给其他连接设备,支持Wi-Fi热点共享、蓝牙共享和USB共享,同时提供网络共享状态、共享流量查询功能。
> **说明:**
> 为了保证应用的运行效率,大部分API调用都是异步的,对于异步调用的API均提供了callback和Promise两种方式,以下示例均采用callback函数,更多方式可以查阅[API参考](../reference/apis/js-apis-net-sharing.md)。
## 基本概念
- WIFI共享:通过WIFI热点共享网络。
- 蓝牙共享:通过蓝牙共享网络。
- USB共享:通过USB共享网络。
## 约束
- 开发语言:C++ JS
- 系统:linux内核
- 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 场景介绍
网络共享的典型场景有:
- 开启网络共享
- 停止网络共享
- 获取共享网络的数据流量
以下分别介绍具体开发方式。
## 接口说明
完整的JS API说明以及实例代码请参考:[网络共享](../reference/apis/js-apis-net-sharing.md)
| 类型 | 接口 | 功能说明 |
| ---- | ---- | ---- |
| ohos.net.sharing | function isSharingSupported(callback: AsyncCallback\<boolean>): void; | 获取当前系统是否支持网络共享,使用callback方式作为异步方法 |
| ohos.net.sharing | function isSharing(callback: AsyncCallback\<boolean>): void; | 获取当前共享状态,使用callback方式作为异步方法 |
| ohos.net.sharing | function startSharing(type: SharingIfaceType, callback: AsyncCallback\<void>): void; | 开启共享,type为共享类型,目前支持Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function stopSharing(type: SharingIfaceType, callback: AsyncCallback\<void>): void; | 停止指定类型共享,type为共享类型,包括Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getStatsRxBytes(callback: AsyncCallback\<number>): void; | 获取共享接收数据量,单位KB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getStatsTxBytes(callback: AsyncCallback\<number>): void; | 获取共享发送数据量,单位KB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getStatsTotalBytes(callback: AsyncCallback\<number>): void; | 获取共享总数据流量,单位KB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getSharingIfaces(state: SharingIfaceState, callback: AsyncCallback\<Array\<string>>): void; | 获取指定状态的网卡名称,state为状态,包括正在共享、可共享、共享错误,使用callback方式作为异步方法 |
| ohos.net.sharing | function getSharingState(type: SharingIfaceType, callback: AsyncCallback\<SharingIfaceState>): void; | 获取指定类型共享状态,type为类型,目前支持Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getSharableRegexes(type: SharingIfaceType, callback: AsyncCallback\<Array\<string>>): void; | 获取与指定类型匹配的网卡正则表达式列表,type为类型,目前支持Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function on(type: 'sharingStateChange', callback: Callback\<boolean>): void; | 注册共享状态改变监听,返回网络共享的状态。 |
| ohos.net.sharing | function off(type: 'sharingStateChange', callback?: Callback\<boolean>): void; | 注销共享状态改变监听,返回网络共享的状态。 |
| ohos.net.sharing | unction on(type: 'interfaceSharingStateChange', callback: Callback\<{ type: SharingIfaceType, iface: string, state: SharingIfaceState }>): void; | 注册指定网卡共享状态改变监听 |
| ohos.net.sharing | function off(type: 'interfaceSharingStateChange', callback?: Callback\<{ type: SharingIfaceType, iface: string, state: SharingIfaceState }>): void; | 注销指定网卡共享状态改变监听 |
| ohos.net.sharing | function on(type: 'sharingUpstreamChange', callback: Callback\<NetHandle>): void; | 注册上行网卡改变监听 |
| ohos.net.sharing | function off(type: 'sharingUpstreamChange', callback?: Callback\<NetHandle>): void; | 注销上行网卡改变监听 |
## 开启网络共享
1. 从@ohos.net.sharing中导入sharing命名空间。
2. 注册监听共享状态的改变。
3. 调用startSharing方法,来开启指定类型共享。
4. 接收到共享状态开启的回调,开启共享成功。
```js
// 从@ohos.net.sharing中导入sharing命名空间
import sharing from '@ohos.net.sharing'
// 注册监听共享状态的改变
sharing.on('sharingStateChange', (error, data) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
// 调用startSharing方法,来开启指定类型共享
sharing.startSharing(sharing.SharingIfaceType.SHARING_WIFI, (error) => {
console.log(JSON.stringify(error));
});
```
## 停止网络共享
### 开发步骤
1. 从@ohos.net.sharing中导入sharing命名空间。
2. 注册监听共享状态的改变。
3. 调用stopSharing方法,来停止指定类型共享。
4. 接收到共享状态关闭的回调,停止共享成功。
```js
// 从@ohos.net.sharing中导入sharing命名空间
import sharing from '@ohos.net.sharing'
// 注册监听共享状态的改变
sharing.on('sharingStateChange', (error, data) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
// 调用stopSharing方法,来停止指定类型共享
sharing.stopSharing(sharing.SharingIfaceType.SHARING_WIFI, (error) => {
console.log(JSON.stringify(error));
});
```
## 获取共享网络的数据流量
### 开发步骤
1. 从@ohos.net.sharing中导入sharing命名空间。
2. 调用startSharing方法,来开启指定类型共享。
3. 调用getStatsTotalBytes方法,来获取共享网络数据量。
4. 调用stopSharing方法,来停止指定类型共享,共享网络数据量清零。
```js
// 从@ohos.net.sharing中导入sharing命名空间
import sharing from '@ohos.net.sharing'
// 调用startSharing方法,来开启指定类型共享
sharing.startSharing(sharing.SharingIfaceType.SHARING_WIFI, (error) => {
console.log(JSON.stringify(error));
});
// 调用getStatsTotalBytes方法,来获取共享网络数据量
sharing.getStatsTotalBytes((error, data) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
// 调用stopSharing方法,来停止指定类型共享,共享网络数据量清零
sharing.stopSharing(sharing.SharingIfaceType.SHARING_WIFI, (error) => {
console.log(JSON.stringify(error));
});
// 再次调用getStatsTotalBytes方法,共享网络数据量已清零
sharing.getStatsTotalBytes((error, data) => {
console.log(JSON.stringify(error));
console.log(JSON.stringify(data));
});
```
......@@ -190,7 +190,7 @@ UDP与TCP流程大体类似,下面以TCP为例:
let tlsTwoWay = socket.constructTLSSocketInstance();
// 订阅TLS Socket相关的订阅事件
tcp.on('message', value => {
tlsTwoWay.on('message', value => {
console.log("on message")
let buffer = value.message
let dataView = new DataView(buffer)
......@@ -200,10 +200,10 @@ UDP与TCP流程大体类似,下面以TCP为例:
}
console.log("on connect received:" + str)
});
tcp.on('connect', () => {
tlsTwoWay.on('connect', () => {
console.log("on connect")
});
tcp.on('close', () => {
tlsTwoWay.on('close', () => {
console.log("on close")
});
......@@ -247,22 +247,22 @@ UDP与TCP流程大体类似,下面以TCP为例:
});
// 连接使用完毕后,主动关闭。取消相关事件的订阅。
tls.close((err) => {
tlsTwoWay.close((err) => {
if (err) {
console.log("close callback error = " + err);
} else {
console.log("close success");
}
tls.off('message');
tls.off('connect');
tls.off('close');
tlsTwoWay.off('message');
tlsTwoWay.off('connect');
tlsTwoWay.off('close');
});
// 创建一个(单向认证)TLS Socket连接,返回一个TLS Socket对象。
let tlsOneWay = socket.constructTLSSocketInstance(); // One way authentication
// 订阅TLS Socket相关的订阅事件
tcp.on('message', value => {
tlsTwoWay.on('message', value => {
console.log("on message")
let buffer = value.message
let dataView = new DataView(buffer)
......@@ -272,10 +272,10 @@ UDP与TCP流程大体类似,下面以TCP为例:
}
console.log("on connect received:" + str)
});
tcp.on('connect', () => {
tlsTwoWay.on('connect', () => {
console.log("on connect")
});
tcp.on('close', () => {
tlsTwoWay.on('close', () => {
console.log("on close")
});
......@@ -308,15 +308,15 @@ UDP与TCP流程大体类似,下面以TCP为例:
});
// 连接使用完毕后,主动关闭。取消相关事件的订阅。
tls.close((err) => {
tlsTwoWay.close((err) => {
if (err) {
console.log("close callback error = " + err);
} else {
console.log("close success");
}
tls.off('message');
tls.off('connect');
tls.off('close');
tlsTwoWay.off('message');
tlsTwoWay.off('connect');
tlsTwoWay.off('close');
});
```
......
......@@ -28,7 +28,7 @@ import distributedKVStore from '@ohos.data.distributedKVStore';
| 名称 | 类型 | 必填 | 说明 |
| ---------- | --------------------- | ---- | ------------------------------------------------------------ |
| context | Context | 是 |应用的上下文。 <br>FA模型的应用Context定义见[Context](js-apis-inner-app-context.md)<br>Stage模型的应用Context定义见[Context](js-apis-ability-context.md)。 |
| context | Context | 是 |应用的上下文。 <br>FA模型的应用Context定义见[Context](js-apis-inner-app-context.md)<br>Stage模型的应用Context定义见[Context](js-apis-inner-application-uiAbilityContext.md)。 |
| bundleName | string | 是 | 调用方的包名。 |
## Constants
......@@ -1241,7 +1241,7 @@ reset(): Query
| 类型 | 说明 |
| -------------- | --------------------- |
| [Query](query) | 返回重置的Query对象。 |
| [Query](#query) | 返回重置的Query对象。 |
**示例:**
......@@ -1277,7 +1277,7 @@ equalTo(field: string, value: number|string|boolean): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1311,7 +1311,7 @@ notEqualTo(field: string, value: number|string|boolean): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1344,7 +1344,7 @@ greaterThan(field: string, value: number|string|boolean): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1379,7 +1379,7 @@ lessThan(field: string, value: number|string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1414,7 +1414,7 @@ greaterThanOrEqualTo(field: string, value: number|string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1449,7 +1449,7 @@ lessThanOrEqualTo(field: string, value: number|string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1482,7 +1482,7 @@ isNull(field: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1516,7 +1516,7 @@ inNumber(field: string, valueList: number[]): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1550,7 +1550,7 @@ inString(field: string, valueList: string[]): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1584,7 +1584,7 @@ notInNumber(field: string, valueList: number[]): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1618,7 +1618,7 @@ notInString(field: string, valueList: string[]): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1652,7 +1652,7 @@ like(field: string, value: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1686,7 +1686,7 @@ unlike(field: string, value: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1713,7 +1713,7 @@ and(): Query
| 类型 | 说明 |
| -------------- | -------------- |
| [Query](query) | 返回查询对象。 |
| [Query](#query) | 返回查询对象。 |
**示例:**
......@@ -1742,7 +1742,7 @@ or(): Query
| 类型 | 说明 |
| -------------- | -------------- |
| [Query](query) | 返回查询对象。 |
| [Query](#query) | 返回查询对象。 |
**示例:**
......@@ -1777,7 +1777,7 @@ orderByAsc(field: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1811,7 +1811,7 @@ orderByDesc(field: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1846,7 +1846,7 @@ limit(total: number, offset: number): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1882,7 +1882,7 @@ isNotNull(field: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1909,7 +1909,7 @@ beginGroup(): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1938,7 +1938,7 @@ endGroup(): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -1973,7 +1973,7 @@ prefixKey(prefix: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -2007,7 +2007,7 @@ setSuggestIndex(index: string): Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -2041,7 +2041,7 @@ deviceId(deviceId:string):Query
| 类型 | 说明 |
| -------------- | --------------- |
| [Query](query) | 返回Query对象。 |
| [Query](#query) | 返回Query对象。 |
**示例:**
......@@ -3085,7 +3085,7 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ----------------------------------------------- |
| query | [Query](query) | 是 | 表示要匹配的键前缀。 |
| query | [Query](#query) | 是 | 表示要匹配的键前缀。 |
| callback | AsyncCallback&lt;[Entry](#entry)[]&gt; | 是 | 回调函数。返回与指定Query对象匹配的键值对列表。 |
**错误码:**
......@@ -3147,7 +3147,7 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | -------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -3413,7 +3413,7 @@ getResultSet(query: Query): Promise&lt;KVStoreResultSet&gt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | -------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -3660,7 +3660,7 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回与指定Query对象匹配的结果数。 |
**错误码:**
......@@ -3718,7 +3718,7 @@ getResultSize(query: Query): Promise&lt;number&gt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | -------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -4547,7 +4547,7 @@ sync(deviceIds: string[], query: Query, mode: SyncMode, delayMs?: number): void
| --------- | --------------------- | ---- | ---------------------------------------------- |
| deviceIds | string[] | 是 | 同一组网环境下,需要同步的设备的deviceId列表。 |
| mode | [SyncMode](#syncmode) | 是 | 同步模式。 |
| query | [Query](query) | 是 | 表示数据库的查询谓词条件 |
| query | [Query](#query) | 是 | 表示数据库的查询谓词条件 |
| delayMs | number | 否 | 可选参数,允许延时时间,单位:ms(毫秒)。 |
**错误码:**
......@@ -5323,7 +5323,7 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ----------------------------------------------------- |
| query | [Query](query) | 是 | 表示要匹配的键前缀。 |
| query | [Query](#query) | 是 | 表示要匹配的键前缀。 |
| callback | AsyncCallback&lt;[Entry](#entry)[]&gt; | 是 | 回调函数。返回本设备与指定Query对象匹配的键值对列表。 |
**错误码:**
......@@ -5385,7 +5385,7 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | -------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -5452,7 +5452,7 @@ getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ------------------------------------------------------- |
| deviceId | string | 是 | 键值对所属的设备ID。 |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
| callback | AsyncCallback&lt;[Entry](#entry)[]&gt; | 是 | 回调函数。返回与指定设备ID和Query对象匹配的键值对列表。 |
**错误码:**
......@@ -5521,7 +5521,7 @@ getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------- | ---- | -------------------- |
| deviceId | string | 是 | 键值对所属的设备ID。 |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -5829,7 +5829,7 @@ getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KVStoreR
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| deviceId | string | 是 | KVStoreResultSet对象所属的设备ID。 |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
| callback | AsyncCallback&lt;[KVStoreResultSet](#kvstoreresultset)&gt; | 是 | 回调函数。返回与指定设备ID和Query对象匹配的KVStoreResultSet对象。 |
**错误码:**
......@@ -5901,7 +5901,7 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KVStoreResultSet&gt;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------- | ---- | ---------------------------------- |
| deviceId | string | 是 | KVStoreResultSet对象所属的设备ID。 |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -5974,7 +5974,7 @@ getResultSet(query: Query): Promise&lt;KVStoreResultSet&gt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | -------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -6040,7 +6040,7 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KVStoreResultSet&gt;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------- | ---- | ---------------------------------- |
| deviceId | string | 是 | KVStoreResultSet对象所属的设备ID。 |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -6340,7 +6340,7 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ------------------------------------------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回与本设备指定Query对象匹配的结果数。 |
**错误码:**
......@@ -6398,7 +6398,7 @@ getResultSize(query: Query): Promise&lt;number&gt;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------------- | ---- | -------------- |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......@@ -6462,7 +6462,7 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number&
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | --------------------------------------------------- |
| deviceId | string | 是 | KVStoreResultSet对象所属的设备ID。 |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回与指定设备ID和Query对象匹配的结果数。 |
**错误码:**
......@@ -6526,7 +6526,7 @@ getResultSize(deviceId: string, query: Query): Promise&lt;number&gt;
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------- | ---- | ---------------------------------- |
| deviceId | string | 是 | KVStoreResultSet对象所属的设备ID。 |
| query | [Query](query) | 是 | 表示查询对象。 |
| query | [Query](#query) | 是 | 表示查询对象。 |
**返回值:**
......
......@@ -77,7 +77,7 @@ createHttp(): HttpRequest
| 类型 | 说明 |
| :---------- | :----------------------------------------------------------- |
| HttpRequest | 返回一个HttpRequest对象,里面包括request、destroy、on和off方法。 |
| HttpRequest | 返回一个HttpRequest对象,里面包括request、request2、destroy、on和off方法。 |
**示例:**
......@@ -545,12 +545,8 @@ on(type: 'headerReceive', callback: AsyncCallback\<Object\>): void
**示例:**
```js
httpRequest.on('headerReceive', (err, data) => {
if (!err) {
console.info('header: ' + JSON.stringify(data));
} else {
console.info('error:' + JSON.stringify(err));
}
httpRequest.on('headerReceive', (data) => {
console.info('error:' + JSON.stringify(data));
});
```
......@@ -763,9 +759,7 @@ httpRequest.off('dataEnd');
```js
httpRequest.on('dataProgress', (data) => {
if (!err) {
console.info('dataProgress:' + JSON.stringify(data));
}
console.info('dataProgress:' + JSON.stringify(data));
});
```
......@@ -915,7 +909,7 @@ let httpResponseCache = http.createHttpResponseCache();
## HttpResponseCache<sup>9+</sup>
存储HTTP访问请求响应的对象。
存储HTTP访问请求响应的对象。在调用HttpResponseCache的方法前,需要先通过[createHttpResponseCache()](#httpcreatehttpresponsecache9)创建一个任务。
### flush<sup>9+</sup>
......
# @ohos.net.socket (Socket连接)
本模块提供利用Socket进行数据传输的能力,支持TCPSocket、UDPSocket、WebSocket和TLSSocket。
> **说明:**
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册