Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
提交 d0aee04f 编写于 作者: S songruirui
浏览文件
操作

代码检视意见修改 

Signed-off-by: Nsongruirui <songruirui1@huawei.com>
上级 c1dbd75a
隐藏空白更改
内联 并排
Showing with 72 addition and 149 deletion
zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md
浏览文件 @ d0aee04f
# DataShareExtensionAbility # DataShareExtensionAbility
**DataShareExtensionAbility** 是基于元能力提供的ExtensionAbility框架，提供支持数据共享业务的能力。 **DataShareExtensionAbility**基于ExtensionAbility框架，提供支持数据共享业务的能力。
>**说明：** >**说明：**
> >
>本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。仅限系统应用。 >本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。仅限系统应用。
>以下接口全部为系统接口，三方应用不支持调用。
## 导入模块 ## 导入模块
...@@ -17,13 +18,9 @@ import DataShareExtensionAbility from '@ohos.application.DataShareExtensionAbili ...@@ -17,13 +18,9 @@ import DataShareExtensionAbility from '@ohos.application.DataShareExtensionAbili
onCreate?(want: Want, callback: AsyncCallback&lt;void&gt;): void onCreate?(want: Want, callback: AsyncCallback&lt;void&gt;): void
DataShareExtAbility生命周期回调，在创建时回调，执行初始化业务逻辑操作。 DataShare客户端连接DataShareExtensionAbility服务端时，服务端回调此接口，执行初始化业务逻辑操作。该方法可以选择性重写。
此接口为可选的。可以被重写，也可以不进行重写。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
...@@ -43,9 +40,7 @@ let DDL_TBL_CREATE = "CREATE TABLE IF NOT EXISTS " ...@@ -43,9 +40,7 @@ let DDL_TBL_CREATE = "CREATE TABLE IF NOT EXISTS "
+ TBL_NAME + TBL_NAME
+ " (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER, phoneNumber DOUBLE, isStudent BOOLEAN, Binary BINARY)"; + " (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER, phoneNumber DOUBLE, isStudent BOOLEAN, Binary BINARY)";
// All of the input parameters are passed from the native side
onCreate(want, callback) { onCreate(want, callback) {
// Specific functions need to be implemented by the user
console.log('DataShareExtAbility onCreate, want:' + want.abilityName); console.log('DataShareExtAbility onCreate, want:' + want.abilityName);
console.log('DataShareExtAbility onCreate, this.context:' + this.context); console.log('DataShareExtAbility onCreate, this.context:' + this.context);
rdb.getRdbStore(this.context, { rdb.getRdbStore(this.context, {
...@@ -66,11 +61,7 @@ onCreate(want, callback) { ...@@ -66,11 +61,7 @@ onCreate(want, callback) {
insert?(uri: string, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void insert?(uri: string, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void
insert生命周期回调，在数据库插入时回调。 在数据库插入时回调此接口，该方法可以选择性重写。
此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
...@@ -87,12 +78,9 @@ insert生命周期回调，在数据库插入时回调。 ...@@ -87,12 +78,9 @@ insert生命周期回调，在数据库插入时回调。
```ts ```ts
import rdb from '@ohos.data.rdb'; import rdb from '@ohos.data.rdb';
let TBL_NAME = "TBL00"; let TBL_NAME = "TBL00";
// Refer to the onCreate for the method of obtaining rdbStore
let rdbStore; let rdbStore;
// All of the input parameters are passed from the native side
insert(uri, value, callback) { insert(uri, value, callback) {
// Specific functions need to be implemented by the user
if (value == null) { if (value == null) {
console.info('invalid valueBuckets'); console.info('invalid valueBuckets');
return; return;
...@@ -110,11 +98,7 @@ insert(uri, value, callback) { ...@@ -110,11 +98,7 @@ insert(uri, value, callback) {
update?(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void update?(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void
update生命周期回调，在数据库更新时回调。 在数据库更新时服务端回调此接口，该方法可以选择性重写。
此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
...@@ -132,12 +116,9 @@ update生命周期回调，在数据库更新时回调。 ...@@ -132,12 +116,9 @@ update生命周期回调，在数据库更新时回调。
```ts ```ts
import rdb from '@ohos.data.rdb'; import rdb from '@ohos.data.rdb';
let TBL_NAME = "TBL00"; let TBL_NAME = "TBL00";
// Refer to the onCreate for the method of obtaining rdbStore
let rdbStore; let rdbStore;
// All of the input parameters are passed from the native side
update(uri, predicates, value, callback) { update(uri, predicates, value, callback) {
// Specific functions need to be implemented by the user
if (predicates == null || predicates == undefined) { if (predicates == null || predicates == undefined) {
return; return;
} }
...@@ -153,12 +134,10 @@ update(uri, predicates, value, callback) { ...@@ -153,12 +134,10 @@ update(uri, predicates, value, callback) {
query?(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;Object&gt;): void query?(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;Object&gt;): void
query生命周期回调，在数据库查询时回调。 在查询数据库时服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
...@@ -175,12 +154,9 @@ query生命周期回调，在数据库查询时回调。 ...@@ -175,12 +154,9 @@ query生命周期回调，在数据库查询时回调。
```ts ```ts
import rdb from '@ohos.data.rdb'; import rdb from '@ohos.data.rdb';
let TBL_NAME = "TBL00"; let TBL_NAME = "TBL00";
// Refer to the onCreate for the method of obtaining rdbStore
let rdbStore; let rdbStore;
// All of the input parameters are passed from the native side
query(uri, predicates, columns, callback) { query(uri, predicates, columns, callback) {
// Specific functions need to be implemented by the user
if (predicates == null || predicates == undefined) { if (predicates == null || predicates == undefined) {
return; return;
} }
...@@ -199,19 +175,17 @@ query(uri, predicates, columns, callback) { ...@@ -199,19 +175,17 @@ query(uri, predicates, columns, callback) {
delete?(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt;number&gt;): void delete?(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt;number&gt;): void
delete生命周期回调，在删除数据库记录时回调。 在删除数据库记录时服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------ |
| uri | string | 是 | 指示要查询的数据的路径。 | | uri | string | 是 | 指示要删除的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | | predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 表示被指定的回调方法。 | | callback | AsyncCallback&lt;number&gt; | 是 | 表示被指定的回调方法。 |
...@@ -220,12 +194,9 @@ delete生命周期回调，在删除数据库记录时回调。 ...@@ -220,12 +194,9 @@ delete生命周期回调，在删除数据库记录时回调。
```ts ```ts
import rdb from '@ohos.data.rdb'; import rdb from '@ohos.data.rdb';
let TBL_NAME = "TBL00"; let TBL_NAME = "TBL00";
// Refer to the onCreate for the method of obtaining rdbStore
let rdbStore; let rdbStore;
// All of the input parameters are passed from the native side
delete(uri, predicates, callback) { delete(uri, predicates, callback) {
// Specific functions need to be implemented by the user
if (predicates == null || predicates == undefined) { if (predicates == null || predicates == undefined) {
return; return;
} }
...@@ -237,16 +208,14 @@ delete(uri, predicates, callback) { ...@@ -237,16 +208,14 @@ delete(uri, predicates, callback) {
} }
``` ```
## batchInsert ## BatchInsert
batchInsert?(uri: string, valueBuckets: Array&lt;ValuesBucket&gt;, callback: AsyncCallback&lt;number&gt;): void BatchInsert?(uri: string, valueBuckets: Array&lt;ValuesBucket&gt;, callback: AsyncCallback&lt;number&gt;): void
batchinsert生命周期回调，在数据库批量插入时回调。 在数据库批量插入时服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
...@@ -254,7 +223,7 @@ batchinsert生命周期回调，在数据库批量插入时回调。 ...@@ -254,7 +223,7 @@ batchinsert生命周期回调，在数据库批量插入时回调。
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------ | ------------------------------------------------------------ | ---- | ------------------------ | | ------------ | ------------------------------------------------------------ | ---- | ------------------------ |
| uri | string | 是 | 指示要插入的数据的路径。 | | uri | string | 是 | 指示要插入的数据的路径。 |
| valueBuckets | Array&lt;[ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket)&gt; | 是 | 指示要插入的数据记录。 | | valueBuckets | Array&lt;[ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket)&gt; | 是 | 指示要批量插入的数据记录。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 表示被指定的回调方法。 | | callback | AsyncCallback&lt;number&gt; | 是 | 表示被指定的回调方法。 |
**示例：** **示例：**
...@@ -262,12 +231,9 @@ batchinsert生命周期回调，在数据库批量插入时回调。 ...@@ -262,12 +231,9 @@ batchinsert生命周期回调，在数据库批量插入时回调。
```ts ```ts
import rdb from '@ohos.data.rdb'; import rdb from '@ohos.data.rdb';
let TBL_NAME = "TBL00"; let TBL_NAME = "TBL00";
// Refer to the onCreate for the method of obtaining rdbStore
let rdbStore; let rdbStore;
// All of the input parameters are passed from the native side
batchInsert(uri: string, valueBuckets, callback) { batchInsert(uri: string, valueBuckets, callback) {
// Specific functions need to be implemented by the user
if (valueBuckets == null || valueBuckets.length == undefined) { if (valueBuckets == null || valueBuckets.length == undefined) {
console.info('invalid valueBuckets'); console.info('invalid valueBuckets');
return; return;
...@@ -287,27 +253,23 @@ batchInsert(uri: string, valueBuckets, callback) { ...@@ -287,27 +253,23 @@ batchInsert(uri: string, valueBuckets, callback) {
getType?(uri: string, callback: AsyncCallback&lt;string&gt;): void getType?(uri: string, callback: AsyncCallback&lt;string&gt;): void
getType生命周期回调函数，获取给定URI对应的MIME类型时回调。 获取给定uri对应的MIME类型时服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ------ | ------ | | ----- | ------ | ------ | ------ |
| uri | string | 是 | 指示要操作的数据的路径。 | | uri | string | 是 | 指示要获取MIME类型的数据的路径。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 表示被指定的回调方法。 | | callback | AsyncCallback&lt;string&gt; | 是 | 表示被指定的回调方法。 |
**示例：** **示例：**
```ts ```ts
// All of the input parameters are passed from the native side
getType(uri: string, callback) { getType(uri: string, callback) {
// Specific functions need to be implemented by the user
let err; let err;
let ret = "image"; let ret = "image";
callback(err, ret); callback(err, ret);
...@@ -318,12 +280,10 @@ getType(uri: string, callback) { ...@@ -318,12 +280,10 @@ getType(uri: string, callback) {
getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;): void getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;): void
getFileTypes生命周期回调，获取支持文件的MIME类型时回调。 获取支持文件的MIME类型时服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
...@@ -337,9 +297,7 @@ getFileTypes生命周期回调，获取支持文件的MIME类型时回调。 ...@@ -337,9 +297,7 @@ getFileTypes生命周期回调，获取支持文件的MIME类型时回调。
**示例：** **示例：**
```ts ```ts
// All of the input parameters are passed from the native side
getFileTypes(uri: string, mimeTypeFilter: string,callback) { getFileTypes(uri: string, mimeTypeFilter: string,callback) {
// Specific functions need to be implemented by the user
let err; let err;
let ret = new Array("type01", "type02", "type03"); let ret = new Array("type01", "type02", "type03");
callback(err, ret); callback(err, ret);
...@@ -350,27 +308,23 @@ getFileTypes(uri: string, mimeTypeFilter: string,callback) { ...@@ -350,27 +308,23 @@ getFileTypes(uri: string, mimeTypeFilter: string,callback) {
normalizeUri?(uri: string, callback: AsyncCallback&lt;string&gt;): void normalizeUri?(uri: string, callback: AsyncCallback&lt;string&gt;): void
normalizeUri生命周期回调，给定uri转换为规范化uri时回调。 用户给定Uri转换为服务端使用的Uri时进行回调服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------- | ---- | ----------------------- | | -------- | --------------------- | ---- | ----------------------- |
| uri | string | 是 | 指示要规范化的uri对象。 | | uri | string | 是 | 指示用户传入的uri。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 表示被指定的回调方法。 | | callback | AsyncCallback&lt;string&gt; | 是 | 表示被指定的回调方法。 |
**示例：** **示例：**
```ts ```ts
// All of the input parameters are passed from the native side
normalizeUri(uri: string, callback) { normalizeUri(uri: string, callback) {
// Specific functions need to be implemented by the user
let err; let err;
let ret = "normalize+" + uri; let ret = "normalize+" + uri;
callback(err, ret); callback(err, ret);
...@@ -381,27 +335,23 @@ normalizeUri(uri: string, callback) { ...@@ -381,27 +335,23 @@ normalizeUri(uri: string, callback) {
denormalizeUri?(uri: string, callback: AsyncCallback&lt;string&gt;): void denormalizeUri?(uri: string, callback: AsyncCallback&lt;string&gt;): void
将由denormalizeUri生命周期回调，给定规范化uri转换为非规范化uri时回调。 服务端使用的Uri转换为用户传入的初始Uri时服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
**参数：** **参数：**
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------- | ---- | ----------------------- | | -------- | --------------------- | ---- | ----------------------- |
| uri | string | 是 | 指示要规范化的uri对象。 | | uri | string | 是 | 指示服务端使用的uri。 |
| callback | AsyncCallback&lt;string&gt; | 是 | 表示被指定的回调方法。 | | callback | AsyncCallback&lt;string&gt; | 是 | 表示被指定的回调方法。 |
**示例：** **示例：**
```ts ```ts
// All of the input parameters are passed from the native side
denormalizeUri(uri: string, callback) { denormalizeUri(uri: string, callback) {
// Specific functions need to be implemented by the user
let err; let err;
let ret = "denormalize+" + uri; let ret = "denormalize+" + uri;
callback(err, ret); callback(err, ret);
...@@ -412,11 +362,10 @@ denormalizeUri(uri: string, callback) { ...@@ -412,11 +362,10 @@ denormalizeUri(uri: string, callback) {
openFile?(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;): void openFile?(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;): void
将由openFile生命周期回调，在打开文件时回调。 在打开文件时服务端回调此接口。
此接口为可选的。可以被重写，也可以不进行重写。 此接口为可选的。可以被重写，也可以不进行重写。
此接口为系统接口，三方应用不支持调用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Provider。
...@@ -431,9 +380,7 @@ openFile?(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;): voi ...@@ -431,9 +380,7 @@ openFile?(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;): voi
**示例：** **示例：**
```ts ```ts
// All of the input parameters are passed from the native side
openFile(uri: string, mode, callback) { openFile(uri: string, mode, callback) {
// Specific functions need to be implemented by the user
let err; let err;
let fd = 0; let fd = 0;
callback(err,fd); callback(err,fd);
......
zh-cn/application-dev/reference/apis/js-apis-data-DataShareResultSet.md
浏览文件 @ d0aee04f
# DataShareResultSet # DataShareResultSet
**结果集(DataShareResultSet)** 是为了提供通过查询数据库生成的结果集的访问方法，可以根据提供的行数，查询相应的值，也可以查询指定数据类型的值。 **结果集(DataShareResultSet)**可提供访问由查询数据库生成的结果集的相关方法，根据提供的行数，查询相应的值，也可查询指定数据类型的值。
>**说明：** >**说明：**
> >
...@@ -31,7 +31,7 @@ await dataShare.createDataShareHelper(this.context, uri, (err, data) => { ...@@ -31,7 +31,7 @@ await dataShare.createDataShareHelper(this.context, uri, (err, data) => {
} }
}); });
let columns = ["*"]； let columns = ["*"];
let da = new dataShare.DataSharePredicates(); let da = new dataShare.DataSharePredicates();
let resultSet; let resultSet;
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
...@@ -45,20 +45,22 @@ dataShareHelper.query(uri, da, columns).then((data) => { ...@@ -45,20 +45,22 @@ dataShareHelper.query(uri, da, columns).then((data) => {
## 属性 ## 属性
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ----------- | ------------- | ---- | ------------------------ | | ----------- | ------------- | ---- | ------------------------ |
| columnNames | Array&lt;string&gt; | 是 | 结果集中所有列的名称。 | | columnNames | Array&lt;string&gt; | 是 | 结果集中所有列的名称。 |
| columnCount | number | 是 | 结果集中的列数。 | | columnCount | number | 是 | 结果集中的列数。 |
| rowCount | number | 是 | 结果集中的行数。 | | rowCount | number | 是 | 结果集中的行数。 |
| isClosed | boolean | 是 | 标志当前结果集是否关闭。 | | isClosed | boolean | 是 | 标识当前结果集是否关闭。 |
## goToFirstRow ## goToFirstRow
goToFirstRow(): boolean goToFirstRow(): boolean
该接口用于转到结果集的第一行。 转到结果集的第一行。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**返回值：** **返回值：**
...@@ -69,8 +71,6 @@ goToFirstRow(): boolean ...@@ -69,8 +71,6 @@ goToFirstRow(): boolean
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let isGoTOFirstRow = resultSet.goToFirstRow(); let isGoTOFirstRow = resultSet.goToFirstRow();
console.info('resultSet.goToFirstRow: ' + isGoTOFirstRow); console.info('resultSet.goToFirstRow: ' + isGoTOFirstRow);
``` ```
...@@ -79,9 +79,9 @@ console.info('resultSet.goToFirstRow: ' + isGoTOFirstRow); ...@@ -79,9 +79,9 @@ console.info('resultSet.goToFirstRow: ' + isGoTOFirstRow);
goToLastRow(): boolean goToLastRow(): boolean
该接口用于转到结果集的最后一行。 转到结果集的最后一行。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**返回值：** **返回值：**
...@@ -92,8 +92,6 @@ goToLastRow(): boolean ...@@ -92,8 +92,6 @@ goToLastRow(): boolean
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let isGoToLastRow = resultSet.goToLastRow(); let isGoToLastRow = resultSet.goToLastRow();
console.info('resultSet.goToLastRow: ' + isGoToLastRow); console.info('resultSet.goToLastRow: ' + isGoToLastRow);
``` ```
...@@ -102,9 +100,9 @@ console.info('resultSet.goToLastRow: ' + isGoToLastRow); ...@@ -102,9 +100,9 @@ console.info('resultSet.goToLastRow: ' + isGoToLastRow);
goToNextRow(): boolean goToNextRow(): boolean
该接口用于转到结果集的下一行。 转到结果集的下一行。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**返回值：** **返回值：**
...@@ -115,8 +113,6 @@ goToNextRow(): boolean ...@@ -115,8 +113,6 @@ goToNextRow(): boolean
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let isGoToNextRow = resultSet.goToNextRow(); let isGoToNextRow = resultSet.goToNextRow();
console.info('resultSet.goToNextRow: ' + isGoToNextRow); console.info('resultSet.goToNextRow: ' + isGoToNextRow);
``` ```
...@@ -125,9 +121,9 @@ console.info('resultSet.goToNextRow: ' + isGoToNextRow); ...@@ -125,9 +121,9 @@ console.info('resultSet.goToNextRow: ' + isGoToNextRow);
goToPreviousRow(): boolean goToPreviousRow(): boolean
该接口用于转到结果集的上一行。 转到结果集的上一行。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**返回值：** **返回值：**
...@@ -138,8 +134,6 @@ goToPreviousRow(): boolean ...@@ -138,8 +134,6 @@ goToPreviousRow(): boolean
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let isGoToPreviousRow = resultSet.goToPreviousRow(); let isGoToPreviousRow = resultSet.goToPreviousRow();
console.info('resultSet.goToPreviousRow: ' + isGoToPreviousRow); console.info('resultSet.goToPreviousRow: ' + isGoToPreviousRow);
``` ```
...@@ -148,9 +142,9 @@ console.info('resultSet.goToPreviousRow: ' + isGoToPreviousRow); ...@@ -148,9 +142,9 @@ console.info('resultSet.goToPreviousRow: ' + isGoToPreviousRow);
goTo(offset:number): boolean goTo(offset:number): boolean
该接口用于向前或向后转至结果集的指定行，相对于其当前位置偏移。 向前或向后转至结果集的指定行，相对于其当前位置偏移。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -167,8 +161,6 @@ goTo(offset:number): boolean ...@@ -167,8 +161,6 @@ goTo(offset:number): boolean
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let goToNum = 1; let goToNum = 1;
let isGoTo = resultSet.goTo(goToNum); let isGoTo = resultSet.goTo(goToNum);
console.info('resultSet.goTo: ' + isGoTo); console.info('resultSet.goTo: ' + isGoTo);
...@@ -178,9 +170,9 @@ console.info('resultSet.goTo: ' + isGoTo); ...@@ -178,9 +170,9 @@ console.info('resultSet.goTo: ' + isGoTo);
goToRow(position: number): boolean goToRow(position: number): boolean
该接口用于转到结果集的指定行。 转到结果集的指定行。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -197,8 +189,6 @@ goToRow(position: number): boolean ...@@ -197,8 +189,6 @@ goToRow(position: number): boolean
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let goToRowNum = 2 let goToRowNum = 2
let isGoToRow = resultSet.goToRow(goToRowNum); let isGoToRow = resultSet.goToRow(goToRowNum);
console.info('resultSet.goToRow: ' + isGoToRow); console.info('resultSet.goToRow: ' + isGoToRow);
...@@ -208,9 +198,9 @@ console.info('resultSet.goToRow: ' + isGoToRow); ...@@ -208,9 +198,9 @@ console.info('resultSet.goToRow: ' + isGoToRow);
getBlob(columnIndex: number): Uint8Array getBlob(columnIndex: number): Uint8Array
该接口用于以字节数组的形式获取当前行中指定列的值。 以字节数组的形式获取当前行中指定列的值。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -227,8 +217,6 @@ getBlob(columnIndex: number): Uint8Array ...@@ -227,8 +217,6 @@ getBlob(columnIndex: number): Uint8Array
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let columnIndex = 1 let columnIndex = 1
let goToFirstRow = resultSet.goToFirstRow(); let goToFirstRow = resultSet.goToFirstRow();
let getBlob = resultSet.getBlob(columnIndex); let getBlob = resultSet.getBlob(columnIndex);
...@@ -239,9 +227,9 @@ console.info('resultSet.getBlob: ' + getBlob); ...@@ -239,9 +227,9 @@ console.info('resultSet.getBlob: ' + getBlob);
getString(columnIndex: number): *string* getString(columnIndex: number): *string*
该接口用于以字符串形式获取当前行中指定列的值。 以字符串形式获取当前行中指定列的值。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -258,8 +246,6 @@ getString(columnIndex: number): *string* ...@@ -258,8 +246,6 @@ getString(columnIndex: number): *string*
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let columnIndex = 1 let columnIndex = 1
let goToFirstRow = resultSet.goToFirstRow(); let goToFirstRow = resultSet.goToFirstRow();
let getString = resultSet.getString(columnIndex); let getString = resultSet.getString(columnIndex);
...@@ -268,11 +254,11 @@ console.info('resultSet.getString: ' + getString); ...@@ -268,11 +254,11 @@ console.info('resultSet.getString: ' + getString);
## getLong ## getLong
getLong(columnIndex: number): *number* getLong(columnIndex: number): number
该接口用于以Long形式获取当前行中指定列的值。 以长整数值形式获取当前行中指定列的值。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -284,13 +270,11 @@ getLong(columnIndex: number): *number* ...@@ -284,13 +270,11 @@ getLong(columnIndex: number): *number*
| 类型 | 说明 | | 类型 | 说明 |
| ------ | -------------------------- | | ------ | -------------------------- |
| number | 以Long形式返回指定列的值。 | | number | 以长整数值形式返回指定列的值。 |
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let columnIndex = 1 let columnIndex = 1
let goToFirstRow = resultSet.goToFirstRow(); let goToFirstRow = resultSet.goToFirstRow();
let getLong = resultSet.getLong(columnIndex); let getLong = resultSet.getLong(columnIndex);
...@@ -299,11 +283,11 @@ console.info('resultSet.getLong: ' + getLong); ...@@ -299,11 +283,11 @@ console.info('resultSet.getLong: ' + getLong);
## getDouble ## getDouble
getDouble(columnIndex: number): *number* getDouble(columnIndex: number): number
该接口用于以double形式获取当前行中指定列的值。 以值类型为双浮点数形式获取当前行中指定列的值。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -315,13 +299,11 @@ getDouble(columnIndex: number): *number* ...@@ -315,13 +299,11 @@ getDouble(columnIndex: number): *number*
| 类型 | 说明 | | 类型 | 说明 |
| ------ | ---------------------------- | | ------ | ---------------------------- |
| number | 以double形式返回指定列的值。 | | number | 值类型为双浮点数形式返回指定列的值。 |
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let columnIndex = 1 let columnIndex = 1
let goToFirstRow = resultSet.goToFirstRow(); let goToFirstRow = resultSet.goToFirstRow();
let getDouble = resultSet.getDouble(columnIndex); let getDouble = resultSet.getDouble(columnIndex);
...@@ -332,9 +314,9 @@ console.info('resultSet.getDouble: ' + getDouble); ...@@ -332,9 +314,9 @@ console.info('resultSet.getDouble: ' + getDouble);
close(): void close(): void
该接口用于关闭结果集。 关闭结果集。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**示例：** **示例：**
...@@ -344,11 +326,11 @@ resultSet.close(); ...@@ -344,11 +326,11 @@ resultSet.close();
## getColumnIndex ## getColumnIndex
getColumnIndex(columnName: string): *number* getColumnIndex(columnName: string): number
该接口用于根据指定的列名获取列索引。 根据指定的列名获取列索引。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -365,8 +347,6 @@ getColumnIndex(columnName: string): *number* ...@@ -365,8 +347,6 @@ getColumnIndex(columnName: string): *number*
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let ColumnName = "name" let ColumnName = "name"
let getColumnIndex = resultSet.getColumnIndex(ColumnName) let getColumnIndex = resultSet.getColumnIndex(ColumnName)
console.info('resultSet.getColumnIndex: ' + getColumnIndex); console.info('resultSet.getColumnIndex: ' + getColumnIndex);
...@@ -376,9 +356,9 @@ console.info('resultSet.getColumnIndex: ' + getColumnIndex); ...@@ -376,9 +356,9 @@ console.info('resultSet.getColumnIndex: ' + getColumnIndex);
getColumnName(columnIndex: number): *string* getColumnName(columnIndex: number): *string*
该接口用于根据指定的列索引获取列名。 根据指定的列索引获取列名。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -395,8 +375,6 @@ getColumnName(columnIndex: number): *string* ...@@ -395,8 +375,6 @@ getColumnName(columnIndex: number): *string*
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let columnIndex = 1 let columnIndex = 1
let getColumnName = resultSet.getColumnName(columnIndex) let getColumnName = resultSet.getColumnName(columnIndex)
console.info('resultSet.getColumnName: ' + getColumnName); console.info('resultSet.getColumnName: ' + getColumnName);
...@@ -406,9 +384,9 @@ console.info('resultSet.getColumnName: ' + getColumnName); ...@@ -406,9 +384,9 @@ console.info('resultSet.getColumnName: ' + getColumnName);
getDataType(columnIndex: number): DataType getDataType(columnIndex: number): DataType
该接口用于获取指定列的数据类型。 指定列索引获取该列的数据类型。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
**参数：** **参数：**
...@@ -425,8 +403,6 @@ getDataType(columnIndex: number): DataType ...@@ -425,8 +403,6 @@ getDataType(columnIndex: number): DataType
**示例：** **示例：**
```ts ```ts
// Refer to the instructions for the method of obtaining resultSet
let resultSet;
let columnIndex = 1; let columnIndex = 1;
let getDataType = resultSet.getDataType(columnIndex); let getDataType = resultSet.getDataType(columnIndex);
console.info('resultSet.getDataType: ' + getDataType); console.info('resultSet.getDataType: ' + getDataType);
...@@ -434,16 +410,16 @@ console.info('resultSet.getDataType: ' + getDataType); ...@@ -434,16 +410,16 @@ console.info('resultSet.getDataType: ' + getDataType);
## DataType ## DataType
该类型用于用于表示数据类型。 用于表示数据类型。
只能被内部应用使用。 只能被系统应用使用。
**系统能力：** SystemCapability.DistributedDataManager.DataShare.Core。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core
| 名称 | 默认值 | 说明 | | 名称 | 默认值 | 说明 |
| ----------- | ------ | -------------------- | | ----------- | ------ | -------------------- |
| TYPE_NULL | 0 | 表示值类型为空。 | | TYPE_NULL | 0 | 表示值类型为空。 |
| TYPE_LONG | 1 | 表示值类型为Long。 | | TYPE_LONG | 1 | 表示值类型为长整数值。 |
| TYPE_DOUBLE | 2 | 表示值类型为Double。 | | TYPE_DOUBLE | 2 | 表示值类型为双浮点数。 |
| TYPE_STRING | 3 | 表示值类型为String。 | | TYPE_STRING | 3 | 表示值类型为字符串。 |
| TYPE_BLOB | 4 | 表示值类型为Blob。 | | TYPE_BLOB | 4 | 表示值类型为字节数组。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-data-ValuesBucket.md
浏览文件 @ d0aee04f
# ValuesBucket # ValuesBucket
**数据集(ValuesBucket) **是用户通过DataShare进行插入的数据集合，通过DataShare的insert方法可以进行插入对应的数据集，update方法可以对已经插入的数据集进行修改，数据集以键-值对的形式进行传输。 **数据集(ValuesBucket) **是开发者向数据库插入的数据集合，数据集以键-值对的形式进行传输。
>**说明：** >**说明：**
> >
...@@ -16,13 +16,13 @@ import { ValuesBucket } from '@ohos.data.ValuesBucket'; ...@@ -16,13 +16,13 @@ import { ValuesBucket } from '@ohos.data.ValuesBucket';
## ValueType ## ValueType
该类型用于表示允许的数据字段类型。 该类型用于表示数据库允许的数据字段类型。
| 名称 | 说明 | | 名称 | 说明 |
| ------- | -------------------- | | ------- | -------------------- |
| number | 表示值类型为数字。 | | number | 表示字段类型为数字。 |
| string | 表示值类型为字符串。 | | string | 表示字段类型为字符串。 |
| boolean | 表示值类型为布尔值。 | | boolean | 表示字段类型为布尔值。 |
## ValuesBucket ## ValuesBucket
...@@ -30,5 +30,5 @@ import { ValuesBucket } from '@ohos.data.ValuesBucket'; ...@@ -30,5 +30,5 @@ import { ValuesBucket } from '@ohos.data.ValuesBucket';
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ------------- | --------------------------------------------- | ---- | ------------------------------------------------------------ | | ------------- | --------------------------------------------- | ---- | ------------------------------------------------------------ |
| [key: string] | [ValueType](#valuetype) \| Uint8Array \| null | 是 | 键的类型为字符串型；值的类型可以为数字，字符串，布尔值，无符号整型8位数组，空值。 | | [key: string] | [ValueType](#valuetype)(number/string/boolean) \| Uint8Array \| null | 是 | 键的类型为字符串型；值的类型可以为数字，字符串，布尔值，无符号整型8位数组，空值。 |
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或