Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
未验证 提交 f4fc4c6f 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!3723 分布式数据子系统-API样板话统一审视优化修改：需同步翻译 

Merge pull request !3723 from 葛亚芳/master
上级 a3009801 6973367f
显示空白变更内容
内联 并排
Showing with 410 addition and 376 deletion
zh-cn/application-dev/reference/apis/js-apis-data-ability.md
浏览文件 @ f4fc4c6f
...@@ -6,8 +6,8 @@ ...@@ -6,8 +6,8 @@
## 导入模块 ## 导入模块
``` ```js
import dataAbility from '@ohos.data.dataAbility' import dataAbility from '@ohos.data.dataAbility';
``` ```
...@@ -24,8 +24,8 @@ createRdbPredicates(name: string, dataAbilityPredicates: DataAbilityPredicates): ...@@ -24,8 +24,8 @@ createRdbPredicates(name: string, dataAbilityPredicates: DataAbilityPredicates):
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| name | string | 是 | 数据库表中表名。 | | name | string | 是 | 数据库表中的表名。 |
| dataAbilityPredicates | [DataAbilityPredicates](#dataabilitypredicates) | 是 | dataAbility谓词。 | | dataAbilityPredicates | [DataAbilityPredicates](#dataabilitypredicates) | 是 | DataAbility谓词。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -33,7 +33,7 @@ createRdbPredicates(name: string, dataAbilityPredicates: DataAbilityPredicates): ...@@ -33,7 +33,7 @@ createRdbPredicates(name: string, dataAbilityPredicates: DataAbilityPredicates):
| rdb.[RdbPredicates](js-apis-data-rdb.md#rdbpredicates) | 返回RdbPredicates对象。 | | rdb.[RdbPredicates](js-apis-data-rdb.md#rdbpredicates) | 返回RdbPredicates对象。 |
- 示例： - 示例：
``` ```js
let dataAbilityPredicates = new dataAbility.DataAbilityPredicates() let dataAbilityPredicates = new dataAbility.DataAbilityPredicates()
dataAbilityPredicates.equalTo("NAME", "Rose").between("AGE", 16, 30) dataAbilityPredicates.equalTo("NAME", "Rose").between("AGE", 16, 30)
let predicates = dataAbility.createRdbPredicates("EMPLOYEE", dataAbilityPredicates) let predicates = dataAbility.createRdbPredicates("EMPLOYEE", dataAbilityPredicates)
...@@ -59,7 +59,7 @@ equalTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -59,7 +59,7 @@ equalTo(field: string, value: ValueType): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示要与谓词匹配的值。 | | value | [ValueType](#valuetype) | 是 | 指示要与谓词匹配的值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -67,7 +67,7 @@ equalTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -67,7 +67,7 @@ equalTo(field: string, value: ValueType): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "lisi") predicates.equalTo("NAME", "lisi")
``` ```
...@@ -87,7 +87,7 @@ notEqualTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -87,7 +87,7 @@ notEqualTo(field: string, value: ValueType): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示要与谓词匹配的值。 | | value | [ValueType](#valuetype) | 是 | 指示要与谓词匹配的值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -95,7 +95,7 @@ notEqualTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -95,7 +95,7 @@ notEqualTo(field: string, value: ValueType): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.notEqualTo("NAME", "lisi") predicates.notEqualTo("NAME", "lisi")
``` ```
...@@ -117,7 +117,7 @@ beginWrap(): DataAbilityPredicates ...@@ -117,7 +117,7 @@ beginWrap(): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回带有左括号的DataAbility谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回带有左括号的DataAbility谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbilitylity.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbilitylity.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "lisi") predicates.equalTo("NAME", "lisi")
.beginWrap() .beginWrap()
...@@ -144,7 +144,7 @@ endWrap(): DataAbilityPredicates ...@@ -144,7 +144,7 @@ endWrap(): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回带有右括号的DataAbility谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回带有右括号的DataAbility谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "lisi") predicates.equalTo("NAME", "lisi")
.beginWrap() .beginWrap()
...@@ -171,7 +171,7 @@ or(): DataAbilityPredicates ...@@ -171,7 +171,7 @@ or(): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回带有或条件的DataAbility谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回带有或条件的DataAbility谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Lisa") predicates.equalTo("NAME", "Lisa")
.or() .or()
...@@ -185,7 +185,7 @@ or(): DataAbilityPredicates ...@@ -185,7 +185,7 @@ or(): DataAbilityPredicates
and(): DataAbilityPredicates and(): DataAbilityPredicates
向谓词添加和条件。 将和条件添加到谓词中。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。
...@@ -195,7 +195,7 @@ and(): DataAbilityPredicates ...@@ -195,7 +195,7 @@ and(): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回带有和条件的DataAbility谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回带有和条件的DataAbility谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Lisa") predicates.equalTo("NAME", "Lisa")
.and() .and()
...@@ -209,7 +209,7 @@ and(): DataAbilityPredicates ...@@ -209,7 +209,7 @@ and(): DataAbilityPredicates
contains(field: string, value: string): DataAbilityPredicates contains(field: string, value: string): DataAbilityPredicates
配置谓词以匹配数据类型为String且value包含指定值的字段。 配置谓词以匹配数据类型为string且value包含指定值的字段。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。
...@@ -225,7 +225,7 @@ contains(field: string, value: string): DataAbilityPredicates ...@@ -225,7 +225,7 @@ contains(field: string, value: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.contains("NAME", "os") predicates.contains("NAME", "os")
``` ```
...@@ -237,7 +237,7 @@ contains(field: string, value: string): DataAbilityPredicates ...@@ -237,7 +237,7 @@ contains(field: string, value: string): DataAbilityPredicates
beginsWith(field: string, value: string): DataAbilityPredicates beginsWith(field: string, value: string): DataAbilityPredicates
配置谓词以匹配数据类型为String且值以指定字符串开头的字段。 配置谓词以匹配数据类型为string且值以指定字符串开头的字段。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。
...@@ -253,7 +253,7 @@ beginsWith(field: string, value: string): DataAbilityPredicates ...@@ -253,7 +253,7 @@ beginsWith(field: string, value: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.beginsWith("NAME", "os") predicates.beginsWith("NAME", "os")
``` ```
...@@ -265,7 +265,7 @@ beginsWith(field: string, value: string): DataAbilityPredicates ...@@ -265,7 +265,7 @@ beginsWith(field: string, value: string): DataAbilityPredicates
endsWith(field: string, value: string): DataAbilityPredicates endsWith(field: string, value: string): DataAbilityPredicates
配置谓词以匹配数据类型为String且值以指定字符串结尾的字段。 配置谓词以匹配数据类型为string且值以指定字符串结尾的字段。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。
...@@ -308,7 +308,7 @@ isNull(field: string): DataAbilityPredicates ...@@ -308,7 +308,7 @@ isNull(field: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.isNull("NAME") predicates.isNull("NAME")
``` ```
...@@ -335,7 +335,7 @@ isNotNull(field: string): DataAbilityPredicates ...@@ -335,7 +335,7 @@ isNotNull(field: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.isNotNull("NAME") predicates.isNotNull("NAME")
``` ```
...@@ -363,7 +363,7 @@ like(field: string, value: string): DataAbilityPredicates ...@@ -363,7 +363,7 @@ like(field: string, value: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.like("NAME", "%os%") predicates.like("NAME", "%os%")
``` ```
...@@ -375,7 +375,7 @@ like(field: string, value: string): DataAbilityPredicates ...@@ -375,7 +375,7 @@ like(field: string, value: string): DataAbilityPredicates
glob(field: string, value: string): DataAbilityPredicates glob(field: string, value: string): DataAbilityPredicates
配置谓词匹配数据类型为string的指定字段。 配置谓词以匹配数据类型为string的指定字段。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。
...@@ -391,7 +391,7 @@ glob(field: string, value: string): DataAbilityPredicates ...@@ -391,7 +391,7 @@ glob(field: string, value: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.glob("NAME", "?h*g") predicates.glob("NAME", "?h*g")
``` ```
...@@ -403,7 +403,7 @@ glob(field: string, value: string): DataAbilityPredicates ...@@ -403,7 +403,7 @@ glob(field: string, value: string): DataAbilityPredicates
between(field: string, low: ValueType, high: ValueType): DataAbilityPredicates between(field: string, low: ValueType, high: ValueType): DataAbilityPredicates
将谓词配置为匹配数据类型为ValueType且value在指定范围内的指定字段。 配置谓词以匹配数据类型为ValueType且value在指定范围内的指定字段。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。
...@@ -411,8 +411,8 @@ between(field: string, low: ValueType, high: ValueType): DataAbilityPredicates ...@@ -411,8 +411,8 @@ between(field: string, low: ValueType, high: ValueType): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| low | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示与谓词匹配的最小值。 | | low | [ValueType](#valuetype) | 是 | 指示与谓词匹配的最小值。 |
| high | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示与谓词匹配的最大值。 | | high | [ValueType](#valuetype) | 是 | 指示与谓词匹配的最大值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -420,7 +420,7 @@ between(field: string, low: ValueType, high: ValueType): DataAbilityPredicates ...@@ -420,7 +420,7 @@ between(field: string, low: ValueType, high: ValueType): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.between("AGE", 10, 50) predicates.between("AGE", 10, 50)
``` ```
...@@ -440,8 +440,8 @@ notBetween(field: string, low: ValueType, high: ValueType): DataAbilityPredicate ...@@ -440,8 +440,8 @@ notBetween(field: string, low: ValueType, high: ValueType): DataAbilityPredicate
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| low | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示与谓词匹配的最小值。 | | low | [ValueType](#valuetype) | 是 | 指示与谓词匹配的最小值。 |
| high | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示与谓词匹配的最大值。 | | high | [ValueType](#valuetype) | 是 | 指示与谓词匹配的最大值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -449,7 +449,7 @@ notBetween(field: string, low: ValueType, high: ValueType): DataAbilityPredicate ...@@ -449,7 +449,7 @@ notBetween(field: string, low: ValueType, high: ValueType): DataAbilityPredicate
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.notBetween("AGE", 10, 50) predicates.notBetween("AGE", 10, 50)
``` ```
...@@ -469,7 +469,7 @@ greaterThan(field: string, value: ValueType): DataAbilityPredicates ...@@ -469,7 +469,7 @@ greaterThan(field: string, value: ValueType): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示要与谓词匹配的值。 | | value | [ValueType](#valuetype) | 是 | 指示要与谓词匹配的值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -477,7 +477,7 @@ greaterThan(field: string, value: ValueType): DataAbilityPredicates ...@@ -477,7 +477,7 @@ greaterThan(field: string, value: ValueType): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.greaterThan("AGE", 18) predicates.greaterThan("AGE", 18)
``` ```
...@@ -497,7 +497,7 @@ lessThan(field: string, value: ValueType): DataAbilityPredicates ...@@ -497,7 +497,7 @@ lessThan(field: string, value: ValueType): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示要与谓词匹配的值。 | | value | [ValueType](#valuetype) | 是 | 指示要与谓词匹配的值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -505,7 +505,7 @@ lessThan(field: string, value: ValueType): DataAbilityPredicates ...@@ -505,7 +505,7 @@ lessThan(field: string, value: ValueType): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.lessThan("AGE", 20) predicates.lessThan("AGE", 20)
``` ```
...@@ -525,7 +525,7 @@ greaterThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -525,7 +525,7 @@ greaterThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示要与谓词匹配的值。 | | value | [ValueType](#valuetype) | 是 | 指示要与谓词匹配的值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -533,7 +533,7 @@ greaterThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -533,7 +533,7 @@ greaterThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.greaterThanOrEqualTo("AGE", 18) predicates.greaterThanOrEqualTo("AGE", 18)
``` ```
...@@ -553,7 +553,7 @@ lessThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -553,7 +553,7 @@ lessThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | [ValueType](js-apis-data-rdb.md#valuetype) | 是 | 指示要与谓词匹配的值。 | | value | [ValueType](#valuetype) | 是 | 指示要与谓词匹配的值。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -561,7 +561,7 @@ lessThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates ...@@ -561,7 +561,7 @@ lessThanOrEqualTo(field: string, value: ValueType): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.lessThanOrEqualTo("AGE", 20) predicates.lessThanOrEqualTo("AGE", 20)
``` ```
...@@ -588,7 +588,7 @@ orderByAsc(field: string): DataAbilityPredicates ...@@ -588,7 +588,7 @@ orderByAsc(field: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.orderByAsc("NAME") predicates.orderByAsc("NAME")
``` ```
...@@ -615,7 +615,7 @@ orderByDesc(field: string): DataAbilityPredicates ...@@ -615,7 +615,7 @@ orderByDesc(field: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.orderByDesc("AGE") predicates.orderByDesc("AGE")
``` ```
...@@ -637,7 +637,7 @@ distinct(): DataAbilityPredicates ...@@ -637,7 +637,7 @@ distinct(): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回可用于过滤重复记录的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回可用于过滤重复记录的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose").distinct("NAME") predicates.equalTo("NAME", "Rose").distinct("NAME")
let promiseDistinct = rdbStore.query(predicates, ["NAME"]) let promiseDistinct = rdbStore.query(predicates, ["NAME"])
...@@ -670,7 +670,7 @@ limitAs(value: number): DataAbilityPredicates ...@@ -670,7 +670,7 @@ limitAs(value: number): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回可用于设置最大数据记录数的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回可用于设置最大数据记录数的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose").limitAs(3) predicates.equalTo("NAME", "Rose").limitAs(3)
``` ```
...@@ -697,7 +697,7 @@ offsetAs(rowOffset: number): DataAbilityPredicates ...@@ -697,7 +697,7 @@ offsetAs(rowOffset: number): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回具有指定返回结果起始位置的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回具有指定返回结果起始位置的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose").offsetAs(3) predicates.equalTo("NAME", "Rose").offsetAs(3)
``` ```
...@@ -724,7 +724,7 @@ groupBy(fields: Array<string>): DataAbilityPredicates ...@@ -724,7 +724,7 @@ groupBy(fields: Array<string>): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回分组查询列的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回分组查询列的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.groupBy(["AGE", "NAME"]) predicates.groupBy(["AGE", "NAME"])
``` ```
...@@ -749,7 +749,7 @@ indexedBy(field: string): DataAbilityPredicates ...@@ -749,7 +749,7 @@ indexedBy(field: string): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回具有指定索引列的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回具有指定索引列的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.indexedBy("SALARY_INDEX") predicates.indexedBy("SALARY_INDEX")
``` ```
...@@ -769,7 +769,7 @@ in(field: string, value: Array<ValueType>): DataAbilityPredicates ...@@ -769,7 +769,7 @@ in(field: string, value: Array<ValueType>): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | Array<[ValueType](js-apis-data-rdb.md#valuetype)> | 是 | 以ValueType型数组形式指定的要匹配的值。 | | value | Array<[ValueType](#valuetype)> | 是 | 以ValueType类型数组形式指定的要匹配的值。 |
- 返回值： - 返回值：
...@@ -778,7 +778,7 @@ in(field: string, value: Array<ValueType>): DataAbilityPredicates ...@@ -778,7 +778,7 @@ in(field: string, value: Array<ValueType>): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.in("AGE", [18, 20]) predicates.in("AGE", [18, 20])
``` ```
...@@ -798,7 +798,7 @@ notIn(field: string, value: Array<ValueType>): DataAbilityPredicates ...@@ -798,7 +798,7 @@ notIn(field: string, value: Array<ValueType>): DataAbilityPredicates
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| field | string | 是 | 数据库表中的列名。 | | field | string | 是 | 数据库表中的列名。 |
| value | Array<[ValueType](js-apis-data-rdb.md#valuetype)> | 是 | 以ValueType型数组形式指定的要匹配的值。 | | value | Array<[ValueType](#valuetype)> | 是 | 以ValueType类型数组形式指定的要匹配的值。 |
- 返回值： - 返回值：
...@@ -807,8 +807,19 @@ notIn(field: string, value: Array<ValueType>): DataAbilityPredicates ...@@ -807,8 +807,19 @@ notIn(field: string, value: Array<ValueType>): DataAbilityPredicates
| [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 | | [DataAbilityPredicates](#dataabilitypredicates) | 返回与指定字段匹配的谓词。 |
- 示例： - 示例：
``` ```js
let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE") let predicates = new dataAbility.DataAbilityPredicates("EMPLOYEE")
predicates.notIn("NAME", ["Lisa", "Rose"]) predicates.notIn("NAME", ["Lisa", "Rose"])
``` ```
## ValueType
用于表示允许的数据字段类型。
**系统能力**：SystemCapability.DistributedDataManager.DataShare.Core。
| 名称 | 说明 |
| ------- | -------------------- |
| number | 表示值类型为数字。 |
| string | 表示值类型为字符。 |
| boolean | 表示值类型为布尔值。 |
zh-cn/application-dev/reference/apis/js-apis-data-distributedobject.md
浏览文件 @ f4fc4c6f
...@@ -7,7 +7,7 @@ ...@@ -7,7 +7,7 @@
## 导入模块 ## 导入模块
```js ```js
import distributedObject from '@ohos.data.distributedDataObject' import distributedObject from '@ohos.data.distributedDataObject';
``` ```
...@@ -27,9 +27,9 @@ createDistributedObject(source: object): DistributedObject ...@@ -27,9 +27,9 @@ createDistributedObject(source: object): DistributedObject
| source | object | 是 | 设置distributedObject的属性。 | | source | object | 是 | 设置distributedObject的属性。 |
**返回值：** **返回值：**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| [DistributedObject](#distributedobject) | 创建好的分布式对象。 | | [DistributedObject](#distributedobject) | 创建完成的分布式对象。 |
**示例：** **示例：**
```js ```js
...@@ -171,8 +171,6 @@ on(type: 'status', callback: Callback<{ sessionId: string, networkId: string, st ...@@ -171,8 +171,6 @@ on(type: 'status', callback: Callback<{ sessionId: string, networkId: string, st
| type | string | 是 | 事件类型，固定为'status'，表示对象上下线。 | | type | string | 是 | 事件类型，固定为'status'，表示对象上下线。 |
| callback | Callback<{ sessionId: string, networkId: string, status: 'online' \| 'offline' }> | 是 | 监听上下线回调实例。<br>sessionId：标识变更对象的sessionId； <br>networkId：标识对象设备的networkId； <br>status：标识对象为'online'(上线)或'offline'(下线)的状态。 | | callback | Callback<{ sessionId: string, networkId: string, status: 'online' \| 'offline' }> | 是 | 监听上下线回调实例。<br>sessionId：标识变更对象的sessionId； <br>networkId：标识对象设备的networkId； <br>status：标识对象为'online'(上线)或'offline'(下线)的状态。 |
**示例：** **示例：**
```js ```js
import distributedObject from '@ohos.data.distributedDataObject' import distributedObject from '@ohos.data.distributedDataObject'
......
zh-cn/application-dev/reference/apis/js-apis-data-preferences.md
浏览文件 @ f4fc4c6f
...@@ -10,18 +10,17 @@ ...@@ -10,18 +10,17 @@
## 导入模块 ## 导入模块
```ts ```ts
import data_preferences from '@ohos.data.preferences' import data_preferences from '@ohos.data.preferences';
``` ```
## 属性 ## 常量
**系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedDataManager.Preferences.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedDataManager.Preferences.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| MAX_KEY_LENGTH | string | 是 | 否 | key的最大长度限制，大小为80字节。 | | MAX_KEY_LENGTH | string | 是 | 否 | key的最大长度限制，大小为80字节。 |
| MAX_VALUE_LENGTH | string | 是 | 否 | string类型value的最大长度限制，大小为8192字节。 | | MAX_VALUE_LENGTH | string | 是 | 否 | value的最大长度限制，大小为8192字节。 |
| ValueType | number丨string丨boolean | 是 | 否 | 默认返回值，支持number、string、boolean。 |
## data_preferences.getPreferences ## data_preferences.getPreferences
...@@ -191,7 +190,9 @@ deletePreferences(context: Context, name: string): Promise&lt;void&gt; ...@@ -191,7 +190,9 @@ deletePreferences(context: Context, name: string): Promise&lt;void&gt;
removePreferencesFromCache(context: Context, name: string, callback: AsyncCallback&lt;void&gt;): void removePreferencesFromCache(context: Context, name: string, callback: AsyncCallback&lt;void&gt;): void
从内存中移除指定首选项持久化文件对应的Preferences单实例。移除Preferences单实例时，应用不允许再使用该实例进行数据操作，否则会出现数据一致性问题，该方法使用callback方式作为异步方法。 从内存中移除指定首选项持久化文件对应的Preferences单实例。
移除Preferences单实例时，应用不允许再使用该实例进行数据操作，否则会出现数据一致性问题，该方法使用callback方式作为异步方法。
**系统能力**：SystemCapability.DistributedDataManager.Preferences.Core **系统能力**：SystemCapability.DistributedDataManager.Preferences.Core
...@@ -223,7 +224,9 @@ removePreferencesFromCache(context: Context, name: string, callback: AsyncCallba ...@@ -223,7 +224,9 @@ removePreferencesFromCache(context: Context, name: string, callback: AsyncCallba
removePreferencesFromCache(context: Context, name: string): Promise&lt;void&gt; removePreferencesFromCache(context: Context, name: string): Promise&lt;void&gt;
从内存中移除指定首选项持久化文件对应的Preferences单实例。移除Preferences单实例时，应用不允许再使用该实例进行数据操作，否则会出现数据一致性问题，该方法使用Promise方式作为异步方法。 从内存中移除指定首选项持久化文件对应的Preferences单实例。
移除Preferences单实例时，应用不允许再使用该实例进行数据操作，否则会出现数据一致性问题，该方法使用Promise方式作为异步方法。
**系统能力**：SystemCapability.DistributedDataManager.Preferences.Core **系统能力**：SystemCapability.DistributedDataManager.Preferences.Core
...@@ -271,7 +274,7 @@ get(key: string, defValue: ValueType, callback: AsyncCallback&lt;ValueType&gt;): ...@@ -271,7 +274,7 @@ get(key: string, defValue: ValueType, callback: AsyncCallback&lt;ValueType&gt;):
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要获取的存储key名称，不能为空。 | | key | string | 是 | 要获取的存储key名称，不能为空。 |
| defValue | [ValueType](#属性) | 是 | 默认返回值。支持number、string、boolean。 | | defValue | [ValueType](#valuetype) | 是 | 默认返回值。支持number、string、boolean。 |
| callback | AsyncCallback&lt;ValueType&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;ValueType&gt; | 是 | 回调函数。 |
- 示例： - 示例：
...@@ -309,7 +312,7 @@ get(key: string, defValue: ValueType): Promise&lt;ValueType&gt; ...@@ -309,7 +312,7 @@ get(key: string, defValue: ValueType): Promise&lt;ValueType&gt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要获取的存储key名称，不能为空。 | | key | string | 是 | 要获取的存储key名称，不能为空。 |
| defValue | [ValueType](#属性) | 是 | 默认返回值。支持number、string、boolean。 | | defValue | [ValueType](#valuetype) | 是 | 默认返回值。支持number、string、boolean。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -349,7 +352,7 @@ put(key: string, value: ValueType, callback: AsyncCallback&lt;void&gt;): void ...@@ -349,7 +352,7 @@ put(key: string, value: ValueType, callback: AsyncCallback&lt;void&gt;): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要修改的存储的key，不能为空。 | | key | string | 是 | 要修改的存储的key，不能为空。 |
| value | [ValueType](#属性) | 是 | 存储的新值。支持number、string、boolean。 | | value | [ValueType](#valuetype) | 是 | 存储的新值。支持number、string、boolean。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
- 示例： - 示例：
...@@ -387,7 +390,7 @@ put(key: string, value: ValueType): Promise&lt;void&gt; ...@@ -387,7 +390,7 @@ put(key: string, value: ValueType): Promise&lt;void&gt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要修改的存储的key，不能为空。 | | key | string | 是 | 要修改的存储的key，不能为空。 |
| value | [ValueType](#属性) | 是 | 存储的新值。支持number、string、boolean。 | | value | [ValueType](#valuetype) | 是 | 存储的新值。支持number、string、boolean。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -814,3 +817,15 @@ off(type: 'change', callback: Callback&lt;{ key : string }&gt;): void ...@@ -814,3 +817,15 @@ off(type: 'change', callback: Callback&lt;{ key : string }&gt;): void
}) })
} }
``` ```
## ValueType
用于表示允许的数据字段类型。
**系统能力**：SystemCapability.DistributedDataManager.Preferences.Core
| 名称 | 说明 |
| ------- | -------------------- |
| number | 表示值类型为数字。 |
| string | 表示值类型为字符。 |
| boolean | 表示值类型为布尔值。 |
zh-cn/application-dev/reference/apis/js-apis-data-rdb.md
浏览文件 @ f4fc4c6f
...@@ -7,8 +7,8 @@ ...@@ -7,8 +7,8 @@
## 导入模块 ## 导入模块
``` ```js
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb';
``` ```
...@@ -21,16 +21,17 @@ getRdbStore(context: Context, config: StoreConfig, version: number, callback: As ...@@ -21,16 +21,17 @@ getRdbStore(context: Context, config: StoreConfig, version: number, callback: As
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
**参数**： **参数**：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 | | context<sup>8+</sup> | Context | 是 | 应用程序或功能的上下文 |
| config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 | | config | [StoreConfig](#storeconfig) | 是 | 与此RDB存储相关的数据库配置。 |
| version | number | 是 | 数据库版本。 | | version | number | 是 | 数据库版本。 |
| callback | AsyncCallback&lt;[RdbStore](#rdbstore)&gt; | 是 | 指定callback回调函数。返回一个RdbStore。 | | callback | AsyncCallback&lt;[RdbStore](#rdbstore)&gt; | 是 | 指定callback回调函数，返回一个RdbStore。 |
**示例**： **示例**：
``` ```js
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
const STORE_CONFIG = { name: "RdbTest.db"} const STORE_CONFIG = { name: "RdbTest.db"}
const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)" const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
...@@ -40,9 +41,9 @@ data_rdb.getRdbStore(STORE_CONFIG, 1, function (err, rdbStore) { ...@@ -40,9 +41,9 @@ data_rdb.getRdbStore(STORE_CONFIG, 1, function (err, rdbStore) {
}) })
``` ```
API9的示例请参考如下代码： API 9的示例请参考如下代码：
``` ```ts
import Ability from '@ohos.application.Ability' import Ability from '@ohos.application.Ability'
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
...@@ -79,7 +80,7 @@ getRdbStore(context: Context, config: StoreConfig, version: number): Promise&lt; ...@@ -79,7 +80,7 @@ getRdbStore(context: Context, config: StoreConfig, version: number): Promise&lt;
**示例**： **示例**：
``` ```js
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
const STORE_CONFIG = { name: "RdbTest.db" } const STORE_CONFIG = { name: "RdbTest.db" }
const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)" const SQL_CREATE_TABLE = "CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB)"
...@@ -96,9 +97,9 @@ promisegetRdb.then(async (rdbStore) => { ...@@ -96,9 +97,9 @@ promisegetRdb.then(async (rdbStore) => {
}) })
``` ```
API9的示例请参考如下代码： API 9的示例请参考如下代码：
``` ```ts
import Ability from '@ohos.application.Ability' import Ability from '@ohos.application.Ability'
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
...@@ -134,16 +135,16 @@ deleteRdbStore(context: Context, name: string, callback: AsyncCallback&lt;void&g ...@@ -134,16 +135,16 @@ deleteRdbStore(context: Context, name: string, callback: AsyncCallback&lt;void&g
| callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 |
**示例**： **示例**：
``` ```js
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
data_rdb.deleteRdbStore("RdbTest.db", function (err, rdbStore) { data_rdb.deleteRdbStore("RdbTest.db", function (err, rdbStore) {
console.info('delete store done.') console.info('delete store done.')
}) })
``` ```
API9的示例请参考如下代码： API 9的示例请参考如下代码：
``` ```ts
import Ability from '@ohos.application.Ability' import Ability from '@ohos.application.Ability'
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
...@@ -173,7 +174,7 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt; ...@@ -173,7 +174,7 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt;
| Promise&lt;void&gt; | 指定Promise回调函数。 | | Promise&lt;void&gt; | 指定Promise回调函数。 |
**示例**： **示例**：
``` ```js
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
let promisedeleteRdb = data_rdb.deleteRdbStore("RdbTest.db") let promisedeleteRdb = data_rdb.deleteRdbStore("RdbTest.db")
promisedeleteRdb.then(()=>{ promisedeleteRdb.then(()=>{
...@@ -183,9 +184,9 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt; ...@@ -183,9 +184,9 @@ deleteRdbStore(context: Context, name: string): Promise&lt;void&gt;
}) })
``` ```
API9的示例请参考如下代码： API 9的示例请参考如下代码：
``` ```ts
import Ability from '@ohos.application.Ability' import Ability from '@ohos.application.Ability'
import data_rdb from '@ohos.data.rdb' import data_rdb from '@ohos.data.rdb'
export default class MainAbility extends Ability { export default class MainAbility extends Ability {
...@@ -218,7 +219,7 @@ constructor(name: string) ...@@ -218,7 +219,7 @@ constructor(name: string)
| name | string | 是 | 数据库表名。 | | name | string | 是 | 数据库表名。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
``` ```
...@@ -242,7 +243,7 @@ inDevices(devices: Array&lt;string&gt;): RdbPredicates ...@@ -242,7 +243,7 @@ inDevices(devices: Array&lt;string&gt;): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicate.inDevices(['12345678abcde']) predicate.inDevices(['12345678abcde'])
``` ```
...@@ -262,7 +263,7 @@ inAllDevices(): RdbPredicates ...@@ -262,7 +263,7 @@ inAllDevices(): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.inAllDevices() predicates.inAllDevices()
``` ```
...@@ -288,7 +289,7 @@ equalTo(field: string, value: ValueType): RdbPredicates ...@@ -288,7 +289,7 @@ equalTo(field: string, value: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "lisi") predicates.equalTo("NAME", "lisi")
``` ```
...@@ -315,7 +316,7 @@ notEqualTo(field: string, value: ValueType): RdbPredicates ...@@ -315,7 +316,7 @@ notEqualTo(field: string, value: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.notEqualTo("NAME", "lisi") predicates.notEqualTo("NAME", "lisi")
``` ```
...@@ -336,7 +337,7 @@ beginWrap(): RdbPredicates ...@@ -336,7 +337,7 @@ beginWrap(): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回带有左括号的Rdb谓词。 | | [RdbPredicates](#rdbpredicates) | 返回带有左括号的Rdb谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "lisi") predicates.equalTo("NAME", "lisi")
.beginWrap() .beginWrap()
...@@ -362,7 +363,7 @@ endWrap(): RdbPredicates ...@@ -362,7 +363,7 @@ endWrap(): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回带有右括号的Rdb谓词。 | | [RdbPredicates](#rdbpredicates) | 返回带有右括号的Rdb谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "lisi") predicates.equalTo("NAME", "lisi")
.beginWrap() .beginWrap()
...@@ -388,7 +389,7 @@ or(): RdbPredicates ...@@ -388,7 +389,7 @@ or(): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回带有或条件的Rdb谓词。 | | [RdbPredicates](#rdbpredicates) | 返回带有或条件的Rdb谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Lisa") predicates.equalTo("NAME", "Lisa")
.or() .or()
...@@ -411,7 +412,7 @@ and(): RdbPredicates ...@@ -411,7 +412,7 @@ and(): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回带有和条件的Rdb谓词。 | | [RdbPredicates](#rdbpredicates) | 返回带有和条件的Rdb谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Lisa") predicates.equalTo("NAME", "Lisa")
.and() .and()
...@@ -423,7 +424,7 @@ and(): RdbPredicates ...@@ -423,7 +424,7 @@ and(): RdbPredicates
contains(field: string, value: string): RdbPredicates contains(field: string, value: string): RdbPredicates
配置谓词以匹配数据字段为String且value包含指定值的字段。 配置谓词以匹配数据字段为string且value包含指定值的字段。
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
...@@ -439,7 +440,7 @@ contains(field: string, value: string): RdbPredicates ...@@ -439,7 +440,7 @@ contains(field: string, value: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.contains("NAME", "os") predicates.contains("NAME", "os")
``` ```
...@@ -450,7 +451,7 @@ contains(field: string, value: string): RdbPredicates ...@@ -450,7 +451,7 @@ contains(field: string, value: string): RdbPredicates
beginsWith(field: string, value: string): RdbPredicates beginsWith(field: string, value: string): RdbPredicates
配置谓词以匹配数据字段为String且值以指定字符串开头的字段。 配置谓词以匹配数据字段为string且值以指定字符串开头的字段。
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
...@@ -466,7 +467,7 @@ beginsWith(field: string, value: string): RdbPredicates ...@@ -466,7 +467,7 @@ beginsWith(field: string, value: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.beginsWith("NAME", "os") predicates.beginsWith("NAME", "os")
``` ```
...@@ -477,7 +478,7 @@ beginsWith(field: string, value: string): RdbPredicates ...@@ -477,7 +478,7 @@ beginsWith(field: string, value: string): RdbPredicates
endsWith(field: string, value: string): RdbPredicates endsWith(field: string, value: string): RdbPredicates
配置谓词以匹配数据字段为String且值以指定字符串结尾的字段。 配置谓词以匹配数据字段为string且值以指定字符串结尾的字段。
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
...@@ -493,7 +494,7 @@ endsWith(field: string, value: string): RdbPredicates ...@@ -493,7 +494,7 @@ endsWith(field: string, value: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.endsWith("NAME", "se") predicates.endsWith("NAME", "se")
``` ```
...@@ -519,7 +520,7 @@ isNull(field: string): RdbPredicates ...@@ -519,7 +520,7 @@ isNull(field: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
- 示例 - 示例
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.isNull("NAME") predicates.isNull("NAME")
``` ```
...@@ -545,7 +546,7 @@ isNotNull(field: string): RdbPredicates ...@@ -545,7 +546,7 @@ isNotNull(field: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.isNotNull("NAME") predicates.isNotNull("NAME")
``` ```
...@@ -556,7 +557,7 @@ isNotNull(field: string): RdbPredicates ...@@ -556,7 +557,7 @@ isNotNull(field: string): RdbPredicates
like(field: string, value: string): RdbPredicates like(field: string, value: string): RdbPredicates
配置谓词以匹配数据字段为String且值类似于指定字符串的字段。 配置谓词以匹配数据字段为string且值类似于指定字符串的字段。
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
...@@ -572,7 +573,7 @@ like(field: string, value: string): RdbPredicates ...@@ -572,7 +573,7 @@ like(field: string, value: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.like("NAME", "%os%") predicates.like("NAME", "%os%")
``` ```
...@@ -583,7 +584,7 @@ like(field: string, value: string): RdbPredicates ...@@ -583,7 +584,7 @@ like(field: string, value: string): RdbPredicates
glob(field: string, value: string): RdbPredicates glob(field: string, value: string): RdbPredicates
配置RdbPredicates匹配数据字段为String的指定字段。 配置RdbPredicates匹配数据字段为string的指定字段。
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
...@@ -599,7 +600,7 @@ glob(field: string, value: string): RdbPredicates ...@@ -599,7 +600,7 @@ glob(field: string, value: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.glob("NAME", "?h*g") predicates.glob("NAME", "?h*g")
``` ```
...@@ -627,7 +628,7 @@ between(field: string, low: ValueType, high: ValueType): RdbPredicates ...@@ -627,7 +628,7 @@ between(field: string, low: ValueType, high: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.between("AGE", 10, 50) predicates.between("AGE", 10, 50)
``` ```
...@@ -655,7 +656,7 @@ notBetween(field: string, low: ValueType, high: ValueType): RdbPredicates ...@@ -655,7 +656,7 @@ notBetween(field: string, low: ValueType, high: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.notBetween("AGE", 10, 50) predicates.notBetween("AGE", 10, 50)
``` ```
...@@ -681,7 +682,7 @@ greaterThan(field: string, value: ValueType): RdbPredicates ...@@ -681,7 +682,7 @@ greaterThan(field: string, value: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.greaterThan("AGE", 18) predicates.greaterThan("AGE", 18)
``` ```
...@@ -708,7 +709,7 @@ lessThan(field: string, value: ValueType): RdbPredicates ...@@ -708,7 +709,7 @@ lessThan(field: string, value: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.lessThan("AGE", 20) predicates.lessThan("AGE", 20)
``` ```
...@@ -736,7 +737,7 @@ greaterThanOrEqualTo(field: string, value: ValueType): RdbPredicates ...@@ -736,7 +737,7 @@ greaterThanOrEqualTo(field: string, value: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.greaterThanOrEqualTo("AGE", 18) predicates.greaterThanOrEqualTo("AGE", 18)
``` ```
...@@ -764,7 +765,7 @@ lessThanOrEqualTo(field: string, value: ValueType): RdbPredicates ...@@ -764,7 +765,7 @@ lessThanOrEqualTo(field: string, value: ValueType): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.lessThanOrEqualTo("AGE", 20) predicates.lessThanOrEqualTo("AGE", 20)
``` ```
...@@ -791,7 +792,7 @@ orderByAsc(field: string): RdbPredicates ...@@ -791,7 +792,7 @@ orderByAsc(field: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.orderByAsc("NAME") predicates.orderByAsc("NAME")
``` ```
...@@ -818,7 +819,7 @@ orderByDesc(field: string): RdbPredicates ...@@ -818,7 +819,7 @@ orderByDesc(field: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.orderByDesc("AGE") predicates.orderByDesc("AGE")
``` ```
...@@ -839,7 +840,7 @@ distinct(): RdbPredicates ...@@ -839,7 +840,7 @@ distinct(): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回可用于过滤重复记录的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回可用于过滤重复记录的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose").distinct("NAME") predicates.equalTo("NAME", "Rose").distinct("NAME")
let promisequery = rdbStore.query(predicates, ["NAME"]) let promisequery = rdbStore.query(predicates, ["NAME"])
...@@ -872,7 +873,7 @@ limitAs(value: number): RdbPredicates ...@@ -872,7 +873,7 @@ limitAs(value: number): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回可用于设置最大数据记录数的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回可用于设置最大数据记录数的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose").limitAs(3) predicates.equalTo("NAME", "Rose").limitAs(3)
``` ```
...@@ -898,7 +899,7 @@ offsetAs(rowOffset: number): RdbPredicates ...@@ -898,7 +899,7 @@ offsetAs(rowOffset: number): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回具有指定返回结果起始位置的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回具有指定返回结果起始位置的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose").offsetAs(3) predicates.equalTo("NAME", "Rose").offsetAs(3)
``` ```
...@@ -924,7 +925,7 @@ groupBy(fields: Array&lt;string&gt;): RdbPredicates ...@@ -924,7 +925,7 @@ groupBy(fields: Array&lt;string&gt;): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回分组查询列的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回分组查询列的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.groupBy(["AGE", "NAME"]) predicates.groupBy(["AGE", "NAME"])
``` ```
...@@ -950,7 +951,7 @@ indexedBy(field: string): RdbPredicates ...@@ -950,7 +951,7 @@ indexedBy(field: string): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回具有指定索引列的RdbPredicates。 | | [RdbPredicates](#rdbpredicates) | 返回具有指定索引列的RdbPredicates。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.indexedBy("SALARY_INDEX") predicates.indexedBy("SALARY_INDEX")
``` ```
...@@ -978,7 +979,7 @@ in(field: string, value: Array&lt;ValueType&gt;): RdbPredicates ...@@ -978,7 +979,7 @@ in(field: string, value: Array&lt;ValueType&gt;): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.in("AGE", [18, 20]) predicates.in("AGE", [18, 20])
``` ```
...@@ -1006,7 +1007,7 @@ notIn(field: string, value: Array&lt;ValueType&gt;): RdbPredicates ...@@ -1006,7 +1007,7 @@ notIn(field: string, value: Array&lt;ValueType&gt;): RdbPredicates
| [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 | | [RdbPredicates](#rdbpredicates) | 返回与指定字段匹配的谓词。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.notIn("NAME", ["Lisa", "Rose"]) predicates.notIn("NAME", ["Lisa", "Rose"])
``` ```
...@@ -1033,7 +1034,7 @@ insert(name: string, values: ValuesBucket, callback: AsyncCallback&lt;number&gt; ...@@ -1033,7 +1034,7 @@ insert(name: string, values: ValuesBucket, callback: AsyncCallback&lt;number&gt;
| callback | AsyncCallback&lt;number&gt; | 是 | 指定callback回调函数。如果操作成功，返回行ID；否则返回-1。 | | callback | AsyncCallback&lt;number&gt; | 是 | 指定callback回调函数。如果操作成功，返回行ID；否则返回-1。 |
**示例**： **示例**：
``` ```js
const valueBucket = { const valueBucket = {
"NAME": "Lisa", "NAME": "Lisa",
"AGE": 18, "AGE": 18,
...@@ -1066,7 +1067,7 @@ insert(name: string, values: ValuesBucket):Promise&lt;number&gt; ...@@ -1066,7 +1067,7 @@ insert(name: string, values: ValuesBucket):Promise&lt;number&gt;
| Promise&lt;number&gt; | 指定Promise回调函数。如果操作成功，返回行ID；否则返回-1。 | | Promise&lt;number&gt; | 指定Promise回调函数。如果操作成功，返回行ID；否则返回-1。 |
**示例**： **示例**：
``` ```js
const valueBucket = { const valueBucket = {
"NAME": "Lisa", "NAME": "Lisa",
"AGE": 18, "AGE": 18,
...@@ -1098,7 +1099,7 @@ update(values: ValuesBucket, rdbPredicates: RdbPredicates, callback: AsyncCallba ...@@ -1098,7 +1099,7 @@ update(values: ValuesBucket, rdbPredicates: RdbPredicates, callback: AsyncCallba
| callback | AsyncCallback&lt;number&gt; | 是 | 指定的callback回调方法。返回受影响的行数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 指定的callback回调方法。返回受影响的行数。 |
**示例**： **示例**：
``` ```js
const valueBucket = { const valueBucket = {
"NAME": "Rose", "NAME": "Rose",
"AGE": 22, "AGE": 22,
...@@ -1132,7 +1133,7 @@ update(values: ValuesBucket, rdbPredicates: RdbPredicates):Promise&lt;number&gt; ...@@ -1132,7 +1133,7 @@ update(values: ValuesBucket, rdbPredicates: RdbPredicates):Promise&lt;number&gt;
| Promise&lt;number&gt; | 指定的Promise回调方法。返回受影响的行数。 | | Promise&lt;number&gt; | 指定的Promise回调方法。返回受影响的行数。 |
**示例**： **示例**：
``` ```js
const valueBucket = { const valueBucket = {
"NAME": "Rose", "NAME": "Rose",
"AGE": 22, "AGE": 22,
...@@ -1166,7 +1167,7 @@ delete(rdbPredicates: RdbPredicates, callback: AsyncCallback&lt;number&gt;):void ...@@ -1166,7 +1167,7 @@ delete(rdbPredicates: RdbPredicates, callback: AsyncCallback&lt;number&gt;):void
| callback | AsyncCallback&lt;number&gt; | 是 | 指定callback回调函数。返回受影响的行数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 指定callback回调函数。返回受影响的行数。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Lisa") predicates.equalTo("NAME", "Lisa")
rdbStore.delete(predicates, function (err, rows) { rdbStore.delete(predicates, function (err, rows) {
...@@ -1194,7 +1195,7 @@ delete(rdbPredicates: RdbPredicates):Promise&lt;number&gt; ...@@ -1194,7 +1195,7 @@ delete(rdbPredicates: RdbPredicates):Promise&lt;number&gt;
| Promise&lt;number&gt; | 指定Promise回调函数。返回受影响的行数。 | | Promise&lt;number&gt; | 指定Promise回调函数。返回受影响的行数。 |
**示例**： **示例**：
``` ```js
let predicatesdelete = new data_rdb.RdbPredicates("EMPLOYEE") let predicatesdelete = new data_rdb.RdbPredicates("EMPLOYEE")
predicatesdelete.equalTo("NAME", "Lisa") predicatesdelete.equalTo("NAME", "Lisa")
let promisedelete = rdbStore.delete(predicates) let promisedelete = rdbStore.delete(predicates)
...@@ -1222,7 +1223,7 @@ query(rdbPredicates: RdbPredicates, columns: Array&lt;string&gt;, callback: Asyn ...@@ -1222,7 +1223,7 @@ query(rdbPredicates: RdbPredicates, columns: Array&lt;string&gt;, callback: Asyn
| callback | AsyncCallback&lt;[ResultSet](js-apis-data-resultset.md)&gt; | 是 | 指定callback回调函数。如果操作成功，则返回ResultSet对象。 | | callback | AsyncCallback&lt;[ResultSet](js-apis-data-resultset.md)&gt; | 是 | 指定callback回调函数。如果操作成功，则返回ResultSet对象。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose") predicates.equalTo("NAME", "Rose")
rdbStore.query(predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"], function (err, resultSet) { rdbStore.query(predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"], function (err, resultSet) {
...@@ -1252,7 +1253,7 @@ query(rdbPredicates: RdbPredicates, columns?: Array&lt;string&gt;):Promise&lt;Re ...@@ -1252,7 +1253,7 @@ query(rdbPredicates: RdbPredicates, columns?: Array&lt;string&gt;):Promise&lt;Re
| Promise&lt;[ResultSet](../apis/js-apis-data-resultset.md)&gt; | 指定Promise回调函数。如果操作成功，则返回ResultSet对象。 | | Promise&lt;[ResultSet](../apis/js-apis-data-resultset.md)&gt; | 指定Promise回调函数。如果操作成功，则返回ResultSet对象。 |
**示例**： **示例**：
``` ```js
let predicates = new data_rdb.RdbPredicates("EMPLOYEE") let predicates = new data_rdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("NAME", "Rose") predicates.equalTo("NAME", "Rose")
let promisequery = rdbStore.query(predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let promisequery = rdbStore.query(predicates, ["ID", "NAME", "AGE", "SALARY", "CODES"])
...@@ -1281,7 +1282,7 @@ querySql(sql: string, bindArgs: Array&lt;ValueType&gt;, callback: AsyncCallback& ...@@ -1281,7 +1282,7 @@ querySql(sql: string, bindArgs: Array&lt;ValueType&gt;, callback: AsyncCallback&
| callback | AsyncCallback&lt;[ResultSet](js-apis-data-resultset.md)&gt; | 是 | 指定callback回调函数。如果操作成功，则返回ResultSet对象。 | | callback | AsyncCallback&lt;[ResultSet](js-apis-data-resultset.md)&gt; | 是 | 指定callback回调函数。如果操作成功，则返回ResultSet对象。 |
**示例**： **示例**：
``` ```js
rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo'], function (err, resultSet) { rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo'], function (err, resultSet) {
console.log("resultSet column names:" + resultSet.columnNames) console.log("resultSet column names:" + resultSet.columnNames)
console.log("resultSet column count:" + resultSet.columnCount) console.log("resultSet column count:" + resultSet.columnCount)
...@@ -1309,7 +1310,7 @@ querySql(sql: string, bindArgs?: Array&lt;ValueType&gt;):Promise&lt;ResultSet&gt ...@@ -1309,7 +1310,7 @@ querySql(sql: string, bindArgs?: Array&lt;ValueType&gt;):Promise&lt;ResultSet&gt
| Promise&lt;[ResultSet](../apis/js-apis-data-resultset.md)&gt; | 指定Promise回调函数。如果操作成功，则返回ResultSet对象。 | | Promise&lt;[ResultSet](../apis/js-apis-data-resultset.md)&gt; | 指定Promise回调函数。如果操作成功，则返回ResultSet对象。 |
**示例**： **示例**：
``` ```js
let promisequerySql = rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo']) let promisequerySql = rdbStore.querySql("SELECT * FROM EMPLOYEE CROSS JOIN BOOK WHERE BOOK.NAME = ?", ['sanguo'])
promisequerySql.then((resultSet) => { promisequerySql.then((resultSet) => {
console.log("resultSet column names:" + resultSet.columnNames) console.log("resultSet column names:" + resultSet.columnNames)
...@@ -1336,7 +1337,7 @@ executeSql(sql: string, bindArgs: Array&lt;ValueType&gt;, callback: AsyncCallbac ...@@ -1336,7 +1337,7 @@ executeSql(sql: string, bindArgs: Array&lt;ValueType&gt;, callback: AsyncCallbac
| callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 |
**示例**： **示例**：
``` ```js
rdbStore.executeSql("DELETE FROM EMPLOYEE", null, function () { rdbStore.executeSql("DELETE FROM EMPLOYEE", null, function () {
console.info('delete done.') console.info('delete done.')
}) })
...@@ -1363,7 +1364,7 @@ executeSql(sql: string, bindArgs?: Array&lt;ValueType&gt;):Promise&lt;void&gt; ...@@ -1363,7 +1364,7 @@ executeSql(sql: string, bindArgs?: Array&lt;ValueType&gt;):Promise&lt;void&gt;
| Promise&lt;void&gt; | 指定Promise回调函数。 | | Promise&lt;void&gt; | 指定Promise回调函数。 |
**示例**： **示例**：
``` ```js
let promiseexecuteSql = rdbStore.executeSql("DELETE FROM EMPLOYEE") let promiseexecuteSql = rdbStore.executeSql("DELETE FROM EMPLOYEE")
promiseexecuteSql.then(() => { promiseexecuteSql.then(() => {
console.info('delete done.') console.info('delete done.')
...@@ -1381,7 +1382,7 @@ beginTransaction():void ...@@ -1381,7 +1382,7 @@ beginTransaction():void
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
**示例**： **示例**：
``` ```js
rdbStore.beginTransaction() rdbStore.beginTransaction()
const valueBucket = { const valueBucket = {
"name": "lisi", "name": "lisi",
...@@ -1405,7 +1406,7 @@ commit():void ...@@ -1405,7 +1406,7 @@ commit():void
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
**示例**： **示例**：
``` ```js
rdbStore.beginTransaction() rdbStore.beginTransaction()
const valueBucket = { const valueBucket = {
"name": "lisi", "name": "lisi",
...@@ -1430,7 +1431,7 @@ rollBack():void; ...@@ -1430,7 +1431,7 @@ rollBack():void;
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
**示例**： **示例**：
``` ```js
try { try {
rdbStore.beginTransaction() rdbStore.beginTransaction()
const valueBucket = { const valueBucket = {
...@@ -1465,7 +1466,7 @@ setDistributedTables(tables: Array&lt;string&gt;, callback: AsyncCallback&lt;voi ...@@ -1465,7 +1466,7 @@ setDistributedTables(tables: Array&lt;string&gt;, callback: AsyncCallback&lt;voi
| callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 指定callback回调函数。 |
**示例**： **示例**：
``` ```js
rdbStore.setDistributedTables(["EMPLOYEE"], function (err) { rdbStore.setDistributedTables(["EMPLOYEE"], function (err) {
if (err) { if (err) {
console.info('setDistributedTables failed.') console.info('setDistributedTables failed.')
...@@ -1495,7 +1496,7 @@ setDistributedTables(tables: Array&lt;string&gt;, callback: AsyncCallback&lt;voi ...@@ -1495,7 +1496,7 @@ setDistributedTables(tables: Array&lt;string&gt;, callback: AsyncCallback&lt;voi
| Promise&lt;void&gt; | 指定Promise回调函数。 | | Promise&lt;void&gt; | 指定Promise回调函数。 |
**示例**： **示例**：
``` ```js
let promiseset = rdbStore.setDistributedTables(["EMPLOYEE"]) let promiseset = rdbStore.setDistributedTables(["EMPLOYEE"])
promiseset.then(() => { promiseset.then(() => {
console.info("setDistributedTables success.") console.info("setDistributedTables success.")
...@@ -1520,7 +1521,7 @@ obtainDistributedTableName(device: string, table: string, callback: AsyncCallbac ...@@ -1520,7 +1521,7 @@ obtainDistributedTableName(device: string, table: string, callback: AsyncCallbac
| callback | AsyncCallback&lt;string&gt; | 是 | 指定的callback回调函数。如果操作成功，返回远程设备的分布式表名。 | | callback | AsyncCallback&lt;string&gt; | 是 | 指定的callback回调函数。如果操作成功，返回远程设备的分布式表名。 |
**示例**： **示例**：
``` ```js
rdbStore.obtainDistributedTableName(deviceId, "EMPLOYEE", function (err, tableName) { rdbStore.obtainDistributedTableName(deviceId, "EMPLOYEE", function (err, tableName) {
if (err) { if (err) {
console.info('obtainDistributedTableName failed.') console.info('obtainDistributedTableName failed.')
...@@ -1551,7 +1552,7 @@ obtainDistributedTableName(device: string, table: string, callback: AsyncCallbac ...@@ -1551,7 +1552,7 @@ obtainDistributedTableName(device: string, table: string, callback: AsyncCallbac
| Promise&lt;string&gt; | 指定Promise回调函数。如果操作成功，返回远程设备的分布式表名。 | | Promise&lt;string&gt; | 指定Promise回调函数。如果操作成功，返回远程设备的分布式表名。 |
**示例**： **示例**：
``` ```js
let promiseDistr = rdbStore.obtainDistributedTableName(deviceId, "EMPLOYEE") let promiseDistr = rdbStore.obtainDistributedTableName(deviceId, "EMPLOYEE")
promiseDistr.then((tableName) => { promiseDistr.then((tableName) => {
console.info('obtainDistributedTableName success, tableName=' + tableName) console.info('obtainDistributedTableName success, tableName=' + tableName)
...@@ -1576,7 +1577,7 @@ sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback&lt;Array ...@@ -1576,7 +1577,7 @@ sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback&lt;Array
| callback | AsyncCallback&lt;Array&lt;[string, number]&gt;&gt; | 是 | 指定的callback回调函数，用于向调用者发送同步结果。string：设备ID；number：每个设备同步状态，0表示成功，其他值表示失败。| | callback | AsyncCallback&lt;Array&lt;[string, number]&gt;&gt; | 是 | 指定的callback回调函数，用于向调用者发送同步结果。string：设备ID；number：每个设备同步状态，0表示成功，其他值表示失败。|
**示例**： **示例**：
``` ```js
let predicate = new rdb.RdbPredicates('EMPLOYEE') let predicate = new rdb.RdbPredicates('EMPLOYEE')
predicate.inDevices(['12345678abcde']) predicate.inDevices(['12345678abcde'])
rdbStore.sync(rdb.SyncMode.SYNC_MODE_PUSH, predicate, function (err, result) { rdbStore.sync(rdb.SyncMode.SYNC_MODE_PUSH, predicate, function (err, result) {
...@@ -1613,7 +1614,7 @@ sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback&lt;Array ...@@ -1613,7 +1614,7 @@ sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback&lt;Array
| Promise&lt;Array&lt;[string, number]&gt;&gt; | 指定Promise回调函数，用于向调用者发送同步结果。string：设备ID；number：每个设备同步状态，0表示成功，其他值表示失败。 | | Promise&lt;Array&lt;[string, number]&gt;&gt; | 指定Promise回调函数，用于向调用者发送同步结果。string：设备ID；number：每个设备同步状态，0表示成功，其他值表示失败。 |
**示例**： **示例**：
``` ```js
let predicatesync = new data_rdb.RdbPredicates('EMPLOYEE') let predicatesync = new data_rdb.RdbPredicates('EMPLOYEE')
predicatesync.inDevices(['12345678abcde']) predicatesync.inDevices(['12345678abcde'])
let promisesync = rdbStore.sync(data_rdb.SyncMode.SYNC_MODE_PUSH, predicatesync) let promisesync = rdbStore.sync(data_rdb.SyncMode.SYNC_MODE_PUSH, predicatesync)
...@@ -1644,7 +1645,7 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri ...@@ -1644,7 +1645,7 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri
| observer | Callback&lt;Array&lt;string&gt;&gt; | 是 | 指分布式数据库中数据更改事件的观察者。 | | observer | Callback&lt;Array&lt;string&gt;&gt; | 是 | 指分布式数据库中数据更改事件的观察者。 |
**示例**： **示例**：
``` ```js
function storeObserver(devices) { function storeObserver(devices) {
for (let i = 0; i < devices.length; i++) { for (let i = 0; i < devices.length; i++) {
console.log('device=' + device[i] + ' data changed') console.log('device=' + device[i] + ' data changed')
...@@ -1675,7 +1676,7 @@ off(event:'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri ...@@ -1675,7 +1676,7 @@ off(event:'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri
**示例**： **示例**：
``` ```js
function storeObserver(devices) { function storeObserver(devices) {
for (let i = 0; i < devices.length; i++) { for (let i = 0; i < devices.length; i++) {
console.log('device=' + device[i] + ' data changed') console.log('device=' + device[i] + ' data changed')
...@@ -1688,7 +1689,6 @@ off(event:'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri ...@@ -1688,7 +1689,6 @@ off(event:'dataChange', type: SubscribeType, observer: Callback&lt;Array&lt;stri
} }
``` ```
## StoreConfig ## StoreConfig
管理关系数据库配置。 管理关系数据库配置。
......
zh-cn/application-dev/reference/apis/js-apis-data-resultset.md
浏览文件 @ f4fc4c6f
...@@ -8,7 +8,7 @@ ...@@ -8,7 +8,7 @@
需要通过[RdbStore.query()](js-apis-data-rdb.md#query)获取resultSet对象。 需要通过[RdbStore.query()](js-apis-data-rdb.md#query)获取resultSet对象。
``` ```js
import dataRdb from '@ohos.data.rdb'; import dataRdb from '@ohos.data.rdb';
let predicates = new dataRdb.RdbPredicates("EMPLOYEE") let predicates = new dataRdb.RdbPredicates("EMPLOYEE")
predicates.equalTo("AGE", 18) predicates.equalTo("AGE", 18)
...@@ -18,10 +18,6 @@ promise.then((resultSet) => { ...@@ -18,10 +18,6 @@ promise.then((resultSet) => {
console.log(TAG + "resultSet columnCount:" + resultSet.columnCount);}) console.log(TAG + "resultSet columnCount:" + resultSet.columnCount);})
``` ```
## ResultSet ## ResultSet
提供通过查询数据库生成的数据库结果集的访问方法。 提供通过查询数据库生成的数据库结果集的访问方法。
...@@ -63,7 +59,7 @@ getColumnIndex(columnName: string): number ...@@ -63,7 +59,7 @@ getColumnIndex(columnName: string): number
| number | 返回指定列的索引。 | | number | 返回指定列的索引。 |
- 示例： - 示例：
``` ```js
resultSet.goToFirstRow() resultSet.goToFirstRow()
const id = resultSet.getLong(resultSet.getColumnIndex("ID")) const id = resultSet.getLong(resultSet.getColumnIndex("ID"))
const name = resultSet.getString(resultSet.getColumnIndex("NAME")) const name = resultSet.getString(resultSet.getColumnIndex("NAME"))
...@@ -91,7 +87,7 @@ getColumnName(columnIndex: number): string ...@@ -91,7 +87,7 @@ getColumnName(columnIndex: number): string
| string | 返回指定列的名称。 | | string | 返回指定列的名称。 |
- 示例： - 示例：
``` ```js
const id = resultSet.getColumnName(0) const id = resultSet.getColumnName(0)
const name = resultSet.getColumnName(1) const name = resultSet.getColumnName(1)
const age = resultSet.getColumnName(2) const age = resultSet.getColumnName(2)
...@@ -117,7 +113,7 @@ goTo(offset:number): boolean ...@@ -117,7 +113,7 @@ goTo(offset:number): boolean
| boolean | 如果成功移动结果集，则为true；否则返回false。 | | boolean | 如果成功移动结果集，则为true；否则返回false。 |
- 示例： - 示例：
``` ```js
let predicatesgoto = new dataRdb.RdbPredicates("EMPLOYEE") let predicatesgoto = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoto = rdbStore.query(predicatesgoto, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let promisequerygoto = rdbStore.query(predicatesgoto, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoto.then((resultSet) { promisequerygoto.then((resultSet) {
...@@ -148,7 +144,7 @@ goToRow(position: number): boolean ...@@ -148,7 +144,7 @@ goToRow(position: number): boolean
| boolean | 如果成功移动结果集，则为true；否则返回false。 | | boolean | 如果成功移动结果集，则为true；否则返回false。 |
- 示例： - 示例：
``` ```js
let predicatesgotorow = new dataRdb.RdbPredicates("EMPLOYEE") let predicatesgotorow = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygotorow = rdbStore.query(predicatesgotorow, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let promisequerygotorow = rdbStore.query(predicatesgotorow, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygotorow.then((resultSet) { promisequerygotorow.then((resultSet) {
...@@ -175,7 +171,7 @@ goToFirstRow(): boolean ...@@ -175,7 +171,7 @@ goToFirstRow(): boolean
| boolean | 如果成功移动结果集，则为true；否则返回false。 | | boolean | 如果成功移动结果集，则为true；否则返回false。 |
- 示例： - 示例：
``` ```js
let predicatesgoFirst = new dataRdb.RdbPredicates("EMPLOYEE") let predicatesgoFirst = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoFirst = rdbStore.query(predicatesgoFirst, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let promisequerygoFirst = rdbStore.query(predicatesgoFirst, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoFirst.then((resultSet) { promisequerygoFirst.then((resultSet) {
...@@ -201,7 +197,7 @@ goToLastRow(): boolean ...@@ -201,7 +197,7 @@ goToLastRow(): boolean
| boolean | 如果成功移动结果集，则为true；否则返回false。 | | boolean | 如果成功移动结果集，则为true；否则返回false。 |
- 示例： - 示例：
``` ```js
let predicatesgoLast = new dataRdb.RdbPredicates("EMPLOYEE") let predicatesgoLast = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoLast = rdbStore.query(predicatesgoLast, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let promisequerygoLast = rdbStore.query(predicatesgoLast, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoLast.then((resultSet) { promisequerygoLast.then((resultSet) {
...@@ -227,7 +223,7 @@ goToNextRow(): boolean ...@@ -227,7 +223,7 @@ goToNextRow(): boolean
| boolean | 如果成功移动结果集，则为true；否则返回false。 | | boolean | 如果成功移动结果集，则为true；否则返回false。 |
- 示例： - 示例：
``` ```js
let predicatesgoNext = new dataRdb.RdbPredicates("EMPLOYEE") let predicatesgoNext = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoNext = rdbStore.query(predicatesgoNext, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let promisequerygoNext = rdbStore.query(predicatesgoNext, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoNext.then((resultSet) { promisequerygoNext.then((resultSet) {
...@@ -253,7 +249,7 @@ goToPreviousRow(): boolean ...@@ -253,7 +249,7 @@ goToPreviousRow(): boolean
| boolean | 如果成功移动结果集，则为true；否则返回false。 | | boolean | 如果成功移动结果集，则为true；否则返回false。 |
- 示例： - 示例：
``` ```js
let predicatesgoPrev = new dataRdb.RdbPredicates("EMPLOYEE") let predicatesgoPrev = new dataRdb.RdbPredicates("EMPLOYEE")
let promisequerygoPrev = rdbStore.query(predicatesgoPrev, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let promisequerygoPrev = rdbStore.query(predicatesgoPrev, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoPrev.then((resultSet) { promisequerygoPrev.then((resultSet) {
...@@ -284,7 +280,7 @@ getBlob(columnIndex: number): Uint8Array ...@@ -284,7 +280,7 @@ getBlob(columnIndex: number): Uint8Array
| Uint8Array | 以字节数组的形式返回指定列的值。 | | Uint8Array | 以字节数组的形式返回指定列的值。 |
- 示例： - 示例：
``` ```js
const codes = resultSet.getBlob(resultSet.getColumnIndex("CODES")) const codes = resultSet.getBlob(resultSet.getColumnIndex("CODES"))
``` ```
...@@ -308,7 +304,7 @@ getString(columnIndex: number): string ...@@ -308,7 +304,7 @@ getString(columnIndex: number): string
| string | 以字符串形式返回指定列的值。 | | string | 以字符串形式返回指定列的值。 |
- 示例： - 示例：
``` ```js
const name = resultSet.getString(resultSet.getColumnIndex("NAME")) const name = resultSet.getString(resultSet.getColumnIndex("NAME"))
``` ```
...@@ -332,7 +328,7 @@ getLong(columnIndex: number): number ...@@ -332,7 +328,7 @@ getLong(columnIndex: number): number
| number | 以Long形式返回指定列的值。 | | number | 以Long形式返回指定列的值。 |
- 示例： - 示例：
``` ```js
const age = resultSet.getLong(resultSet.getColumnIndex("AGE")) const age = resultSet.getLong(resultSet.getColumnIndex("AGE"))
``` ```
...@@ -356,7 +352,7 @@ getDouble(columnIndex: number): number ...@@ -356,7 +352,7 @@ getDouble(columnIndex: number): number
| number | 以double形式返回指定列的值。 | | number | 以double形式返回指定列的值。 |
- 示例： - 示例：
``` ```js
const salary = resultSet.getDouble(resultSet.getColumnIndex("SALARY")) const salary = resultSet.getDouble(resultSet.getColumnIndex("SALARY"))
``` ```
...@@ -380,7 +376,7 @@ isColumnNull(columnIndex: number): boolean ...@@ -380,7 +376,7 @@ isColumnNull(columnIndex: number): boolean
| boolean | 如果当前行中指定列的值为null，则返回true，否则返回false。 | | boolean | 如果当前行中指定列的值为null，则返回true，否则返回false。 |
- 示例： - 示例：
``` ```js
const isColumnNull = resultSet.isColumnNull(resultSet.getColumnIndex("CODES")) const isColumnNull = resultSet.isColumnNull(resultSet.getColumnIndex("CODES"))
``` ```
...@@ -394,7 +390,7 @@ close(): void ...@@ -394,7 +390,7 @@ close(): void
**系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。 **系统能力**：SystemCapability.DistributedDataManager.RelationalStore.Core。
- 示例： - 示例：
``` ```js
let predicatesclose = new dataRdb.RdbPredicates("EMPLOYEE") let predicatesclose = new dataRdb.RdbPredicates("EMPLOYEE")
let predicatesclose = rdbStore.query(predicatesclose, ["ID", "NAME", "AGE", "SALARY", "CODES"]) let predicatesclose = rdbStore.query(predicatesclose, ["ID", "NAME", "AGE", "SALARY", "CODES"])
promisequerygoPrev.then((resultSet) { promisequerygoPrev.then((resultSet) {
...@@ -403,3 +399,4 @@ close(): void ...@@ -403,3 +399,4 @@ close(): void
console.log('query failed') console.log('query failed')
}) })
``` ```
zh-cn/application-dev/reference/apis/js-apis-data-storage.md
浏览文件 @ f4fc4c6f
...@@ -12,18 +12,18 @@ ...@@ -12,18 +12,18 @@
## 导入模块 ## 导入模块
``` ```js
import dataStorage from '@ohos.data.storage' import dataStorage from '@ohos.data.storage';
``` ```
## 属性 ## 常量
**系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedDataManager.Preferences.Core **系统能力**：以下各项对应的系统能力均为SystemCapability.DistributedDataManager.Preferences.Core
| 名称 | 参数类型 | 可读 | 可写 | 说明 | | 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- | -------- |
| MAX_KEY_LENGTH | string | 是 | 否 | key的最大长度限制，大小为80字节。 | | MAX_KEY_LENGTH | string | 是 | 否 | key的最大长度限制，大小为80字节。 |
| MAX_VALUE_LENGTH | string | 是 | 否 | string类型value的最大长度限制，大小为8192字节。 | | MAX_VALUE_LENGTH | string | 是 | 否 | value的最大长度限制，大小为8192字节。 |
## dataStorage.getStorageSync ## dataStorage.getStorageSync
...@@ -45,7 +45,7 @@ getStorageSync(path: string): Storage ...@@ -45,7 +45,7 @@ getStorageSync(path: string): Storage
| [Storage](#storage) | 获取到要操作的Storage实例，用于进行数据存储操作。 | | [Storage](#storage) | 获取到要操作的Storage实例，用于进行数据存储操作。 |
- 示例： - 示例：
``` ```js
import dataStorage from '@ohos.data.storage' import dataStorage from '@ohos.data.storage'
import featureAbility from '@ohos.ability.featureAbility' import featureAbility from '@ohos.ability.featureAbility'
...@@ -78,7 +78,7 @@ getStorage(path: string, callback: AsyncCallback&lt;Storage&gt;): void ...@@ -78,7 +78,7 @@ getStorage(path: string, callback: AsyncCallback&lt;Storage&gt;): void
| callback | AsyncCallback&lt;[Storage](#storage)&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;[Storage](#storage)&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
import dataStorage from '@ohos.data.storage' import dataStorage from '@ohos.data.storage'
import featureAbility from '@ohos.ability.featureAbility' import featureAbility from '@ohos.ability.featureAbility'
...@@ -120,7 +120,7 @@ getStorage(path: string): Promise&lt;Storage&gt; ...@@ -120,7 +120,7 @@ getStorage(path: string): Promise&lt;Storage&gt;
| Promise&lt;[Storage](#storage)&gt; | Promise实例，用于异步获取结果。 | | Promise&lt;[Storage](#storage)&gt; | Promise实例，用于异步获取结果。 |
- 示例： - 示例：
``` ```js
import dataStorage from '@ohos.data.storage' import dataStorage from '@ohos.data.storage'
import featureAbility from '@ohos.ability.featureAbility' import featureAbility from '@ohos.ability.featureAbility'
...@@ -176,7 +176,7 @@ deleteStorage(path: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -176,7 +176,7 @@ deleteStorage(path: string, callback: AsyncCallback&lt;void&gt;): void
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
dataStorage.deleteStorage(path + '/mystore', function (err) { dataStorage.deleteStorage(path + '/mystore', function (err) {
if (err) { if (err) {
console.info("Deleted failed with err: " + err) console.info("Deleted failed with err: " + err)
...@@ -206,7 +206,7 @@ deleteStorage(path: string): Promise&lt;void&gt; ...@@ -206,7 +206,7 @@ deleteStorage(path: string): Promise&lt;void&gt;
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。 |
- 示例： - 示例：
``` ```js
let promisedelSt = dataStorage.deleteStorage(path + '/mystore') let promisedelSt = dataStorage.deleteStorage(path + '/mystore')
promisedelSt.then(() => { promisedelSt.then(() => {
console.info("Deleted successfully.") console.info("Deleted successfully.")
...@@ -232,7 +232,7 @@ removeStorageFromCacheSync(path: string): void ...@@ -232,7 +232,7 @@ removeStorageFromCacheSync(path: string): void
| path | string | 是 | 应用程序内部数据存储路径。 | | path | string | 是 | 应用程序内部数据存储路径。 |
- 示例： - 示例：
``` ```js
dataStorage.removeStorageFromCacheSync(path + '/mystore') dataStorage.removeStorageFromCacheSync(path + '/mystore')
``` ```
...@@ -254,7 +254,7 @@ removeStorageFromCache(path: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -254,7 +254,7 @@ removeStorageFromCache(path: string, callback: AsyncCallback&lt;void&gt;): void
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
dataStorage.removeStorageFromCache(path + '/mystore', function (err) { dataStorage.removeStorageFromCache(path + '/mystore', function (err) {
if (err) { if (err) {
console.info("Removed storage from cache failed with err: " + err) console.info("Removed storage from cache failed with err: " + err)
...@@ -286,7 +286,7 @@ removeStorageFromCache(path: string): Promise&lt;void&gt; ...@@ -286,7 +286,7 @@ removeStorageFromCache(path: string): Promise&lt;void&gt;
| Promise&lt;void&gt; | Promise实例，用于异步获取结果。 | | Promise&lt;void&gt; | Promise实例，用于异步获取结果。 |
- 示例： - 示例：
``` ```js
let promiserevSt = dataStorage.removeStorageFromCache(path + '/mystore') let promiserevSt = dataStorage.removeStorageFromCache(path + '/mystore')
promiserevSt.then(() => { promiserevSt.then(() => {
console.info("Removed storage from cache successfully.") console.info("Removed storage from cache successfully.")
...@@ -314,8 +314,8 @@ getSync(key: string, defValue: ValueType): ValueType ...@@ -314,8 +314,8 @@ getSync(key: string, defValue: ValueType): ValueType
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要获取的存储key名称。它不能为空。 | | key | string | 是 | 要获取的存储key名称，不能为空。 |
| defValue | ValueType | 是 | 给定key的存储不存在，则要返回的默认值。支持number、string、boolean。 | | defValue | [ValueType](#valuetype) | 是 | 给定key的存储不存在，则要返回的默认值。支持number、string、boolean。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -323,7 +323,7 @@ getSync(key: string, defValue: ValueType): ValueType ...@@ -323,7 +323,7 @@ getSync(key: string, defValue: ValueType): ValueType
| ValueType | 键对应的值，如果值为null或者非默认值类型，返回默认数据。 | | ValueType | 键对应的值，如果值为null或者非默认值类型，返回默认数据。 |
- 示例： - 示例：
``` ```js
let value = storage.getSync('startup', 'default') let value = storage.getSync('startup', 'default')
console.info("The value of startup is " + value) console.info("The value of startup is " + value)
``` ```
...@@ -342,12 +342,12 @@ get(key: string, defValue: ValueType, callback: AsyncCallback&lt;ValueType&gt;): ...@@ -342,12 +342,12 @@ get(key: string, defValue: ValueType, callback: AsyncCallback&lt;ValueType&gt;):
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要获取的存储key名称。它不能为空。 | | key | string | 是 | 要获取的存储key名称，不能为空。 |
| defValue | ValueType | 是 | 默认返回值。支持number、string、boolean。 | | defValue | [ValueType](#valuetype) | 是 | 默认返回值。支持number、string、boolean。 |
| callback | AsyncCallback&lt;ValueType&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;ValueType&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
storage.get('startup', 'default', function(err, value) { storage.get('startup', 'default', function(err, value) {
if (err) { if (err) {
console.info("Get the value of startup failed with err: " + err) console.info("Get the value of startup failed with err: " + err)
...@@ -371,8 +371,8 @@ get(key: string, defValue: ValueType): Promise&lt;ValueType&gt; ...@@ -371,8 +371,8 @@ get(key: string, defValue: ValueType): Promise&lt;ValueType&gt;
- **参数：** - **参数：**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要获取的存储key名称。它不能为空。 | | key | string | 是 | 要获取的存储key名称，不能为空。 |
| defValue | ValueType | 是 | 默认返回值。支持number、string、boolean。 | | defValue | [ValueType](#valuetype) | 是 | 默认返回值。支持number、string、boolean。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -380,7 +380,7 @@ get(key: string, defValue: ValueType): Promise&lt;ValueType&gt; ...@@ -380,7 +380,7 @@ get(key: string, defValue: ValueType): Promise&lt;ValueType&gt;
| Promise&lt;ValueType&gt; | Promise实例，用于异步获取结果。 | | Promise&lt;ValueType&gt; | Promise实例，用于异步获取结果。 |
- 示例： - 示例：
``` ```js
let promiseget = storage.get('startup', 'default') let promiseget = storage.get('startup', 'default')
promiseget.then((value) => { promiseget.then((value) => {
console.info("The value of startup is " + value) console.info("The value of startup is " + value)
...@@ -403,11 +403,11 @@ putSync(key: string, value: ValueType): void ...@@ -403,11 +403,11 @@ putSync(key: string, value: ValueType): void
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要修改的存储的key。它不能为空。 | | key | string | 是 | 要修改的存储的key，不能为空。 |
| value | ValueType | 是 | 存储的新值。支持number、string、boolean。 | | value | [ValueType](#valuetype) | 是 | 存储的新值。支持number、string、boolean。 |
- 示例： - 示例：
``` ```js
storage.putSync('startup', 'auto') storage.putSync('startup', 'auto')
``` ```
...@@ -425,12 +425,12 @@ put(key: string, value: ValueType, callback: AsyncCallback&lt;void&gt;): void ...@@ -425,12 +425,12 @@ put(key: string, value: ValueType, callback: AsyncCallback&lt;void&gt;): void
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要修改的存储的key。它不能为空。 | | key | string | 是 | 要修改的存储的key，不能为空。 |
| value | ValueType | 是 | 存储的新值。支持number、string、boolean。 | | value | [ValueType](#valuetype) | 是 | 存储的新值。支持number、string、boolean。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
storage.put('startup', 'auto', function (err) { storage.put('startup', 'auto', function (err) {
if (err) { if (err) {
console.info("Put the value of startup failed with err: " + err) console.info("Put the value of startup failed with err: " + err)
...@@ -454,8 +454,8 @@ put(key: string, value: ValueType): Promise&lt;void&gt; ...@@ -454,8 +454,8 @@ put(key: string, value: ValueType): Promise&lt;void&gt;
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要修改的存储的key。它不能为空。 | | key | string | 是 | 要修改的存储的key，不能为空。 |
| value | ValueType | 是 | 存储的新值。支持number、string、boolean。 | | value | [ValueType](#valuetype) | 是 | 存储的新值。支持number、string、boolean。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -463,7 +463,7 @@ put(key: string, value: ValueType): Promise&lt;void&gt; ...@@ -463,7 +463,7 @@ put(key: string, value: ValueType): Promise&lt;void&gt;
| Promise&lt;void&gt; | Promise实例，用于异步处理。 | | Promise&lt;void&gt; | Promise实例，用于异步处理。 |
- 示例： - 示例：
``` ```js
let promiseput = storage.put('startup', 'auto') let promiseput = storage.put('startup', 'auto')
promiseput.then(() => { promiseput.then(() => {
console.info("Put the value of startup successfully.") console.info("Put the value of startup successfully.")
...@@ -486,7 +486,7 @@ hasSync(key: string): boolean ...@@ -486,7 +486,7 @@ hasSync(key: string): boolean
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要获取的存储key名称。它不能为空。 | | key | string | 是 | 要获取的存储key名称，不能为空。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -494,7 +494,7 @@ hasSync(key: string): boolean ...@@ -494,7 +494,7 @@ hasSync(key: string): boolean
| boolean | true&nbsp;表示存在，false表示不存在。 | | boolean | true&nbsp;表示存在，false表示不存在。 |
- 示例： - 示例：
``` ```js
let isExist = storage.hasSync('startup') let isExist = storage.hasSync('startup')
if (isExist) { if (isExist) {
console.info("The key of startup is contained.") console.info("The key of startup is contained.")
...@@ -524,7 +524,7 @@ has(key: string, callback: AsyncCallback&lt;boolean&gt;): boolean ...@@ -524,7 +524,7 @@ has(key: string, callback: AsyncCallback&lt;boolean&gt;): boolean
| boolean | true表示存在，false表示不存在。 | | boolean | true表示存在，false表示不存在。 |
- 示例： - 示例：
``` ```js
storage.has('startup', function (err, isExist) { storage.has('startup', function (err, isExist) {
if (err) { if (err) {
console.info("Check the key of startup failed with err: " + err) console.info("Check the key of startup failed with err: " + err)
...@@ -550,7 +550,7 @@ has(key: string): Promise&lt;boolean&gt; ...@@ -550,7 +550,7 @@ has(key: string): Promise&lt;boolean&gt;
- 参数： - 参数：
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 是 | 要获取的存储key名称。它不能为空。 | | key | string | 是 | 要获取的存储key名称，不能为空。 |
- 返回值： - 返回值：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -558,7 +558,7 @@ has(key: string): Promise&lt;boolean&gt; ...@@ -558,7 +558,7 @@ has(key: string): Promise&lt;boolean&gt;
| Promise&lt;boolean&gt; | Promise实例，用于异步处理。 | | Promise&lt;boolean&gt; | Promise实例，用于异步处理。 |
- 示例： - 示例：
``` ```js
let promisehas = storage.has('startup') let promisehas = storage.has('startup')
promisehas.then((isExist) => { promisehas.then((isExist) => {
if (isExist) { if (isExist) {
...@@ -586,12 +586,12 @@ deleteSync(key: string): void ...@@ -586,12 +586,12 @@ deleteSync(key: string): void
| key | string | 是 | 要获取的存储key名称。它不能为空。 | | key | string | 是 | 要获取的存储key名称。它不能为空。 |
- 示例： - 示例：
``` ```js
storage.deleteSync('startup') storage.deleteSync('startup')
``` ```
### delete ### deletej
delete(key: string, callback: AsyncCallback&lt;void&gt;): void delete(key: string, callback: AsyncCallback&lt;void&gt;): void
...@@ -608,7 +608,7 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -608,7 +608,7 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
storage.delete('startup', function (err) { storage.delete('startup', function (err) {
if (err) { if (err) {
console.info("Delete startup key failed with err: " + err) console.info("Delete startup key failed with err: " + err)
...@@ -640,7 +640,7 @@ delete(key: string): Promise&lt;void&gt; ...@@ -640,7 +640,7 @@ delete(key: string): Promise&lt;void&gt;
| Promise&lt;void&gt; | Promise实例，用于异步处理。 | | Promise&lt;void&gt; | Promise实例，用于异步处理。 |
- 示例： - 示例：
``` ```js
let promisedel = storage.delete('startup') let promisedel = storage.delete('startup')
promisedel.then(() => { promisedel.then(() => {
console.info("Deleted startup key successfully.") console.info("Deleted startup key successfully.")
...@@ -661,7 +661,7 @@ flushSync(): void ...@@ -661,7 +661,7 @@ flushSync(): void
**系统能力**：SystemCapability.DistributedDataManager.Preferences.Core **系统能力**：SystemCapability.DistributedDataManager.Preferences.Core
- 示例： - 示例：
``` ```js
storage.flushSync() storage.flushSync()
``` ```
...@@ -682,7 +682,7 @@ flush(callback: AsyncCallback&lt;void&gt;): void ...@@ -682,7 +682,7 @@ flush(callback: AsyncCallback&lt;void&gt;): void
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
storage.flush(function (err) { storage.flush(function (err) {
if (err) { if (err) {
console.info("Flush to file failed with err: " + err) console.info("Flush to file failed with err: " + err)
...@@ -709,7 +709,7 @@ flush(): Promise&lt;void&gt; ...@@ -709,7 +709,7 @@ flush(): Promise&lt;void&gt;
| Promise&lt;void&gt; | Promise实例，用于异步处理。 | | Promise&lt;void&gt; | Promise实例，用于异步处理。 |
- 示例： - 示例：
``` ```js
let promiseflush = storage.flush() let promiseflush = storage.flush()
promiseflush.then(() => { promiseflush.then(() => {
console.info("Flushed to file successfully.") console.info("Flushed to file successfully.")
...@@ -730,7 +730,7 @@ clearSync(): void ...@@ -730,7 +730,7 @@ clearSync(): void
**系统能力**：SystemCapability.DistributedDataManager.Preferences.Core **系统能力**：SystemCapability.DistributedDataManager.Preferences.Core
- 示例： - 示例：
``` ```js
storage.clearSync() storage.clearSync()
``` ```
...@@ -751,7 +751,7 @@ clear(callback: AsyncCallback&lt;void&gt;): void ...@@ -751,7 +751,7 @@ clear(callback: AsyncCallback&lt;void&gt;): void
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |
- 示例： - 示例：
``` ```js
storage.clear(function (err) { storage.clear(function (err) {
if (err) { if (err) {
console.info("Clear to file failed with err: " + err) console.info("Clear to file failed with err: " + err)
...@@ -778,7 +778,7 @@ clear(): Promise&lt;void&gt; ...@@ -778,7 +778,7 @@ clear(): Promise&lt;void&gt;
| Promise&lt;void&gt; | Promise实例，用于异步处理。 | | Promise&lt;void&gt; | Promise实例，用于异步处理。 |
- 示例： - 示例：
``` ```js
let promiseclear = storage.clear() let promiseclear = storage.clear()
promiseclear.then(() => { promiseclear.then(() => {
console.info("Cleared to file successfully.") console.info("Cleared to file successfully.")
...@@ -803,7 +803,7 @@ on(type: 'change', callback: Callback&lt;StorageObserver&gt;): void ...@@ -803,7 +803,7 @@ on(type: 'change', callback: Callback&lt;StorageObserver&gt;): void
| callback | Callback&lt;[StorageObserver](#storageobserver)&gt; | 回调对象实例。 | | callback | Callback&lt;[StorageObserver](#storageobserver)&gt; | 回调对象实例。 |
- 示例： - 示例：
``` ```js
var observer = function (key) { var observer = function (key) {
console.info("The key of " + key + " changed.") console.info("The key of " + key + " changed.")
} }
...@@ -828,7 +828,7 @@ off(type: 'change', callback: Callback&lt;StorageObserver&gt;): void ...@@ -828,7 +828,7 @@ off(type: 'change', callback: Callback&lt;StorageObserver&gt;): void
| callback | Callback&lt;[StorageObserver](#storageobserver)&gt; | 需要取消的回调对象实例。 | | callback | Callback&lt;[StorageObserver](#storageobserver)&gt; | 需要取消的回调对象实例。 |
- 示例： - 示例：
``` ```js
var observer = function (key) { var observer = function (key) {
console.info("The key of " + key + " changed.") console.info("The key of " + key + " changed.")
} }
...@@ -843,3 +843,15 @@ off(type: 'change', callback: Callback&lt;StorageObserver&gt;): void ...@@ -843,3 +843,15 @@ off(type: 'change', callback: Callback&lt;StorageObserver&gt;): void
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| key | string | 否 | 变更的数据内容。 | | key | string | 否 | 变更的数据内容。 |
## ValueType
用于表示允许的数据字段类型。
**系统能力**：SystemCapability.DistributedDataManager.Preferences.Core
| 名称 | 说明 |
| ------- | -------------------- |
| number | 表示值类型为数字。 |
| string | 表示值类型为字符。 |
| boolean | 表示值类型为布尔值。 |
zh-cn/application-dev/reference/apis/js-apis-distributed-data.md
浏览文件 @ f4fc4c6f
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
## 导入模块 ## 导入模块
``` ```js
import distributedData from '@ohos.data.distributedData'; import distributedData from '@ohos.data.distributedData';
``` ```
...@@ -27,7 +27,7 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt ...@@ -27,7 +27,7 @@ createKVManager(config: KVManagerConfig, callback: AsyncCallback&lt;KVManager&gt
| callback | AsyncCallback&lt;[KVManager](#kvmanager)&gt; | 是 | KVManager实例创建时调用的回调，返回KVManager对象实例。 | | callback | AsyncCallback&lt;[KVManager](#kvmanager)&gt; | 是 | KVManager实例创建时调用的回调，返回KVManager对象实例。 |
**示例**： **示例**：
``` ```js
let kvManager; let kvManager;
try { try {
const kvManagerConfig = { const kvManagerConfig = {
...@@ -72,7 +72,7 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt; ...@@ -72,7 +72,7 @@ createKVManager(config: KVManagerConfig): Promise&lt;KVManager&gt;
**示例**： **示例**：
``` ```js
let kvManager; let kvManager;
try { try {
const kvManagerConfig = { const kvManagerConfig = {
...@@ -129,7 +129,7 @@ try { ...@@ -129,7 +129,7 @@ try {
## KVManager ## KVManager
数据管理实例，用于获取KVStore的相关信息。在调用KVManager的方法前，需要先通过createKVManager构建一个KVManager实例。 数据管理实例，用于获取KVStore的相关信息。在调用KVManager的方法前，需要先通过[createKVManager](#distributeddatacreatekvmanager)构建一个KVManager实例。
### getKVStore ### getKVStore
...@@ -145,11 +145,11 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options, callback: ...@@ -145,11 +145,11 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options, callback:
| ----- | ------ | ------ | ------ | | ----- | ------ | ------ | ------ |
| storeId | string | 是 | 数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 | | storeId | string | 是 | 数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 |
| options | [Options](#options) | 是 | 创建KVStore实例的配置信息。 | | options | [Options](#options) | 是 | 创建KVStore实例的配置信息。 |
| callback | AsyncCallback&lt;T&gt;，&lt;T extends KVStore&gt; | 是 | 创建KVStore实例的回调，返回KVStore对象实例。 | | callback | AsyncCallback&lt;T&gt;，&lt;T extends [KVStore](#kvstore)&gt; | 是 | 创建KVStore实例的回调，返回KVStore对象实例。 |
**示例**： **示例**：
``` ```js
let kvStore; let kvStore;
let kvManager; let kvManager;
try { try {
...@@ -195,11 +195,11 @@ getKVStore&lt;T extends KVStore&gt;(storeId: string, options: Options): Promise& ...@@ -195,11 +195,11 @@ 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](#kvstore)&gt; | 指定的Promise回调方法，返回创建的KVStore数据库实例。 |
**示例**： **示例**：
``` ```js
let kvStore; let kvStore;
let kvManager; let kvManager;
try { try {
...@@ -226,7 +226,7 @@ try { ...@@ -226,7 +226,7 @@ try {
closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCallback&lt;void&gt;): void closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCallback&lt;void&gt;): void
通过storId的值关闭指定的kvStore数据库，并通过callback方式返回，此方法为异步方法。 通过storeId的值关闭指定的KVStore数据库，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -237,12 +237,12 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCa ...@@ -237,12 +237,12 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCa
| ------- | ----------------- | ---- | --------------------------- | | ------- | ----------------- | ---- | --------------------------- |
| appId | string | 是 | 所调用数据库方的包名。 | | appId | string | 是 | 所调用数据库方的包名。 |
| storeId | string | 是 | 要关闭的数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 | | storeId | string | 是 | 要关闭的数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 |
| kvStore | [KVStore](#kvstore) | 是 | 要关闭的KvStore数据库。 | | kvStore | [KVStore](#kvstore) | 是 | 要关闭的KVStore数据库。 |
| callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，如果数据库关闭成功则返回true，否则返回false。 | | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数，如果数据库关闭成功则返回true，否则返回false。 |
**示例**： **示例**：
``` ```js
let kvStore; let kvStore;
let kvManager; let kvManager;
const options = { const options = {
...@@ -272,7 +272,7 @@ const options = { ...@@ -272,7 +272,7 @@ const options = {
closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void&gt; closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void&gt;
通过kvStore的值关闭指定的kvStore数据库，并通过Promise方式返回，此方法为异步方法。 通过storeId的值关闭指定的KVStore数据库，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -282,17 +282,17 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void& ...@@ -282,17 +282,17 @@ closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise&lt;void&
| ----- | ------ | ---- | ----------------------------- | | ----- | ------ | ---- | ----------------------------- |
| appId | string | 是 | 所调用数据库方的包名。 | | appId | string | 是 | 所调用数据库方的包名。 |
| storeId | string | 是 | 要关闭的数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 | | storeId | string | 是 | 要关闭的数据库唯一标识符，长度不大于[MAX_STORE_ID_LENGTH](#constants)。 |
| kvStore | [KVStore](#kvstore) | 是 | 要关闭的KvStore数据库。 | | kvStore | [KVStore](#kvstore) | 是 | 要关闭的KVStore数据库。 |
**返回值**： **返回值**：
| 类型 | 说明 | | 类型 | 说明 |
| ------------- | -------------- | | ------------- | -------------- |
| Promise<void> | Promise实例，如果数据库关闭成功则返回true，否则返回false。 | | Promise\<void> | Promise实例，如果数据库关闭成功则返回true，否则返回false。 |
**示例**： **示例**：
``` ```js
let kvManager; let kvManager;
let kvStore; let kvStore;
const options = { const options = {
...@@ -326,7 +326,7 @@ const options = { ...@@ -326,7 +326,7 @@ const options = {
deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt;): void deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt;): void
通过storeId的值删除指定的kvStore数据库，并通过callback方式返回，此方法为异步方法。 通过storeId的值删除指定的KVStore数据库，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -340,7 +340,7 @@ deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt ...@@ -340,7 +340,7 @@ deleteKVStore(appId: string, storeId: string, callback: AsyncCallback&lt;void&gt
**示例**： **示例**：
``` ```js
let kvManager; let kvManager;
let kvStore; let kvStore;
const options = { const options = {
...@@ -369,7 +369,7 @@ try { ...@@ -369,7 +369,7 @@ try {
deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt; deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt;
通过storeId的值删除指定的kvStore数据库，并通过Promise方式返回，此方法为异步方法。 通过storeId的值删除指定的KVStore数据库，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -389,7 +389,7 @@ deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt; ...@@ -389,7 +389,7 @@ deleteKVStore(appId: string, storeId: string): Promise&lt;void&gt;
**示例**： **示例**：
``` ```js
let kvManager; let kvManager;
let kvStore; let kvStore;
const options = { const options = {
...@@ -402,7 +402,7 @@ const options = { ...@@ -402,7 +402,7 @@ const options = {
securityLevel : distributedData.SecurityLevel.S2, securityLevel : distributedData.SecurityLevel.S2,
} }
try { try {
kvManager.getKVStore('storId', 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.deleteKVStore('appId', 'storeId').then(() => { await kvManager.deleteKVStore('appId', 'storeId').then(() => {
...@@ -423,7 +423,7 @@ try { ...@@ -423,7 +423,7 @@ try {
getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void
获取所有通过getKvStore方法创建的且没有调用deleteKvStore方法删除的KvStore数据库的storeId，并通过callback方式返回，此方法为异步方法。 获取所有通过[getKVStore](#getkvstore)方法创建的且没有调用[deleteKVStore](#deletekvstore8)方法删除的KVStore数据库的storeId，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -436,7 +436,7 @@ getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void ...@@ -436,7 +436,7 @@ getAllKVStoreId(appId: string, callback: AsyncCallback&lt;string[]&gt;): void
**示例**： **示例**：
``` ```js
let kvManager; let kvManager;
try { try {
kvManager.getAllKVStoreId('appId', function (err, data) { kvManager.getAllKVStoreId('appId', function (err, data) {
...@@ -453,7 +453,7 @@ try { ...@@ -453,7 +453,7 @@ try {
getAllKVStoreId(appId: string): Promise&lt;string[]&gt; getAllKVStoreId(appId: string): Promise&lt;string[]&gt;
获取所有通过getKvStore方法创建的且没有调用deleteKvStore方法删除的KvStore数据库的storeId，并通过Promise方式返回，此方法为异步方法。 获取所有通过[getKVStore](#getkvstore)方法创建的且没有调用[deleteKVStore](#deletekvstore8)方法删除的KVStore数据库的storeId，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -472,7 +472,7 @@ getAllKVStoreId(appId: string): Promise&lt;string[]&gt; ...@@ -472,7 +472,7 @@ getAllKVStoreId(appId: string): Promise&lt;string[]&gt;
**示例**： **示例**：
``` ```js
let kvManager; let kvManager;
try { try {
console.log('GetAllKVStoreId'); console.log('GetAllKVStoreId');
...@@ -505,7 +505,7 @@ on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): voi ...@@ -505,7 +505,7 @@ on(event: 'distributedDataServiceDie', deathCallback: Callback&lt;void&gt;): voi
**示例** **示例**
``` ```js
let kvManager; let kvManager;
try { try {
...@@ -538,7 +538,7 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v ...@@ -538,7 +538,7 @@ off(event: 'distributedDataServiceDie', deathCallback?: Callback&lt;void&gt;): v
**示例** **示例**
``` ```js
let kvManager; let kvManager;
try { try {
console.log('KVManagerOff'); console.log('KVManagerOff');
...@@ -563,7 +563,7 @@ try { ...@@ -563,7 +563,7 @@ try {
| createIfMissing | boolean | 否 | 当数据库文件不存在时是否创建数据库，默认创建。 | | createIfMissing | boolean | 否 | 当数据库文件不存在时是否创建数据库，默认创建。 |
| encrypt | boolean | 否 |设置数据库文件是否加密，默认不加密。 | | encrypt | boolean | 否 |设置数据库文件是否加密，默认不加密。 |
| backup | boolean | 否 |设置数据库文件是否备份，默认备份。 | | backup | boolean | 否 |设置数据库文件是否备份，默认备份。 |
| autoSync | boolean | 否 |设置数据库文件是否自动同步，默认不自动同步。**需要权限**： ohos.permission.DISTRIBUTED_DATASYNC。 | | autoSync | boolean | 否 |设置数据库文件是否自动同步，默认不自动同步。<br>**需要权限**： ohos.permission.DISTRIBUTED_DATASYNC。 |
| kvStoreType | [KVStoreType](#kvstoretype) | 否 |设置要创建的数据库类型，默认为多设备协同数据库。 | | kvStoreType | [KVStoreType](#kvstoretype) | 否 |设置要创建的数据库类型，默认为多设备协同数据库。 |
| securityLevel | [SecurityLevel](#securitylevel) | 否 |设置数据库安全级别，默认不设置安全级别。 | | securityLevel | [SecurityLevel](#securitylevel) | 否 |设置数据库安全级别，默认不设置安全级别。 |
| schema<sup>8+</sup> | [Schema](#schema8) | 否 | 设置定义存储在数据库中的值。 | | schema<sup>8+</sup> | [Schema](#schema8) | 否 | 设置定义存储在数据库中的值。 |
...@@ -621,7 +621,7 @@ KVStore常量。 ...@@ -621,7 +621,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的跳跃大小。 |
...@@ -674,7 +674,6 @@ appendChild(child: FieldNode): boolean ...@@ -674,7 +674,6 @@ appendChild(child: FieldNode): boolean
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| child | [FieldNode](#fieldnode8) | 是 | 要附加的域节点。 | | child | [FieldNode](#fieldnode8) | 是 | 要附加的域节点。 |
**返回值**： **返回值**：
| 类型 | 说明 | | 类型 | 说明 |
...@@ -683,7 +682,7 @@ appendChild(child: FieldNode): boolean ...@@ -683,7 +682,7 @@ appendChild(child: FieldNode): boolean
**示例** **示例**
``` ```js
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");
...@@ -706,7 +705,7 @@ try { ...@@ -706,7 +705,7 @@ try {
## KvStoreResultSet<sup>8+</sup> ## ## KvStoreResultSet<sup>8+</sup> ##
提供获取KvStore数据库结果集的方法，提供查询和移动数据读取位置的方法，在调用KvStoreResultSet的方法前，需要先通过KvStore 构建一个KvStore 实例。 提供获取KVStore数据库结果集的方法，提供查询和移动数据读取位置的方法，在调用KvStoreResultSet的方法前，需要先通过KVStore 构建一个KVStore 实例。
### getCount<sup>8+</sup> ### ### getCount<sup>8+</sup> ###
...@@ -725,7 +724,7 @@ getCount(): number ...@@ -725,7 +724,7 @@ getCount(): number
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -758,7 +757,7 @@ getPosition(): number ...@@ -758,7 +757,7 @@ getPosition(): number
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -792,7 +791,7 @@ moveToFirst(): boolean ...@@ -792,7 +791,7 @@ moveToFirst(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -826,7 +825,7 @@ moveToLast(): boolean ...@@ -826,7 +825,7 @@ moveToLast(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -860,7 +859,7 @@ moveToNext(): boolean ...@@ -860,7 +859,7 @@ moveToNext(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -894,7 +893,7 @@ moveToPrevious(): boolean ...@@ -894,7 +893,7 @@ moveToPrevious(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -934,7 +933,7 @@ move(offset: number): boolean ...@@ -934,7 +933,7 @@ move(offset: number): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -974,7 +973,7 @@ moveToPosition(position: number): boolean ...@@ -974,7 +973,7 @@ moveToPosition(position: number): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -1008,7 +1007,7 @@ isFirst(): boolean ...@@ -1008,7 +1007,7 @@ isFirst(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -1042,7 +1041,7 @@ isLast(): boolean ...@@ -1042,7 +1041,7 @@ isLast(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -1075,7 +1074,7 @@ isBeforeFirst(): boolean ...@@ -1075,7 +1074,7 @@ isBeforeFirst(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -1109,7 +1108,7 @@ isAfterLast(): boolean ...@@ -1109,7 +1108,7 @@ isAfterLast(): boolean
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -1131,7 +1130,7 @@ try { ...@@ -1131,7 +1130,7 @@ try {
getEntry(): Entry getEntry(): Entry
获取键值对 获取键值对。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -1139,11 +1138,11 @@ getEntry(): Entry ...@@ -1139,11 +1138,11 @@ getEntry(): Entry
| 类型 | 说明 | | 类型 | 说明 |
| ------ | ------- | | ------ | ------- |
| Entry |返回键值对。| | [Entry](#entry) |返回键值对。|
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -1172,7 +1171,7 @@ try { ...@@ -1172,7 +1171,7 @@ try {
constructor() constructor()
用于创建Schema实例的构造函数 用于创建Schema实例的构造函数。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -1194,7 +1193,7 @@ reset(): Query ...@@ -1194,7 +1193,7 @@ reset(): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.equalTo("key", "value"); query.equalTo("key", "value");
...@@ -1210,7 +1209,7 @@ try { ...@@ -1210,7 +1209,7 @@ try {
### equalTo<sup>8+</sup> ### ### equalTo<sup>8+</sup> ###
equalTo(field: string, value: number|string|boolean): Query; equalTo(field: string, value: number|string|boolean): Query
构造一个Query对象来查询具有指定字段的条目，其值等于指定的值。 构造一个Query对象来查询具有指定字段的条目，其值等于指定的值。
...@@ -1221,7 +1220,7 @@ equalTo(field: string, value: number|string|boolean): Query; ...@@ -1221,7 +1220,7 @@ equalTo(field: string, value: number|string|boolean): Query;
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 | | fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 |
| value | number/string/boolean | 是 | 表示指定的值。| | value | number\|string\|boolean | 是 | 表示指定的值。|
**返回值**： **返回值**：
...@@ -1231,7 +1230,7 @@ equalTo(field: string, value: number|string|boolean): Query; ...@@ -1231,7 +1230,7 @@ equalTo(field: string, value: number|string|boolean): Query;
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.equalTo("field", "value"); query.equalTo("field", "value");
...@@ -1256,7 +1255,7 @@ notEqualTo(field: string, value: number|string|boolean): Query ...@@ -1256,7 +1255,7 @@ notEqualTo(field: string, value: number|string|boolean): Query
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 | | fieId | string | 是 |表示指定字段，必须以$开头， 并且不能包含' ^ '。 |
| value | number/string/boolean | 是 | 表示指定的值。| | value | number\|string\|boolean | 是 | 表示指定的值。|
**返回值**： **返回值**：
...@@ -1266,7 +1265,7 @@ notEqualTo(field: string, value: number|string|boolean): Query ...@@ -1266,7 +1265,7 @@ notEqualTo(field: string, value: number|string|boolean): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
...@@ -1301,7 +1300,7 @@ greaterThan(field: string, value: number|string|boolean): Query ...@@ -1301,7 +1300,7 @@ greaterThan(field: string, value: number|string|boolean): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.greaterThan("field", "value"); query.greaterThan("field", "value");
...@@ -1336,7 +1335,7 @@ lessThan(field: string, value: number|string): Query ...@@ -1336,7 +1335,7 @@ lessThan(field: string, value: number|string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.lessThan("field", "value"); query.lessThan("field", "value");
...@@ -1371,7 +1370,7 @@ greaterThanOrEqualTo(field: string, value: number|string): Query ...@@ -1371,7 +1370,7 @@ greaterThanOrEqualTo(field: string, value: number|string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.greaterThanOrEqualTo("field", "value"); query.greaterThanOrEqualTo("field", "value");
...@@ -1406,7 +1405,7 @@ lessThanOrEqualTo(field: string, value: number|string): Query ...@@ -1406,7 +1405,7 @@ lessThanOrEqualTo(field: string, value: number|string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.lessThanOrEqualTo("field", "value"); query.lessThanOrEqualTo("field", "value");
...@@ -1441,7 +1440,7 @@ isNull(field: string): Query ...@@ -1441,7 +1440,7 @@ isNull(field: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.isNull("field"); query.isNull("field");
...@@ -1477,7 +1476,7 @@ inNumber(field: string, valueList: number[]): Query ...@@ -1477,7 +1476,7 @@ inNumber(field: string, valueList: number[]): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.inNumber("field", [0, 1]); query.inNumber("field", [0, 1]);
...@@ -1512,7 +1511,7 @@ inString(field: string, valueList: string[]): Query ...@@ -1512,7 +1511,7 @@ inString(field: string, valueList: string[]): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.inString("field", ['test1', 'test2']); query.inString("field", ['test1', 'test2']);
...@@ -1547,7 +1546,7 @@ notInNumber(field: string, valueList: number[]): Query ...@@ -1547,7 +1546,7 @@ notInNumber(field: string, valueList: number[]): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notInNumber("field", [0, 1]); query.notInNumber("field", [0, 1]);
...@@ -1582,7 +1581,7 @@ notInString(field: string, valueList: string[]): Query ...@@ -1582,7 +1581,7 @@ notInString(field: string, valueList: string[]): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notInString("field", ['test1', 'test2']); query.notInString("field", ['test1', 'test2']);
...@@ -1617,7 +1616,7 @@ like(field: string, value: string): Query ...@@ -1617,7 +1616,7 @@ like(field: string, value: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.like("field", "value"); query.like("field", "value");
...@@ -1652,7 +1651,7 @@ unlike(field: string, value: string): Query ...@@ -1652,7 +1651,7 @@ unlike(field: string, value: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.unlike("field", "value"); query.unlike("field", "value");
...@@ -1680,7 +1679,7 @@ and(): Query ...@@ -1680,7 +1679,7 @@ and(): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value1"); query.notEqualTo("field", "value1");
...@@ -1710,7 +1709,7 @@ or(): Query ...@@ -1710,7 +1709,7 @@ or(): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value1"); query.notEqualTo("field", "value1");
...@@ -1746,7 +1745,7 @@ orderByAsc(field: string): Query ...@@ -1746,7 +1745,7 @@ orderByAsc(field: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
...@@ -1781,7 +1780,7 @@ orderByDesc(field: string): Query ...@@ -1781,7 +1780,7 @@ orderByDesc(field: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
...@@ -1817,7 +1816,7 @@ limit(total: number, offset: number): Query ...@@ -1817,7 +1816,7 @@ limit(total: number, offset: number): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.notEqualTo("field", "value"); query.notEqualTo("field", "value");
...@@ -1852,7 +1851,7 @@ isNotNull(field: string): Query ...@@ -1852,7 +1851,7 @@ isNotNull(field: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.isNotNull("field"); query.isNotNull("field");
...@@ -1880,7 +1879,7 @@ beginGroup(): Query ...@@ -1880,7 +1879,7 @@ beginGroup(): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.beginGroup(); query.beginGroup();
...@@ -1910,7 +1909,7 @@ endGroup(): Query ...@@ -1910,7 +1909,7 @@ endGroup(): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.beginGroup(); query.beginGroup();
...@@ -1946,7 +1945,7 @@ prefixKey(prefix: string): Query ...@@ -1946,7 +1945,7 @@ prefixKey(prefix: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.prefixKey("$.name"); query.prefixKey("$.name");
...@@ -1981,7 +1980,7 @@ setSuggestIndex(index: string): Query ...@@ -1981,7 +1980,7 @@ setSuggestIndex(index: string): Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.setSuggestIndex("$.name"); query.setSuggestIndex("$.name");
...@@ -2017,7 +2016,7 @@ deviceId(deviceId:string):Query ...@@ -2017,7 +2016,7 @@ deviceId(deviceId:string):Query
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
query.deviceId("deviceId"); query.deviceId("deviceId");
...@@ -2044,7 +2043,7 @@ getSqlLike():string ...@@ -2044,7 +2043,7 @@ getSqlLike():string
**示例** **示例**
``` ```js
try { try {
let query = new distributedData.Query(); let query = new distributedData.Query();
let sql1 = query.getSqlLike(); let sql1 = query.getSqlLike();
...@@ -2079,7 +2078,7 @@ put(key: string, value: Uint8Array | string | number | boolean, callback: AsyncC ...@@ -2079,7 +2078,7 @@ put(key: string, value: Uint8Array | string | number | boolean, callback: AsyncC
**示例** **示例**
``` ```js
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';
...@@ -2120,7 +2119,7 @@ put(key: string, value: Uint8Array | string | number | boolean): Promise&lt;void ...@@ -2120,7 +2119,7 @@ put(key: string, value: Uint8Array | string | number | boolean): Promise&lt;void
**示例** **示例**
``` ```js
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';
...@@ -2153,7 +2152,7 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -2153,7 +2152,7 @@ delete(key: string, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
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';
...@@ -2200,7 +2199,7 @@ delete(key: string): Promise&lt;void&gt; ...@@ -2200,7 +2199,7 @@ delete(key: string): Promise&lt;void&gt;
**示例** **示例**
``` ```js
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';
...@@ -2233,13 +2232,13 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific ...@@ -2233,13 +2232,13 @@ on(event: 'dataChange', type: SubscribeType, observer: Callback&lt;ChangeNotific
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| event |'dataChange' | 是 |回调函数名称。 | | event |'dataChange' | 是 |回调函数名称。<br/>'dataChange'表示数据变更事件。 |
| type |[SubscribeType](#subscribetype) | 是 |表示订阅的类型。 | | type |[SubscribeType](#subscribetype) | 是 |表示订阅的类型。 |
| observer |Callback&lt;[ChangeNotification](#changenotification)&gt; | 是 |回调函数。 | | observer |Callback&lt;[ChangeNotification](#changenotification)&gt; | 是 |回调函数。 |
**示例** **示例**
``` ```js
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));
...@@ -2259,7 +2258,7 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt ...@@ -2259,7 +2258,7 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| event |'syncComplete' | 是 |回调函数名称。 | | event |'syncComplete' | 是 |回调函数名称。<br>'syncComplete'表示同步完成事件。 |
| syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 是 |回调函数。 | | syncCallback |Callback&lt;Array&lt;[string, number]&gt;&gt; | 是 |回调函数。 |
**示例** **示例**
...@@ -2283,12 +2282,12 @@ off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void ...@@ -2283,12 +2282,12 @@ off(event:'dataChange', observer?: Callback&lt;ChangeNotification&gt;): void
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----------------------- | | ----- | ------ | ---- | ----------------------- |
| event |'dataChange' | 是 |回调函数名称。 | | event |'dataChange' | 是 |回调函数名称。<br/>'dataChange'表示数据变更事件。 |
| observer |Callback&lt;[ChangeNotification](#changenotification)&gt; |否 |回调函数。 | | observer |Callback&lt;[ChangeNotification](#changenotification)&gt; |否 |回调函数。 |
**示例** **示例**
``` ```js
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);
...@@ -2303,7 +2302,7 @@ kvStore.off('dataChange', function (data) { ...@@ -2303,7 +2302,7 @@ kvStore.off('dataChange', function (data) {
putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void
批量插入键值对到KvStore数据库中，并通过callback方式返回，此方法为异步方法。 批量插入键值对到KVStore数据库中，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2316,7 +2315,7 @@ putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void ...@@ -2316,7 +2315,7 @@ putBatch(entries: Entry[], callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -2350,7 +2349,7 @@ try { ...@@ -2350,7 +2349,7 @@ try {
putBatch(entries: Entry[]): Promise&lt;void&gt; putBatch(entries: Entry[]): Promise&lt;void&gt;
批量插入键值对到KvStore数据库中，并通过Promise方式返回，此方法为异步方法。 批量插入键值对到KVStore数据库中，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2368,7 +2367,7 @@ putBatch(entries: Entry[]): Promise&lt;void&gt; ...@@ -2368,7 +2367,7 @@ putBatch(entries: Entry[]): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -2405,7 +2404,7 @@ try { ...@@ -2405,7 +2404,7 @@ try {
deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void
批量删除KvStore数据库中的键值对，并通过callback方式返回，此方法为异步方法。 批量删除KVStore数据库中的键值对，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2418,7 +2417,7 @@ deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void ...@@ -2418,7 +2417,7 @@ deleteBatch(keys: string[], callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -2452,7 +2451,7 @@ try { ...@@ -2452,7 +2451,7 @@ try {
deleteBatch(keys: string[]): Promise&lt;void&gt; deleteBatch(keys: string[]): Promise&lt;void&gt;
批量删除键值对到KvStore数据库中，并通过Promise方式返回，此方法为异步方法。 批量删除KVStore数据库中的键值对，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2470,7 +2469,7 @@ deleteBatch(keys: string[]): Promise&lt;void&gt; ...@@ -2470,7 +2469,7 @@ deleteBatch(keys: string[]): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -2508,7 +2507,7 @@ try { ...@@ -2508,7 +2507,7 @@ try {
startTransaction(callback: AsyncCallback&lt;void&gt;): void startTransaction(callback: AsyncCallback&lt;void&gt;): void
启动KvStore数据库中的事务，并通过callback方式返回，此方法为异步方法。 启动KVStore数据库中的事务，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2520,7 +2519,7 @@ startTransaction(callback: AsyncCallback&lt;void&gt;): void ...@@ -2520,7 +2519,7 @@ startTransaction(callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
function putBatchString(len, prefix) { function putBatchString(len, prefix) {
let entries = []; let entries = [];
...@@ -2560,7 +2559,7 @@ try { ...@@ -2560,7 +2559,7 @@ try {
startTransaction(): Promise&lt;void&gt; startTransaction(): Promise&lt;void&gt;
启动KvStore数据库中的事务，并通过Promise方式返回，此方法为异步方法。 启动KVStore数据库中的事务，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2572,7 +2571,7 @@ startTransaction(): Promise&lt;void&gt; ...@@ -2572,7 +2571,7 @@ startTransaction(): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
var count = 0; var count = 0;
...@@ -2595,7 +2594,7 @@ try { ...@@ -2595,7 +2594,7 @@ try {
commit(callback: AsyncCallback&lt;void&gt;): void commit(callback: AsyncCallback&lt;void&gt;): void
提交KvStore数据库中的事务，并通过callback方式返回，此方法为异步方法。 提交KVStore数据库中的事务，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2607,7 +2606,7 @@ commit(callback: AsyncCallback&lt;void&gt;): void ...@@ -2607,7 +2606,7 @@ commit(callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.commit(function (err,data) { kvStore.commit(function (err,data) {
...@@ -2627,7 +2626,7 @@ try { ...@@ -2627,7 +2626,7 @@ try {
commit(): Promise&lt;void&gt; commit(): Promise&lt;void&gt;
提交KvStore数据库中的事务，并通过Promise方式返回，此方法为异步方法。 提交KVStore数据库中的事务，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2639,7 +2638,7 @@ commit(): Promise&lt;void&gt; ...@@ -2639,7 +2638,7 @@ commit(): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.commit().then(async (err) => { kvStore.commit().then(async (err) => {
...@@ -2657,7 +2656,7 @@ try { ...@@ -2657,7 +2656,7 @@ try {
rollback(callback: AsyncCallback&lt;void&gt;): void rollback(callback: AsyncCallback&lt;void&gt;): void
在KvStore数据库中回滚事务，并通过callback方式返回，此方法为异步方法。 在KVStore数据库中回滚事务，并通过callback方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2669,7 +2668,7 @@ rollback(callback: AsyncCallback&lt;void&gt;): void ...@@ -2669,7 +2668,7 @@ rollback(callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.rollback(function (err,data) { kvStore.rollback(function (err,data) {
...@@ -2689,7 +2688,7 @@ try { ...@@ -2689,7 +2688,7 @@ try {
rollback(): Promise&lt;void&gt; rollback(): Promise&lt;void&gt;
在KvStore数据库中回滚事务，并通过Promise方式返回，此方法为异步方法。 在KVStore数据库中回滚事务，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2701,7 +2700,7 @@ rollback(): Promise&lt;void&gt; ...@@ -2701,7 +2700,7 @@ rollback(): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.rollback().then(async (err) => { kvStore.rollback().then(async (err) => {
...@@ -2732,7 +2731,7 @@ enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void ...@@ -2732,7 +2731,7 @@ enableSync(enabled: boolean, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.enableSync(true, function (err,data) { kvStore.enableSync(true, function (err,data) {
...@@ -2770,7 +2769,7 @@ enableSync(enabled: boolean): Promise&lt;void&gt; ...@@ -2770,7 +2769,7 @@ enableSync(enabled: boolean): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.enableSync(true).then((err) => { kvStore.enableSync(true).then((err) => {
...@@ -2802,7 +2801,7 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: Asy ...@@ -2802,7 +2801,7 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: Asy
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
const localLabels = ['A', 'B']; const localLabels = ['A', 'B'];
...@@ -2840,7 +2839,7 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v ...@@ -2840,7 +2839,7 @@ setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise&lt;v
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
const localLabels = ['A', 'B']; const localLabels = ['A', 'B'];
...@@ -2902,7 +2901,7 @@ try { ...@@ -2902,7 +2901,7 @@ try {
| 名称 | 参数类型 |可读 |可写 | 说明 | | 名称 | 参数类型 |可读 |可写 | 说明 |
| ----- | ------- | -----| ------|------------------------ | | ----- | ------- | -----| ------|------------------------ |
| type | [ValueType](#value) | 是 | 是 |值类型。 | | type | [ValueType](#value) | 是 | 是 |值类型。 |
| value | Uint8Array / string / number / boolean| 是 | 是 |值对象。 | | value | Uint8Array \| string \| number \| boolean| 是 | 是 |值对象。 |
## ValueType ## ValueType
...@@ -2923,7 +2922,7 @@ try { ...@@ -2923,7 +2922,7 @@ try {
## SingleKVStore ## SingleKVStore
单版本分布式数据库，继承自KVStore，提供查询数据和同步数据的方法。在调用 SingleKVStore 的方法前，需要先通过 getKVStore 构建一个 SingleKVStore 实例。 单版本分布式数据库，继承自KVStore，提供查询数据和同步数据的方法。在调用 SingleKVStore 的方法前，需要先通过 [getKVStore](#getkvstore) 构建一个 SingleKVStore 实例。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -2944,7 +2943,7 @@ get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | numb ...@@ -2944,7 +2943,7 @@ get(key: string, callback: AsyncCallback&lt;Uint8Array | string | boolean | numb
**示例** **示例**
``` ```js
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';
...@@ -2988,7 +2987,7 @@ get(key: string): Promise&lt;Uint8Array | string | boolean | number&gt; ...@@ -2988,7 +2987,7 @@ get(key: string): Promise&lt;Uint8Array | string | boolean | number&gt;
**示例** **示例**
``` ```js
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';
...@@ -3025,7 +3024,7 @@ getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void ...@@ -3025,7 +3024,7 @@ getEntries(keyPrefix: string, callback: AsyncCallback&lt;Entry[]&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -3076,7 +3075,7 @@ getEntries(keyPrefix: string): Promise&lt;Entry[]&gt; ...@@ -3076,7 +3075,7 @@ getEntries(keyPrefix: string): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -3129,7 +3128,7 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void ...@@ -3129,7 +3128,7 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
...@@ -3185,7 +3184,7 @@ getEntries(query: Query): Promise&lt;Entry[]&gt; ...@@ -3185,7 +3184,7 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```js
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
let entries = []; let entries = [];
...@@ -3237,7 +3236,7 @@ getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;) ...@@ -3237,7 +3236,7 @@ getResultSet(keyPrefix: string, callback: AsyncCallback&lt;KvStoreResultSet&gt;)
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -3273,7 +3272,7 @@ try { ...@@ -3273,7 +3272,7 @@ try {
getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt; getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt;
从 KvStore 数据库中获取具有指定前缀的结果集，并通过Promise方式返回，此方法为异步方法。 从 KVStore 数据库中获取具有指定前缀的结果集，并通过Promise方式返回，此方法为异步方法。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -3291,7 +3290,7 @@ getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt; ...@@ -3291,7 +3290,7 @@ getResultSet(keyPrefix: string): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -3346,7 +3345,7 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi ...@@ -3346,7 +3345,7 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -3399,7 +3398,7 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt; ...@@ -3399,7 +3398,7 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -3450,7 +3449,7 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;) ...@@ -3450,7 +3449,7 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;)
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet = null; let resultSet = null;
...@@ -3489,7 +3488,7 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt; ...@@ -3489,7 +3488,7 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet = null; let resultSet = null;
...@@ -3521,7 +3520,7 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void ...@@ -3521,7 +3520,7 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -3572,7 +3571,7 @@ getResultSize(query: Query): Promise&lt;number&gt; ...@@ -3572,7 +3571,7 @@ getResultSize(query: Query): Promise&lt;number&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -3622,7 +3621,7 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -3622,7 +3621,7 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
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';
...@@ -3669,7 +3668,7 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt; ...@@ -3669,7 +3668,7 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;
**示例** **示例**
``` ```js
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';
...@@ -3749,7 +3748,7 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]& ...@@ -3749,7 +3748,7 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]&
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
const func = function (data) { const func = function (data) {
...@@ -3768,6 +3767,7 @@ try { ...@@ -3768,6 +3767,7 @@ try {
sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
在手动模式下，触发数据库同步，此方法为同步方法。 在手动模式下，触发数据库同步，此方法为同步方法。
**需要权限**： ohos.permission.DISTRIBUTED_DATASYNC。 **需要权限**： ohos.permission.DISTRIBUTED_DATASYNC。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -3782,7 +3782,7 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void ...@@ -3782,7 +3782,7 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
**示例**： **示例**：
``` ```js
let kvStore; let kvStore;
kvStore.sync('deviceIds', distributedData.SyncMode.PULL_ONLY, 1000); kvStore.sync('deviceIds', distributedData.SyncMode.PULL_ONLY, 1000);
``` ```
...@@ -3804,7 +3804,7 @@ setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;) ...@@ -3804,7 +3804,7 @@ setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback&lt;void&gt;)
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
const defaultAllowedDelayMs = 500; const defaultAllowedDelayMs = 500;
...@@ -3840,7 +3840,7 @@ setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt; ...@@ -3840,7 +3840,7 @@ setSyncParam(defaultAllowedDelayMs: number): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
const defaultAllowedDelayMs = 500; const defaultAllowedDelayMs = 500;
...@@ -3871,7 +3871,7 @@ getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void ...@@ -3871,7 +3871,7 @@ getSecurityLevel(callback: AsyncCallback&lt;SecurityLevel&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.getSecurityLevel(function (err,data) { kvStore.getSecurityLevel(function (err,data) {
...@@ -3899,7 +3899,7 @@ getSecurityLevel(): Promise&lt;SecurityLevel&gt; ...@@ -3899,7 +3899,7 @@ getSecurityLevel(): Promise&lt;SecurityLevel&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
kvStore.getSecurityLevel().then((data) => { kvStore.getSecurityLevel().then((data) => {
...@@ -3915,7 +3915,7 @@ try { ...@@ -3915,7 +3915,7 @@ try {
## DeviceKVStore<sup>8+</sup> ## ## DeviceKVStore<sup>8+</sup> ##
在分布式系统中按设备管理分布式数据，继承自KvStore，提供查询数据和同步数据的方法。在调用DeviceKVStore的方法前，需要先通过getKVStore构建一个DeviceKVStore实例。 在分布式系统中按设备管理分布式数据，继承自KVStore，提供查询数据和同步数据的方法。在调用DeviceKVStore的方法前，需要先通过[getKVStore](#getkvstore)构建一个DeviceKVStore实例。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.DistributedKVStore。
...@@ -3937,7 +3937,7 @@ get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|num ...@@ -3937,7 +3937,7 @@ get(deviceId: string, key: string, callback: AsyncCallback&lt;boolean|string|num
**示例** **示例**
``` ```js
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';
...@@ -3977,7 +3977,7 @@ get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array& ...@@ -3977,7 +3977,7 @@ get(deviceId: string, key: string): Promise&lt;boolean|string|number|Uint8Array&
**示例** **示例**
``` ```js
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';
...@@ -4016,7 +4016,7 @@ getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry ...@@ -4016,7 +4016,7 @@ getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;Entry
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -4069,7 +4069,7 @@ getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt; ...@@ -4069,7 +4069,7 @@ getEntries(deviceId: string, keyPrefix: string): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -4122,7 +4122,7 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void ...@@ -4122,7 +4122,7 @@ getEntries(query: Query, callback: AsyncCallback&lt;Entry[]&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
...@@ -4180,7 +4180,7 @@ getEntries(query: Query): Promise&lt;Entry[]&gt; ...@@ -4180,7 +4180,7 @@ getEntries(query: Query): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
...@@ -4234,7 +4234,7 @@ getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt ...@@ -4234,7 +4234,7 @@ getEntries(deviceId: string, query: Query, callback: AsyncCallback&lt;Entry[]&gt
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
...@@ -4293,7 +4293,7 @@ getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt; ...@@ -4293,7 +4293,7 @@ getEntries(deviceId: string, query: Query): Promise&lt;Entry[]&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
var arr = new Uint8Array([21,31]); var arr = new Uint8Array([21,31]);
...@@ -4348,7 +4348,7 @@ getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvS ...@@ -4348,7 +4348,7 @@ getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback&lt;KvS
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -4388,7 +4388,7 @@ getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&g ...@@ -4388,7 +4388,7 @@ getResultSet(deviceId: string, keyPrefix: string): Promise&lt;KvStoreResultSet&g
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -4426,7 +4426,7 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi ...@@ -4426,7 +4426,7 @@ getResultSet(query: Query, callback: AsyncCallback&lt;KvStoreResultSet&gt;): voi
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -4483,7 +4483,7 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt; ...@@ -4483,7 +4483,7 @@ getResultSet(query: Query): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -4543,7 +4543,7 @@ getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreR ...@@ -4543,7 +4543,7 @@ getResultSet(deviceId: string, query: Query, callback: AsyncCallback&lt;KvStoreR
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -4600,7 +4600,7 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt; ...@@ -4600,7 +4600,7 @@ getResultSet(deviceId: string, query: Query): Promise&lt;KvStoreResultSet&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let resultSet; let resultSet;
...@@ -4660,7 +4660,7 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;) ...@@ -4660,7 +4660,7 @@ closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback&lt;void&gt;)
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
console.log('CloseResultSet success'); console.log('CloseResultSet success');
...@@ -4700,7 +4700,7 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt; ...@@ -4700,7 +4700,7 @@ closeResultSet(resultSet: KvStoreResultSet): Promise&lt;void&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
console.log('CloseResultSet success'); console.log('CloseResultSet success');
...@@ -4733,7 +4733,7 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void ...@@ -4733,7 +4733,7 @@ getResultSize(query: Query, callback: AsyncCallback&lt;number&gt;): void
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -4785,7 +4785,7 @@ getResultSize(query: Query): Promise&lt;number&gt; ...@@ -4785,7 +4785,7 @@ getResultSize(query: Query): Promise&lt;number&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -4837,7 +4837,7 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number& ...@@ -4837,7 +4837,7 @@ getResultSize(deviceId: string, query: Query, callback: AsyncCallback&lt;number&
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -4889,7 +4889,7 @@ getResultSize(deviceId: string, query: Query): Promise&lt;number&gt; ...@@ -4889,7 +4889,7 @@ getResultSize(deviceId: string, query: Query): Promise&lt;number&gt;
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
let entries = []; let entries = [];
...@@ -4939,7 +4939,7 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -4939,7 +4939,7 @@ removeDeviceData(deviceId: string, callback: AsyncCallback&lt;void&gt;): void
**示例** **示例**
``` ```js
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';
...@@ -4986,7 +4986,7 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt; ...@@ -4986,7 +4986,7 @@ removeDeviceData(deviceId: string): Promise&lt;void&gt;
**示例** **示例**
``` ```js
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';
...@@ -5018,6 +5018,7 @@ try { ...@@ -5018,6 +5018,7 @@ try {
sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
在手动模式下，触发数据库同步，此方法为同步方法。 在手动模式下，触发数据库同步，此方法为同步方法。
**需要权限**： ohos.permission.DISTRIBUTED_DATASYNC。 **需要权限**： ohos.permission.DISTRIBUTED_DATASYNC。
**系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。 **系统能力**： SystemCapability.DistributedDataManager.KVStore.Core。
...@@ -5032,7 +5033,7 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void ...@@ -5032,7 +5033,7 @@ sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
**示例** **示例**
``` ```js
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';
...@@ -5068,7 +5069,7 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt ...@@ -5068,7 +5069,7 @@ on(event: 'syncComplete', syncCallback: Callback&lt;Array&lt;[string, number]&gt
**示例** **示例**
``` ```js
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 {
...@@ -5103,7 +5104,7 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]& ...@@ -5103,7 +5104,7 @@ off(event: 'syncComplete', syncCallback?: Callback&lt;Array&lt;[string, number]&
**示例** **示例**
``` ```js
let kvStore; let kvStore;
try { try {
const func = function (data) { const func = function (data) {
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或