From 99298f4479a9675c9bd37b6f4360a9f0b8d9a0ab Mon Sep 17 00:00:00 2001 From: songruirui Date: Fri, 24 Jun 2022 10:18:22 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: songruirui --- ...s-application-DataShareExtensionAbility.md | 32 ++++++++-------- .../apis/js-apis-data-DataSharePredicates.md | 2 +- .../apis/js-apis-data-DataShareResultSet.md | 8 ++-- .../reference/apis/js-apis-data-dataShare.md | 38 +++++++++---------- 4 files changed, 40 insertions(+), 40 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md b/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md index 082e863ef3..2e87107814 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-DataShareExtensionAbility.md @@ -42,7 +42,7 @@ let DDL_TBL_CREATE = "CREATE TABLE IF NOT EXISTS " + " (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER, phoneNumber DOUBLE, isStudent BOOLEAN, Binary BINARY)"; let rdbStore; -onCreate(want: Want, callback: AsyncCallback<void>) { +onCreate(want: Want, callback: AsyncCallback) { rdb.getRdbStore(this.context, { name: DB_NAME }, 1, function (err, data) { @@ -77,7 +77,7 @@ insert?(uri: string, valueBucket: ValuesBucket, callback: AsyncCallback<numbe **示例：** ```ts -insert(uri: string, valueBucket: ValuesBucket, callback: AsyncCallback<number>) { +insert(uri: string, valueBucket: ValuesBucket, callback: AsyncCallback) { if (value == null) { console.info('invalid valueBuckets'); return; @@ -104,14 +104,14 @@ update?(uri: string, predicates: dataSharePredicates.DataSharePredicates, valueB | 参数名 | 参数类型 | 必填 | 说明 | | ----- | ------ | ------ | ------ | | uri | string | 是 | 指示要更新的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | | valueBucket | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 | | callback | AsyncCallback<number> | 是 | 回调函数。返回更新的数据记录数。 | **示例：** ```ts -update(uri: string, predicates: dataSharePredicates.DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback<number>) { +update(uri: string, predicates: dataSharePredicates.DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback) { if (predicates == null || predicates == undefined) { return; } @@ -136,14 +136,14 @@ query?(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns | 名称 | 参数类型 | 必填 | 说明 | | ----- | ------ | ------ | ------ | | uri | string | 是 | 指示要查询的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | | columns | Array<string> | 是 | 指示要查询的列。如果此参数为空，则查询所有列。 | | callback | AsyncCallback<Object> | 是 | 回调函数。返回查询到的结果集。 | **示例：** ```ts -query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array<string>, callback: AsyncCallback<Object>) { +query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array, callback: AsyncCallback) { if (predicates == null || predicates == undefined) { return; } @@ -171,13 +171,13 @@ delete?(uri: string, predicates: dataSharePredicates.DataSharePredicates, callba | 名称 | 参数类型 | 必填 | 说明 | | ---------- | ------------------------------------------------------------ | ---- | ---------------------------------- | | uri | string | 是 | 指示要删除的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | | callback | AsyncCallback<number> | 是 | 回调函数。返回已删除的数据记录数。 | **示例：** ```ts -delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback<number>) { +delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback) { if (predicates == null || predicates == undefined) { return; } @@ -208,7 +208,7 @@ BatchInsert?(uri: string, valueBuckets: Array<ValuesBucket>, callback: Asy **示例：** ```ts -batchInsert(uri: string, valueBuckets: Array<ValuesBucket>, callback: AsyncCallback<number>) { +batchInsert(uri: string, valueBuckets: Array, callback: AsyncCallback) { if (valueBuckets == null || valueBuckets.length == undefined) { console.info('invalid valueBuckets'); return; @@ -242,7 +242,7 @@ getType?(uri: string, callback: AsyncCallback<string>): void **示例：** ```ts -getType(uri: string, callback: AsyncCallback<string>) { +getType(uri: string, callback: AsyncCallback) { let err = {"code":0}; let ret = "image"; callback(err, ret); @@ -268,7 +268,7 @@ getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Ar **示例：** ```ts -getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array<string>>) { +getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback>) { let err = {"code":0}; let ret = new Array("type01", "type02", "type03"); callback(err, ret); @@ -287,13 +287,13 @@ normalizeUri?(uri: string, callback: AsyncCallback<string>): void | 名称 | 类型 | 必填 | 描述 | | -------- | --------------------- | ---- | ----------------------- | -| uri | string | 是 | 指示用户传入的URI。 | +| uri | string | 是 | 指示用户传入的[URI](js-apis-uri.md#uri)。 | | callback | AsyncCallback<string> | 是 | 回调函数。如果支持URI规范化，则返回规范化URI，否则返回空。 | **示例：** ```ts -normalizeUri(uri: string, callback: AsyncCallback<string>) { +normalizeUri(uri: string, callback: AsyncCallback) { let err = {"code":0}; let ret = "normalize+" + uri; callback(err, ret); @@ -312,13 +312,13 @@ denormalizeUri?(uri: string, callback: AsyncCallback<string>): void | 名称 | 类型 | 必填 | 描述 | | -------- | --------------------- | ---- | ----------------------- | -| uri | string | 是 | 指示服务端使用的uri。 | +| uri | string | 是 | 指示服务端使用的[URI](js-apis-uri.md#uri)。 | | callback | AsyncCallback<string> | 是 | 回调函数。如果反规范化成功，则返回反规范化的URI；如果无需进行反规范化，则返回原始URI；若不支持则返回空。 | **示例：** ```ts -denormalizeUri(uri: string, callback: AsyncCallback<string>) { +denormalizeUri(uri: string, callback: AsyncCallback) { let err = {"code":0}; let ret = "denormalize+" + uri; callback(err, ret); @@ -344,7 +344,7 @@ openFile?(uri: string, mode: string, callback: AsyncCallback<number>): voi **示例：** ```ts -openFile(uri: string, mode: string, callback: AsyncCallback<number>) { +openFile(uri: string, mode: string, callback: AsyncCallback) { let err = {"code":0}; let fd = 0; callback(err,fd); diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-DataSharePredicates.md b/zh-cn/application-dev/reference/apis/js-apis-data-DataSharePredicates.md index 53b0d16ef5..d31e2dbf12 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-DataSharePredicates.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-DataSharePredicates.md @@ -338,7 +338,7 @@ like(field: string, value: string): DataSharePredicates | 类型 | 说明 | | ------------------------------------------- | ------------------------------------------------------------ | -| [DataSharePredicates](#datasharepredicates) | xxxxxxxxxx openFile(uri: string, mode: string, callback: AsyncCallback<number>) {    let err = {"code":0};    let fd = 0;    callback(err,fd);}ts | +| [DataSharePredicates](#datasharepredicates) | xxxxxxxxxx openFile(uri: string, mode: string, callback: AsyncCallback) {    let err = {"code":0};    let fd = 0;    callback(err,fd);}ts | **示例：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-DataShareResultSet.md b/zh-cn/application-dev/reference/apis/js-apis-data-DataShareResultSet.md index 9043e366f0..bf35cec5ab 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-DataShareResultSet.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-DataShareResultSet.md @@ -15,7 +15,7 @@ import DataShareResultSet from '@ohos.data.DataShareResultSet'; ## 使用说明 -需要通过[dataShare.query()](js-apis-data-dataShare.md#query)获取DataShareResultSet对象。 +需要通过调用[query](js-apis-data-dataShare.md#query)接口获取DataShareResultSet对象。 ```ts import dataShare from '@ohos.data.dataShare'; @@ -411,13 +411,13 @@ console.info('resultSet.getDataType: ' + getDataType); ## DataType -用于表示数据类型。 +数据类型枚举。 -只能被系统应用使用。 +只支持系统应用，不支持三方应用。 **系统能力：** SystemCapability.DistributedDataManager.DataShare.Core -| 名称 | 默认值 | 说明 | +| 名称 | 值 | 说明 | | ----------- | ------ | -------------------- | | TYPE_NULL | 0 | 表示值类型为空。 | | TYPE_LONG | 1 | 表示值类型为长整数值。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md b/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md index e83f4e0504..40005b36d9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md +++ b/zh-cn/application-dev/reference/apis/js-apis-data-dataShare.md @@ -324,11 +324,11 @@ getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Arr **参数：** -| 名称 | 类型 | 必填 | 描述 | -| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| uri | string | 是 | 指示要获取的文件的路径。 | -| mimeTypeFilter | string | 是 | 指示要筛选的MIME类型。例如：
“\*/\*”：获取支持的所有类型。
“image/\*”：获取主类型image，子类型为任何类型的MIME。
”\*/jpg”：获取子类型为jpg，主类型为任何类型的MIME。 | -| callback | openFile(uri: string, mode: string, callback: AsyncCallback<number>) {    let err = {"code":0};    let fd = 0;    callback(err,fd);}ts | 是 | 回调函数。返回匹配的MIME类型数组。 | +| 名称 | 类型 | 必填 | 描述 | +| -------------- | ---------------------------------------- | ---- | ------------------------------------------------------------ | +| uri | string | 是 | 指示要获取的文件的路径。 | +| mimeTypeFilter | string | 是 | 指示要筛选的MIME类型。例如：
“\*/\*”：获取支持的所有类型。
“image/\*”：获取主类型image，子类型为任何类型的MIME。
”\*/jpg”：获取子类型为jpg，主类型为任何类型的MIME。 | +| callback | AsyncCallback<Array<string>> | 是 | 回调函数。返回匹配的MIME类型数组。 | **示例：** @@ -389,7 +389,7 @@ normalizeUri(uri: string, callback: AsyncCallback<string>): void | 名称 | 类型 | 必填 | 描述 | | -------- | ---------------------- | ---- | -------------------------------------------------------- | -| uri | string | 是 | 指示要规范化的URI。 | +| uri | string | 是 | 指示要规范化的[URI](js-apis-uri.md#uri)。 | | callback | AsyncCallback<string> | 是 | 回调函数。如果支持URI规范化，则返回规范化URI，否则返回空。 | **示例：** @@ -415,9 +415,9 @@ normalizeUri(uri: string): Promise<string> **参数：** -| 名称 | 类型 | 必填 | 描述 | -| ---- | ------ | ---- | ------------------- | -| uri | string | 是 | 指示要规范化的URI。 | +| 名称 | 类型 | 必填 | 描述 | +| ---- | ------ | ---- | ----------------------------------------- | +| uri | string | 是 | 指示要规范化的[URI](js-apis-uri.md#uri)。 | **返回值：** @@ -448,7 +448,7 @@ denormalizeUri(uri: string, callback: AsyncCallback<string>): void | 名称 | 类型 | 必填 | 描述 | | -------- | ---------------------- | ---- | --------------------------------------------------- | -| uri | string | 是 | 指示要反规范化的URI。 | +| uri | string | 是 | 指示要反规范化的[URI](js-apis-uri.md#uri)。 | | callback | AsyncCallback<string> | 是 | 回调函数。如果反规范化成功，则返回反规范化的URI；如果无需进行反规范化，则返回原始URI；若不支持则返回空。 | **示例：** @@ -474,9 +474,9 @@ denormalizeUri(uri: string): Promise<string> **参数：** -| 名称 | 类型 | 必填 | 描述 | -| ---- | ------ | ---- | --------------------- | -| uri | string | 是 | 指示要反规范化的URI。 | +| 名称 | 类型 | 必填 | 描述 | +| ---- | ------ | ---- | ------------------------------------------- | +| uri | string | 是 | 指示要反规范化的[URI](js-apis-uri.md#uri)。 | **返回值：** @@ -646,7 +646,7 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callbac | 名称 | 类型 | 必填 | 描述 | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | uri | string | 是 | 指示要删除的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
delete接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB的删除目前仅支持inKeys谓词。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
delete接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB的删除目前仅支持inKeys谓词。 | | callback | AsyncCallback<number> | 是 | 回调函数。返回已删除的数据记录数。
因部分数据库（如KVDB）的相应接口并不提供相应支持，故若服务端使用此数据库，则此callback也无法返回删除的数据记录数。 | **示例：** @@ -679,7 +679,7 @@ delete(uri: string, predicates: dataSharePredicates.DataSharePredicates): Promis | 名称 | 类型 | 必填 | 描述 | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | uri | string | 是 | 指示要删除的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
delete接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB的删除目前仅支持inKeys谓词。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
delete接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB的删除目前仅支持inKeys谓词。 | **返回值：** @@ -715,7 +715,7 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: | 名称 | 类型 | 必填 | 描述 | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | uri | string | 是 | 指示要更新的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
update接口是否支持谓词筛选条件取决于服务端所选用的数据库，如KVDB目前并不支持谓词筛选条件，仅RDB支持。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
update接口是否支持谓词筛选条件取决于服务端所选用的数据库，如KVDB目前并不支持谓词筛选条件，仅RDB支持。 | | value | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 | | callback | AsyncCallback<number> | 是 | 回调函数。返回更新的数据记录数。
因部分数据库（如KVDB）的相应接口并不提供相应支持，故若服务端使用此数据库，则此callback也无法返回更新的数据记录数。 | @@ -755,7 +755,7 @@ update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: | 名称 | 类型 | 必填 | 描述 | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | uri | string | 是 | 指示要更新的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
update接口是否支持谓词筛选条件取决于服务端所选用的数据库，如KVDB目前并不支持谓词筛选条件，仅RDB支持。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
update接口是否支持谓词筛选条件取决于服务端所选用的数据库，如KVDB目前并不支持谓词筛选条件，仅RDB支持。 | | value | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 | **返回值：** @@ -798,7 +798,7 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: | 名称 | 类型 | 必填 | 描述 | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | uri | string | 是 | 指示要查询的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
query接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB目前仅支持inKeys和prefixKey。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
query接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB目前仅支持inKeys和prefixKey。 | | columns | Array<string> | 是 | 指示要查询的列。如果此参数为空，则查询所有列。 | | callback | AsyncCallback<[DataShareResultSet](js-apis-data-DataShareResultSet.md#datashareresultset)> | 是 | 回调函数。返回查询到的结果集。 | @@ -833,7 +833,7 @@ query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: | 名称 | 类型 | 必填 | 描述 | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | uri | string | 是 | 指示要查询的数据的路径。 | -| predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
query接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB目前仅支持inKeys和prefixKey。 | +| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。
query接口所支持的谓词方法取决于服务端所选用的数据库，如KVDB目前仅支持inKeys和prefixKey。 | | columns | Array<string> | 是 | 指示要查询的列。如果此参数为空，则查询所有列。 | **返回值：** -- GitLab