提交 54f52eb3 编写于 作者: W wufengshan

Signed-off-by: wufengshan <wufengshan@huawei.com>

 Changes to be committed:
上级 408c03a8
...@@ -9,14 +9,14 @@ ...@@ -9,14 +9,14 @@
``` ```
import distributedData from '@ohos.data.distributedData'; import distributedData from '@ohos.data.distributedData';
``` ```
## 系统能力
SystemCapability.DistributedDataManager.KVStore.DistributedKVStore
## distributedData.createKVManager ## distributedData.createKVManager
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt;): void createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt;): void
创建一个KVManager对象实例,用于管理数据库对象,并通过callback方式返回,此方法为异步方法。 创建一个KVManager对象实例,用于管理数据库对象,并通过callback方式返回,此方法为异步方法。
...@@ -56,6 +56,8 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt ...@@ -56,6 +56,8 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt
## distributedData.createKVManager ## distributedData.createKVManager
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
创建一个KVManager对象实例,用于管理数据库对象,并通过Promise方式返回,此方法为异步方法。 创建一个KVManager对象实例,用于管理数据库对象,并通过Promise方式返回,此方法为异步方法。
...@@ -98,6 +100,8 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -98,6 +100,8 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
## KVManagerConfig ## KVManagerConfig
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
提供KVManager实例的配置信息,包括调用方的包名和用户信息。 提供KVManager实例的配置信息,包括调用方的包名和用户信息。
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -109,6 +113,8 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -109,6 +113,8 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
## UserInfo ## UserInfo
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
用户信息。 用户信息。
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
...@@ -118,6 +124,8 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -118,6 +124,8 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
## UserType ## UserType
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
用户类型。 用户类型。
...@@ -128,11 +136,15 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -128,11 +136,15 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
## KVManager ## KVManager
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
数据管理实例,用于获取KVStore的相关信息。在调用KVManager的方法前,需要先通过createKVManager构建一个KVManager实例。 数据管理实例,用于获取KVStore的相关信息。在调用KVManager的方法前,需要先通过createKVManager构建一个KVManager实例。
### getKVStore ### getKVStore
getKVStore<T extends KVStore>(storeId: string, options: Options, callback: AsyncCallback&lt;T&gt;): void **系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options, callback: AsyncCallback&lt;T&gt;): void
通过指定Options和storeId,创建并获取KVStore数据库,并通过callback方式返回,此方法为异步方法。 通过指定Options和storeId,创建并获取KVStore数据库,并通过callback方式返回,此方法为异步方法。
...@@ -174,6 +186,9 @@ getKVStore<T extends KVStore>(storeId: string, options: Options, callback: Async ...@@ -174,6 +186,9 @@ getKVStore<T extends KVStore>(storeId: string, options: Options, callback: Async
### getKVStore ### getKVStore
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options): Promise&lt;T&gt; getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options): Promise&lt;T&gt;
通过指定Options和storeId,创建并获取KVStore数据库,并通过Promise方式返回,此方法为异步方法。 通过指定Options和storeId,创建并获取KVStore数据库,并通过Promise方式返回,此方法为异步方法。
...@@ -220,10 +235,12 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options): Promise& ...@@ -220,10 +235,12 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options): Promise&
### closeKVStore<sup>8+</sup> ### ### closeKVStore<sup>8+</sup> ###
closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCallback&lt;void&gt;): void; closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCallback&lt;void&gt;): void
通过storId的值关闭指定的kvStore数据库,并通过callback方式返回,此方法为异步方法。 通过storId的值关闭指定的kvStore数据库,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
...@@ -264,10 +281,12 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCa ...@@ -264,10 +281,12 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCa
### closeKVStore<sup>8+</sup> ### ### closeKVStore<sup>8+</sup> ###
closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void&gt;; closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void&gt;
通过kvStore的值关闭指定的kvStore数据库,并通过Promise方式返回,此方法为异步方法。 通过kvStore的值关闭指定的kvStore数据库,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -316,10 +335,12 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void& ...@@ -316,10 +335,12 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void&
### deleteKVStore<sup>8+</sup> ### ### deleteKVStore<sup>8+</sup> ###
deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt;): void; deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt;): void
通过storeId的值删除指定的kvStore数据库,并通过callback方式返回,此方法为异步方法。 通过storeId的值删除指定的kvStore数据库,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -358,10 +379,12 @@ deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt ...@@ -358,10 +379,12 @@ deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt
### deleteKVStore<sup>8+</sup> ### ### deleteKVStore<sup>8+</sup> ###
deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt;; deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt;
通过storeId的值删除指定的kvStore数据库,并通过Promise方式返回,此方法为异步方法。 通过storeId的值删除指定的kvStore数据库,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -410,10 +433,12 @@ deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt;; ...@@ -410,10 +433,12 @@ deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt;;
### getAllKVStoreId<sup>8+</sup> ### ### getAllKVStoreId<sup>8+</sup> ###
getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void; getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void
获取所有通过getKvStore方法创建的且没有调用deleteKvStore方法删除的KvStore数据库的storeId,并通过callback方式返回,此方法为异步方法。 获取所有通过getKvStore方法创建的且没有调用deleteKvStore方法删除的KvStore数据库的storeId,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -438,10 +463,12 @@ getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void; ...@@ -438,10 +463,12 @@ getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void;
### getAllKVStoreId<sup>8+</sup> ### ### getAllKVStoreId<sup>8+</sup> ###
getAllKVStoreId(appId: string): Promise&lt;string[]&gt;; getAllKVStoreId(appId: string): Promise&lt;string[]&gt;
获取所有通过getKvStore方法创建的且没有调用deleteKvStore方法删除的KvStore数据库的storeId,并通过Promise方式返回,此方法为异步方法。 获取所有通过getKvStore方法创建的且没有调用deleteKvStore方法删除的KvStore数据库的storeId,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -475,10 +502,12 @@ getAllKVStoreId(appId: string): Promise&lt;string[]&gt;; ...@@ -475,10 +502,12 @@ getAllKVStoreId(appId: string): Promise&lt;string[]&gt;;
### on<sup>8+</sup> ### ### on<sup>8+</sup> ###
on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): void; on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): void
订阅服务状态变更通知,并通过callback方式返回,此方法为同步方法。 订阅服务状态变更通知,并通过callback方式返回,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -507,10 +536,12 @@ on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): voi ...@@ -507,10 +536,12 @@ on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): voi
### off<sup>8+</sup> ### ### off<sup>8+</sup> ###
off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): void; off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): void
取消订阅服务状态变更通知,并通过callback方式返回,此方法为同步方法。 取消订阅服务状态变更通知,并通过callback方式返回,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -539,6 +570,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v ...@@ -539,6 +570,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v
用于提供创建数据库的配置信息。 用于提供创建数据库的配置信息。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| createIfMissing | boolean | 否 | 当数据库文件不存在时是否创建数据库,默认创建。 | | createIfMissing | boolean | 否 | 当数据库文件不存在时是否创建数据库,默认创建。 |
...@@ -553,6 +586,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v ...@@ -553,6 +586,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v
用于指定创建的数据库的类型。 用于指定创建的数据库的类型。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| --- | ---- | ----------------------- | | --- | ---- | ----------------------- |
| DEVICE_COLLABORATION | 0 | 表示多设备协同数据库。 | | DEVICE_COLLABORATION | 0 | 表示多设备协同数据库。 |
...@@ -565,6 +600,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v ...@@ -565,6 +600,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v
用于指定创建的数据库的安全级别。 用于指定创建的数据库的安全级别。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| --- | ---- | ----------------------- | | --- | ---- | ----------------------- |
| NO_LEVEL | 0 | 表示数据库不设置安全级别。 | | NO_LEVEL | 0 | 表示数据库不设置安全级别。 |
...@@ -579,6 +616,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v ...@@ -579,6 +616,8 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v
KVStore常量。 KVStore常量。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| --- | ---- | ----------------------- | | --- | ---- | ----------------------- |
| MAX_KEY_LENGTH | 1024 | 数据库中Key允许最大长度,单位字节。 | | MAX_KEY_LENGTH | 1024 | 数据库中Key允许最大长度,单位字节。 |
...@@ -592,42 +631,23 @@ KVStore常量。 ...@@ -592,42 +631,23 @@ KVStore常量。
表示数据库模式,可以在创建或打开数据库时创建 Schema 对象并将它们放入 Options 中。 表示数据库模式,可以在创建或打开数据库时创建 Schema 对象并将它们放入 Options 中。
### toJsonString<sup>8+</sup> ### **系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
toJsonString():string;
获取 json 格式的 schema 。
- 返回值:
| 类型 | 说明 |
| ------------- | -------------- |
| string |以 json 格式返回Schema。 |
- 示例
```
import ddm from '@ohos.data.distributedData';
try {
let schema = new ddm.Schema();
const str = schema.toJsonString();
console.log("schema: " + str);
} catch (e) {
console.log("toJsonString " + e);
}
```
## FieldNode<sup>8+</sup> ## ## FieldNode<sup>8+</sup> ##
表示 Schema 实例的节点,提供定义存储在数据库中的值的方法。 表示 Schema 实例的节点,提供定义存储在数据库中的值的方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
### appendChild<sup>8+</sup> ### ### appendChild<sup>8+</sup> ###
appendChild(child: FieldNode): boolean; appendChild(child: FieldNode): boolean
向这个 FieldNode 添加一个子节点。 向这个 FieldNode 添加一个子节点。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -664,43 +684,22 @@ appendChild(child: FieldNode): boolean; ...@@ -664,43 +684,22 @@ appendChild(child: FieldNode): boolean;
``` ```
### toJson<sup>8+</sup> ###
toJson(): string;
获取字段名称。
- 返回值:
| 类型 | 说明 |
| ------ | -------------- |
| string |返回节点的字段名称。 |
- 示例
```
import ddm from '@ohos.data.distributedData';
try {
let node = new ddm.FieldNode("root");
let child = new ddm.FieldNode("child");
node.appendChild(child);
console.log("appendNode " + node.toJson());
} catch (e) {
console.log("ToJson " + e);
}
```
## KvStoreResultSet<sup>8+</sup> ## ## KvStoreResultSet<sup>8+</sup> ##
提供获取KvStore数据库结果集的方法,提供查询和移动数据读取位置的方法,在调用KvStoreResultSet的方法前,需要先通过KvStore 构建一个KvStore 实例。 提供获取KvStore数据库结果集的方法,提供查询和移动数据读取位置的方法,在调用KvStoreResultSet的方法前,需要先通过KvStore 构建一个KvStore 实例。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
### getCount<sup>8+</sup> ### ### getCount<sup>8+</sup> ###
getCount(): number; getCount(): number
获取结果集中的行数。 获取结果集中的行数。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -729,10 +728,12 @@ getCount(): number; ...@@ -729,10 +728,12 @@ getCount(): number;
### getPosition<sup>8+</sup> ### ### getPosition<sup>8+</sup> ###
getPosition(): number; getPosition(): number
获取结果集中当前的读取位置。 获取结果集中当前的读取位置。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -761,10 +762,12 @@ getPosition(): number; ...@@ -761,10 +762,12 @@ getPosition(): number;
### moveToFirst<sup>8+</sup> ### ### moveToFirst<sup>8+</sup> ###
moveToFirst(): boolean; moveToFirst(): boolean
将读取位置移动到第一行。 将读取位置移动到第一行。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -793,10 +796,12 @@ moveToFirst(): boolean; ...@@ -793,10 +796,12 @@ moveToFirst(): boolean;
### moveToLast<sup>8+</sup> ### ### moveToLast<sup>8+</sup> ###
moveToLast(): boolean; moveToLast(): boolean
将读取位置移动到最后一行。 将读取位置移动到最后一行。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -825,10 +830,12 @@ moveToLast(): boolean; ...@@ -825,10 +830,12 @@ moveToLast(): boolean;
### moveToNext<sup>8+</sup> ### ### moveToNext<sup>8+</sup> ###
moveToNext(): boolean; moveToNext(): boolean
将读取位置移动到下一行。 将读取位置移动到下一行。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -857,10 +864,12 @@ moveToNext(): boolean; ...@@ -857,10 +864,12 @@ moveToNext(): boolean;
### moveToPrevious<sup>8+</sup> ### ### moveToPrevious<sup>8+</sup> ###
moveToPrevious(): boolean; moveToPrevious(): boolean
将读取位置移动到上一行。 将读取位置移动到上一行。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -889,10 +898,12 @@ moveToPrevious(): boolean; ...@@ -889,10 +898,12 @@ moveToPrevious(): boolean;
### move<sup>8+</sup> ### ### move<sup>8+</sup> ###
move(offset: number): boolean; move(offset: number): boolean
将读取位置移动到当前位置的相对偏移量。 将读取位置移动到当前位置的相对偏移量。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -927,10 +938,12 @@ move(offset: number): boolean; ...@@ -927,10 +938,12 @@ move(offset: number): boolean;
### moveToPosition<sup>8+</sup> ### ### moveToPosition<sup>8+</sup> ###
moveToPosition(position: number): boolean; moveToPosition(position: number): boolean
将读取位置从 0 移动到绝对位置。 将读取位置从 0 移动到绝对位置。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -965,10 +978,12 @@ moveToPosition(position: number): boolean; ...@@ -965,10 +978,12 @@ moveToPosition(position: number): boolean;
### isFirst<sup>8+</sup> ### ### isFirst<sup>8+</sup> ###
isFirst(): boolean; isFirst(): boolean
检查读取位置是否为第一行。 检查读取位置是否为第一行。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -997,10 +1012,12 @@ isFirst(): boolean; ...@@ -997,10 +1012,12 @@ isFirst(): boolean;
### isLast<sup>8+</sup> ### ### isLast<sup>8+</sup> ###
isLast(): boolean; isLast(): boolean
检查读取位置是否为最后一行。 检查读取位置是否为最后一行。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1029,10 +1046,12 @@ isLast(): boolean; ...@@ -1029,10 +1046,12 @@ isLast(): boolean;
### isBeforeFirst<sup>8+</sup> ### ### isBeforeFirst<sup>8+</sup> ###
isBeforeFirst(): boolean; isBeforeFirst(): boolean
检查读取位置是否在第一行之前。 检查读取位置是否在第一行之前。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1061,10 +1080,12 @@ isBeforeFirst(): boolean; ...@@ -1061,10 +1080,12 @@ isBeforeFirst(): boolean;
### isAfterLast<sup>8+</sup> ### ### isAfterLast<sup>8+</sup> ###
isAfterLast(): boolean; isAfterLast(): boolean
检查读取位置是否在最后一行之后。 检查读取位置是否在最后一行之后。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1093,10 +1114,12 @@ isAfterLast(): boolean; ...@@ -1093,10 +1114,12 @@ isAfterLast(): boolean;
### getEntry<sup>8+</sup> ### ### getEntry<sup>8+</sup> ###
getEntry(): Entry; getEntry(): Entry
获取键值对 获取键值对
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1128,12 +1151,18 @@ getEntry(): Entry; ...@@ -1128,12 +1151,18 @@ getEntry(): Entry;
使用谓词表示数据库查询,提供创建Query实例、查询数据库中的数据和添加谓词的方法。 使用谓词表示数据库查询,提供创建Query实例、查询数据库中的数据和添加谓词的方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
### reset<sup>8+</sup> ### ### reset<sup>8+</sup> ###
reset(): Query; reset(): Query
公共查询重置。 公共查询重置。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1162,6 +1191,8 @@ equalTo(field: string, value: number|string|boolean): Query; ...@@ -1162,6 +1191,8 @@ equalTo(field: string, value: number|string|boolean): Query;
构造一个Query对象来查询具有指定字段的条目,其值等于指定的值。 构造一个Query对象来查询具有指定字段的条目,其值等于指定的值。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1191,10 +1222,12 @@ equalTo(field: string, value: number|string|boolean): Query; ...@@ -1191,10 +1222,12 @@ equalTo(field: string, value: number|string|boolean): Query;
### notEqualTo<sup>8+</sup> ### ### notEqualTo<sup>8+</sup> ###
notEqualTo(field: string, value: number|string|boolean): Query; notEqualTo(field: string, value: number|string|boolean): Query
构造一个Query对象以查询具有指定字段且值不等于指定值的条目。 构造一个Query对象以查询具有指定字段且值不等于指定值的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1224,10 +1257,12 @@ notEqualTo(field: string, value: number|string|boolean): Query; ...@@ -1224,10 +1257,12 @@ notEqualTo(field: string, value: number|string|boolean): Query;
### greaterThan<sup>8+</sup> ### ### greaterThan<sup>8+</sup> ###
greaterThan(field: string, value: number|string|boolean): Query; greaterThan(field: string, value: number|string|boolean): Query
构造一个Query对象以查询具有大于指定值的指定字段的条目。 构造一个Query对象以查询具有大于指定值的指定字段的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1257,10 +1292,12 @@ greaterThan(field: string, value: number|string|boolean): Query; ...@@ -1257,10 +1292,12 @@ greaterThan(field: string, value: number|string|boolean): Query;
### lessThan<sup>8+</sup> ### ### lessThan<sup>8+</sup> ###
lessThan(field: string, value: number|string): Query; lessThan(field: string, value: number|string): Query
构造一个Query对象以查询具有小于指定值的指定字段的条目。 构造一个Query对象以查询具有小于指定值的指定字段的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1290,10 +1327,12 @@ lessThan(field: string, value: number|string): Query; ...@@ -1290,10 +1327,12 @@ lessThan(field: string, value: number|string): Query;
### greaterThanOrEqualTo<sup>8+</sup> ### ### greaterThanOrEqualTo<sup>8+</sup> ###
greaterThanOrEqualTo(field: string, value: number|string): Query; greaterThanOrEqualTo(field: string, value: number|string): Query
构造一个Query对象以查询具有指定字段且值大于或等于指定值的条目。 构造一个Query对象以查询具有指定字段且值大于或等于指定值的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1323,10 +1362,12 @@ greaterThanOrEqualTo(field: string, value: number|string): Query; ...@@ -1323,10 +1362,12 @@ greaterThanOrEqualTo(field: string, value: number|string): Query;
### lessThanOrEqualTo<sup>8+</sup> ### ### lessThanOrEqualTo<sup>8+</sup> ###
lessThanOrEqualTo(field: string, value: number|string): Query; lessThanOrEqualTo(field: string, value: number|string): Query
构造一个Query对象以查询具有指定字段且值小于或等于指定值的条目。 构造一个Query对象以查询具有指定字段且值小于或等于指定值的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1356,10 +1397,13 @@ lessThanOrEqualTo(field: string, value: number|string): Query; ...@@ -1356,10 +1397,13 @@ lessThanOrEqualTo(field: string, value: number|string): Query;
### isNull<sup>8+</sup> ### ### isNull<sup>8+</sup> ###
isNull(field: string): Query; isNull(field: string): Query
构造一个Query对象以查询具有值为null的指定字段的条目。 构造一个Query对象以查询具有值为null的指定字段的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1388,10 +1432,13 @@ isNull(field: string): Query; ...@@ -1388,10 +1432,13 @@ isNull(field: string): Query;
### inNumber<sup>8+</sup> ### ### inNumber<sup>8+</sup> ###
inNumber(field: string, valueList: number[]): Query; inNumber(field: string, valueList: number[]): Query
构造一个Query对象以查询具有指定字段的条目,其值在指定的值列表中。 构造一个Query对象以查询具有指定字段的条目,其值在指定的值列表中。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1422,10 +1469,12 @@ inNumber(field: string, valueList: number[]): Query; ...@@ -1422,10 +1469,12 @@ inNumber(field: string, valueList: number[]): Query;
### inString<sup>8+</sup> ### ### inString<sup>8+</sup> ###
inString(field: string, valueList: string[]): Query; inString(field: string, valueList: string[]): Query
构造一个Query对象以查询具有指定字段的条目,其值在指定的字符串值列表中。 构造一个Query对象以查询具有指定字段的条目,其值在指定的字符串值列表中。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1455,10 +1504,12 @@ inString(field: string, valueList: string[]): Query; ...@@ -1455,10 +1504,12 @@ inString(field: string, valueList: string[]): Query;
### notInNumber<sup>8+</sup> ### ### notInNumber<sup>8+</sup> ###
notInNumber(field: string, valueList: number[]): Query; notInNumber(field: string, valueList: number[]): Query
构造一个Query对象以查询具有指定字段的条目,该字段的值不在指定的值列表中。 构造一个Query对象以查询具有指定字段的条目,该字段的值不在指定的值列表中。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1488,10 +1539,12 @@ notInNumber(field: string, valueList: number[]): Query; ...@@ -1488,10 +1539,12 @@ notInNumber(field: string, valueList: number[]): Query;
### notInString<sup>8+</sup> ### ### notInString<sup>8+</sup> ###
notInString(field: string, valueList: string[]): Query; notInString(field: string, valueList: string[]): Query
构造一个Query对象以查询具有指定字段且值不在指定字符串值列表中的条目。 构造一个Query对象以查询具有指定字段且值不在指定字符串值列表中的条目。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1521,10 +1574,12 @@ notInString(field: string, valueList: string[]): Query; ...@@ -1521,10 +1574,12 @@ notInString(field: string, valueList: string[]): Query;
### like<sup>8+</sup> ### ### like<sup>8+</sup> ###
like(field: string, value: string): Query; like(field: string, value: string): Query
构造一个Query对象以查询具有与指定字符串值相似的指定字段的条目。 构造一个Query对象以查询具有与指定字符串值相似的指定字段的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1554,10 +1609,12 @@ like(field: string, value: string): Query; ...@@ -1554,10 +1609,12 @@ like(field: string, value: string): Query;
### unlike<sup>8+</sup> ### ### unlike<sup>8+</sup> ###
unlike(field: string, value: string): Query; unlike(field: string, value: string): Query
构造一个Query对象以查询具有与指定字符串值不相似的指定字段的条目。 构造一个Query对象以查询具有与指定字符串值不相似的指定字段的条目。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1587,10 +1644,12 @@ unlike(field: string, value: string): Query; ...@@ -1587,10 +1644,12 @@ unlike(field: string, value: string): Query;
### and<sup>8+</sup> ### ### and<sup>8+</sup> ###
and(): Query; and(): Query
构造一个带有与条件的查询对象。 构造一个带有与条件的查询对象。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1615,10 +1674,12 @@ and(): Query; ...@@ -1615,10 +1674,12 @@ and(): Query;
### or<sup>8+</sup> ### ### or<sup>8+</sup> ###
or(): Query; or(): Query
构造一个带有或条件的Query对象。 构造一个带有或条件的Query对象。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1643,10 +1704,12 @@ or(): Query; ...@@ -1643,10 +1704,12 @@ or(): Query;
### orderByAsc<sup>8+</sup> ### ### orderByAsc<sup>8+</sup> ###
orderByAsc(field: string): Query; orderByAsc(field: string): Query
构造一个Query对象,将查询结果按升序排序。 构造一个Query对象,将查询结果按升序排序。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1676,10 +1739,12 @@ orderByAsc(field: string): Query; ...@@ -1676,10 +1739,12 @@ orderByAsc(field: string): Query;
### orderByDesc<sup>8+</sup> ### ### orderByDesc<sup>8+</sup> ###
orderByDesc(field: string): Query; orderByDesc(field: string): Query
构造一个Query对象,将查询结果按降序排序。 构造一个Query对象,将查询结果按降序排序。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1710,10 +1775,12 @@ orderByDesc(field: string): Query; ...@@ -1710,10 +1775,12 @@ orderByDesc(field: string): Query;
### limit<sup>8+</sup> ### ### limit<sup>8+</sup> ###
limit(total: number, offset: number): Query; limit(total: number, offset: number): Query
构造一个Query对象来指定结果的数量和开始位置。 构造一个Query对象来指定结果的数量和开始位置。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1744,10 +1811,12 @@ limit(total: number, offset: number): Query; ...@@ -1744,10 +1811,12 @@ limit(total: number, offset: number): Query;
### isNotNull<sup>8+</sup> ### ### isNotNull<sup>8+</sup> ###
isNotNull(field: string): Query; isNotNull(field: string): Query
使用不为空的指定字段创建查询条件。 使用不为空的指定字段创建查询条件。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1776,10 +1845,12 @@ isNotNull(field: string): Query; ...@@ -1776,10 +1845,12 @@ isNotNull(field: string): Query;
### beginGroup<sup>8+</sup> ### ### beginGroup<sup>8+</sup> ###
beginGroup(): Query; beginGroup(): Query
创建一个带有左括号的查询条件组。 创建一个带有左括号的查询条件组。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1804,10 +1875,12 @@ beginGroup(): Query; ...@@ -1804,10 +1875,12 @@ beginGroup(): Query;
### endGroup<sup>8+</sup> ### ### endGroup<sup>8+</sup> ###
endGroup(): Query; endGroup(): Query
创建一个带有右括号的查询条件组。 创建一个带有右括号的查询条件组。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1832,10 +1905,12 @@ endGroup(): Query; ...@@ -1832,10 +1905,12 @@ endGroup(): Query;
### prefixKey<sup>8+</sup> ### ### prefixKey<sup>8+</sup> ###
prefixKey(prefix: string): Query; prefixKey(prefix: string): Query
创建具有指定键前缀的查询条件。 创建具有指定键前缀的查询条件。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1865,10 +1940,12 @@ prefixKey(prefix: string): Query; ...@@ -1865,10 +1940,12 @@ prefixKey(prefix: string): Query;
### setSuggestIndex<sup>8+</sup> ### ### setSuggestIndex<sup>8+</sup> ###
setSuggestIndex(index: string): Query; setSuggestIndex(index: string): Query
设置一个指定的索引,将优先用于查询。 设置一个指定的索引,将优先用于查询。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1898,10 +1975,12 @@ setSuggestIndex(index: string): Query; ...@@ -1898,10 +1975,12 @@ setSuggestIndex(index: string): Query;
### deviceId<sup>8+</sup> ### ### deviceId<sup>8+</sup> ###
deviceId(deviceId:string):Query; deviceId(deviceId:string):Query
添加设备ID作为key的前缀。 添加设备ID作为key的前缀。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1930,10 +2009,12 @@ deviceId(deviceId:string):Query; ...@@ -1930,10 +2009,12 @@ deviceId(deviceId:string):Query;
### getSqlLike<sup>8+</sup> ### ### getSqlLike<sup>8+</sup> ###
getSqlLike():string; getSqlLike():string
获取指定Query对象的查询语句。 获取指定Query对象的查询语句。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -1957,12 +2038,16 @@ getSqlLike():string; ...@@ -1957,12 +2038,16 @@ getSqlLike():string;
KVStore数据库实例,提供增加数据、删除数据和订阅数据变更、订阅同步完成的方法。在调用KVStore的方法前,需要先通过getKVStore构建一个KVStore实例。 KVStore数据库实例,提供增加数据、删除数据和订阅数据变更、订阅同步完成的方法。在调用KVStore的方法前,需要先通过getKVStore构建一个KVStore实例。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
### put ### put
put(key: string, value: Uint8Array | string | number | boolean, callback: AsyncCallback&lt;void&gt;): void put(key: string, value: Uint8Array | string | number | boolean, callback: AsyncCallback&lt;void&gt;): void
添加指定类型键值对到数据库,并通过callback方式返回,此方法为异步方法。 添加指定类型键值对到数据库,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -1997,6 +2082,8 @@ put(key: string, value: Uint8Array | string | number | boolean): Promise&lt;void ...@@ -1997,6 +2082,8 @@ put(key: string, value: Uint8Array | string | number | boolean): Promise&lt;void
添加指定类型键值对到数据库,并通过Promise方式返回,此方法为异步方法。 添加指定类型键值对到数据库,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2035,6 +2122,8 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -2035,6 +2122,8 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void
从数据库中删除指定键值的数据,并通过callback方式返回,此方法为异步方法。 从数据库中删除指定键值的数据,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2075,6 +2164,8 @@ delete(key: string): Promise&lt;void&gt; ...@@ -2075,6 +2164,8 @@ delete(key: string): Promise&lt;void&gt;
从数据库中删除指定键值的数据,并通过Promise方式返回,此方法为异步方法。 从数据库中删除指定键值的数据,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2116,6 +2207,8 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific ...@@ -2116,6 +2207,8 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific
订阅指定类型的数据变更通知,此方法为同步方法。 订阅指定类型的数据变更通知,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2137,16 +2230,18 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific ...@@ -2137,16 +2230,18 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific
### on ### on
on(event: 'syncComplete', syncCallback: Callback<Array&lt;[string, number]&gt;): void on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt;&gt;): void
订阅同步完成事件回调通知,此方法为同步方法。 订阅同步完成事件回调通知,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| event |'syncComplete' | 是 |回调函数名称。 | | event |'syncComplete' | 是 |回调函数名称。 |
| syncCallback |Callback&lt;Array&lt;[string, number]&gt; | 是 |回调函数。 | | syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 是 |回调函数。 |
- 示例 - 示例
...@@ -2160,10 +2255,12 @@ on(event: 'syncComplete', syncCallback: Callback<Array&lt;[string, number]&gt;): ...@@ -2160,10 +2255,12 @@ on(event: 'syncComplete', syncCallback: Callback<Array&lt;[string, number]&gt;):
### off<sup>8+</sup> ### off<sup>8+</sup>
off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void; off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void
取消订阅数据变更通知,此方法为同步方法。 取消订阅数据变更通知,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2186,10 +2283,12 @@ off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void; ...@@ -2186,10 +2283,12 @@ off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void;
### putBatch<sup>8+</sup> ### putBatch<sup>8+</sup>
putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void; putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void
批量插入键值对到KvStore数据库中,并通过callback方式返回,此方法为异步方法。 批量插入键值对到KvStore数据库中,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2232,10 +2331,12 @@ putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void; ...@@ -2232,10 +2331,12 @@ putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void;
### putBatch<sup>8+</sup> ### putBatch<sup>8+</sup>
putBatch(entries: Entry[]): Promise&lt;void&gt;; putBatch(entries: Entry[]): Promise&lt;void&gt;
批量插入键值对到KvStore数据库中,并通过Promise方式返回,此方法为异步方法。 批量插入键值对到KvStore数据库中,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2285,10 +2386,12 @@ putBatch(entries: Entry[]): Promise&lt;void&gt;; ...@@ -2285,10 +2386,12 @@ putBatch(entries: Entry[]): Promise&lt;void&gt;;
### deleteBatch<sup>8+</sup> ### deleteBatch<sup>8+</sup>
deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void; deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void
批量删除KvStore数据库中的键值对,并通过callback方式返回,此方法为异步方法。 批量删除KvStore数据库中的键值对,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2330,10 +2433,12 @@ deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void; ...@@ -2330,10 +2433,12 @@ deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void;
### deleteBatch<sup>8+</sup> ### ### deleteBatch<sup>8+</sup> ###
deleteBatch(keys: string[]): Promise&lt;void&gt;; deleteBatch(keys: string[]): Promise&lt;void&gt;
批量删除键值对到KvStore数据库中,并通过Promise方式返回,此方法为异步方法。 批量删除键值对到KvStore数据库中,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2384,10 +2489,12 @@ deleteBatch(keys: string[]): Promise&lt;void&gt;; ...@@ -2384,10 +2489,12 @@ deleteBatch(keys: string[]): Promise&lt;void&gt;;
### startTransaction<sup>8+</sup> ### ### startTransaction<sup>8+</sup> ###
startTransaction(callback: AsyncCallback&lt;void&gt;): void; startTransaction(callback: AsyncCallback&lt;void&gt;): void
启动KvStore数据库中的事务,并通过callback方式返回,此方法为异步方法。 启动KvStore数据库中的事务,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2434,10 +2541,12 @@ startTransaction(callback: AsyncCallback&lt;void&gt;): void; ...@@ -2434,10 +2541,12 @@ startTransaction(callback: AsyncCallback&lt;void&gt;): void;
### startTransaction<sup>8+</sup> ### ### startTransaction<sup>8+</sup> ###
startTransaction(): Promise&lt;void&gt;; startTransaction(): Promise&lt;void&gt;
启动KvStore数据库中的事务,并通过Promise方式返回,此方法为异步方法。 启动KvStore数据库中的事务,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2467,10 +2576,12 @@ startTransaction(): Promise&lt;void&gt;; ...@@ -2467,10 +2576,12 @@ startTransaction(): Promise&lt;void&gt;;
### commit<sup>8+</sup> ### ### commit<sup>8+</sup> ###
commit(callback: AsyncCallback&lt;void&gt;): void; commit(callback: AsyncCallback&lt;void&gt;): void
提交KvStore数据库中的事务,并通过callback方式返回,此方法为异步方法。 提交KvStore数据库中的事务,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2497,10 +2608,12 @@ commit(callback: AsyncCallback&lt;void&gt;): void; ...@@ -2497,10 +2608,12 @@ commit(callback: AsyncCallback&lt;void&gt;): void;
### commit<sup>8+</sup> ### ### commit<sup>8+</sup> ###
commit(): Promise&lt;void&gt;; commit(): Promise&lt;void&gt;
提交KvStore数据库中的事务,并通过Promise方式返回,此方法为异步方法。 提交KvStore数据库中的事务,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2525,10 +2638,12 @@ commit(): Promise&lt;void&gt;; ...@@ -2525,10 +2638,12 @@ commit(): Promise&lt;void&gt;;
### rollback<sup>8+</sup> ### ### rollback<sup>8+</sup> ###
rollback(callback: AsyncCallback&lt;void&gt;): void; rollback(callback: AsyncCallback&lt;void&gt;): void
在KvStore数据库中回滚事务,并通过callback方式返回,此方法为异步方法。 在KvStore数据库中回滚事务,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2555,10 +2670,12 @@ rollback(callback: AsyncCallback&lt;void&gt;): void; ...@@ -2555,10 +2670,12 @@ rollback(callback: AsyncCallback&lt;void&gt;): void;
### rollback<sup>8+</sup> ### ### rollback<sup>8+</sup> ###
rollback(): Promise&lt;void&gt;; rollback(): Promise&lt;void&gt;
在KvStore数据库中回滚事务,并通过Promise方式返回,此方法为异步方法。 在KvStore数据库中回滚事务,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -2583,10 +2700,12 @@ rollback(): Promise&lt;void&gt;; ...@@ -2583,10 +2700,12 @@ rollback(): Promise&lt;void&gt;;
### enableSync<sup>8+</sup> ### ### enableSync<sup>8+</sup> ###
enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void; enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void
设定是否开启同步,并通过callback方式返回,此方法为异步方法。 设定是否开启同步,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2614,10 +2733,12 @@ enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void; ...@@ -2614,10 +2733,12 @@ enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void;
### enableSync<sup>8+</sup> ### ### enableSync<sup>8+</sup> ###
enableSync(enabled: boolean): Promise&lt;void&gt;; enableSync(enabled: boolean): Promise&lt;void&gt;
设定是否开启同步,并通过Promise方式返回,此方法为异步方法。 设定是否开启同步,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2648,10 +2769,12 @@ enableSync(enabled: boolean): Promise&lt;void&gt;; ...@@ -2648,10 +2769,12 @@ enableSync(enabled: boolean): Promise&lt;void&gt;;
### setSyncRange<sup>8+</sup> ### ### setSyncRange<sup>8+</sup> ###
setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: AsyncCallback&lt;void&gt;): void; setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: AsyncCallback&lt;void&gt;): void
设置同步范围标签,并通过callback方式返回,此方法为异步方法。 设置同步范围标签,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2678,10 +2801,12 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: Asy ...@@ -2678,10 +2801,12 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: Asy
### setSyncRange<sup>8+</sup> ### ### setSyncRange<sup>8+</sup> ###
setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;void&gt;; setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;void&gt;
设置同步范围标签,并通过Promise方式返回,此方法为异步方法。 设置同步范围标签,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2718,6 +2843,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2718,6 +2843,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
描述订阅类型。 描述订阅类型。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| ----- | ------ | ----------------------- | | ----- | ------ | ----------------------- |
| SUBSCRIBE_TYPE_LOCAL |0 |表示订阅本地数据变更。 | | SUBSCRIBE_TYPE_LOCAL |0 |表示订阅本地数据变更。 |
...@@ -2728,6 +2855,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2728,6 +2855,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
数据变更时通知的对象,包括数据插入的数据、更新的数据、删除的数据和设备ID。 数据变更时通知的对象,包括数据插入的数据、更新的数据、删除的数据和设备ID。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 参数类型 |可读 |可写 | 说明 | | 名称 | 参数类型 |可读 |可写 | 说明 |
| ----- | ------- | -----| ------|------------------------ | | ----- | ------- | -----| ------|------------------------ |
| insertEntries | [Entry](#entry)[] | 是 | 是 |数据添加记录。 | | insertEntries | [Entry](#entry)[] | 是 | 是 |数据添加记录。 |
...@@ -2739,6 +2868,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2739,6 +2868,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
存储在数据库中的键值对。 存储在数据库中的键值对。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 参数类型 |可读 |可写 | 说明 | | 名称 | 参数类型 |可读 |可写 | 说明 |
| ----- | ------- | -----| ------|------------------------ | | ----- | ------- | -----| ------|------------------------ |
| key | string | 是 | 是 |键值。 | | key | string | 是 | 是 |键值。 |
...@@ -2749,6 +2880,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2749,6 +2880,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
存储在数据库中的对象。 存储在数据库中的对象。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 参数类型 |可读 |可写 | 说明 | | 名称 | 参数类型 |可读 |可写 | 说明 |
| ----- | ------- | -----| ------|------------------------ | | ----- | ------- | -----| ------|------------------------ |
| type | [ValueType](#value) | 是 | 是 |值类型。 | | type | [ValueType](#value) | 是 | 是 |值类型。 |
...@@ -2760,6 +2893,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2760,6 +2893,8 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
只能被内部应用使用。 只能被内部应用使用。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| ----- | ------ | ----------------------- | | ----- | ------ | ----------------------- |
| STRING |0 |表示值类型为字符串。 | | STRING |0 |表示值类型为字符串。 |
...@@ -2773,12 +2908,16 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2773,12 +2908,16 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
单版本分布式数据库,继承自KVStore,提供查询数据和同步数据的方法。在调用 SingleKVStore 的方法前,需要先通过 getKVStore 构建一个 SingleKVStore 实例。 单版本分布式数据库,继承自KVStore,提供查询数据和同步数据的方法。在调用 SingleKVStore 的方法前,需要先通过 getKVStore 构建一个 SingleKVStore 实例。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
### get ### get
get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | number&gt;): void get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | number&gt;): void
获取指定键的值,并通过callback方式返回,此方法为异步方法。 获取指定键的值,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2811,10 +2950,12 @@ get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | numb ...@@ -2811,10 +2950,12 @@ get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | numb
### get ### get
get(key: string): Promise&lt;Uint8Array | string | boolean | number&gt; get(key: string): Promise&lt;Uint8Array | string | boolean | number&gt
获取指定键的值,并通过Promise方式返回,此方法为异步方法。 获取指定键的值,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2853,10 +2994,12 @@ get(key: string): Promise&lt;Uint8Array | string | boolean | number&gt; ...@@ -2853,10 +2994,12 @@ get(key: string): Promise&lt;Uint8Array | string | boolean | number&gt;
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void; getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void
获取匹配指定键前缀的所有键值对,并通过callback方式返回,此方法为异步方法。 获取匹配指定键前缀的所有键值对,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2897,10 +3040,12 @@ getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void; ...@@ -2897,10 +3040,12 @@ getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void;
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(keyPrefix: string): Promise&lt;Entry[]&gt;; getEntries(keyPrefix: string): Promise&lt;Entry[]&gt;
获取匹配指定键前缀的所有键值对,并通过Promise方式返回,此方法为异步方法。 获取匹配指定键前缀的所有键值对,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -2953,10 +3098,12 @@ getEntries(keyPrefix: string): Promise&lt;Entry[]&gt;; ...@@ -2953,10 +3098,12 @@ getEntries(keyPrefix: string): Promise&lt;Entry[]&gt;;
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void; getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
获取与指定 Query 对象匹配的键值对列表,并通过callback方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的键值对列表,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3002,10 +3149,12 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void; ...@@ -3002,10 +3149,12 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void;
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(query: Query): Promise&lt;Entry[]&gt;; getEntries(query: Query): Promise&lt;Entry[]&gt;
获取匹配指定键前缀的所有键值对,并通过Promise方式返回,此方法为异步方法。 获取匹配指定键前缀的所有键值对,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3057,10 +3206,12 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;; ...@@ -3057,10 +3206,12 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;;
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void; getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void
从 KvStore 数据库中获取具有指定前缀的结果集,并通过callback方式返回,此方法为异步方法。 从 KvStore 数据库中获取具有指定前缀的结果集,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3104,10 +3255,12 @@ getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;) ...@@ -3104,10 +3255,12 @@ getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;)
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt;; getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt;
从 KvStore 数据库中获取具有指定前缀的结果集,并通过Promise方式返回,此方法为异步方法。 从 KvStore 数据库中获取具有指定前缀的结果集,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3162,10 +3315,12 @@ getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt;; ...@@ -3162,10 +3315,12 @@ getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt;;
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void; getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void
获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3208,10 +3363,12 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi ...@@ -3208,10 +3363,12 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;; getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;
获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3262,10 +3419,12 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;; ...@@ -3262,10 +3419,12 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;;
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;): void; closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;): void
关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。 关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3294,10 +3453,12 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;) ...@@ -3294,10 +3453,12 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;)
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;; closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;
关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。 关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3329,10 +3490,12 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;; ...@@ -3329,10 +3490,12 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;;
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void; getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
获取与指定 Query 对象匹配的结果数,并通过callback方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的结果数,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3373,10 +3536,12 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void; ...@@ -3373,10 +3536,12 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void;
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
getResultSize(query: Query): Promise&lt;number&gt;; getResultSize(query: Query): Promise&lt;number&gt;
获取与指定 Query 对象匹配的结果数,并通过Promise方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的结果数,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3426,10 +3591,12 @@ getResultSize(query: Query): Promise&lt;number&gt;; ...@@ -3426,10 +3591,12 @@ getResultSize(query: Query): Promise&lt;number&gt;;
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void; removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void
删除指定设备的数据,并通过callback方式返回,此方法为异步方法。 删除指定设备的数据,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3466,10 +3633,12 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void; ...@@ -3466,10 +3633,12 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void;
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
removeDeviceData(deviceId: string): Promise&lt;void&gt;; removeDeviceData(deviceId: string): Promise&lt;void&gt;
删除指定设备的数据,并通过Promise方式返回,此方法为异步方法。 删除指定设备的数据,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3513,16 +3682,18 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;; ...@@ -3513,16 +3682,18 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;;
### on<sup>8+</sup> ### ### on<sup>8+</sup> ###
on(event: 'syncComplete', syncCallback: Callback<Array&lt;[string, number]&gt;): void; on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt;&gt;): void
订阅同步完成事件回调通知,此方法为同步方法。 订阅同步完成事件回调通知,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| event |'syncComplete' | 是 |同步完成时触发的事件名。 | | event |'syncComplete' | 是 |同步完成时触发的事件名。 |
| syncCallback |Callback<Array&lt;[string, number]&gt; | 是 |用于向调用方发送同步结果的回调。 | | syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 是 |用于向调用方发送同步结果的回调。 |
- 示例 - 示例
...@@ -3547,16 +3718,18 @@ on(event: 'syncComplete', syncCallback: Callback<Array&lt;[string, number]&gt;): ...@@ -3547,16 +3718,18 @@ on(event: 'syncComplete', syncCallback: Callback<Array&lt;[string, number]&gt;):
### off<sup>8+</sup> ### ### off<sup>8+</sup> ###
off(event: 'syncComplete', syncCallback?: Callback<Array&lt;[string, number]&gt;): void; off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]&gt;&gt;): void
取消订阅同步完成事件回调通知,此方法为同步方法。 取消订阅同步完成事件回调通知,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| event |'syncComplete' | 是 |同步完成时触发的事件名。 | | event |'syncComplete' | 是 |同步完成时触发的事件名。 |
| syncCallback |Callback<Array&lt;[string, number]&gt; | 否 |用于向调用方发送同步结果的回调。 | | syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 否 |用于向调用方发送同步结果的回调。 |
- 示例 - 示例
...@@ -3581,6 +3754,8 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void ...@@ -3581,6 +3754,8 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
在手动模式下,触发数据库同步,此方法为同步方法。 在手动模式下,触发数据库同步,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3598,10 +3773,12 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void ...@@ -3598,10 +3773,12 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
### setSyncParam<sup>8+</sup> ### ### setSyncParam<sup>8+</sup> ###
setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;): void; setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;): void
设置允许数据库同步的默认延迟,并通过callback方式返回,此方法为异步方法。 设置允许数据库同步的默认延迟,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3627,10 +3804,12 @@ setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;) ...@@ -3627,10 +3804,12 @@ setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;)
### setSyncParam<sup>8+</sup> ### ### setSyncParam<sup>8+</sup> ###
setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt;; setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt;
设置允许数据库同步的默认延迟,并通过Promise方式返回,此方法为异步方法。 设置允许数据库同步的默认延迟,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3663,10 +3842,12 @@ setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt;; ...@@ -3663,10 +3842,12 @@ setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt;;
### getSecurityLevel<sup>8+</sup> ### ### getSecurityLevel<sup>8+</sup> ###
getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void; getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void
获取数据库的安全级别,并通过callback方式返回,此方法为异步方法。 获取数据库的安全级别,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3689,10 +3870,12 @@ getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void; ...@@ -3689,10 +3870,12 @@ getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void;
### getSecurityLevel<sup>8+</sup> ### ### getSecurityLevel<sup>8+</sup> ###
getSecurityLevel(): Promise&lt;SecurityLevel&gt;; getSecurityLevel(): Promise&lt;SecurityLevel&gt;
获取数据库的安全级别,并通过Promise方式返回,此方法为异步方法。 获取数据库的安全级别,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 返回值: - 返回值:
| 类型 | 说明 | | 类型 | 说明 |
...@@ -3720,12 +3903,16 @@ getSecurityLevel(): Promise&lt;SecurityLevel&gt;; ...@@ -3720,12 +3903,16 @@ getSecurityLevel(): Promise&lt;SecurityLevel&gt;;
在分布式系统中按设备管理分布式数据,继承自KvStore,提供查询数据和同步数据的方法。在调用DeviceKVStore的方法前,需要先通过getKVStore构建一个DeviceKVStore实例。 在分布式系统中按设备管理分布式数据,继承自KvStore,提供查询数据和同步数据的方法。在调用DeviceKVStore的方法前,需要先通过getKVStore构建一个DeviceKVStore实例。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
### get<sup>8+</sup> ### ### get<sup>8+</sup> ###
get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|number|Uint8Array&gt;): void; get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|number|Uint8Array&gt;): void
获取与指定设备 ID 和 key 匹配的 String 值,并通过callback方式返回,此方法为异步方法。 获取与指定设备 ID 和 key 匹配的 String 值,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3756,10 +3943,12 @@ get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|num ...@@ -3756,10 +3943,12 @@ get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|num
### get<sup>8+</sup> ### ### get<sup>8+</sup> ###
get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array&gt;; get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array&gt;
获取与指定设备 ID 和 key 匹配的 String 值,并通过Promise方式返回,此方法为异步方法。 获取与指定设备 ID 和 key 匹配的 String 值,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3798,10 +3987,12 @@ get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array& ...@@ -3798,10 +3987,12 @@ get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array&
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void; getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void
获取与指定设备 ID 和 key 前缀匹配的所有键值对,并通过callback方式返回,此方法为异步方法。 获取与指定设备 ID 和 key 前缀匹配的所有键值对,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3844,10 +4035,12 @@ getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry ...@@ -3844,10 +4035,12 @@ getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt;; getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt;
获取与指定设备 ID 和 key 前缀匹配的所有键值对,并通过Promise方式返回,此方法为异步方法。 获取与指定设备 ID 和 key 前缀匹配的所有键值对,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3901,10 +4094,12 @@ getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt;; ...@@ -3901,10 +4094,12 @@ getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt;;
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void; getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
获取与指定 Query 对象匹配的键值对列表,并通过callback方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的键值对列表,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -3952,10 +4147,12 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void; ...@@ -3952,10 +4147,12 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void;
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(query: Query): Promise&lt;Entry[]&gt;; getEntries(query: Query): Promise&lt;Entry[]&gt;
获取与指定 Query 对象匹配的键值对列表,并通过Promise方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的键值对列表,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4008,10 +4205,12 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;; ...@@ -4008,10 +4205,12 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;;
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void; getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
获取与指定设备 ID 和 Query 对象匹配的键值对列表,并通过callback方式返回,此方法为异步方法。 获取与指定设备 ID 和 Query 对象匹配的键值对列表,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4060,10 +4259,12 @@ getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt ...@@ -4060,10 +4259,12 @@ getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt;; getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt;
获取与指定设备 ID 和 Query 对象匹配的键值对列表,并通过Promise方式返回,此方法为异步方法。 获取与指定设备 ID 和 Query 对象匹配的键值对列表,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4118,10 +4319,12 @@ getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt;; ...@@ -4118,10 +4319,12 @@ getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt;;
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void; getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void
获取与指定设备 ID 和 key 前缀匹配的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。 获取与指定设备 ID 和 key 前缀匹配的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4151,10 +4354,12 @@ getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvS ...@@ -4151,10 +4354,12 @@ getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvS
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&gt;; getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&gt;
获取与指定设备 ID 和 key 前缀匹配的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。 获取与指定设备 ID 和 key 前缀匹配的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4193,10 +4398,12 @@ getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&g ...@@ -4193,10 +4398,12 @@ getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&g
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void; getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void
获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4243,10 +4450,12 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi ...@@ -4243,10 +4450,12 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;; getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;
获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4305,10 +4514,12 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;; ...@@ -4305,10 +4514,12 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;;
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void; getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): void
获取与指定设备ID和Query对象匹配的KvStoreResultSet对象,并通过callback方式返回,此方法为异步方法。 获取与指定设备ID和Query对象匹配的KvStoreResultSet对象,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4355,10 +4566,12 @@ getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreR ...@@ -4355,10 +4566,12 @@ getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreR
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt;; getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt;
获取与指定设备ID和Query对象匹配的KvStoreResultSet对象,并通过Promise方式返回,此方法为异步方法。 获取与指定设备ID和Query对象匹配的KvStoreResultSet对象,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4419,10 +4632,12 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt;; ...@@ -4419,10 +4632,12 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt;;
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;): void; closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;): void
关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。 关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4452,10 +4667,12 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;) ...@@ -4452,10 +4667,12 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;)
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;; closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;
关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。 关闭由 getResultSet 返回的 KvStoreResultSet 对象,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4488,10 +4705,12 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;; ...@@ -4488,10 +4705,12 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;;
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void; getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
获取与指定 Query 对象匹配的结果数,并通过callback方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的结果数,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4533,10 +4752,12 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void; ...@@ -4533,10 +4752,12 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void;
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
getResultSize(query: Query): Promise&lt;number&gt;; getResultSize(query: Query): Promise&lt;number&gt;
获取与指定 Query 对象匹配的结果数,并通过Promise方式返回,此方法为异步方法。 获取与指定 Query 对象匹配的结果数,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4591,6 +4812,8 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number& ...@@ -4591,6 +4812,8 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number&
获取与指定设备 ID 和 Query 对象匹配的结果数,并通过callback方式返回,此方法为异步方法。 获取与指定设备 ID 和 Query 对象匹配的结果数,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4632,10 +4855,12 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number& ...@@ -4632,10 +4855,12 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number&
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
getResultSize(deviceId: string, query: Query): Promise&lt;number&gt;; getResultSize(deviceId: string, query: Query): Promise&lt;number&gt;
获取与指定设备 ID 和 Query 对象匹配的结果数,并通过Promise方式返回,此方法为异步方法。 获取与指定设备 ID 和 Query 对象匹配的结果数,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4686,10 +4911,12 @@ getResultSize(deviceId: string, query: Query): Promise&lt;number&gt;; ...@@ -4686,10 +4911,12 @@ getResultSize(deviceId: string, query: Query): Promise&lt;number&gt;;
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void; removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void
从当前数据库中删除指定设备的数据,并通过callback方式返回,此方法为异步方法。 从当前数据库中删除指定设备的数据,并通过callback方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4726,10 +4953,12 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void; ...@@ -4726,10 +4953,12 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void;
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
removeDeviceData(deviceId: string): Promise&lt;void&gt;; removeDeviceData(deviceId: string): Promise&lt;void&gt;
从当前数据库中删除指定设备的数据,并通过Promise方式返回,此方法为异步方法。 从当前数据库中删除指定设备的数据,并通过Promise方式返回,此方法为异步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4773,10 +5002,12 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;; ...@@ -4773,10 +5002,12 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;;
### sync<sup>8+</sup> ### ### sync<sup>8+</sup> ###
sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void; sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
在手动模式下,触发数据库同步,此方法为同步方法。 在手动模式下,触发数据库同步,此方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4809,10 +5040,12 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void; ...@@ -4809,10 +5040,12 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void;
### on<sup>8+</sup> ### ### on<sup>8+</sup> ###
on(event: 'syncComplete', syncCallback: Callback<Arrary&lt;<[string, number]&gt;): void; on(event: 'syncComplete', syncCallback: Callback&lt;Arrary&lt;[string, number]&gt;&gt;): void
订阅同步完成事件回调通知,该方法为同步方法。 订阅同步完成事件回调通知,该方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
...@@ -4841,16 +5074,18 @@ on(event: 'syncComplete', syncCallback: Callback<Arrary&lt;<[string, number]&gt; ...@@ -4841,16 +5074,18 @@ on(event: 'syncComplete', syncCallback: Callback<Arrary&lt;<[string, number]&gt;
### off<sup>8+</sup> ### ### off<sup>8+</sup> ###
off(event: 'syncComplete', syncCallback?: Callback<Array&lt;[string, number]&gt;): void; off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]&gt;&gt;): void
取消订阅同步完成事件回调通知,该方法为同步方法。 取消订阅同步完成事件回调通知,该方法为同步方法。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
- 参数: - 参数:
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| event |'syncComplete' | 是 |同步完成时触发的事件名。 | | event |'syncComplete' | 是 |同步完成时触发的事件名。 |
| syncCallback |Callback<Arrary&lt;<[string, number]&gt; | 否 |用于向调用方发送同步结果的回调。 | | syncCallback |Callback<Arrary&lt;[string, number]&gt;&gt; | 否 |用于向调用方发送同步结果的回调。 |
- 示例 - 示例
...@@ -4873,6 +5108,8 @@ off(event: 'syncComplete', syncCallback?: Callback<Array&lt;[string, number]&gt; ...@@ -4873,6 +5108,8 @@ off(event: 'syncComplete', syncCallback?: Callback<Array&lt;[string, number]&gt;
用于指定同步模式。 用于指定同步模式。
**系统能力**:以下各项对应的系统能力均为 SystemCapability.DistributedDataManager.KVStore.Core。
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| ----- | ------ | ----------------------- | | ----- | ------ | ----------------------- |
| PULL_ONLY |0 |表示只能从远端拉取数据到本端。 | | PULL_ONLY |0 |表示只能从远端拉取数据到本端。 |
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册