Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
“6d5744b40b05c1450ba2123631ae328e4d521c39”上不存在“...fluid/tests/git@gitcode.net:Crayonxin2000/Paddle.git”
未验证 提交 e02e7657 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!2820 js-apis-distributed-data.md代码块样式修改&轻量级存储开发指南重命名 

Merge pull request !2820 from 葛亚芳/OpenHarmony-3.1-Release
上级 71d300d0 e931c9de
隐藏空白更改
内联 并排
Showing with 2516 addition and 2200 deletion
zh-cn/application-dev/ability/fa-formability.md
浏览文件 @ e02e7657
...@@ -231,7 +231,7 @@ Form需要在应用配置文件config.json中进行配置。 ...@@ -231,7 +231,7 @@ Form需要在应用配置文件config.json中进行配置。
} }
``` ```
具体的持久化方法可以参考[轻量级数据存储开发指导](../database/database-preference-guidelines.md)。 具体的持久化方法可以参考[轻量级数据存储开发指导](../database/database-storage-guidelines.md)。
需要注意的是，卡片使用方在请求卡片时传递给提供方应用的Want数据中存在临时标记字段，表示此次请求的卡片是否为临时卡片： 需要注意的是，卡片使用方在请求卡片时传递给提供方应用的Want数据中存在临时标记字段，表示此次请求的卡片是否为临时卡片：
......
zh-cn/application-dev/ability/stage-formextension.md 0 → 100644
浏览文件 @ e02e7657
# Stage卡片开发指导
## 卡片概述
卡片是一种界面展示形式，可以将应用的重要信息或操作前置到卡片，以达到服务直达，减少体验层级的目的。
卡片常用于嵌入到其他应用（当前只支持系统应用）中作为其界面的一部分显示，并支持拉起页面，发送消息等基础的交互功能。卡片使用方负责显示卡片。
卡片的基本概念：
- 卡片提供方
提供卡片显示内容原子化服务，控制卡片的显示内容、控件布局以及控件点击事件。
- 卡片使用方
显示卡片内容的宿主应用，控制卡片在宿主中展示的位置。
- 卡片管理服务
用于管理系统中所添加卡片的常驻代理服务，包括卡片对象的管理与使用，以及卡片周期性刷新等。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 卡片使用方和提供方不要求常驻运行，在需要添加/删除/请求更新卡片时，卡片管理服务会拉起卡片提供方获取卡片信息。
开发者仅需作为卡片提供方进行卡片内容的开发，卡片使用方和卡片管理服务由系统自动处理。
卡片提供方控制卡片实际显示的内容、控件布局以及点击事件。
## 场景介绍
Stage卡片开发，即基于[Stage模型综述](stage-brief.md)的卡片提供方开发，主要涉及如下功能逻辑：
- 卡片生命周期回调函数FormExtension开发。
- 创建卡片数据FormBindingData对象。
- 通过FormProvider更新卡片。
- 卡片页面开发。
## 接口说明
FormExtension功能如下：FormExtension类，拥有context属性，具体的API详见[接口文档](../reference/apis/js-apis-formextension.md)。
**表1** FormExtension API接口功能介绍
| 接口名 | 描述 |
| :----------------------------------------------------------- | :------------------------------------------- |
| onCreate(want: Want): formBindingData.FormBindingData | 卡片提供方接收创建卡片的通知接口。 |
| onCastToNormal(formId: string): void | 卡片提供方接收临时卡片转常态卡片的通知接口。 |
| onUpdate(formId: string): void | 卡片提供方接收更新卡片的通知接口。 |
| onVisibilityChange(newStatus: { [key: string]: number }): void | 卡片提供方接收修改可见性的通知接口。 |
| onEvent(formId: string, message: string): void | 卡片提供方接收处理卡片事件的通知接口。 |
| onDestroy(formId: string): void | 卡片提供方接收销毁卡片的通知接口。 |
| onConfigurationUpdated(config: Configuration): void; | 当系统配置更新时调用。 |
FormExtension类拥有context属性，context属性为FormExtensionContext类，具体的API详见[接口文档](../reference/apis/js-apis-formextensioncontext.md)。
**表2** FormExtensionContext API接口功能介绍
| 接口名 | 描述 |
| :----------------------------------------------------------- | :------------------------ |
| updateForm(formId: string, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback\<void>): void | 回调形式主动更新卡片。 |
| updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise\<void> | Promise形式主动更新卡片。 |
FormProvider类具体的API详见[接口文档](../reference/apis/js-apis-formprovider.md)。
**表3** FormProvider API接口功能介绍
| 接口名 | 描述 |
| :----------------------------------------------------------- | :------------------------------------------------ |
| setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback&lt;void&gt;): void; | 设置指定卡片的下一次更新时间。 |
| setFormNextRefreshTime(formId: string, minute: number): Promise&lt;void&gt;; | 设置指定卡片的下一次更新时间，以promise方式返回。 |
| updateForm(formId: string, formBindingData: FormBindingData, callback: AsyncCallback&lt;void&gt;): void; | 更新指定的卡片。 |
| updateForm(formId: string, formBindingData: FormBindingData): Promise&lt;void&gt;; | 更新指定的卡片，以promise方式返回。 |
## 开发步骤
### 创建卡片FormExtension
创建Stage模型的卡片，需实现FormExtension生命周期接口。具体示例代码如下：
1. 导入相关模块
```javascript
import FormExtension from '@ohos.application.FormExtension'
import formBindingData from '@ohos.application.formBindingData'
import formInfo from '@ohos.application.formInfo'
import formProvider from '@ohos.application.formProvider'
```
2. 实现FormExtension生命周期接口
```javascript
export default class FormAbility extends FormExtension {
onCreate(want) {
console.log('FormAbility onCreate');
// 由开发人员自行实现，将创建的卡片信息持久化，以便在下次获取/更新该卡片实例时进行使用
let obj = {
"title": "titleOnCreate",
"detail": "detailOnCreate"
};
let formData = formBindingData.createFormBindingData(obj);
return formData;
}
onCastToNormal(formId) {
// 使用方将临时卡片转换为常态卡片触发，提供方需要做相应的处理
console.log('FormAbility onCastToNormal');
}
onUpdate(formId) {
// 若卡片支持定时更新/定点更新/卡片使用方主动请求更新功能，则提供方需要覆写该方法以支持数据更新
console.log('FormAbility onUpdate');
let obj = {
"title": "titleOnUpdate",
"detail": "detailOnUpdate"
};
let formData = formBindingData.createFormBindingData(obj);
formProvider.updateForm(formId, formData).catch((error) => {
console.log('FormAbility updateForm, error:' + JSON.stringify(error));
});
}
onVisibilityChange(newStatus) {
// 使用方发起可见或者不可见通知触发，提供方需要做相应的处理
console.log('FormAbility onVisibilityChange');
}
onEvent(formId, message) {
// 若卡片支持触发事件，则需要覆写该方法并实现对事件的触发
console.log('FormAbility onEvent');
}
onDestroy(formId) {
// 删除卡片实例数据
console.log('FormAbility onDestroy');
}
onAcquireFormState(want) {
console.log('FormAbility onAcquireFormState');
return formInfo.FormState.READY;
}
}
```
### 配置卡片配置文件
Form需要在应用配置文件module.json中进行配置。
- extensionAbility模块，内部字段结构说明：
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| ----------- | ------------------------------------------------------------ | ---------- | -------------------- |
| name | 表示extensionAbility的名字。该标签不可缺省。 | 字符串 | 否 |
| srcEntrance | 表示extensionAbility所对应的JS的代码路径。该标签不可缺省。 | 字符串 | 否 |
| description | 表示extensionAbility的描述。可以是表示描述内容的字符串，也可以是对描述内容的资源索引以支持多语言。 | 字符串 | 可缺省，缺省值为空。 |
| icon | 表示extensionAbility的图标资源文件的索引。 | 字符串 | 可缺省，缺省值为空。 |
| label | 表示extensionAbility的标签信息，即extensionAbility对外显示的文字描述信息。取值可以是描述性内容，也可以是标识label的资源索引。 | 字符串 | 可缺省，缺省值为空。 |
| type | 表示extensionAbility的类型。取值form、service等 | 字符串 | 否 |
| permissions | 表示其他应用的Ability调用此Ability时需要申请的权限。 | 字符串数组 | 可缺省，缺省值为空。 |
| metadata | 表示extensionAbility的元信息。用于描述extensionAbility的配置信息。 | 对象 | 可缺省，缺省值为空 |
对于FormExtensionAbility来说，type需要配置为form，并且需要填写metadata元信息，用于配置卡片的具体信息。
配置示例如下：
```json
"extensionAbilities": [{
"name": "FormAbility",
"srcEntrance": "./ets/FormAbility/FormAbility.ts",
"label": "$string:form_FormAbility_label",
"description": "$string:form_FormAbility_desc",
"type": "form",
"metadata": [{
"name": "ohos.extension.form",
"resource": "$profile:form_config"
}]
}]
```
- 卡片profile模块。在 FormExtensionAbility 的元信息中，需要使用 ohos.extension.form 指定的资源文件的路径，如使用 $profile:form_config 指定开发视图的 resources/base/profile/ 目录下的 form_config.json 作为卡片profile配置文件。
内部字段结构说明：
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| ------------------- | ------------------------------------------------------------ | ---------- | ------------------------ |
| name | 表示卡片的类名。字符串最大长度为127字节。 | 字符串 | 否 |
| description | 表示卡片的描述。取值可以是描述性内容，也可以是对描述性内容的资源索引，以支持多语言。字符串最大长度为255字节。 | 字符串 | 可缺省，缺省为空。 |
| src | 表示卡片对应的UI代码的完整路径。 | 字符串 | 否 |
| window | 用于定义与显示窗口相关的配置。 | 对象 | 可缺省 |
| isDefault | 表示该卡片是否为默认卡片，每个Ability有且只有一个默认卡片。<br />true：默认卡片。<br />false：非默认卡片。 | 布尔值 | 否 |
| colorMode | 表示卡片的主题样式，取值范围如下：<br />auto：自适应。<br />dark：深色主题。<br />light：浅色主题。 | 字符串 | 可缺省，缺省值为“auto”。 |
| supportDimensions | 表示卡片支持的外观规格，取值范围：<br />1 * 2：表示1行2列的二宫格。<br />2 * 2：表示2行2列的四宫格。<br />2 * 4：表示2行4列的八宫格。<br />4 * 4：表示4行4列的十六宫格。 | 字符串数组 | 否 |
| defaultDimension | 表示卡片的默认外观规格，取值必须在该卡片supportDimensions配置的列表中。 | 字符串 | 否 |
| updateEnabled | 表示卡片是否支持周期性刷新，取值范围：<br />true：表示支持周期性刷新，可以在定时刷新（updateDuration）和定点刷新（scheduledUpdateTime）两种方式任选其一，优先选择定时刷新。<br />false：表示不支持周期性刷新。 | 布尔类型 | 否 |
| scheduledUpdateTime | 表示卡片的定点刷新的时刻，采用24小时制，精确到分钟。 | 字符串 | 可缺省，缺省值为“0:0”。 |
| updateDuration | 表示卡片定时刷新的更新周期，单位为30分钟，取值为自然数。<br />当取值为0时，表示该参数不生效。<br />当取值为正整数N时，表示刷新周期为30*N分钟。 | 数值 | 可缺省，缺省值为“0”。 |
| formConfigAbility | 表示用于调整卡片的设施或活动的名称。 | 字符串 | 可缺省，缺省值为空。 |
| formVisibleNotify | 标识是否允许卡片使用卡片可见性通知 | 字符串 | 可缺省，缺省值为空。 |
| metaData | 表示卡片的自定义信息，包含customizeData数组标签。 | 对象 | 可缺省，缺省值为空。 |
配置示例如下：
```json
{
"forms": [{
"name": "widget",
"description": "This is a service widget.",
"src": "./js/widget/pages/index/index",
"window": {
"autoDesignWidth": true,
"designWidth": 720
},
"isDefault": true,
"colorMode": "auto",
"supportDimensions": ["2*2"],
"defaultDimension": "2*2",
"updateEnabled": true,
"scheduledUpdateTime": "10:30",
"updateDuration": 1
}]
}
```
### 卡片信息的持久化
因大部分卡片提供方都不是常驻服务，只有在需要使用时才会被拉起获取卡片信息，且卡片管理服务支持对卡片进行多实例管理，卡片ID对应实例ID，因此若卡片提供方支持对卡片数据进行配置，则需要对卡片的业务数据按照卡片ID进行持久化管理，以便在后续获取、更新以及拉起时能获取到正确的卡片业务数据。
```javascript
onCreate(want) {
console.log('FormAbility onCreate');
let formId = want.parameters["ohos.extra.param.key.form_identity"];
let formName = want.parameters["ohos.extra.param.key.form_name"];
let tempFlag = want.parameters["ohos.extra.param.key.form_temporary"];
// 由开发人员自行实现，将创建的卡片信息持久化，以便在下次获取/更新该卡片实例时进行使用
storeFormInfo(formId, formName, tempFlag, want);
let obj = {
"title": "titleOnCreate",
"detail": "detailOnCreate"
};
let formData = formBindingData.createFormBindingData(obj);
return formData;
}
```
且需要适配onDestroy卡片删除通知接口，在其中实现卡片实例数据的删除。
```javascript
onDestroy(formId) {
// 删除卡片实例数据
deleteFormInfo(formId);
console.log('FormAbility onDestroy');
}
```
具体的持久化方法可以参考[轻量级数据存储开发指导](../database/database-storage-guidelines.md)。
需要注意的是，卡片使用方在请求卡片时传递给提供方应用的Want数据中存在临时标记字段，表示此次请求的卡片是否为临时卡片：
常态卡片：卡片使用方会持久化的卡片；
临时卡片：卡片使用方不会持久化的卡片；
由于临时卡片的数据具有非持久化的特殊性，某些场景比如卡片服务框架死亡重启，此时临时卡片数据在卡片管理服务中已经删除，且对应的卡片ID不会通知到提供方，所以卡片提供方需要自己负责清理长时间未删除的临时卡片数据。同时对应的卡片使用方可能会将之前请求的临时卡片转换为常态卡片。如果转换成功，卡片提供方也需要对对应的临时卡片ID进行处理，把卡片提供方记录的临时卡片数据转换为常态卡片数据，防止提供方在清理长时间未删除的临时卡片时，把已经转换为常态卡片的临时卡片信息删除，导致卡片信息丢失。
### 开发卡片页面
开发者可以使用hml+css+json开发JS卡片页面：
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 当前仅支持JS扩展的类Web开发范式来实现卡片的UI页面。
- hml:
```html
<div class="container">
<stack>
<div class="container-img">
<image src="/common/widget.png" class="bg-img"></image>
</div>
<div class="container-inner">
<text class="title">{{title}}</text>
<text class="detail_text" onclick="routerEvent">{{detail}}</text>
</div>
</stack>
</div>
```
- css:
```css
.container {
flex-direction: column;
justify-content: center;
align-items: center;
}
.bg-img {
flex-shrink: 0;
height: 100%;
}
.container-inner {
flex-direction: column;
justify-content: flex-end;
align-items: flex-start;
height: 100%;
width: 100%;
padding: 12px;
}
.title {
font-size: 19px;
font-weight: bold;
color: white;
text-overflow: ellipsis;
max-lines: 1;
}
.detail_text {
font-size: 16px;
color: white;
opacity: 0.66;
text-overflow: ellipsis;
max-lines: 1;
margin-top: 6px;
}
```
- json:
```json
{
"data": {
"title": "TitleDefault",
"detail": "TextDefault"
},
"actions": {
"routerEvent": {
"action": "router",
"abilityName": "com.example.MyApplication.hmservice.FormAbility",
"params": {
"message": "add detail"
}
}
}
}
```
最终可以得到，如下卡片：
![fa-form-example](figures/fa-form-example.png)
\ No newline at end of file
zh-cn/application-dev/application-dev-website.md
浏览文件 @ e02e7657
...@@ -208,8 +208,8 @@ ...@@ -208,8 +208,8 @@
- [关系型数据库概述](database/database-relational-overview.md) - [关系型数据库概述](database/database-relational-overview.md)
- [关系型数据库开发指导](database/database-relational-guidelines.md) - [关系型数据库开发指导](database/database-relational-guidelines.md)
- 轻量级数据存储 - 轻量级数据存储
- [轻量级数据存储概述](database/database-preference-overview.md) - [轻量级数据存储概述](database/database-storage-overview.md)
- [轻量级数据存储开发指导](database/database-preference-guidelines.md) - [轻量级数据存储开发指导](database/database-storage-guidelines.md)
- 分布式数据对象 - 分布式数据对象
- [分布式数据对象概述](database/database-distributedobject-overview.md) - [分布式数据对象概述](database/database-distributedobject-overview.md)
- [分布式数据对象开发指导](database/database-distributedobject-guidelines.md) - [分布式数据对象开发指导](database/database-distributedobject-guidelines.md)
...@@ -533,7 +533,7 @@ ...@@ -533,7 +533,7 @@
- [访问控制](reference/apis/js-apis-abilityAccessCtrl.md) - [访问控制](reference/apis/js-apis-abilityAccessCtrl.md)
- [通用密钥库系统](reference/apis/js-apis-huks.md) - [通用密钥库系统](reference/apis/js-apis-huks.md)
- 数据管理 - 数据管理
- [轻量级存储](reference/apis/js-apis-data-preferences.md) - [轻量级存储](reference/apis/js-apis-data-storage.md)
- [分布式数据管理](reference/apis/js-apis-distributed-data.md) - [分布式数据管理](reference/apis/js-apis-distributed-data.md)
- [关系型数据库](reference/apis/js-apis-data-rdb.md) - [关系型数据库](reference/apis/js-apis-data-rdb.md)
- [结果集](reference/apis/js-apis-data-resultset.md) - [结果集](reference/apis/js-apis-data-resultset.md)
......
zh-cn/application-dev/database/Readme-CN.md
浏览文件 @ e02e7657
...@@ -7,8 +7,8 @@ ...@@ -7,8 +7,8 @@
- [关系型数据库概述](database-relational-overview.md) - [关系型数据库概述](database-relational-overview.md)
- [关系型数据库开发指导](database-relational-guidelines.md) - [关系型数据库开发指导](database-relational-guidelines.md)
- 轻量级数据存储 - 轻量级数据存储
- [轻量级数据存储概述](database-preference-overview.md) - [轻量级数据存储概述](database-storage-overview.md)
- [轻量级数据存储开发指导](database-preference-guidelines.md) - [轻量级数据存储开发指导](database-storage-guidelines.md)
- 分布式数据对象 - 分布式数据对象
- [分布式数据对象概述](database-distributedobject-overview.md) - [分布式数据对象概述](database-distributedobject-overview.md)
- [分布式数据对象开发指导](database-distributedobject-guidelines.md) - [分布式数据对象开发指导](database-distributedobject-guidelines.md)
zh-cn/application-dev/reference/apis/js-apis-distributed-data.md
浏览文件 @ e02e7657
...@@ -27,27 +27,28 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt ...@@ -27,27 +27,28 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt
| callback | AsyncCallback&lt;[KVManager](#kvmanager)&gt; | 是 | KVManager实例创建时调用的回调，返回KVManager对象实例。 | | callback | AsyncCallback&lt;[KVManager](#kvmanager)&gt; | 是 | KVManager实例创建时调用的回调，返回KVManager对象实例。 |
**示例**： **示例**：
```
let kvManager; let kvManager;
try { try {
const kvManagerConfig = { const kvManagerConfig = {
bundleName : 'com.example.datamanagertest', bundleName : 'com.example.datamanagertest',
userInfo : { userInfo : {
userId : '0', userId : '0',
userType : distributedData.UserType.SAME_USER_ID userType : distributedData.UserType.SAME_USER_ID
}
} }
distributedData.createKVManager(kvManagerConfig, function (err, manager) {
if (err) {
console.log("createKVManager err: " + JSON.stringify(err));
return;
}
console.log("createKVManager success");
kvManager = manager;
});
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
} }
distributedData.createKVManager(kvManagerConfig, function (err, manager) {
if (err) {
console.log("createKVManager err: " + JSON.stringify(err));
return;
}
console.log("createKVManager success");
kvManager = manager;
});
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
}
```
## distributedData.createKVManager ## distributedData.createKVManager
...@@ -71,25 +72,26 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -71,25 +72,26 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
**示例**： **示例**：
let kvManager; ```
try { let kvManager;
const kvManagerConfig = { try {
bundleName : 'com.example.datamanagertest', const kvManagerConfig = {
userInfo : { bundleName : 'com.example.datamanagertest',
userId : '0', userInfo : {
userType : distributedData.UserType.SAME_USER_ID userId : '0',
} userType : distributedData.UserType.SAME_USER_ID
} }
distributedData.createKVManager(kvManagerConfig).then((manager) => {
console.log("createKVManager success");
kvManager = manager;
}).catch((err) => {
console.log("createKVManager err: " + JSON.stringify(err));
});
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
} }
distributedData.createKVManager(kvManagerConfig).then((manager) => {
console.log("createKVManager success");
kvManager = manager;
}).catch((err) => {
console.log("createKVManager err: " + JSON.stringify(err));
});
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
}
```
## KVManagerConfig ## KVManagerConfig
...@@ -102,8 +104,6 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -102,8 +104,6 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
| userInfo | [UserInfo](#userinfo) | 是 | 调用方的用户信息。 | | userInfo | [UserInfo](#userinfo) | 是 | 调用方的用户信息。 |
| bundleName | string | 是 | 调用方的包名。 | | bundleName | string | 是 | 调用方的包名。 |
## UserInfo ## UserInfo
用户信息。 用户信息。
...@@ -131,8 +131,6 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -131,8 +131,6 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
数据管理实例，用于获取KVStore的相关信息。在调用KVManager的方法前，需要先通过createKVManager构建一个KVManager实例。 数据管理实例，用于获取KVStore的相关信息。在调用KVManager的方法前，需要先通过createKVManager构建一个KVManager实例。
### getKVStore ### getKVStore
getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options, callback: AsyncCallback&lt;T&gt;): void getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options, callback: AsyncCallback&lt;T&gt;): void
...@@ -151,30 +149,30 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options, callback: ...@@ -151,30 +149,30 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options, callback:
**示例**： **示例**：
``` ```
let kvStore; let kvStore;
let kvManager; let kvManager;
try { try {
const options = { const options = {
createIfMissing : true, createIfMissing : true,
encrypt : false, encrypt : false,
backup : false, backup : false,
autoSync : true, autoSync : true,
kvStoreType : distributedData.KVStoreType.SINGLE_VERSION, kvStoreType : distributedData.KVStoreType.SINGLE_VERSION,
securityLevel : distributedData.SecurityLevel.S2, securityLevel : distributedData.SecurityLevel.S2,
}; };
kvManager.getKVStore('storeId', options, function (err, store) { kvManager.getKVStore('storeId', options, function (err, store) {
if (err) { if (err) {
console.log("getKVStore err: " + JSON.stringify(err)); console.log("getKVStore err: " + JSON.stringify(err));
return; return;
} }
console.log("getKVStore success"); console.log("getKVStore success");
kvStore = store; kvStore = store;
}); });
} catch (e) { } catch (e) {
console.log("An unexpected error occurred. Error:" + e); console.log("An unexpected error occurred. Error:" + e);
} }
``` ```
### getKVStore ### getKVStore
...@@ -199,31 +197,30 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options): Promise& ...@@ -199,31 +197,30 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options): Promise&
| -------------------------------------- | ------------------------ | | -------------------------------------- | ------------------------ |
| Promise&lt;T&gt; &lt;T extends KVStore&gt; | 指定的Promise回调方法，返回创建的KVStore数据库实例。 | | Promise&lt;T&gt; &lt;T extends KVStore&gt; | 指定的Promise回调方法，返回创建的KVStore数据库实例。 |
**示例**： **示例**：
``` ```
let kvStore; let kvStore;
let kvManager; let kvManager;
try { try {
const options = { const options = {
createIfMissing : true, createIfMissing : true,
encrypt : false, encrypt : false,
backup : false, backup : false,
autoSync : true, autoSync : true,
kvStoreType : distributedData.KVStoreType.SINGLE_VERSION, kvStoreType : distributedData.KVStoreType.SINGLE_VERSION,
securityLevel : distributedData.SecurityLevel.S2, securityLevel : distributedData.SecurityLevel.S2,
}; };
kvManager.getKVStore('storeId', options).then((store) => { kvManager.getKVStore('storeId', options).then((store) => {
console.log("getKVStore success"); console.log("getKVStore success");
kvStore = store; kvStore = store;
}).catch((err) => { }).catch((err) => {
console.log("getKVStore err: " + JSON.stringify(err)); console.log("getKVStore err: " + JSON.stringify(err));
}); });
} catch (e) { } catch (e) {
console.log("An unexpected error occurred. Error:" + e); console.log("An unexpected error occurred. Error:" + e);
} }
``` ```
### closeKVStore<sup>8+</sup> ### ### closeKVStore<sup>8+</sup> ###
...@@ -243,33 +240,33 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCa ...@@ -243,33 +240,33 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCa
| kvStore | [KVStore](#kvstore) | 是 | 要关闭的KvStore数据库。 | | kvStore | [KVStore](#kvstore) | 是 | 要关闭的KvStore数据库。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，如果数据库关闭成功则返回true，否则返回false。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，如果数据库关闭成功则返回true，否则返回false。 |
**示例**： **示例**：
``` ```
let kvStore; let kvStore;
let kvManager; let kvManager;
const options = { const options = {
createIfMissing : true, createIfMissing : true,
encrypt : false, encrypt : false,
backup : false, backup : false,
autoSync : true, autoSync : true,
kvStoreType : distributedData.KVStoreType.SINGLE_VERSION, kvStoreType : distributedData.KVStoreType.SINGLE_VERSION,
schema : '', schema : '',
securityLevel : distributedData.SecurityLevel.S2, securityLevel : distributedData.SecurityLevel.S2,
} }
try { try {
kvManager.getKVStore('storeId', options, async function (err, store) { kvManager.getKVStore('storeId', options, async function (err, store) {
console.log('getKVStore success'); console.log('getKVStore success');
kvStore = store; kvStore = store;
await kvManager.closeKVStore('appId', 'storeId', kvStore, function (err, data) { await kvManager.closeKVStore('appId', 'storeId', kvStore, function (err, data) {
console.log('closeKVStore success'); console.log('closeKVStore success');
}); });
}); });
} catch (e) { } catch (e) {
console.log('closeKVStore e ' + e); console.log('closeKVStore e ' + e);
} }
``` ```
### closeKVStore<sup>8+</sup> ### ### closeKVStore<sup>8+</sup> ###
...@@ -295,34 +292,34 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void& ...@@ -295,34 +292,34 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void&
**示例**： **示例**：
``` ```
let kvManager; let kvManager;
let kvStore; let kvStore;
const options = { const options = {
createIfMissing : true, createIfMissing : true,
encrypt : false, encrypt : false,
backup : false, backup : false,
autoSync : true, autoSync : true,
kvStoreType : distributedData.KVStoreType.SINGLE_VERSION, kvStoreType : distributedData.KVStoreType.SINGLE_VERSION,
schema : '', schema : '',
securityLevel : distributedData.SecurityLevel.S2, securityLevel : distributedData.SecurityLevel.S2,
} }
try { try {
kvManager.getKVStore('storeId', options).then(async (store) => { kvManager.getKVStore('storeId', options).then(async (store) => {
console.log('getKVStore success'); console.log('getKVStore success');
kvStore = store; kvStore = store;
await kvManager.closeKVStore('appId', 'storeId', kvStore).then(() => { await kvManager.closeKVStore('appId', 'storeId', kvStore).then(() => {
console.log('closeKVStore success'); console.log('closeKVStore success');
}).catch((err) => { }).catch((err) => {
console.log('closeKVStore err ' + JSON.stringify(err)); console.log('closeKVStore err ' + JSON.stringify(err));
}); });
}).catch((err) => { }).catch((err) => {
console.log('CloseKVStore getKVStore err ' + JSON.stringify(err)); console.log('CloseKVStore getKVStore err ' + JSON.stringify(err));
}); });
} catch (e) { } catch (e) {
console.log('closeKVStore e ' + e); console.log('closeKVStore e ' + e);
} }
``` ```
### deleteKVStore<sup>8+</sup> ### ### deleteKVStore<sup>8+</sup> ###
...@@ -341,33 +338,32 @@ deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt ...@@ -341,33 +338,32 @@ deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt
| storeId | string | 是 | 要删除的数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 | | storeId | string | 是 | 要删除的数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，如果成功返回true，否则返回false。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，如果成功返回true，否则返回false。 |
**示例**： **示例**：
``` ```
let kvManager; let kvManager;
let kvStore; let kvStore;
const options = { const options = {
createIfMissing : true, createIfMissing : true,
encrypt : false, encrypt : false,
backup : false, backup : false,
autoSync : true, autoSync : true,
kvStoreType : distributedData.KVStoreType.SINGLE_VERSION, kvStoreType : distributedData.KVStoreType.SINGLE_VERSION,
schema : '', schema : '',
securityLevel : distributedData.SecurityLevel.S2, securityLevel : distributedData.SecurityLevel.S2,
} }
try { try {
kvManager.getKVStore('store', options, async function (err, store) { kvManager.getKVStore('store', options, async function (err, store) {
console.log('getKVStore success'); console.log('getKVStore success');
kvStore = store; kvStore = store;
await kvManager.deleteKVStore('appId', 'storeId', function (err, data) { await kvManager.deleteKVStore('appId', 'storeId', function (err, data) {
console.log('deleteKVStore success'); console.log('deleteKVStore success');
});
}); });
} catch (e) { });
console.log('DeleteKVStore e ' + e); } catch (e) {
} console.log('DeleteKVStore e ' + e);
``` }
```
### deleteKVStore<sup>8+</sup> ### ### deleteKVStore<sup>8+</sup> ###
...@@ -393,34 +389,34 @@ deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt; ...@@ -393,34 +389,34 @@ deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt;
**示例**： **示例**：
``` ```
let kvManager; let kvManager;
let kvStore; let kvStore;
const options = { const options = {
createIfMissing : true, createIfMissing : true,
encrypt : false, encrypt : false,
backup : false, backup : false,
autoSync : true, autoSync : true,
kvStoreType : distributedData.KVStoreType.SINGLE_VERSION, kvStoreType : distributedData.KVStoreType.SINGLE_VERSION,
schema : '', schema : '',
securityLevel : distributedData.SecurityLevel.S2, securityLevel : distributedData.SecurityLevel.S2,
} }
try { try {
kvManager.getKVStore('storId', options).then(async (store) => { kvManager.getKVStore('storId', options).then(async (store) => {
console.log('getKVStore success'); console.log('getKVStore success');
kvStore = store; kvStore = store;
await kvManager.deleteKVStore('appId', 'storeId').then(() => { await kvManager.deleteKVStore('appId', 'storeId').then(() => {
console.log('deleteKVStore success'); console.log('deleteKVStore success');
}).catch((err) => {
console.log('deleteKVStore err ' + JSON.stringify(err));
});
}).catch((err) => { }).catch((err) => {
console.log('getKVStore err ' + JSON.stringify(err)); console.log('deleteKVStore err ' + JSON.stringify(err));
}); });
} catch (e) { }).catch((err) => {
console.log('deleteKVStore e ' + e); console.log('getKVStore err ' + JSON.stringify(err));
} });
``` } catch (e) {
console.log('deleteKVStore e ' + e);
}
```
### getAllKVStoreId<sup>8+</sup> ### ### getAllKVStoreId<sup>8+</sup> ###
...@@ -440,17 +436,17 @@ getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void ...@@ -440,17 +436,17 @@ getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void
**示例**： **示例**：
``` ```
let kvManager; let kvManager;
try { try {
kvManager.getAllKVStoreId('appId', function (err, data) { kvManager.getAllKVStoreId('appId', function (err, data) {
console.log('GetAllKVStoreId success'); console.log('GetAllKVStoreId success');
console.log('GetAllKVStoreId size = ' + data.length); console.log('GetAllKVStoreId size = ' + data.length);
}); });
} catch (e) { } catch (e) {
console.log('GetAllKVStoreId e ' + e); console.log('GetAllKVStoreId e ' + e);
} }
``` ```
### getAllKVStoreId<sup>8+</sup> ### ### getAllKVStoreId<sup>8+</sup> ###
...@@ -476,20 +472,20 @@ getAllKVStoreId(appId: string): Promise&lt;string[]&gt; ...@@ -476,20 +472,20 @@ getAllKVStoreId(appId: string): Promise&lt;string[]&gt;
**示例**： **示例**：
``` ```
let kvManager; let kvManager;
try { try {
console.log('GetAllKVStoreId'); console.log('GetAllKVStoreId');
kvManager.getAllKVStoreId('apppId').then((data) => { kvManager.getAllKVStoreId('apppId').then((data) => {
console.log('getAllKVStoreId success'); console.log('getAllKVStoreId success');
console.log('size = ' + data.length); console.log('size = ' + data.length);
}).catch((err) => { }).catch((err) => {
console.log('getAllKVStoreId err ' + JSON.stringify(err)); console.log('getAllKVStoreId err ' + JSON.stringify(err));
}); });
} catch(e) { } catch(e) {
console.log('getAllKVStoreId e ' + e); console.log('getAllKVStoreId e ' + e);
} }
``` ```
### on<sup>8+</sup> ### ### on<sup>8+</sup> ###
...@@ -507,23 +503,21 @@ on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): voi ...@@ -507,23 +503,21 @@ on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): voi
| event | 'distributedDataServiceDie' | 是 | 服务状态改变时触发的事件名。 | | event | 'distributedDataServiceDie' | 是 | 服务状态改变时触发的事件名。 |
| deathCallback | Callback&lt;void&gt; | 是 | 回调函数，在设备状态改变时获取通知。 | | deathCallback | Callback&lt;void&gt; | 是 | 回调函数，在设备状态改变时获取通知。 |
**示例** **示例**
``` ```
let kvManager; let kvManager;
try { try {
console.log('KVManagerOn'); console.log('KVManagerOn');
const deathCallback = function () { const deathCallback = function () {
console.log('death callback call'); console.log('death callback call');
}
kvManager.on('distributedDataServiceDie', deathCallback);
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
} }
``` kvManager.on('distributedDataServiceDie', deathCallback);
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
}
```
### off<sup>8+</sup> ### ### off<sup>8+</sup> ###
...@@ -544,19 +538,19 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v ...@@ -544,19 +538,19 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v
**示例** **示例**
``` ```
let kvManager; let kvManager;
try { try {
console.log('KVManagerOff'); console.log('KVManagerOff');
const deathCallback = function () { const deathCallback = function () {
console.log('death callback call'); console.log('death callback call');
}
kvManager.off('distributedDataServiceDie', deathCallback);
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
} }
kvManager.off('distributedDataServiceDie', deathCallback);
} catch (e) {
console.log("An unexpected error occurred. Error:" + e);
}
``` ```
## Options ## Options
...@@ -588,7 +582,6 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v ...@@ -588,7 +582,6 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v
| MULTI_VERSION | 2 | 表示多版本数据库。此类型当前不允许使用。 | | MULTI_VERSION | 2 | 表示多版本数据库。此类型当前不允许使用。 |
## SecurityLevel ## SecurityLevel
用于指定创建的数据库的安全级别。 用于指定创建的数据库的安全级别。
...@@ -629,7 +622,7 @@ KVStore常量。 ...@@ -629,7 +622,7 @@ KVStore常量。
| 名称 | 类型 | 说明 | | 名称 | 类型 | 说明 |
| --- | ---- | ----------------------- | | --- | ---- | ----------------------- |
| root<sup>8+</sup> | [FieldNode](#fieldnode8) | 表示json根对象 | | root<sup>8+</sup> | [FieldNode](#fieldnode8) | 表示json根对象 |
| indexes<sup>8+</sup> | Array<string> | 表示json类型的字符串数组。 | | indexes<sup>8+</sup> | Array\<string> | 表示json类型的字符串数组。 |
| mode<sup>8+</sup> | number | 表示Schema的模式。 | | mode<sup>8+</sup> | number | 表示Schema的模式。 |
| skip<sup>8+</sup> | number | Schema的跳跃大小。 | | skip<sup>8+</sup> | number | Schema的跳跃大小。 |
...@@ -690,27 +683,25 @@ appendChild(child: FieldNode): boolean ...@@ -690,27 +683,25 @@ appendChild(child: FieldNode): boolean
**示例** **示例**
``` ```
import ddm from '@ohos.data.distributedData'; import ddm from '@ohos.data.distributedData';
try { try {
let node = new ddm.FieldNode("root"); let node = new ddm.FieldNode("root");
let child1 = new ddm.FieldNode("child1"); let child1 = new ddm.FieldNode("child1");
let child2 = new ddm.FieldNode("child2"); let child2 = new ddm.FieldNode("child2");
let child3 = new ddm.FieldNode("child3"); let child3 = new ddm.FieldNode("child3");
node.appendChild(child1); node.appendChild(child1);
node.appendChild(child2); node.appendChild(child2);
node.appendChild(child3); node.appendChild(child3);
console.log("appendNode " + node.toJson()); console.log("appendNode " + node.toJson());
child1 = null; child1 = null;
child2 = null; child2 = null;
child3 = null; child3 = null;
node = null; node = null;
} catch (e) { } catch (e) {
console.log("AppendChild " + e); console.log("AppendChild " + e);
} }
``` ```
## KvStoreResultSet<sup>8+</sup> ## ## KvStoreResultSet<sup>8+</sup> ##
...@@ -734,23 +725,22 @@ getCount(): number ...@@ -734,23 +725,22 @@ getCount(): number
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const count = resultSet.getCount(); const count = resultSet.getCount();
console.log("GetCount " + count); console.log("GetCount " + count);
} catch (e) { } catch (e) {
console.log("GetCount fail " + e); console.log("GetCount fail " + e);
} }
``` ```
### getPosition<sup>8+</sup> ### ### getPosition<sup>8+</sup> ###
...@@ -768,22 +758,22 @@ getPosition(): number ...@@ -768,22 +758,22 @@ getPosition(): number
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const position = resultSet.getPosition(); const position = resultSet.getPosition();
console.log("getPosition " + position); console.log("getPosition " + position);
} catch (e) { } catch (e) {
console.log("GetPosition fail " + e); console.log("GetPosition fail " + e);
} }
``` ```
### moveToFirst<sup>8+</sup> ### ### moveToFirst<sup>8+</sup> ###
...@@ -802,22 +792,22 @@ moveToFirst(): boolean ...@@ -802,22 +792,22 @@ moveToFirst(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.moveToFirst(); const moved = resultSet.moveToFirst();
console.log("moveToFirst " + moved); console.log("moveToFirst " + moved);
} catch (e) { } catch (e) {
console.log("MoveToFirst fail " + e); console.log("MoveToFirst fail " + e);
} }
``` ```
### moveToLast<sup>8+</sup> ### ### moveToLast<sup>8+</sup> ###
...@@ -836,22 +826,22 @@ moveToLast(): boolean ...@@ -836,22 +826,22 @@ moveToLast(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.moveToLast(); const moved = resultSet.moveToLast();
console.log("moveToLast " + moved); console.log("moveToLast " + moved);
} catch (e) { } catch (e) {
console.log("moveToLast fail " + e); console.log("moveToLast fail " + e);
} }
``` ```
### moveToNext<sup>8+</sup> ### ### moveToNext<sup>8+</sup> ###
...@@ -870,22 +860,22 @@ moveToNext(): boolean ...@@ -870,22 +860,22 @@ moveToNext(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.moveToNext(); const moved = resultSet.moveToNext();
console.log("moveToNext " + moved); console.log("moveToNext " + moved);
} catch (e) { } catch (e) {
console.log("moveToNext fail " + e); console.log("moveToNext fail " + e);
} }
``` ```
### moveToPrevious<sup>8+</sup> ### ### moveToPrevious<sup>8+</sup> ###
...@@ -904,22 +894,22 @@ moveToPrevious(): boolean ...@@ -904,22 +894,22 @@ moveToPrevious(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.moveToPrevious(); const moved = resultSet.moveToPrevious();
console.log("moveToPrevious " + moved); console.log("moveToPrevious " + moved);
} catch (e) { } catch (e) {
console.log("moveToPrevious fail " + e); console.log("moveToPrevious fail " + e);
} }
``` ```
### move<sup>8+</sup> ### ### move<sup>8+</sup> ###
...@@ -944,22 +934,22 @@ move(offset: number): boolean ...@@ -944,22 +934,22 @@ move(offset: number): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.move(); const moved = resultSet.move();
console.log("move " + moved); console.log("move " + moved);
} catch (e) { } catch (e) {
console.log("move fail " + e); console.log("move fail " + e);
} }
``` ```
### moveToPosition<sup>8+</sup> ### ### moveToPosition<sup>8+</sup> ###
...@@ -984,22 +974,22 @@ moveToPosition(position: number): boolean ...@@ -984,22 +974,22 @@ moveToPosition(position: number): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.moveToPosition(); const moved = resultSet.moveToPosition();
console.log("moveToPosition " + moved); console.log("moveToPosition " + moved);
} catch (e) { } catch (e) {
console.log("moveToPosition fail " + e); console.log("moveToPosition fail " + e);
} }
``` ```
### isFirst<sup>8+</sup> ### ### isFirst<sup>8+</sup> ###
...@@ -1018,22 +1008,22 @@ isFirst(): boolean ...@@ -1018,22 +1008,22 @@ isFirst(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.isFirst(); const moved = resultSet.isFirst();
console.log("isFirst " + moved); console.log("isFirst " + moved);
} catch (e) { } catch (e) {
console.log("isFirst fail " + e); console.log("isFirst fail " + e);
} }
``` ```
### isLast<sup>8+</sup> ### ### isLast<sup>8+</sup> ###
...@@ -1052,23 +1042,22 @@ isLast(): boolean ...@@ -1052,23 +1042,22 @@ isLast(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.isLast(); const moved = resultSet.isLast();
console.log("isLast " + moved); console.log("isLast " + moved);
} catch (e) { } catch (e) {
console.log("isLast fail " + e); console.log("isLast fail " + e);
} }
``` ```
### isBeforeFirst<sup>8+</sup> ### ### isBeforeFirst<sup>8+</sup> ###
...@@ -1086,22 +1075,22 @@ isBeforeFirst(): boolean ...@@ -1086,22 +1075,22 @@ isBeforeFirst(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.isBeforeFirst(); const moved = resultSet.isBeforeFirst();
console.log("isBeforeFirst " + moved); console.log("isBeforeFirst " + moved);
} catch (e) { } catch (e) {
console.log("isBeforeFirst fail " + e); console.log("isBeforeFirst fail " + e);
} }
``` ```
### isAfterLast<sup>8+</sup> ### ### isAfterLast<sup>8+</sup> ###
...@@ -1120,22 +1109,22 @@ isAfterLast(): boolean ...@@ -1120,22 +1109,22 @@ isAfterLast(): boolean
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.isAfterLast(); const moved = resultSet.isAfterLast();
console.log("isAfterLast " + moved); console.log("isAfterLast " + moved);
} catch (e) { } catch (e) {
console.log("isAfterLast fail " + e); console.log("isAfterLast fail " + e);
} }
``` ```
### getEntry<sup>8+</sup> ### ### getEntry<sup>8+</sup> ###
...@@ -1154,23 +1143,23 @@ getEntry(): Entry ...@@ -1154,23 +1143,23 @@ getEntry(): Entry
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('batch_test_string_key').then((result) => { kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + err); console.log('getResultSet fail ' + err);
}); });
const moved = resultSet.moveToNext(); const moved = resultSet.moveToNext();
const entry = resultSet.getEntry(); const entry = resultSet.getEntry();
console.log("getEntry " + JSON.stringify(entry)); console.log("getEntry " + JSON.stringify(entry));
} catch (e) { } catch (e) {
console.log("getEntry fail " + e); console.log("getEntry fail " + e);
} }
``` ```
## Query<sup>8+</sup> ## ## Query<sup>8+</sup> ##
...@@ -1205,18 +1194,18 @@ reset(): Query ...@@ -1205,18 +1194,18 @@ reset(): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.equalTo("key", "value"); query.equalTo("key", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query.reset(); query.reset();
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("simply calls should be ok :" + e); console.log("simply calls should be ok :" + e);
} }
``` ```
### equalTo<sup>8+</sup> ### ### equalTo<sup>8+</sup> ###
...@@ -1242,16 +1231,16 @@ equalTo(field: string, value: number|string|boolean): Query; ...@@ -1242,16 +1231,16 @@ equalTo(field: string, value: number|string|boolean): Query;
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.equalTo("field", "value"); query.equalTo("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### notEqualTo<sup>8+</sup> ### ### notEqualTo<sup>8+</sup> ###
...@@ -1277,16 +1266,16 @@ notEqualTo(field: string, value: number|string|boolean): Query ...@@ -1277,16 +1266,16 @@ notEqualTo(field: string, value: number|string|boolean): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### greaterThan<sup>8+</sup> ### ### greaterThan<sup>8+</sup> ###
...@@ -1302,7 +1291,7 @@ greaterThan(field: string, value: number|string|boolean): Query ...@@ -1302,7 +1291,7 @@ greaterThan(field: string, value: number|string|boolean): Query
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 | | fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 |
| value | number/string/boolean | 是 | 表示指定的值。| | value | number\|string\|boolean | 是 | 表示指定的值。|
**返回值**： **返回值**：
...@@ -1312,16 +1301,16 @@ greaterThan(field: string, value: number|string|boolean): Query ...@@ -1312,16 +1301,16 @@ greaterThan(field: string, value: number|string|boolean): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.greaterThan("field", "value"); query.greaterThan("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### lessThan<sup>8+</sup> ### ### lessThan<sup>8+</sup> ###
...@@ -1337,7 +1326,7 @@ lessThan(field: string, value: number|string): Query ...@@ -1337,7 +1326,7 @@ lessThan(field: string, value: number|string): Query
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 | | fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 |
| value | number/string/boolean | 是 | 表示指定的值。| | value | number\|string\|boolean | 是 | 表示指定的值。|
**返回值**： **返回值**：
...@@ -1347,16 +1336,16 @@ lessThan(field: string, value: number|string): Query ...@@ -1347,16 +1336,16 @@ lessThan(field: string, value: number|string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.lessThan("field", "value"); query.lessThan("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### greaterThanOrEqualTo<sup>8+</sup> ### ### greaterThanOrEqualTo<sup>8+</sup> ###
...@@ -1372,7 +1361,7 @@ greaterThanOrEqualTo(field: string, value: number|string): Query ...@@ -1372,7 +1361,7 @@ greaterThanOrEqualTo(field: string, value: number|string): Query
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 | | fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 |
| value | number/string/boolean | 是 | 表示指定的值。| | value | number\|string\|boolean | 是 | 表示指定的值。|
**返回值**： **返回值**：
...@@ -1382,17 +1371,17 @@ greaterThanOrEqualTo(field: string, value: number|string): Query ...@@ -1382,17 +1371,17 @@ greaterThanOrEqualTo(field: string, value: number|string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.greaterThanOrEqualTo("field", "value"); query.greaterThanOrEqualTo("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### lessThanOrEqualTo<sup>8+</sup> ### ### lessThanOrEqualTo<sup>8+</sup> ###
...@@ -1407,7 +1396,7 @@ lessThanOrEqualTo(field: string, value: number|string): Query ...@@ -1407,7 +1396,7 @@ lessThanOrEqualTo(field: string, value: number|string): Query
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 | | fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 |
| value | number/string/boolean | 是 | 表示指定的值。| | value | number\|string\|boolean | 是 | 表示指定的值。|
**返回值**： **返回值**：
...@@ -1417,16 +1406,16 @@ lessThanOrEqualTo(field: string, value: number|string): Query ...@@ -1417,16 +1406,16 @@ lessThanOrEqualTo(field: string, value: number|string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.lessThanOrEqualTo("field", "value"); query.lessThanOrEqualTo("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### isNull<sup>8+</sup> ### ### isNull<sup>8+</sup> ###
...@@ -1452,16 +1441,16 @@ isNull(field: string): Query ...@@ -1452,16 +1441,16 @@ isNull(field: string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.isNull("field"); query.isNull("field");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### inNumber<sup>8+</sup> ### ### inNumber<sup>8+</sup> ###
...@@ -1486,19 +1475,18 @@ inNumber(field: string, valueList: number[]): Query ...@@ -1486,19 +1475,18 @@ inNumber(field: string, valueList: number[]): Query
| ------ | ------- | | ------ | ------- |
| [Query](#query8) |返回查询对象。| | [Query](#query8) |返回查询对象。|
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.inNumber("field", [0, 1]); query.inNumber("field", [0, 1]);
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### inString<sup>8+</sup> ### ### inString<sup>8+</sup> ###
...@@ -1524,16 +1512,16 @@ inString(field: string, valueList: string[]): Query ...@@ -1524,16 +1512,16 @@ inString(field: string, valueList: string[]): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.inString("field", ['test1', 'test2']); query.inString("field", ['test1', 'test2']);
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### notInNumber<sup>8+</sup> ### ### notInNumber<sup>8+</sup> ###
...@@ -1559,16 +1547,16 @@ notInNumber(field: string, valueList: number[]): Query ...@@ -1559,16 +1547,16 @@ notInNumber(field: string, valueList: number[]): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notInNumber("field", [0, 1]); query.notInNumber("field", [0, 1]);
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### notInString<sup>8+</sup> ### ### notInString<sup>8+</sup> ###
...@@ -1594,16 +1582,16 @@ notInString(field: string, valueList: string[]): Query ...@@ -1594,16 +1582,16 @@ notInString(field: string, valueList: string[]): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notInString("field", ['test1', 'test2']); query.notInString("field", ['test1', 'test2']);
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### like<sup>8+</sup> ### ### like<sup>8+</sup> ###
...@@ -1629,16 +1617,16 @@ like(field: string, value: string): Query ...@@ -1629,16 +1617,16 @@ like(field: string, value: string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.like("field", "value"); query.like("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### unlike<sup>8+</sup> ### ### unlike<sup>8+</sup> ###
...@@ -1664,16 +1652,16 @@ unlike(field: string, value: string): Query ...@@ -1664,16 +1652,16 @@ unlike(field: string, value: string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.unlike("field", "value"); query.unlike("field", "value");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### and<sup>8+</sup> ### ### and<sup>8+</sup> ###
...@@ -1692,18 +1680,18 @@ and(): Query ...@@ -1692,18 +1680,18 @@ and(): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value1"); query.notEqualTo("field", "value1");
query.and(); query.and();
query.notEqualTo("field", "value2"); query.notEqualTo("field", "value2");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### or<sup>8+</sup> ### ### or<sup>8+</sup> ###
...@@ -1722,18 +1710,18 @@ or(): Query ...@@ -1722,18 +1710,18 @@ or(): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value1"); query.notEqualTo("field", "value1");
query.or(); query.or();
query.notEqualTo("field", "value2"); query.notEqualTo("field", "value2");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### orderByAsc<sup>8+</sup> ### ### orderByAsc<sup>8+</sup> ###
...@@ -1758,17 +1746,17 @@ orderByAsc(field: string): Query ...@@ -1758,17 +1746,17 @@ orderByAsc(field: string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
query.orderByAsc("field"); query.orderByAsc("field");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### orderByDesc<sup>8+</sup> ### ### orderByDesc<sup>8+</sup> ###
...@@ -1791,20 +1779,19 @@ orderByDesc(field: string): Query ...@@ -1791,20 +1779,19 @@ orderByDesc(field: string): Query
| ------ | ------- | | ------ | ------- |
| [Query](#query8) |返回查询对象。| | [Query](#query8) |返回查询对象。|
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
query.orderByDesc("field"); query.orderByDesc("field");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### limit<sup>8+</sup> ### ### limit<sup>8+</sup> ###
...@@ -1830,17 +1817,17 @@ limit(total: number, offset: number): Query ...@@ -1830,17 +1817,17 @@ limit(total: number, offset: number): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
query.limit("total", "offset"); query.limit("total", "offset");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### isNotNull<sup>8+</sup> ### ### isNotNull<sup>8+</sup> ###
...@@ -1865,16 +1852,16 @@ isNotNull(field: string): Query ...@@ -1865,16 +1852,16 @@ isNotNull(field: string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.isNotNull("field"); query.isNotNull("field");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### beginGroup<sup>8+</sup> ### ### beginGroup<sup>8+</sup> ###
...@@ -1893,18 +1880,18 @@ beginGroup(): Query ...@@ -1893,18 +1880,18 @@ beginGroup(): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.beginGroup(); query.beginGroup();
query.isNotNull("field"); query.isNotNull("field");
query.endGroup(); query.endGroup();
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### endGroup<sup>8+</sup> ### ### endGroup<sup>8+</sup> ###
...@@ -1923,18 +1910,18 @@ endGroup(): Query ...@@ -1923,18 +1910,18 @@ endGroup(): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.beginGroup(); query.beginGroup();
query.isNotNull("field"); query.isNotNull("field");
query.endGroup(); query.endGroup();
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### prefixKey<sup>8+</sup> ### ### prefixKey<sup>8+</sup> ###
...@@ -1959,17 +1946,17 @@ prefixKey(prefix: string): Query ...@@ -1959,17 +1946,17 @@ prefixKey(prefix: string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.prefixKey("$.name"); query.prefixKey("$.name");
query.prefixKey("0"); query.prefixKey("0");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### setSuggestIndex<sup>8+</sup> ### ### setSuggestIndex<sup>8+</sup> ###
...@@ -1994,17 +1981,17 @@ setSuggestIndex(index: string): Query ...@@ -1994,17 +1981,17 @@ setSuggestIndex(index: string): Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.setSuggestIndex("$.name"); query.setSuggestIndex("$.name");
query.setSuggestIndex("0"); query.setSuggestIndex("0");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
query = null; query = null;
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok :" + e); console.log("dumplicated calls should be ok :" + e);
} }
``` ```
### deviceId<sup>8+</sup> ### ### deviceId<sup>8+</sup> ###
...@@ -2030,15 +2017,15 @@ deviceId(deviceId:string):Query ...@@ -2030,15 +2017,15 @@ deviceId(deviceId:string):Query
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.deviceId("deviceId"); query.deviceId("deviceId");
console.log("query is " + query.getSqlLike()); console.log("query is " + query.getSqlLike());
} catch (e) { } catch (e) {
console.log("should be ok on Method Chaining : " + e); console.log("should be ok on Method Chaining : " + e);
} }
``` ```
### getSqlLike<sup>8+</sup> ### ### getSqlLike<sup>8+</sup> ###
...@@ -2057,15 +2044,15 @@ getSqlLike():string ...@@ -2057,15 +2044,15 @@ getSqlLike():string
**示例** **示例**
``` ```
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
let sql1 = query.getSqlLike(); let sql1 = query.getSqlLike();
console.log("GetSqlLike sql=" + sql1); console.log("GetSqlLike sql=" + sql1);
} catch (e) { } catch (e) {
console.log("dumplicated calls should be ok : " + e); console.log("dumplicated calls should be ok : " + e);
} }
``` ```
## KVStore ## KVStore
...@@ -2092,22 +2079,22 @@ put(key: string, value: Uint8Array | string | number | boolean, callback: AsyncC ...@@ -2092,22 +2079,22 @@ put(key: string, value: Uint8Array | string | number | boolean, callback: AsyncC
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-test-string'; const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err,data) { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err,data) {
if (err != undefined) { if (err != undefined) {
console.log("put err: " + JSON.stringify(err)); console.log("put err: " + JSON.stringify(err));
return; return;
} }
console.log("put success"); console.log("put success");
}); });
}catch (e) { }catch (e) {
console.log("An unexpected error occurred. Error:" + e); console.log("An unexpected error occurred. Error:" + e);
} }
``` ```
### put ### put
...@@ -2131,23 +2118,22 @@ put(key: string, value: Uint8Array | string | number | boolean): Promise&lt;void ...@@ -2131,23 +2118,22 @@ put(key: string, value: Uint8Array | string | number | boolean): Promise&lt;void
| ------ | ------- | | ------ | ------- |
| Promise&lt;void&gt; |Promise实例，用于异步处理。| | Promise&lt;void&gt; |Promise实例，用于异步处理。|
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-test-string'; const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((data) => { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((data) => {
console.log("put success: " + JSON.stringify(data)); console.log("put success: " + JSON.stringify(data));
}).catch((err) => { }).catch((err) => {
console.log("put err: " + JSON.stringify(err)); console.log("put err: " + JSON.stringify(err));
}); });
}catch (e) { }catch (e) {
console.log("An unexpected error occurred. Error:" + e); console.log("An unexpected error occurred. Error:" + e);
} }
``` ```
### delete ### delete
...@@ -2167,29 +2153,29 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -2167,29 +2153,29 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-test-string'; const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err,data) { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err,data) {
if (err != undefined) {
console.log("put err: " + JSON.stringify(err));
return;
}
console.log("put success");
kvStore.delete(KEY_TEST_STRING_ELEMENT, function (err,data) {
if (err != undefined) { if (err != undefined) {
console.log("put err: " + JSON.stringify(err)); console.log("delete err: " + JSON.stringify(err));
return; return;
} }
console.log("put success"); console.log("delete success");
kvStore.delete(KEY_TEST_STRING_ELEMENT, function (err,data) {
if (err != undefined) {
console.log("delete err: " + JSON.stringify(err));
return;
}
console.log("delete success");
});
}); });
}catch (e) { });
console.log("An unexpected error occurred. Error:" + e); }catch (e) {
} console.log("An unexpected error occurred. Error:" + e);
``` }
```
### delete ### delete
...@@ -2214,25 +2200,25 @@ delete(key: string): Promise&lt;void&gt; ...@@ -2214,25 +2200,25 @@ delete(key: string): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-test-string'; const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((data) => { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((data) => {
console.log("put success: " + JSON.stringify(data)); console.log("put success: " + JSON.stringify(data));
kvStore.delete(KEY_TEST_STRING_ELEMENT).then((data) => { kvStore.delete(KEY_TEST_STRING_ELEMENT).then((data) => {
console.log("delete success"); console.log("delete success");
}).catch((err) => {
console.log("delete err: " + JSON.stringify(err));
});
}).catch((err) => { }).catch((err) => {
console.log("put err: " + JSON.stringify(err)); console.log("delete err: " + JSON.stringify(err));
}); });
}catch (e) { }).catch((err) => {
console.log("An unexpected error occurred. Error:" + e); console.log("put err: " + JSON.stringify(err));
} });
``` }catch (e) {
console.log("An unexpected error occurred. Error:" + e);
}
```
### on ### on
...@@ -2251,15 +2237,14 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific ...@@ -2251,15 +2237,14 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific
| type |[SubscribeType](#subscribetype) | 是 |表示订阅的类型。 | | type |[SubscribeType](#subscribetype) | 是 |表示订阅的类型。 |
| observer |Callback&lt;[ChangeNotification](#changenotification)&gt; | 是 |回调函数。 | | observer |Callback&lt;[ChangeNotification](#changenotification)&gt; | 是 |回调函数。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
kvStore.on('dataChange', distributedData.SubscribeType.SUBSCRIBE_TYPE_LOCAL, function (data) { kvStore.on('dataChange', distributedData.SubscribeType.SUBSCRIBE_TYPE_LOCAL, function (data) {
console.log("dataChange callback call data: " + JSON.stringify(data)); console.log("dataChange callback call data: " + JSON.stringify(data));
}); });
``` ```
### on ### on
...@@ -2277,15 +2262,14 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt ...@@ -2277,15 +2262,14 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt
| event |'syncComplete' | 是 |回调函数名称。 | | event |'syncComplete' | 是 |回调函数名称。 |
| syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 是 |回调函数。 | | syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 是 |回调函数。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
kvStore.on('syncComplete', function (data) { kvStore.on('syncComplete', function (data) {
console.log("syncComplete callback call data: " + data); console.log("syncComplete callback call data: " + data);
}); });
``` ```
### off<sup>8+</sup> ### off<sup>8+</sup>
...@@ -2304,15 +2288,15 @@ off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void ...@@ -2304,15 +2288,15 @@ off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
kvStore.on('dataChange', function (data) { kvStore.on('dataChange', function (data) {
console.log("syncComplete callback call data: " + data); console.log("syncComplete callback call data: " + data);
}); });
kvStore.off('dataChange', function (data) { kvStore.off('dataChange', function (data) {
console.log("syncComplete callback call data: " + data); console.log("syncComplete callback call data: " + data);
}); });
``` ```
### putBatch<sup>8+</sup> ### putBatch<sup>8+</sup>
...@@ -2332,35 +2316,34 @@ putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void ...@@ -2332,35 +2316,34 @@ putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
await kvStore.getEntries('batch_test_string_key', function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
}catch(e) {
console.log('PutBatch e ' + e);
} }
console.log('entries: ' + JSON.stringify(entries));
``` kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
await kvStore.getEntries('batch_test_string_key', function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
}catch(e) {
console.log('PutBatch e ' + e);
}
```
### putBatch<sup>8+</sup> ### putBatch<sup>8+</sup>
...@@ -2385,37 +2368,37 @@ putBatch(entries: Entry[]): Promise&lt;void&gt; ...@@ -2385,37 +2368,37 @@ putBatch(entries: Entry[]): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries).then(async (err) => { }
console.log('putBatch success'); console.log('entries: ' + JSON.stringify(entries));
await kvStore.getEntries('batch_test_string_key').then((entrys) => { kvStore.putBatch(entries).then(async (err) => {
console.log('getEntries success'); console.log('putBatch success');
console.log('PutBatch ' + JSON.stringify(entries)); await kvStore.getEntries('batch_test_string_key').then((entrys) => {
}).catch((err) => { console.log('getEntries success');
console.log('getEntries fail ' + JSON.stringify(err)); console.log('PutBatch ' + JSON.stringify(entries));
});
}).catch((err) => { }).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err)); console.log('getEntries fail ' + JSON.stringify(err));
}); });
}catch(e) { }).catch((err) => {
console.log('PutBatch e ' + e); console.log('putBatch fail ' + JSON.stringify(err));
} });
``` }catch(e) {
console.log('PutBatch e ' + e);
}
```
### deleteBatch<sup>8+</sup> ### deleteBatch<sup>8+</sup>
...@@ -2435,34 +2418,34 @@ deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void ...@@ -2435,34 +2418,34 @@ deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
let keys = []; let keys = [];
for (var i = 0; i < 5; i++) { for (var i = 0; i < 5; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
keys.push(key + i);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries, async function (err,data) { keys.push(key + i);
console.log('putBatch success');
await kvStore.deleteBatch(keys, async function (err,data) {
console.log('deleteBatch success');
});
});
}catch(e) {
console.log('DeleteBatch e ' + e);
} }
``` console.log('entries: ' + JSON.stringify(entries));
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
await kvStore.deleteBatch(keys, async function (err,data) {
console.log('deleteBatch success');
});
});
}catch(e) {
console.log('DeleteBatch e ' + e);
}
```
### deleteBatch<sup>8+</sup> ### ### deleteBatch<sup>8+</sup> ###
...@@ -2487,38 +2470,38 @@ deleteBatch(keys: string[]): Promise&lt;void&gt; ...@@ -2487,38 +2470,38 @@ deleteBatch(keys: string[]): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
let keys = []; let keys = [];
for (var i = 0; i < 5; i++) { for (var i = 0; i < 5; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
keys.push(key + i);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries).then(async (err) => { keys.push(key + i);
console.log('putBatch success'); }
await kvStore.deleteBatch(keys).then((err) => { console.log('entries: ' + JSON.stringify(entries));
console.log('deleteBatch success'); kvStore.putBatch(entries).then(async (err) => {
}).catch((err) => { console.log('putBatch success');
console.log('deleteBatch fail ' + JSON.stringify(err)); await kvStore.deleteBatch(keys).then((err) => {
}); console.log('deleteBatch success');
}).catch((err) => { }).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err)); console.log('deleteBatch fail ' + JSON.stringify(err));
}); });
}catch(e) { }).catch((err) => {
console.log('DeleteBatch e ' + e); console.log('putBatch fail ' + JSON.stringify(err));
} });
``` }catch(e) {
console.log('DeleteBatch e ' + e);
}
```
### startTransaction<sup>8+</sup> ### ### startTransaction<sup>8+</sup> ###
...@@ -2537,40 +2520,40 @@ startTransaction(callback: AsyncCallback&lt;void&gt;): void ...@@ -2537,40 +2520,40 @@ startTransaction(callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
function putBatchString(len, prefix) { function putBatchString(len, prefix) {
let entries = []; let entries = [];
for (var i = 0; i < len; i++) { for (var i = 0; i < len; i++) {
var entry = { var entry = {
key : prefix + i, key : prefix + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
return entries; entries.push(entry);
} }
try { return entries;
var count = 0; }
kvStore.on('dataChange', 0, function (data) { try {
console.log('startTransaction 0' + data) var count = 0;
count++; kvStore.on('dataChange', 0, function (data) {
}); console.log('startTransaction 0' + data)
kvStore.startTransaction(async function (err,data) { count++;
console.log('startTransaction success'); });
let entries = putBatchString(10, 'batch_test_string_key'); kvStore.startTransaction(async function (err,data) {
console.log('entries: ' + JSON.stringify(entries)); console.log('startTransaction success');
await kvStore.putBatch(entries, async function (err,data) { let entries = putBatchString(10, 'batch_test_string_key');
console.log('putBatch success'); console.log('entries: ' + JSON.stringify(entries));
}); await kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
}); });
}catch(e) { });
console.log('startTransaction e ' + e); }catch(e) {
} console.log('startTransaction e ' + e);
``` }
```
### startTransaction<sup>8+</sup> ### ### startTransaction<sup>8+</sup> ###
...@@ -2589,23 +2572,23 @@ startTransaction(): Promise&lt;void&gt; ...@@ -2589,23 +2572,23 @@ startTransaction(): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
var count = 0; var count = 0;
kvStore.on('dataChange', distributedData.SubscribeType.SUBSCRIBE_TYPE_ALL, function (data) { kvStore.on('dataChange', distributedData.SubscribeType.SUBSCRIBE_TYPE_ALL, function (data) {
console.log('startTransaction ' + JSON.stringify(data)); console.log('startTransaction ' + JSON.stringify(data));
count++; count++;
}); });
kvStore.startTransaction().then(async (err) => { kvStore.startTransaction().then(async (err) => {
console.log('startTransaction success'); console.log('startTransaction success');
}).catch((err) => { }).catch((err) => {
console.log('startTransaction fail ' + JSON.stringify(err)); console.log('startTransaction fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('startTransaction e ' + e); console.log('startTransaction e ' + e);
} }
``` ```
### commit<sup>8+</sup> ### ### commit<sup>8+</sup> ###
...@@ -2624,20 +2607,20 @@ commit(callback: AsyncCallback&lt;void&gt;): void ...@@ -2624,20 +2607,20 @@ commit(callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.commit(function (err,data) { kvStore.commit(function (err,data) {
if (err == undefined) { if (err == undefined) {
console.log('commit success'); console.log('commit success');
} else { } else {
console.log('commit fail'); console.log('commit fail');
} }
}); });
}catch(e) { }catch(e) {
console.log('Commit e ' + e); console.log('Commit e ' + e);
} }
``` ```
### commit<sup>8+</sup> ### ### commit<sup>8+</sup> ###
...@@ -2656,18 +2639,18 @@ commit(): Promise&lt;void&gt; ...@@ -2656,18 +2639,18 @@ commit(): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.commit().then(async (err) => { kvStore.commit().then(async (err) => {
console.log('commit success'); console.log('commit success');
}).catch((err) => { }).catch((err) => {
console.log('commit fail ' + JSON.stringify(err)); console.log('commit fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('Commit e ' + e); console.log('Commit e ' + e);
} }
``` ```
### rollback<sup>8+</sup> ### ### rollback<sup>8+</sup> ###
...@@ -2686,20 +2669,20 @@ rollback(callback: AsyncCallback&lt;void&gt;): void ...@@ -2686,20 +2669,20 @@ rollback(callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.rollback(function (err,data) { kvStore.rollback(function (err,data) {
if (err == undefined) { if (err == undefined) {
console.log('commit success'); console.log('commit success');
} else { } else {
console.log('commit fail'); console.log('commit fail');
} }
}); });
}catch(e) { }catch(e) {
console.log('Rollback e ' + e); console.log('Rollback e ' + e);
} }
``` ```
### rollback<sup>8+</sup> ### ### rollback<sup>8+</sup> ###
...@@ -2718,18 +2701,18 @@ rollback(): Promise&lt;void&gt; ...@@ -2718,18 +2701,18 @@ rollback(): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.rollback().then(async (err) => { kvStore.rollback().then(async (err) => {
console.log('rollback success'); console.log('rollback success');
}).catch((err) => { }).catch((err) => {
console.log('rollback fail ' + JSON.stringify(err)); console.log('rollback fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('Rollback e ' + e); console.log('Rollback e ' + e);
} }
``` ```
### enableSync<sup>8+</sup> ### ### enableSync<sup>8+</sup> ###
...@@ -2749,20 +2732,20 @@ enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void ...@@ -2749,20 +2732,20 @@ enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.enableSync(true, function (err,data) { kvStore.enableSync(true, function (err,data) {
if (err == undefined) { if (err == undefined) {
console.log('enableSync success'); console.log('enableSync success');
} else { } else {
console.log('enableSync fail'); console.log('enableSync fail');
} }
}); });
}catch(e) { }catch(e) {
console.log('EnableSync e ' + e); console.log('EnableSync e ' + e);
} }
``` ```
### enableSync<sup>8+</sup> ### ### enableSync<sup>8+</sup> ###
...@@ -2787,18 +2770,18 @@ enableSync(enabled: boolean): Promise&lt;void&gt; ...@@ -2787,18 +2770,18 @@ enableSync(enabled: boolean): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.enableSync(true).then((err) => { kvStore.enableSync(true).then((err) => {
console.log('enableSync success'); console.log('enableSync success');
}).catch((err) => { }).catch((err) => {
console.log('enableSync fail ' + JSON.stringify(err)); console.log('enableSync fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('EnableSync e ' + e); console.log('EnableSync e ' + e);
} }
``` ```
### setSyncRange<sup>8+</sup> ### ### setSyncRange<sup>8+</sup> ###
...@@ -2819,18 +2802,18 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: Asy ...@@ -2819,18 +2802,18 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: Asy
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
const localLabels = ['A', 'B']; const localLabels = ['A', 'B'];
const remoteSupportLabels = ['C', 'D']; const remoteSupportLabels = ['C', 'D'];
kvStore.setSyncRange(localLabels, remoteSupportLabels, function (err,data) { kvStore.setSyncRange(localLabels, remoteSupportLabels, function (err,data) {
console.log('SetSyncRange put success'); console.log('SetSyncRange put success');
}); });
}catch(e) { }catch(e) {
console.log('SetSyncRange e ' + e); console.log('SetSyncRange e ' + e);
} }
``` ```
### setSyncRange<sup>8+</sup> ### ### setSyncRange<sup>8+</sup> ###
...@@ -2857,20 +2840,20 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2857,20 +2840,20 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
const localLabels = ['A', 'B']; const localLabels = ['A', 'B'];
const remoteSupportLabels = ['C', 'D']; const remoteSupportLabels = ['C', 'D'];
kvStore.setSyncRange(localLabels, remoteSupportLabels).then((err) => { kvStore.setSyncRange(localLabels, remoteSupportLabels).then((err) => {
console.log('setSyncRange success'); console.log('setSyncRange success');
}).catch((err) => { }).catch((err) => {
console.log('delete fail ' + err); console.log('delete fail ' + err);
}); });
}catch(e) { }catch(e) {
console.log('SetSyncRange e ' + e); console.log('SetSyncRange e ' + e);
} }
``` ```
## SubscribeType ## SubscribeType
...@@ -2957,29 +2940,29 @@ get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | numb ...@@ -2957,29 +2940,29 @@ get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | numb
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| key |string | 是 |要查询数据的key，不能为空且长度不大于[MAX_KEY_LENGTH](#constants)。 | | key |string | 是 |要查询数据的key，不能为空且长度不大于[MAX_KEY_LENGTH](#constants)。 |
| callback |AsyncCallback&lt;Uint8Array / string / boolean / number&gt;) | 是 |回调函数，获取查询的值。 | | callback |AsyncCallback&lt;Uint8Array \| string \| boolean \| number&gt;) | 是 |回调函数，获取查询的值。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-test-string'; const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err,data) { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, function (err,data) {
if (err != undefined) { if (err != undefined) {
console.log("put err: " + JSON.stringify(err)); console.log("put err: " + JSON.stringify(err));
return; return;
} }
console.log("put success"); console.log("put success");
kvStore.get(KEY_TEST_STRING_ELEMENT, function (err,data) { kvStore.get(KEY_TEST_STRING_ELEMENT, function (err,data) {
console.log("get success data: " + data); console.log("get success data: " + data);
});
}); });
}catch (e) { });
console.log("An unexpected error occurred. Error:" + e); }catch (e) {
} console.log("An unexpected error occurred. Error:" + e);
``` }
```
### get ### get
...@@ -3001,30 +2984,29 @@ get(key: string): Promise&lt;Uint8Array | string | boolean | number> ...@@ -3001,30 +2984,29 @@ get(key: string): Promise&lt;Uint8Array | string | boolean | number>
| 类型 | 说明 | | 类型 | 说明 |
| ------ | ------- | | ------ | ------- |
|Promise&lt;Uint8Array / string / boolean / number&gt; |Promise实例，用于获取异步返回结果。| |Promise&lt;Uint8Array \| string \| boolean \| number&gt; |Promise实例，用于获取异步返回结果。|
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-test-string'; const VALUE_TEST_STRING_ELEMENT = 'value-test-string';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((data) => { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((data) => {
console.log("put success: " + JSON.stringify(data)); console.log("put success: " + JSON.stringify(data));
kvStore.get(KEY_TEST_STRING_ELEMENT).then((data) => { kvStore.get(KEY_TEST_STRING_ELEMENT).then((data) => {
console.log("get success data: " + data); console.log("get success data: " + data);
}).catch((err) => {
console.log("get err: " + JSON.stringify(err));
});
}).catch((err) => { }).catch((err) => {
console.log("put err: " + JSON.stringify(err)); console.log("get err: " + JSON.stringify(err));
}); });
}catch (e) { }).catch((err) => {
console.log("An unexpected error occurred. Error:" + e); console.log("put err: " + JSON.stringify(err));
} });
``` }catch (e) {
console.log("An unexpected error occurred. Error:" + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -3039,37 +3021,37 @@ getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void ...@@ -3039,37 +3021,37 @@ getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| keyPrefix |string | 是 |表示要匹配的键前缀。 | | keyPrefix |string | 是 |表示要匹配的键前缀。 |
| callback |AsyncCallback&lt;Entry[]&gt; | 是 |回调函数，获取指定前缀的键值对列表。 | | callback |AsyncCallback&lt;[Entry](#entry)[]&gt; | 是 |回调函数，获取指定前缀的键值对列表。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_number_key'; var key = 'batch_test_number_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.INTEGER, type : distributedData.ValueType.INTEGER,
value : 222 value : 222
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err,data) { entries.push(entry);
console.log('putBatch success');
await kvStore.getEntries('batch_test_number_key', function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
}catch(e) {
console.log('PutBatch e ' + e);
} }
``` kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
await kvStore.getEntries('batch_test_number_key', function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
}catch(e) {
console.log('PutBatch e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -3094,40 +3076,40 @@ getEntries(keyPrefix: string): Promise&lt;Entry[]&gt; ...@@ -3094,40 +3076,40 @@ getEntries(keyPrefix: string): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
console.log('entries: ' + entries); entries.push(entry);
kvStore.putBatch(entries).then(async (err) => { }
console.log('putBatch success'); console.log('entries: ' + entries);
await kvStore.getEntries('batch_test_string_key').then((entrys) => { kvStore.putBatch(entries).then(async (err) => {
console.log('getEntries success'); console.log('putBatch success');
console.log('entrys.length: ' + entrys.length); await kvStore.getEntries('batch_test_string_key').then((entrys) => {
console.log('entrys[0]: ' + JSON.stringify(entrys[0])); console.log('getEntries success');
console.log('entrys[0].value: ' + JSON.stringify(entrys[0].value)); console.log('entrys.length: ' + entrys.length);
console.log('entrys[0].value.value: ' + entrys[0].value.value); console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
}).catch((err) => { console.log('entrys[0].value: ' + JSON.stringify(entrys[0].value));
console.log('getEntries fail ' + JSON.stringify(err)); console.log('entrys[0].value.value: ' + entrys[0].value.value);
});
}).catch((err) => { }).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err)); console.log('getEntries fail ' + JSON.stringify(err));
}); });
}catch(e) { }).catch((err) => {
console.log('PutBatch e ' + e); console.log('putBatch fail ' + JSON.stringify(err));
} });
``` }catch(e) {
console.log('PutBatch e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -3143,42 +3125,42 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void ...@@ -3143,42 +3125,42 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| query |[Query](#query8) | 是 |表示要匹配的键前缀。 | | query |[Query](#query8) | 是 |表示要匹配的键前缀。 |
| callback |AsyncCallback&lt;Entry[]&gt; | 是 |回调函数，获取指定前缀的键值对列表。 | | callback |AsyncCallback&lt;[Entry](#entry)[]&gt; | 是 |回调函数，获取指定前缀的键值对列表。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_bool_key'; var key = 'batch_test_bool_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.BYTE_ARRAY, type : distributedData.ValueType.BYTE_ARRAY,
value : arr value : arr
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getEntries(query, function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
console.log('GetEntries success');
}catch(e) {
console.log('GetEntries e ' + e);
} }
``` console.log('entries: ' + JSON.stringify(entries));
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getEntries(query, function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
console.log('GetEntries success');
}catch(e) {
console.log('GetEntries e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -3203,39 +3185,39 @@ getEntries(query: Query): Promise&lt;Entry[]&gt; ...@@ -3203,39 +3185,39 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_bool_key'; var key = 'batch_test_bool_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.BYTE_ARRAY, type : distributedData.ValueType.BYTE_ARRAY,
value : arr value : arr
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries).then(async (err) => { }
console.log('putBatch success'); console.log('entries: ' + JSON.stringify(entries));
const query = new distributedData.Query(); kvStore.putBatch(entries).then(async (err) => {
query.prefixKey("batch_test"); console.log('putBatch success');
await kvStore.getEntries(query).then((entrys) => { const query = new distributedData.Query();
console.log('getEntries success'); query.prefixKey("batch_test");
}).catch((err) => { await kvStore.getEntries(query).then((entrys) => {
console.log('getEntries fail ' + JSON.stringify(err)); console.log('getEntries success');
});
}).catch((err) => { }).catch((err) => {
console.log('GetEntries putBatch fail ' + JSON.stringify(err)) console.log('getEntries fail ' + JSON.stringify(err));
}); });
console.log('GetEntries success'); }).catch((err) => {
}catch(e) { console.log('GetEntries putBatch fail ' + JSON.stringify(err))
console.log('GetEntries e ' + e); });
} console.log('GetEntries success');
``` }catch(e) {
console.log('GetEntries e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -3255,36 +3237,36 @@ getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;) ...@@ -3255,36 +3237,36 @@ getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;)
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err, data) { entries.push(entry);
console.log('GetResultSet putBatch success');
await kvStore.getResultSet('batch_test_string_key', async function (err, result) {
console.log('GetResultSet getResultSet success');
resultSet = result;
kvStore.closeResultSet(resultSet, function (err, data) {
console.log('GetResultSet closeResultSet success');
})
});
});
}catch(e) {
console.log('GetResultSet e ' + e);
} }
``` kvStore.putBatch(entries, async function (err, data) {
console.log('GetResultSet putBatch success');
await kvStore.getResultSet('batch_test_string_key', async function (err, result) {
console.log('GetResultSet getResultSet success');
resultSet = result;
kvStore.closeResultSet(resultSet, function (err, data) {
console.log('GetResultSet closeResultSet success');
})
});
});
}catch(e) {
console.log('GetResultSet e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -3309,42 +3291,42 @@ getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt; ...@@ -3309,42 +3291,42 @@ getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries).then(async (err) => { entries.push(entry);
console.log('putBatch success');
}).catch((err) => {
console.log('PutBatch putBatch fail ' + JSON.stringify(err));
});
kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('GetResult getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
kvStore.closeResultSet(resultSet).then((err) => {
console.log('GetResult closeResultSet success');
}).catch((err) => {
console.log('closeResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResult e ' + e);
} }
``` kvStore.putBatch(entries).then(async (err) => {
console.log('putBatch success');
}).catch((err) => {
console.log('PutBatch putBatch fail ' + JSON.stringify(err));
});
kvStore.getResultSet('batch_test_string_key').then((result) => {
console.log('GetResult getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
kvStore.closeResultSet(resultSet).then((err) => {
console.log('GetResult closeResultSet success');
}).catch((err) => {
console.log('closeResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResult e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -3364,35 +3346,35 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi ...@@ -3364,35 +3346,35 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err, data) { entries.push(entry);
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSet(query, async function (err, result) {
console.log('getResultSet success');
resultSet = result;
});
});
} catch(e) {
console.log('GetResultSet e ' + e);
} }
``` kvStore.putBatch(entries, async function (err, data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSet(query, async function (err, result) {
console.log('getResultSet success');
resultSet = result;
});
});
} catch(e) {
console.log('GetResultSet e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -3417,39 +3399,39 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt; ...@@ -3417,39 +3399,39 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries).then(async (err) => { entries.push(entry);
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSet(query).then((result) => {
console.log(' getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSet e ' + e);
} }
``` kvStore.putBatch(entries).then(async (err) => {
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSet(query).then((result) => {
console.log(' getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSet e ' + e);
}
```
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
...@@ -3468,21 +3450,21 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;) ...@@ -3468,21 +3450,21 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;)
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet = null; let resultSet = null;
kvStore.closeResultSet(resultSet, function (err, data) { kvStore.closeResultSet(resultSet, function (err, data) {
if (err == undefined) { if (err == undefined) {
console.log('closeResultSet success'); console.log('closeResultSet success');
} else { } else {
console.log('closeResultSet fail'); console.log('closeResultSet fail');
} }
}); });
}catch(e) { }catch(e) {
console.log('CloseResultSet e ' + e); console.log('CloseResultSet e ' + e);
} }
``` ```
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
...@@ -3507,19 +3489,19 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt; ...@@ -3507,19 +3489,19 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet = null; let resultSet = null;
kvStore.closeResultSet(resultSet).then(() => { kvStore.closeResultSet(resultSet).then(() => {
console.log('closeResultSet success'); console.log('closeResultSet success');
}).catch((err) => { }).catch((err) => {
console.log('closeResultSet fail ' + JSON.stringify(err)); console.log('closeResultSet fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('CloseResultSet e ' + e); console.log('CloseResultSet e ' + e);
} }
``` ```
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
...@@ -3539,33 +3521,33 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void ...@@ -3539,33 +3521,33 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err, data) { entries.push(entry);
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSize(query, async function (err, resultSize) {
console.log('getResultSet success');
});
});
} catch(e) {
console.log('GetResultSize e ' + e);
} }
``` kvStore.putBatch(entries, async function (err, data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSize(query, async function (err, resultSize) {
console.log('getResultSet success');
});
});
} catch(e) {
console.log('GetResultSize e ' + e);
}
```
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
...@@ -3590,37 +3572,37 @@ getResultSize(query: Query): Promise&lt;number&gt; ...@@ -3590,37 +3572,37 @@ getResultSize(query: Query): Promise&lt;number&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries).then(async (err) => { entries.push(entry);
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSize(query).then((resultSize) => {
console.log('getResultSet success');
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSize e ' + e);
} }
``` kvStore.putBatch(entries).then(async (err) => {
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSize(query).then((resultSize) => {
console.log('getResultSet success');
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSize e ' + e);
}
```
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
...@@ -3640,29 +3622,29 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -3640,29 +3622,29 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string_2'; const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
const VALUE_TEST_STRING_ELEMENT = 'value-string-002'; const VALUE_TEST_STRING_ELEMENT = 'value-string-002';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err,data) { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err,data) {
console.log('put success'); console.log('put success');
const deviceid = 'no_exist_device_id'; const deviceid = 'no_exist_device_id';
await kvStore.removeDeviceData(deviceid, async function (err,data) { await kvStore.removeDeviceData(deviceid, async function (err,data) {
if (err == undefined) { if (err == undefined) {
console.log('removeDeviceData success'); console.log('removeDeviceData success');
} else { } else {
console.log('removeDeviceData fail'); console.log('removeDeviceData fail');
await kvStore.get(KEY_TEST_STRING_ELEMENT, async function (err,data) { await kvStore.get(KEY_TEST_STRING_ELEMENT, async function (err,data) {
console.log('RemoveDeviceData get success'); console.log('RemoveDeviceData get success');
}); });
} }
});
}); });
}catch(e) { });
console.log('RemoveDeviceData e ' + e); }catch(e) {
} console.log('RemoveDeviceData e ' + e);
``` }
```
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
...@@ -3687,31 +3669,31 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt; ...@@ -3687,31 +3669,31 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string_2'; const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
const VALUE_TEST_STRING_ELEMENT = 'value-string-001'; const VALUE_TEST_STRING_ELEMENT = 'value-string-001';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((err) => { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((err) => {
console.log('removeDeviceData put success'); console.log('removeDeviceData put success');
}).catch((err) => { }).catch((err) => {
console.log('put fail ' + JSON.stringify(err)); console.log('put fail ' + JSON.stringify(err));
}); });
const deviceid = 'no_exist_device_id'; const deviceid = 'no_exist_device_id';
kvStore.removeDeviceData(deviceid).then((err) => { kvStore.removeDeviceData(deviceid).then((err) => {
console.log('removeDeviceData success'); console.log('removeDeviceData success');
}).catch((err) => { }).catch((err) => {
console.log('removeDeviceData fail ' + JSON.stringify(err)); console.log('removeDeviceData fail ' + JSON.stringify(err));
}); });
kvStore.get(KEY_TEST_STRING_ELEMENT).then((data) => { kvStore.get(KEY_TEST_STRING_ELEMENT).then((data) => {
console.log('get success data:' + data); console.log('get success data:' + data);
}).catch((err) => { }).catch((err) => {
console.log('RemoveDeviceData get fail ' + JSON.stringify(err)); console.log('RemoveDeviceData get fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('RemoveDeviceData e ' + e); console.log('RemoveDeviceData e ' + e);
} }
``` ```
### on<sup>8+</sup> ### ### on<sup>8+</sup> ###
...@@ -3731,23 +3713,23 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt ...@@ -3731,23 +3713,23 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_FLOAT_ELEMENT = 'key_test_float'; const KEY_TEST_FLOAT_ELEMENT = 'key_test_float';
const VALUE_TEST_FLOAT_ELEMENT = 321.12; const VALUE_TEST_FLOAT_ELEMENT = 321.12;
try { try {
kvStore.on('syncComplete', function (data) { kvStore.on('syncComplete', function (data) {
console.log('syncComplete ' + data) console.log('syncComplete ' + data)
}); });
kvStore.put(KEY_TEST_FLOAT_ELEMENT, VALUE_TEST_FLOAT_ELEMENT).then((data) => { kvStore.put(KEY_TEST_FLOAT_ELEMENT, VALUE_TEST_FLOAT_ELEMENT).then((data) => {
console.log('syncComplete put success'); console.log('syncComplete put success');
}).catch((error) => { }).catch((error) => {
console.log('syncComplete put fail ' + error); console.log('syncComplete put fail ' + error);
}); });
}catch(e) { }catch(e) {
console.log('syncComplete put e ' + e); console.log('syncComplete put e ' + e);
} }
``` ```
### off<sup>8+</sup> ### ### off<sup>8+</sup> ###
...@@ -3765,21 +3747,20 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]& ...@@ -3765,21 +3747,20 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]&
| event |'syncComplete' | 是 |同步完成时触发的事件名。 | | event |'syncComplete' | 是 |同步完成时触发的事件名。 |
| syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 否 |用于向调用方发送同步结果的回调。 | | syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 否 |用于向调用方发送同步结果的回调。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
const func = function (data) { const func = function (data) {
console.log('syncComplete ' + data) console.log('syncComplete ' + data)
}; };
kvStore.on('syncComplete', func); kvStore.on('syncComplete', func);
kvStore.off('syncComplete', func); kvStore.off('syncComplete', func);
}catch(e) { }catch(e) {
console.log('syncComplete e ' + e); console.log('syncComplete e ' + e);
} }
``` ```
### sync ### sync
...@@ -3801,10 +3782,10 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void ...@@ -3801,10 +3782,10 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
**示例**： **示例**：
``` ```
let kvStore; let kvStore;
kvStore.sync('deviceIds', distributedData.SyncMode.PULL_ONLY, 1000); kvStore.sync('deviceIds', distributedData.SyncMode.PULL_ONLY, 1000);
``` ```
### setSyncParam<sup>8+</sup> ### ### setSyncParam<sup>8+</sup> ###
...@@ -3821,20 +3802,19 @@ setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;) ...@@ -3821,20 +3802,19 @@ setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;)
| defaultAllowedDelayMs |number | 是 |表示数据库同步允许的默认延迟，以毫秒为单位。 | | defaultAllowedDelayMs |number | 是 |表示数据库同步允许的默认延迟，以毫秒为单位。 |
| callback |AsyncCallback&lt;void&gt; | 是 |回调函数。 | | callback |AsyncCallback&lt;void&gt; | 是 |回调函数。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
const defaultAllowedDelayMs = 500; const defaultAllowedDelayMs = 500;
kvStore.setSyncParam(defaultAllowedDelayMs, function (err,data) { kvStore.setSyncParam(defaultAllowedDelayMs, function (err,data) {
console.log('SetSyncParam put success'); console.log('SetSyncParam put success');
}); });
}catch(e) { }catch(e) {
console.log('testSingleKvStoreSetSyncParam e ' + e); console.log('testSingleKvStoreSetSyncParam e ' + e);
} }
``` ```
### setSyncParam<sup>8+</sup> ### ### setSyncParam<sup>8+</sup> ###
...@@ -3860,19 +3840,19 @@ setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt; ...@@ -3860,19 +3840,19 @@ setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
const defaultAllowedDelayMs = 500; const defaultAllowedDelayMs = 500;
kvStore.setSyncParam(defaultAllowedDelayMs).then((err) => { kvStore.setSyncParam(defaultAllowedDelayMs).then((err) => {
console.log('SetSyncParam put success'); console.log('SetSyncParam put success');
}).catch((err) => { }).catch((err) => {
console.log('SetSyncParam put fail ' + JSON.stringify(err)); console.log('SetSyncParam put fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('SetSyncParam e ' + e); console.log('SetSyncParam e ' + e);
} }
``` ```
### getSecurityLevel<sup>8+</sup> ### ### getSecurityLevel<sup>8+</sup> ###
...@@ -3891,16 +3871,16 @@ getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void ...@@ -3891,16 +3871,16 @@ getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.getSecurityLevel(function (err,data) { kvStore.getSecurityLevel(function (err,data) {
console.log('getSecurityLevel success'); console.log('getSecurityLevel success');
}); });
}catch(e) { }catch(e) {
console.log('GetSecurityLeve e ' + e); console.log('GetSecurityLeve e ' + e);
} }
``` ```
### getSecurityLevel<sup>8+</sup> ### ### getSecurityLevel<sup>8+</sup> ###
...@@ -3917,21 +3897,20 @@ getSecurityLevel(): Promise&lt;SecurityLevel&gt; ...@@ -3917,21 +3897,20 @@ getSecurityLevel(): Promise&lt;SecurityLevel&gt;
| ------ | ------- | | ------ | ------- |
|Promise&lt;[SecurityLevel](#securitylevel)&gt; |Promise实例，用于获取异步返回结果。| |Promise&lt;[SecurityLevel](#securitylevel)&gt; |Promise实例，用于获取异步返回结果。|
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
kvStore.getSecurityLevel().then((data) => { kvStore.getSecurityLevel().then((data) => {
console.log(' getSecurityLevel success'); console.log(' getSecurityLevel success');
}).catch((err) => { }).catch((err) => {
console.log('getSecurityLevel fail ' + JSON.stringify(err)); console.log('getSecurityLevel fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('GetSecurityLeve e ' + e); console.log('GetSecurityLeve e ' + e);
} }
``` ```
## DeviceKVStore<sup>8+</sup> ## ## DeviceKVStore<sup>8+</sup> ##
...@@ -3954,26 +3933,25 @@ get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|num ...@@ -3954,26 +3933,25 @@ get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|num
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| deviceId |string | 是 |标识要查询其数据的设备。 | | deviceId |string | 是 |标识要查询其数据的设备。 |
| key |string | 是 |表示要查询 key 值的键。 | | key |string | 是 |表示要查询 key 值的键。 |
| callback |AsyncCallback&lt;boolean/string/number/Uint8Array&gt; | 是 |回调函数，返回匹配给定条件的字符串值。 | | callback |AsyncCallback&lt;boolean\|string\|number\|Uint8Array&gt; | 是 |回调函数，返回匹配给定条件的字符串值。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string_2'; const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
const VALUE_TEST_STRING_ELEMENT = 'value-string-002'; const VALUE_TEST_STRING_ELEMENT = 'value-string-002';
try{ try{
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err,data) { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err,data) {
console.log('put success'); console.log('put success');
kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT, function (err,data) { kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT, function (err,data) {
console.log('get success'); console.log('get success');
}); });
}) })
}catch(e) { }catch(e) {
console.log('get e' + e); console.log('get e' + e);
} }
``` ```
### get<sup>8+</sup> ### ### get<sup>8+</sup> ###
...@@ -3995,29 +3973,29 @@ get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array& ...@@ -3995,29 +3973,29 @@ get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array&
| 类型 | 说明 | | 类型 | 说明 |
| ------ | ------- | | ------ | ------- |
|Promise&lt;boolean/string/number/Uint8Array&gt; |Promise实例，用于获取异步返回结果。| |Promise&lt;boolean\|string\|number\|Uint8Array&gt; |Promise实例，用于获取异步返回结果。|
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string_2'; const KEY_TEST_STRING_ELEMENT = 'key_test_string_2';
const VALUE_TEST_STRING_ELEMENT = 'value-string-002'; const VALUE_TEST_STRING_ELEMENT = 'value-string-002';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(async (data) => { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then(async (data) => {
console.log(' put success'); console.log(' put success');
kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT).then((data) => { kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT).then((data) => {
console.log('get success'); console.log('get success');
}).catch((err) => { }).catch((err) => {
console.log('get fail ' + JSON.stringify(err)); console.log('get fail ' + JSON.stringify(err));
});
}).catch((error) => {
console.log('put error' + error);
}); });
} catch (e) { }).catch((error) => {
console.log('Get e ' + e); console.log('put error' + error);
} });
``` } catch (e) {
console.log('Get e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -4038,34 +4016,34 @@ getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry ...@@ -4038,34 +4016,34 @@ getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
console.log('entries: ' + entries); entries.push(entry);
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
await kvStore.getEntries('localDeviceId', 'batch_test_string_key', function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
}catch(e) {
console.log('PutBatch e ' + e);
} }
``` console.log('entries: ' + entries);
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
await kvStore.getEntries('localDeviceId', 'batch_test_string_key', function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
}catch(e) {
console.log('PutBatch e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -4091,40 +4069,40 @@ getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt; ...@@ -4091,40 +4069,40 @@ getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
console.log('entries: ' + entries); entries.push(entry);
kvStore.putBatch(entries).then(async (err) => { }
console.log('putBatch success'); console.log('entries: ' + entries);
await kvStore.getEntries('localDeviceId', 'batch_test_string_key').then((entrys) => { kvStore.putBatch(entries).then(async (err) => {
console.log('getEntries success'); console.log('putBatch success');
console.log('entrys.length: ' + entrys.length); await kvStore.getEntries('localDeviceId', 'batch_test_string_key').then((entrys) => {
console.log('entrys[0]: ' + JSON.stringify(entrys[0])); console.log('getEntries success');
console.log('entrys[0].value: ' + JSON.stringify(entrys[0].value)); console.log('entrys.length: ' + entrys.length);
console.log('entrys[0].value.value: ' + entrys[0].value.value); console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
}).catch((err) => { console.log('entrys[0].value: ' + JSON.stringify(entrys[0].value));
console.log('getEntries fail ' + JSON.stringify(err)); console.log('entrys[0].value.value: ' + entrys[0].value.value);
});
}).catch((err) => { }).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err)); console.log('getEntries fail ' + JSON.stringify(err));
}); });
}catch(e) { }).catch((err) => {
console.log('PutBatch e ' + e); console.log('putBatch fail ' + JSON.stringify(err));
} });
``` }catch(e) {
console.log('PutBatch e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -4144,40 +4122,40 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void ...@@ -4144,40 +4122,40 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_bool_key'; var key = 'batch_test_bool_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.BYTE_ARRAY, type : distributedData.ValueType.BYTE_ARRAY,
value : arr value : arr
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
expect(err == undefined).assertTrue();
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
await kvStore.getEntries(query, function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
console.log('GetEntries success');
}catch(e) {
console.log('GetEntries e ' + e);
} }
``` console.log('entries: ' + JSON.stringify(entries));
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
expect(err == undefined).assertTrue();
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
await kvStore.getEntries(query, function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
});
});
console.log('GetEntries success');
}catch(e) {
console.log('GetEntries e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -4202,40 +4180,40 @@ getEntries(query: Query): Promise&lt;Entry[]&gt; ...@@ -4202,40 +4180,40 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_bool_key'; var key = 'batch_test_bool_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.BYTE_ARRAY, type : distributedData.ValueType.BYTE_ARRAY,
value : arr value : arr
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries).then(async (err) => { }
console.log('putBatch success'); console.log('entries: ' + JSON.stringify(entries));
const query = new distributedData.Query(); kvStore.putBatch(entries).then(async (err) => {
query.prefixKey("batch_test"); console.log('putBatch success');
await kvStore.getEntries(query).then((entrys) => { const query = new distributedData.Query();
console.log('getEntries success'); query.prefixKey("batch_test");
}).catch((err) => { await kvStore.getEntries(query).then((entrys) => {
console.log('getEntries fail ' + JSON.stringify(err)); console.log('getEntries success');
});
}).catch((err) => { }).catch((err) => {
console.log('GetEntries putBatch fail ' + JSON.stringify(err)) console.log('getEntries fail ' + JSON.stringify(err));
}); });
console.log('GetEntries success'); }).catch((err) => {
}catch(e) { console.log('GetEntries putBatch fail ' + JSON.stringify(err))
console.log('GetEntries e ' + e); });
} console.log('GetEntries success');
``` }catch(e) {
console.log('GetEntries e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -4256,40 +4234,40 @@ getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt ...@@ -4256,40 +4234,40 @@ getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_bool_key'; var key = 'batch_test_bool_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.BYTE_ARRAY, type : distributedData.ValueType.BYTE_ARRAY,
value : arr value : arr
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
expect(err == undefined).assertTrue();
var query = new distributedData.Query();
query.deviceId('localDeviceId');
query.prefixKey("batch_test");
await kvStore.getEntries('localDeviceId', query, function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
})
});
console.log('GetEntries success');
}catch(e) {
console.log('GetEntries e ' + e);
} }
``` console.log('entries: ' + JSON.stringify(entries));
kvStore.putBatch(entries, async function (err,data) {
console.log('putBatch success');
expect(err == undefined).assertTrue();
var query = new distributedData.Query();
query.deviceId('localDeviceId');
query.prefixKey("batch_test");
await kvStore.getEntries('localDeviceId', query, function (err,entrys) {
console.log('getEntries success');
console.log('entrys.length: ' + entrys.length);
console.log('entrys[0]: ' + JSON.stringify(entrys[0]));
})
});
console.log('GetEntries success');
}catch(e) {
console.log('GetEntries e ' + e);
}
```
### getEntries<sup>8+</sup> ### ### getEntries<sup>8+</sup> ###
...@@ -4315,41 +4293,41 @@ getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt; ...@@ -4315,41 +4293,41 @@ getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_bool_key'; var key = 'batch_test_bool_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.BYTE_ARRAY, type : distributedData.ValueType.BYTE_ARRAY,
value : arr value : arr
}
} }
entries.push(entry);
} }
console.log('entries: ' + JSON.stringify(entries)); entries.push(entry);
kvStore.putBatch(entries).then(async (err) => { }
console.log('putBatch success'); console.log('entries: ' + JSON.stringify(entries));
var query = new distributedData.Query(); kvStore.putBatch(entries).then(async (err) => {
query.deviceId('localDeviceId'); console.log('putBatch success');
query.prefixKey("batch_test"); var query = new distributedData.Query();
await kvStore.getEntries('localDeviceId', query).then((entrys) => { query.deviceId('localDeviceId');
console.log('getEntries success'); query.prefixKey("batch_test");
}).catch((err) => { await kvStore.getEntries('localDeviceId', query).then((entrys) => {
console.log('getEntries fail ' + JSON.stringify(err)); console.log('getEntries success');
});
}).catch((err) => { }).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err)); console.log('getEntries fail ' + JSON.stringify(err));
}); });
console.log('GetEntries success'); }).catch((err) => {
}catch(e) { console.log('putBatch fail ' + JSON.stringify(err));
console.log('GetEntries e ' + e); });
} console.log('GetEntries success');
``` }catch(e) {
console.log('GetEntries e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -4370,21 +4348,21 @@ getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvS ...@@ -4370,21 +4348,21 @@ getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvS
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('localDeviceId', 'batch_test_string_key', async function (err, result) { kvStore.getResultSet('localDeviceId', 'batch_test_string_key', async function (err, result) {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
await kvStore.closeResultSet(resultSet, function (err, data) { await kvStore.closeResultSet(resultSet, function (err, data) {
console.log('closeResultSet success'); console.log('closeResultSet success');
}) })
}); });
}catch(e) { }catch(e) {
console.log('GetResultSet e ' + e); console.log('GetResultSet e ' + e);
} }
``` ```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -4410,25 +4388,25 @@ getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&g ...@@ -4410,25 +4388,25 @@ getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&g
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
kvStore.getResultSet('localDeviceId', 'batch_test_string_key').then((result) => { kvStore.getResultSet('localDeviceId', 'batch_test_string_key').then((result) => {
console.log('getResultSet success'); console.log('getResultSet success');
resultSet = result; resultSet = result;
}).catch((err) => { }).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err)); console.log('getResultSet fail ' + JSON.stringify(err));
}); });
kvStore.closeResultSet(resultSet).then((err) => { kvStore.closeResultSet(resultSet).then((err) => {
console.log('closeResultSet success'); console.log('closeResultSet success');
}).catch((err) => { }).catch((err) => {
console.log('closeResultSet fail ' + JSON.stringify(err)); console.log('closeResultSet fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('GetResultSet e ' + e); console.log('GetResultSet e ' + e);
} }
``` ```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -4448,39 +4426,39 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi ...@@ -4448,39 +4426,39 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err, data) { entries.push(entry);
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
await kvStore.getResultSet(query, async function (err, result) {
console.log('getResultSet success');
resultSet = result;
await kvStore.closeResultSet(resultSet, function (err, data) {
console.log('closeResultSet success');
})
});
});
} catch(e) {
console.log('GetResultSet e ' + e);
} }
``` kvStore.putBatch(entries, async function (err, data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
await kvStore.getResultSet(query, async function (err, result) {
console.log('getResultSet success');
resultSet = result;
await kvStore.closeResultSet(resultSet, function (err, data) {
console.log('closeResultSet success');
})
});
});
} catch(e) {
console.log('GetResultSet e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -4505,46 +4483,46 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt; ...@@ -4505,46 +4483,46 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries).then(async (err) => { entries.push(entry);
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + err);
});
const query = new distributedData.Query();
query.deviceId('localDeviceId');
query.prefixKey("batch_test");
console.log("GetResultSet " + query.getSqlLike());
kvStore.getResultSet(query).then((result) => {
console.log('getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
kvStore.closeResultSet(resultSet).then((err) => {
console.log('closeResultSet success');
}).catch((err) => {
console.log('closeResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSet e ' + e);
} }
``` kvStore.putBatch(entries).then(async (err) => {
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + err);
});
const query = new distributedData.Query();
query.deviceId('localDeviceId');
query.prefixKey("batch_test");
console.log("GetResultSet " + query.getSqlLike());
kvStore.getResultSet(query).then((result) => {
console.log('getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
kvStore.closeResultSet(resultSet).then((err) => {
console.log('closeResultSet success');
}).catch((err) => {
console.log('closeResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSet e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -4565,38 +4543,38 @@ getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreR ...@@ -4565,38 +4543,38 @@ getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreR
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err, data) { entries.push(entry);
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSet('localDeviceId', query, async function (err, result) {
console.log('getResultSet success');
resultSet = result;
await kvStore.closeResultSet(resultSet, function (err, data) {
console.log('closeResultSet success');
})
});
});
} catch(e) {
console.log('GetResultSet e ' + e);
} }
``` kvStore.putBatch(entries, async function (err, data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSet('localDeviceId', query, async function (err, result) {
console.log('getResultSet success');
resultSet = result;
await kvStore.closeResultSet(resultSet, function (err, data) {
console.log('closeResultSet success');
})
});
});
} catch(e) {
console.log('GetResultSet e ' + e);
}
```
### getResultSet<sup>8+</sup> ### ### getResultSet<sup>8+</sup> ###
...@@ -4622,47 +4600,47 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt; ...@@ -4622,47 +4600,47 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries).then(async (err) => { entries.push(entry);
console.log('GetResultSet putBatch success');
}).catch((err) => {
console.log('PutBatch putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSet('localDeviceId', query).then((result) => {
console.log('GetResultSet getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('GetResultSet getResultSet fail ' + JSON.stringify(err));
});
query.deviceId('localDeviceId');
console.log("GetResultSet " + query.getSqlLike());
kvStore.closeResultSet(resultSet).then((err) => {
console.log('GetResultSet closeResultSet success');
}).catch((err) => {
console.log('GetResultSet closeResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSet e ' + e);
} }
``` kvStore.putBatch(entries).then(async (err) => {
console.log('GetResultSet putBatch success');
}).catch((err) => {
console.log('PutBatch putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSet('localDeviceId', query).then((result) => {
console.log('GetResultSet getResultSet success');
resultSet = result;
}).catch((err) => {
console.log('GetResultSet getResultSet fail ' + JSON.stringify(err));
});
query.deviceId('localDeviceId');
console.log("GetResultSet " + query.getSqlLike());
kvStore.closeResultSet(resultSet).then((err) => {
console.log('GetResultSet closeResultSet success');
}).catch((err) => {
console.log('GetResultSet closeResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSet e ' + e);
}
```
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
...@@ -4682,22 +4660,22 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;) ...@@ -4682,22 +4660,22 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;)
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
console.log('CloseResultSet success'); console.log('CloseResultSet success');
let resultSet = null; let resultSet = null;
kvStore.closeResultSet(resultSet, function (err, data) { kvStore.closeResultSet(resultSet, function (err, data) {
if (err == undefined) { if (err == undefined) {
console.log('closeResultSet success'); console.log('closeResultSet success');
} else { } else {
console.log('closeResultSet fail'); console.log('closeResultSet fail');
} }
}); });
}catch(e) { }catch(e) {
console.log('CloseResultSet e ' + e); console.log('CloseResultSet e ' + e);
} }
``` ```
### closeResultSet<sup>8+</sup> ### ### closeResultSet<sup>8+</sup> ###
...@@ -4722,20 +4700,20 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt; ...@@ -4722,20 +4700,20 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
console.log('CloseResultSet success'); console.log('CloseResultSet success');
let resultSet = null; let resultSet = null;
kvStore.closeResultSet(resultSet).then(() => { kvStore.closeResultSet(resultSet).then(() => {
console.log('closeResultSet success'); console.log('closeResultSet success');
}).catch((err) => { }).catch((err) => {
console.log('closeResultSet fail ' + JSON.stringify(err)); console.log('closeResultSet fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('CloseResultSet e ' + e); console.log('CloseResultSet e ' + e);
} }
``` ```
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
...@@ -4755,34 +4733,34 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void ...@@ -4755,34 +4733,34 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err, data) { entries.push(entry);
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
await kvStore.getResultSize(query, async function (err, resultSize) {
console.log('getResultSet success');
});
});
} catch(e) {
console.log('GetResultSize e ' + e);
} }
``` kvStore.putBatch(entries, async function (err, data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
await kvStore.getResultSize(query, async function (err, resultSize) {
console.log('getResultSet success');
});
});
} catch(e) {
console.log('GetResultSize e ' + e);
}
```
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
...@@ -4807,38 +4785,38 @@ getResultSize(query: Query): Promise&lt;number&gt; ...@@ -4807,38 +4785,38 @@ getResultSize(query: Query): Promise&lt;number&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries).then(async (err) => { entries.push(entry);
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
kvStore.getResultSize(query).then((resultSize) => {
console.log('getResultSet success');
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSize e ' + e);
} }
``` kvStore.putBatch(entries).then(async (err) => {
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
const query = new distributedData.Query();
query.prefixKey("batch_test");
query.deviceId('localDeviceId');
kvStore.getResultSize(query).then((resultSize) => {
console.log('getResultSet success');
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSize e ' + e);
}
```
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
...@@ -4859,33 +4837,33 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number& ...@@ -4859,33 +4837,33 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number&
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries, async function (err, data) { entries.push(entry);
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSize('localDeviceId', query, async function (err, resultSize) {
console.log('getResultSet success');
});
});
} catch(e) {
console.log('GetResultSize e ' + e);
} }
``` kvStore.putBatch(entries, async function (err, data) {
console.log('putBatch success');
const query = new distributedData.Query();
query.prefixKey("batch_test");
await kvStore.getResultSize('localDeviceId', query, async function (err, resultSize) {
console.log('getResultSet success');
});
});
} catch(e) {
console.log('GetResultSize e ' + e);
}
```
### getResultSize<sup>8+</sup> ### ### getResultSize<sup>8+</sup> ###
...@@ -4911,37 +4889,37 @@ getResultSize(deviceId: string, query: Query): Promise&lt;number&gt; ...@@ -4911,37 +4889,37 @@ getResultSize(deviceId: string, query: Query): Promise&lt;number&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
for (var i = 0; i < 10; i++) { for (var i = 0; i < 10; i++) {
var key = 'batch_test_string_key'; var key = 'batch_test_string_key';
var entry = { var entry = {
key : key + i, key : key + i,
value : { value : {
type : distributedData.ValueType.STRING, type : distributedData.ValueType.STRING,
value : 'batch_test_string_value' value : 'batch_test_string_value'
}
} }
entries.push(entry);
} }
kvStore.putBatch(entries).then(async (err) => { entries.push(entry);
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
var query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSize('localDeviceId', query).then((resultSize) => {
console.log('getResultSet success');
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSize e ' + e);
} }
``` kvStore.putBatch(entries).then(async (err) => {
console.log('putBatch success');
}).catch((err) => {
console.log('putBatch fail ' + JSON.stringify(err));
});
var query = new distributedData.Query();
query.prefixKey("batch_test");
kvStore.getResultSize('localDeviceId', query).then((resultSize) => {
console.log('getResultSet success');
}).catch((err) => {
console.log('getResultSet fail ' + JSON.stringify(err));
});
}catch(e) {
console.log('GetResultSize e ' + e);
}
```
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
...@@ -4961,29 +4939,29 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -4961,29 +4939,29 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-string-001'; const VALUE_TEST_STRING_ELEMENT = 'value-string-001';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err,data) { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT, async function (err,data) {
console.log('RemoveDeviceData put success'); console.log('RemoveDeviceData put success');
const deviceid = 'no_exist_device_id'; const deviceid = 'no_exist_device_id';
await kvStore.removeDeviceData(deviceid, async function (err,data) { await kvStore.removeDeviceData(deviceid, async function (err,data) {
if (err == undefined) { if (err == undefined) {
console.log('removeDeviceData success'); console.log('removeDeviceData success');
} else { } else {
console.log('removeDeviceData fail'); console.log('removeDeviceData fail');
await kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT, async function (err,data) { await kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT, async function (err,data) {
console.log('RemoveDeviceData get success'); console.log('RemoveDeviceData get success');
}); });
} }
});
}); });
}catch(e) { });
console.log('RemoveDeviceData e ' + e); }catch(e) {
} console.log('RemoveDeviceData e ' + e);
``` }
```
### removeDeviceData<sup>8+</sup> ### ### removeDeviceData<sup>8+</sup> ###
...@@ -5008,31 +4986,31 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt; ...@@ -5008,31 +4986,31 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_STRING_ELEMENT = 'key_test_string'; const KEY_TEST_STRING_ELEMENT = 'key_test_string';
const VALUE_TEST_STRING_ELEMENT = 'value-string-001'; const VALUE_TEST_STRING_ELEMENT = 'value-string-001';
try { try {
kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((err) => { kvStore.put(KEY_TEST_STRING_ELEMENT, VALUE_TEST_STRING_ELEMENT).then((err) => {
console.log('RemoveDeviceData put success'); console.log('RemoveDeviceData put success');
}).catch((err) => { }).catch((err) => {
console.log('RemoveDeviceData put fail ' + JSON.stringify(err)); console.log('RemoveDeviceData put fail ' + JSON.stringify(err));
}); });
const deviceid = 'no_exist_device_id'; const deviceid = 'no_exist_device_id';
kvStore.removeDeviceData(deviceid).then((err) => { kvStore.removeDeviceData(deviceid).then((err) => {
console.log('removeDeviceData success'); console.log('removeDeviceData success');
}).catch((err) => { }).catch((err) => {
console.log('removeDeviceData fail ' + JSON.stringify(err)); console.log('removeDeviceData fail ' + JSON.stringify(err));
}); });
kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT).then((data) => { kvStore.get('localDeviceId', KEY_TEST_STRING_ELEMENT).then((data) => {
console.log('RemoveDeviceData get success data:' + data); console.log('RemoveDeviceData get success data:' + data);
}).catch((err) => { }).catch((err) => {
console.log('RemoveDeviceData get fail ' + JSON.stringify(err)); console.log('RemoveDeviceData get fail ' + JSON.stringify(err));
}); });
}catch(e) { }catch(e) {
console.log('RemoveDeviceData e ' + e); console.log('RemoveDeviceData e ' + e);
} }
``` ```
### sync<sup>8+</sup> ### ### sync<sup>8+</sup> ###
...@@ -5052,27 +5030,26 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void ...@@ -5052,27 +5030,26 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
| mode |[SyncMode](#syncmode) | 是 |表示同步方式，PUSH、PULL或PUSH_PULL。 | | mode |[SyncMode](#syncmode) | 是 |表示同步方式，PUSH、PULL或PUSH_PULL。 |
| allowedDelayMs |number | 否 |可选参数，允许延时时间，单位：ms（毫秒）。 | | allowedDelayMs |number | 否 |可选参数，允许延时时间，单位：ms（毫秒）。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
const KEY_TEST_SYNC_ELEMENT = 'key_test_sync'; const KEY_TEST_SYNC_ELEMENT = 'key_test_sync';
const VALUE_TEST_SYNC_ELEMENT = 'value-string-001'; const VALUE_TEST_SYNC_ELEMENT = 'value-string-001';
try { try {
kvStore.on('syncComplete', function (data) { kvStore.on('syncComplete', function (data) {
console.log('Sync dataChange'); console.log('Sync dataChange');
}); });
kvStore.put(KEY_TEST_SYNC_ELEMENT + 'testSync101', VALUE_TEST_SYNC_ELEMENT, function (err,data) { kvStore.put(KEY_TEST_SYNC_ELEMENT + 'testSync101', VALUE_TEST_SYNC_ELEMENT, function (err,data) {
console.log('Sync put success'); console.log('Sync put success');
const devices = ['deviceList']; const devices = ['deviceList'];
const mode = distributedData.SyncMode.PULL_ONLY; const mode = distributedData.SyncMode.PULL_ONLY;
kvStore.sync(devices, mode); kvStore.sync(devices, mode);
}); });
}catch(e) { }catch(e) {
console.log('Sync e' + e); console.log('Sync e' + e);
} }
``` ```
### on<sup>8+</sup> ### ### on<sup>8+</sup> ###
...@@ -5091,22 +5068,22 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt ...@@ -5091,22 +5068,22 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt
**示例** **示例**
``` ```
const KEY_TEST_FLOAT_ELEMENT = 'key_test_float'; const KEY_TEST_FLOAT_ELEMENT = 'key_test_float';
const VALUE_TEST_FLOAT_ELEMENT = 321.12; const VALUE_TEST_FLOAT_ELEMENT = 321.12;
try { try {
kvStore.on('syncComplete', function (data) { kvStore.on('syncComplete', function (data) {
console.log('syncComplete ' + data) console.log('syncComplete ' + data)
}); });
kvStore.put(KEY_TEST_FLOAT_ELEMENT, VALUE_TEST_FLOAT_ELEMENT).then((data) => { kvStore.put(KEY_TEST_FLOAT_ELEMENT, VALUE_TEST_FLOAT_ELEMENT).then((data) => {
console.log('syncComplete put success'); console.log('syncComplete put success');
}).catch((error) => { }).catch((error) => {
console.log('syncComplete put fail ' + error); console.log('syncComplete put fail ' + error);
}); });
}catch(e) { }catch(e) {
console.log('syncComplete put e ' + e); console.log('syncComplete put e ' + e);
} }
``` ```
### off<sup>8+</sup> ### ### off<sup>8+</sup> ###
...@@ -5124,21 +5101,20 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]& ...@@ -5124,21 +5101,20 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]&
| event |'syncComplete' | 是 |同步完成时触发的事件名。 | | event |'syncComplete' | 是 |同步完成时触发的事件名。 |
| syncCallback |Callback<Array&lt;[string, number]&gt;&gt; | 否 |用于向调用方发送同步结果的回调。 | | syncCallback |Callback<Array&lt;[string, number]&gt;&gt; | 否 |用于向调用方发送同步结果的回调。 |
**示例** **示例**
``` ```
let kvStore; let kvStore;
try { try {
const func = function (data) { const func = function (data) {
console.log('syncComplete ' + data) console.log('syncComplete ' + data)
}; };
kvStore.on('syncComplete', func); kvStore.on('syncComplete', func);
kvStore.off('syncComplete', func); kvStore.off('syncComplete', func);
}catch(e) { }catch(e) {
console.log('syncComplete e ' + e); console.log('syncComplete e ' + e);
} }
``` ```
## SyncMode ## SyncMode
......
zh-cn/application-dev/website.md
浏览文件 @ e02e7657
...@@ -219,8 +219,8 @@ ...@@ -219,8 +219,8 @@
- [关系型数据库概述](database/database-relational-overview.md) - [关系型数据库概述](database/database-relational-overview.md)
- [关系型数据库开发指导](database/database-relational-guidelines.md) - [关系型数据库开发指导](database/database-relational-guidelines.md)
- 轻量级数据存储 - 轻量级数据存储
- [轻量级数据存储概述](database/database-preference-overview.md) - [轻量级数据存储概述](database/database-storage-overview.md)
- [轻量级数据存储开发指导](database/database-preference-guidelines.md) - [轻量级数据存储开发指导](database/database-storage-guidelines.md)
- 分布式数据对象 - 分布式数据对象
- [分布式数据对象概述](database/database-distributedobject-overview.md) - [分布式数据对象概述](database/database-distributedobject-overview.md)
- [分布式数据对象开发指导](database/database-distributedobject-guidelines.md) - [分布式数据对象开发指导](database/database-distributedobject-guidelines.md)
...@@ -545,7 +545,7 @@ ...@@ -545,7 +545,7 @@
- [访问控制](reference/apis/js-apis-abilityAccessCtrl.md) - [访问控制](reference/apis/js-apis-abilityAccessCtrl.md)
- [通用密钥库系统](reference/apis/js-apis-huks.md) - [通用密钥库系统](reference/apis/js-apis-huks.md)
- 数据管理 - 数据管理
- [轻量级存储](reference/apis/js-apis-data-preferences.md) - [轻量级存储](reference/apis/js-apis-data-storage.md)
- [分布式数据管理](reference/apis/js-apis-distributed-data.md) - [分布式数据管理](reference/apis/js-apis-distributed-data.md)
- [关系型数据库](reference/apis/js-apis-data-rdb.md) - [关系型数据库](reference/apis/js-apis-data-rdb.md)
- [结果集](reference/apis/js-apis-data-resultset.md) - [结果集](reference/apis/js-apis-data-resultset.md)
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或