提交 34e9eaf4 编写于 作者: S songruirui

predicates相关修改

Signed-off-by: Nsongruirui <songruirui1@huawei.com>
上级 30e9341f
...@@ -51,7 +51,9 @@ onCreate(want: Want, callback: AsyncCallback&lt;void&gt;) { ...@@ -51,7 +51,9 @@ onCreate(want: Want, callback: AsyncCallback&lt;void&gt;) {
rdbStore.executeSql(DDL_TBL_CREATE, [], function (err) { rdbStore.executeSql(DDL_TBL_CREATE, [], function (err) {
console.log('executeSql done, error message : ' + err); console.log('executeSql done, error message : ' + err);
}); });
callback(); if (callback) {
callback();
}
}); });
} }
``` ```
...@@ -91,7 +93,7 @@ insert(uri: string, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number ...@@ -91,7 +93,7 @@ insert(uri: string, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number
## update ## update
update?(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void update?(uri: string, predicates: dataSharePredicates.DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void
在数据库更新时服务端回调此接口,该方法可以选择性重写。 在数据库更新时服务端回调此接口,该方法可以选择性重写。
...@@ -102,14 +104,14 @@ update?(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket, ...@@ -102,14 +104,14 @@ update?(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket,
| 参数名 | 参数类型 | 必填 | 说明 | | 参数名 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ------ | ------ | | ----- | ------ | ------ | ------ |
| uri | string | 是 | 指示要更新的数据的路径。 | | uri | string | 是 | 指示要更新的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 |
| valueBucket | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 | | valueBucket | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回更新的数据记录数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回更新的数据记录数。 |
**示例:** **示例:**
```ts ```ts
update(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;) { update(uri: string, predicates: dataSharePredicates.DataSharePredicates, valueBucket: ValuesBucket, callback: AsyncCallback&lt;number&gt;) {
if (predicates == null || predicates == undefined) { if (predicates == null || predicates == undefined) {
return; return;
} }
...@@ -123,7 +125,7 @@ update(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket, ...@@ -123,7 +125,7 @@ update(uri: string, predicates: DataSharePredicates, valueBucket: ValuesBucket,
## query ## query
query?(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;Object&gt;): void query?(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;Object&gt;): void
在查询数据库时服务端回调此接口,该方法可以选择性重写。 在查询数据库时服务端回调此接口,该方法可以选择性重写。
...@@ -134,14 +136,14 @@ query?(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt ...@@ -134,14 +136,14 @@ query?(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ----- | ------ | ------ | ------ | | ----- | ------ | ------ | ------ |
| uri | string | 是 | 指示要查询的数据的路径。 | | uri | string | 是 | 指示要查询的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 |
| columns | Array&lt;string&gt; | 是 | 指示要查询的列。如果此参数为空,则查询所有列。 | | columns | Array&lt;string&gt; | 是 | 指示要查询的列。如果此参数为空,则查询所有列。 |
| callback | AsyncCallback&lt;Object&gt; | 是 | 回调函数。返回查询到的结果集。 | | callback | AsyncCallback&lt;Object&gt; | 是 | 回调函数。返回查询到的结果集。 |
**示例:** **示例:**
```ts ```ts
query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;Object&gt;) { query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;Object&gt;) {
if (predicates == null || predicates == undefined) { if (predicates == null || predicates == undefined) {
return; return;
} }
...@@ -158,7 +160,7 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt; ...@@ -158,7 +160,7 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;
## delete ## delete
delete?(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt;number&gt;): void delete?(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback&lt;number&gt;): void
在删除数据库记录时服务端回调此接口,该方法可以选择性重写。 在删除数据库记录时服务端回调此接口,该方法可以选择性重写。
...@@ -169,13 +171,13 @@ delete?(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt ...@@ -169,13 +171,13 @@ delete?(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 参数类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ---------------------------------- | | ---------- | ------------------------------------------------------------ | ---- | ---------------------------------- |
| uri | string | 是 | 指示要删除的数据的路径。 | | uri | string | 是 | 指示要删除的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回已删除的数据记录数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回已删除的数据记录数。 |
**示例:** **示例:**
```ts ```ts
delete(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt;number&gt;) { delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback&lt;number&gt;) {
if (predicates == null || predicates == undefined) { if (predicates == null || predicates == undefined) {
return; return;
} }
......
# DataSharePredicates # DataSharePredicates
**谓词(DataSharePredicates)** 是用户通过DataShare查询数据库中的数据所使用的筛选条件,经常被应用在更新数据([update](js-apis-data-dataShare.md#update))和查询数据([query](js-apis-data-dataShare.md#query))中。 **谓词(DataSharePredicates)** 是用户通过DataShare查询数据库中的数据所使用的筛选条件,经常被应用在更新数据([update](js-apis-data-dataShare.md#update))、删除数据([delete](js-apis-data-dataShare.md#delete))和查询数据([query](js-apis-data-dataShare.md#query))中。
>**说明:** >**说明:**
> >
...@@ -10,7 +10,7 @@ ...@@ -10,7 +10,7 @@
## 导入模块 ## 导入模块
```ts ```ts
import dataSharePredicates from '@ohos.data.DataSharePredicates'; import dataSharePredicates from '@ohos.data.dataSharePredicates';
``` ```
## equalTo ## equalTo
...@@ -338,7 +338,7 @@ like(field: string, value: string): DataSharePredicates ...@@ -338,7 +338,7 @@ like(field: string, value: string): DataSharePredicates
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------------- | ------------------------------------------------------------ | | ------------------------------------------- | ------------------------------------------------------------ |
| [DataSharePredicates](#datasharepredicates) | openFile(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;) {    let err = {"code":0};    let fd = 0;    callback(err,fd);}ts | | [DataSharePredicates](#datasharepredicates) | xxxxxxxxxx openFile(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;) {    let err = {"code":0};    let fd = 0;    callback(err,fd);}ts |
**示例:** **示例:**
......
...@@ -19,6 +19,7 @@ import DataShareResultSet from '@ohos.data.DataShareResultSet'; ...@@ -19,6 +19,7 @@ import DataShareResultSet from '@ohos.data.DataShareResultSet';
```ts ```ts
import dataShare from '@ohos.data.dataShare'; import dataShare from '@ohos.data.dataShare';
import dataSharePredicates from '@ohos.data.dataSharePredicates'
let dataShareHelper; let dataShareHelper;
let uri = ("datashare:///com.samples.datasharetest.DataShare"); let uri = ("datashare:///com.samples.datasharetest.DataShare");
...@@ -32,7 +33,7 @@ await dataShare.createDataShareHelper(this.context, uri, (err, data) => { ...@@ -32,7 +33,7 @@ await dataShare.createDataShareHelper(this.context, uri, (err, data) => {
}); });
let columns = ["*"]; let columns = ["*"];
let da = new dataShare.DataSharePredicates(); let da = new dataSharePredicates.DataSharePredicates();
let resultSet; let resultSet;
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
dataShareHelper.query(uri, da, columns).then((data) => { dataShareHelper.query(uri, da, columns).then((data) => {
......
...@@ -65,9 +65,9 @@ createDataShareHelper(context: Context, uri: string): Promise&lt;DataShareHelper ...@@ -65,9 +65,9 @@ createDataShareHelper(context: Context, uri: string): Promise&lt;DataShareHelper
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------- | ---------------------------------------------- | | -------------------------------------------------- | ---------------------------------------------- |
| Promise&lt;&lt;DataShareHelper&gt; | Promise对象。返回创建后的DataShareHelper实例。 | | Promise&lt;[DataShareHelper](#datasharehelper)&gt; | Promise对象。返回创建后的DataShareHelper实例。 |
**示例:** **示例:**
...@@ -107,6 +107,7 @@ openFile(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;): void ...@@ -107,6 +107,7 @@ openFile(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;): void
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.openFile(uri, "rwt", (err, data) => { dataShareHelper.openFile(uri, "rwt", (err, data) => {
if (err != undefined) { if (err != undefined) {
console.info("openFile failed, error message : " + err); console.info("openFile failed, error message : " + err);
...@@ -141,6 +142,7 @@ openFile(uri: string, mode: string): Promise&lt;number&gt; ...@@ -141,6 +142,7 @@ openFile(uri: string, mode: string): Promise&lt;number&gt;
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.openFile(uri, "rwt").then((data) => { dataShareHelper.openFile(uri, "rwt").then((data) => {
console.info("openFile succeed, data : " + data); console.info("openFile succeed, data : " + data);
let fd = data; let fd = data;
...@@ -171,6 +173,7 @@ on(type: 'dataChange', uri: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -171,6 +173,7 @@ on(type: 'dataChange', uri: string, callback: AsyncCallback&lt;void&gt;): void
function onCallback() { function onCallback() {
console.info("**** Observer on callback ****"); console.info("**** Observer on callback ****");
} }
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.on("dataChange", uri, onCallback); dataShareHelper.on("dataChange", uri, onCallback);
``` ```
...@@ -196,6 +199,7 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback&lt;void&gt;): void ...@@ -196,6 +199,7 @@ off(type: 'dataChange', uri: string, callback?: AsyncCallback&lt;void&gt;): void
function offCallback() { function offCallback() {
console.info("**** Observer off callback ****"); console.info("**** Observer off callback ****");
} }
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.off("dataChange", uri, offCallback); dataShareHelper.off("dataChange", uri, offCallback);
``` ```
...@@ -217,6 +221,7 @@ notifyChange(uri: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -217,6 +221,7 @@ notifyChange(uri: string, callback: AsyncCallback&lt;void&gt;): void
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.notifyChange(uri, () => { dataShareHelper.notifyChange(uri, () => {
console.log("***** notifyChange *****"); console.log("***** notifyChange *****");
}); });
...@@ -245,6 +250,7 @@ notifyChange(uri: string): Promise&lt;void&gt; ...@@ -245,6 +250,7 @@ notifyChange(uri: string): Promise&lt;void&gt;
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.notifyChange(uri); dataShareHelper.notifyChange(uri);
``` ```
...@@ -266,6 +272,7 @@ getType(uri: string, callback: AsyncCallback&lt;string&gt;): void ...@@ -266,6 +272,7 @@ getType(uri: string, callback: AsyncCallback&lt;string&gt;): void
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.getType(uri, (err, data)=>{ dataShareHelper.getType(uri, (err, data)=>{
if (err != undefined) { if (err != undefined) {
console.log("getType failed, error message : " + err); console.log("getType failed, error message : " + err);
...@@ -299,6 +306,7 @@ getType(uri: string): Promise&lt;string&gt; ...@@ -299,6 +306,7 @@ getType(uri: string): Promise&lt;string&gt;
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.getType(uri).then((data) => { dataShareHelper.getType(uri).then((data) => {
console.log("getType succeed, data : " + data); console.log("getType succeed, data : " + data);
}).catch((err) => { }).catch((err) => {
...@@ -316,15 +324,16 @@ getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback&lt;Arr ...@@ -316,15 +324,16 @@ getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback&lt;Arr
**参数:** **参数:**
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| -------------- | ---------------------------------------- | ---- | ------------------------------------------------------------ | | -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要获取的文件的路径。 | | uri | string | 是 | 指示要获取的文件的路径。 |
| mimeTypeFilter | string | 是 | 指示要筛选的MIME类型。例如:<br />\*/\*”:获取支持的所有类型。<br/>“image/\*”:获取主类型image,子类型为任何类型的MIME。<br />\*/jpg”:获取子类型为jpg,主类型为任何类型的MIME。 | | mimeTypeFilter | string | 是 | 指示要筛选的MIME类型。例如:<br />\*/\*”:获取支持的所有类型。<br/>“image/\*”:获取主类型image,子类型为任何类型的MIME。<br />\*/jpg”:获取子类型为jpg,主类型为任何类型的MIME。 |
| callback | AsyncCallback&lt;Array&lt;string&gt;&gt; | 是 | 回调函数。返回匹配的MIME类型数组。 | | callback | openFile(uri: string, mode: string, callback: AsyncCallback&lt;number&gt;) {    let err = {"code":0};    let fd = 0;    callback(err,fd);}ts | 是 | 回调函数。返回匹配的MIME类型数组。 |
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let mimeTypeFilter = "image/*"; let mimeTypeFilter = "image/*";
dataShareHelper.getFileTypes(uri, mimeTypeFilter, (err,data) => { dataShareHelper.getFileTypes(uri, mimeTypeFilter, (err,data) => {
if (err != undefined) { if (err != undefined) {
...@@ -359,6 +368,7 @@ getFileTypes(uri: string, mimeTypeFilter: string): Promise&lt;Array&lt;string&gt ...@@ -359,6 +368,7 @@ getFileTypes(uri: string, mimeTypeFilter: string): Promise&lt;Array&lt;string&gt
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let mimeTypeFilter = "image/*"; let mimeTypeFilter = "image/*";
dataShareHelper.getFileTypes(uri, mimeTypeFilter).then((data) => { dataShareHelper.getFileTypes(uri, mimeTypeFilter).then((data) => {
console.log("getFileTypes succeed, data : " + data); console.log("getFileTypes succeed, data : " + data);
...@@ -385,6 +395,7 @@ normalizeUri(uri: string, callback: AsyncCallback&lt;string&gt;): void ...@@ -385,6 +395,7 @@ normalizeUri(uri: string, callback: AsyncCallback&lt;string&gt;): void
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.normalizeUri(uri, (err, data) => { dataShareHelper.normalizeUri(uri, (err, data) => {
if (err != undefined) { if (err != undefined) {
console.log("normalizeUri failed, error message : " + err); console.log("normalizeUri failed, error message : " + err);
...@@ -417,6 +428,7 @@ normalizeUri(uri: string): Promise&lt;string&gt; ...@@ -417,6 +428,7 @@ normalizeUri(uri: string): Promise&lt;string&gt;
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.normalizeUri(uri).then((data) => { dataShareHelper.normalizeUri(uri).then((data) => {
console.log("normalizeUri = " + data); console.log("normalizeUri = " + data);
}).catch((err) => { }).catch((err) => {
...@@ -442,6 +454,7 @@ denormalizeUri(uri: string, callback: AsyncCallback&lt;string&gt;): void ...@@ -442,6 +454,7 @@ denormalizeUri(uri: string, callback: AsyncCallback&lt;string&gt;): void
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.denormalizeUri(uri, (err, data) => { dataShareHelper.denormalizeUri(uri, (err, data) => {
if (err != undefined) { if (err != undefined) {
console.log("denormalizeUri failed, error message : " + err); console.log("denormalizeUri failed, error message : " + err);
...@@ -474,6 +487,7 @@ denormalizeUri(uri: string): Promise&lt;string&gt; ...@@ -474,6 +487,7 @@ denormalizeUri(uri: string): Promise&lt;string&gt;
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
dataShareHelper.denormalizeUri(uri).then((data) => { dataShareHelper.denormalizeUri(uri).then((data) => {
console.log("denormalizeUri = " + data); console.log("denormalizeUri = " + data);
}).catch((err) => { }).catch((err) => {
...@@ -500,6 +514,7 @@ insert(uri: string, value: ValuesBucket, callback: AsyncCallback&lt;number&gt;): ...@@ -500,6 +514,7 @@ insert(uri: string, value: ValuesBucket, callback: AsyncCallback&lt;number&gt;):
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
const valueBucket = { const valueBucket = {
"name": "rose", "name": "rose",
"age": 22, "age": 22,
...@@ -538,6 +553,7 @@ insert(uri: string, value: ValuesBucket): Promise&lt;number&gt; ...@@ -538,6 +553,7 @@ insert(uri: string, value: ValuesBucket): Promise&lt;number&gt;
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
const valueBucket = { const valueBucket = {
"name": "rose1", "name": "rose1",
"age": 221, "age": 221,
...@@ -569,6 +585,7 @@ batchInsert(uri: string, values: Array&lt;ValuesBucket&gt;, callback: AsyncCallb ...@@ -569,6 +585,7 @@ batchInsert(uri: string, values: Array&lt;ValuesBucket&gt;, callback: AsyncCallb
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let vbs = new Array({"name": "roe11", "age": 21, "salary": 20.5,}, let vbs = new Array({"name": "roe11", "age": 21, "salary": 20.5,},
{"name": "roe12", "age": 21, "salary": 20.5,}, {"name": "roe12", "age": 21, "salary": 20.5,},
{"name": "roe13", "age": 21, "salary": 20.5,}) {"name": "roe13", "age": 21, "salary": 20.5,})
...@@ -605,6 +622,7 @@ batchInsert(uri: string, values: Array&lt;ValuesBucket&gt;): Promise&lt;number&g ...@@ -605,6 +622,7 @@ batchInsert(uri: string, values: Array&lt;ValuesBucket&gt;): Promise&lt;number&g
**示例:** **示例:**
```ts ```ts
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let vbs = new Array({"name": "roe11", "age": 21, "salary": 20.5,}, let vbs = new Array({"name": "roe11", "age": 21, "salary": 20.5,},
{"name": "roe12", "age": 21, "salary": 20.5,}, {"name": "roe12", "age": 21, "salary": 20.5,},
{"name": "roe13", "age": 21, "salary": 20.5,}) {"name": "roe13", "age": 21, "salary": 20.5,})
...@@ -617,7 +635,7 @@ dataShareHelper.batchInsert(uri, vbs).then((data) => { ...@@ -617,7 +635,7 @@ dataShareHelper.batchInsert(uri, vbs).then((data) => {
### delete ### delete
delete(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt;number&gt;): void delete(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback&lt;number&gt;): void
从数据库中删除一条或多条数据记录。使用callback异步回调。 从数据库中删除一条或多条数据记录。使用callback异步回调。
...@@ -628,13 +646,16 @@ delete(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt; ...@@ -628,13 +646,16 @@ delete(uri: string, predicates: DataSharePredicates, callback: AsyncCallback&lt;
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要删除的数据的路径。 | | uri | string | 是 | 指示要删除的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />delete接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB的删除目前仅支持inKeys谓词。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />delete接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB的删除目前仅支持inKeys谓词。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回已删除的数据记录数。<br />因部分数据库(如KVDB)的相应接口并不提供相应支持,故若服务端使用此数据库,则此callback也无法返回删除的数据记录数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回已删除的数据记录数。<br />因部分数据库(如KVDB)的相应接口并不提供相应支持,故若服务端使用此数据库,则此callback也无法返回删除的数据记录数。 |
**示例:** **示例:**
```ts ```ts
let da = new dataShare.DataSharePredicates(); import dataSharePredicates from '@ohos.data.dataSharePredicates'
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let da = new dataSharePredicates.DataSharePredicates();
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
dataShareHelper.delete(uri, da, (err, data) => { dataShareHelper.delete(uri, da, (err, data) => {
if (err != undefined) { if (err != undefined) {
...@@ -647,7 +668,7 @@ dataShareHelper.delete(uri, da, (err, data) => { ...@@ -647,7 +668,7 @@ dataShareHelper.delete(uri, da, (err, data) => {
### delete ### delete
delete(uri: string, predicates: DataSharePredicates): Promise&lt;number&gt; delete(uri: string, predicates: dataSharePredicates.DataSharePredicates): Promise&lt;number&gt;
从数据库中删除一条或多条数据记录。使用Promise异步回调。 从数据库中删除一条或多条数据记录。使用Promise异步回调。
...@@ -658,7 +679,7 @@ delete(uri: string, predicates: DataSharePredicates): Promise&lt;number&gt; ...@@ -658,7 +679,7 @@ delete(uri: string, predicates: DataSharePredicates): Promise&lt;number&gt;
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要删除的数据的路径。 | | uri | string | 是 | 指示要删除的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />delete接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB的删除目前仅支持inKeys谓词。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />delete接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB的删除目前仅支持inKeys谓词。 |
**返回值:** **返回值:**
...@@ -669,7 +690,10 @@ delete(uri: string, predicates: DataSharePredicates): Promise&lt;number&gt; ...@@ -669,7 +690,10 @@ delete(uri: string, predicates: DataSharePredicates): Promise&lt;number&gt;
**示例:** **示例:**
```ts ```ts
let da = new dataShare.DataSharePredicates(); import dataSharePredicates from '@ohos.data.dataSharePredicates'
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let da = new dataSharePredicates.DataSharePredicates();
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
dataShareHelper.delete(uri, da).then((data) => { dataShareHelper.delete(uri, da).then((data) => {
console.log("delete succeed, data : " + data); console.log("delete succeed, data : " + data);
...@@ -680,7 +704,7 @@ dataShareHelper.delete(uri, da).then((data) => { ...@@ -680,7 +704,7 @@ dataShareHelper.delete(uri, da).then((data) => {
### update ### update
update(uri: string, predicates: DataSharePredicates, value: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: ValuesBucket, callback: AsyncCallback&lt;number&gt;): void
更新数据库中的数据记录。使用callback异步回调。 更新数据库中的数据记录。使用callback异步回调。
...@@ -691,14 +715,17 @@ update(uri: string, predicates: DataSharePredicates, value: ValuesBucket, callba ...@@ -691,14 +715,17 @@ update(uri: string, predicates: DataSharePredicates, value: ValuesBucket, callba
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要更新的数据的路径。 | | uri | string | 是 | 指示要更新的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />update接口是否支持谓词筛选条件取决于服务端所选用的数据库,如KVDB目前并不支持谓词筛选条件,仅RDB支持。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />update接口是否支持谓词筛选条件取决于服务端所选用的数据库,如KVDB目前并不支持谓词筛选条件,仅RDB支持。 |
| value | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 | | value | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 |
| callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回更新的数据记录数。<br />因部分数据库(如KVDB)的相应接口并不提供相应支持,故若服务端使用此数据库,则此callback也无法返回更新的数据记录数。 | | callback | AsyncCallback&lt;number&gt; | 是 | 回调函数。返回更新的数据记录数。<br />因部分数据库(如KVDB)的相应接口并不提供相应支持,故若服务端使用此数据库,则此callback也无法返回更新的数据记录数。 |
**示例:** **示例:**
```ts ```ts
let da = new dataShare.DataSharePredicates(); import dataSharePredicates from '@ohos.data.dataSharePredicates'
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let da = new dataSharePredicates.DataSharePredicates();
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
const va = { const va = {
"name": "roe1", "name": "roe1",
...@@ -717,7 +744,7 @@ dataShareHelper.update(uri, da, va, (err, data) => { ...@@ -717,7 +744,7 @@ dataShareHelper.update(uri, da, va, (err, data) => {
### update ### update
update(uri: string, predicates: DataSharePredicates, value: ValuesBucket): Promise&lt;number&gt; update(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: ValuesBucket): Promise&lt;number&gt;
更新数据库中的数据记录。使用Promise异步回调。 更新数据库中的数据记录。使用Promise异步回调。
...@@ -728,7 +755,7 @@ update(uri: string, predicates: DataSharePredicates, value: ValuesBucket): Promi ...@@ -728,7 +755,7 @@ update(uri: string, predicates: DataSharePredicates, value: ValuesBucket): Promi
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要更新的数据的路径。 | | uri | string | 是 | 指示要更新的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />update接口是否支持谓词筛选条件取决于服务端所选用的数据库,如KVDB目前并不支持谓词筛选条件,仅RDB支持。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />update接口是否支持谓词筛选条件取决于服务端所选用的数据库,如KVDB目前并不支持谓词筛选条件,仅RDB支持。 |
| value | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 | | value | [ValuesBucket](js-apis-data-ValuesBucket.md#valuesbucket) | 是 | 指示要更新的数据。 |
**返回值:** **返回值:**
...@@ -740,7 +767,10 @@ update(uri: string, predicates: DataSharePredicates, value: ValuesBucket): Promi ...@@ -740,7 +767,10 @@ update(uri: string, predicates: DataSharePredicates, value: ValuesBucket): Promi
**示例:** **示例:**
```ts ```ts
let da = new dataShare.DataSharePredicates(); import dataSharePredicates from '@ohos.data.dataSharePredicates'
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let da = new dataSharePredicates.DataSharePredicates();
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
const va = { const va = {
"name": "roe1", "name": "roe1",
...@@ -757,7 +787,7 @@ dataShareHelper.update(uri, da, va).then((data) => { ...@@ -757,7 +787,7 @@ dataShareHelper.update(uri, da, va).then((data) => {
### query ### query
query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;DataShareResultSet&gt;): void query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array&lt;string&gt;, callback: AsyncCallback&lt;DataShareResultSet&gt;): void
查询数据库中的数据。使用callback异步回调。 查询数据库中的数据。使用callback异步回调。
...@@ -768,28 +798,31 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt; ...@@ -768,28 +798,31 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要查询的数据的路径。 | | uri | string | 是 | 指示要查询的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />query接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB目前仅支持inKeys和prefixKey。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />query接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB目前仅支持inKeys和prefixKey。 |
| columns | Array&lt;string&gt; | 是 | 指示要查询的列。如果此参数为空,则查询所有列。 | | columns | Array&lt;string&gt; | 是 | 指示要查询的列。如果此参数为空,则查询所有列。 |
| callback | AsyncCallback&lt;[DataShareResultSet](js-apis-data-DataShareResultSet.md#datashareresultset)&gt; | 是 | 回调函数。返回查询到的结果集。 | | callback | AsyncCallback&lt;[DataShareResultSet](js-apis-data-DataShareResultSet.md#datashareresultset)&gt; | 是 | 回调函数。返回查询到的结果集。 |
**示例:** **示例:**
```ts ```ts
import dataSharePredicates from '@ohos.data.dataSharePredicates'
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let columns = ["*"]; let columns = ["*"];
let da = new dataShare.DataSharePredicates(); let da = new dataSharePredicates.DataSharePredicates();
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
dataShareHelper.query(uri, da, columns, (err, data) => { dataShareHelper.query(uri, da, columns, (err, data) => {
if (err != undefined) { if (err != undefined) {
console.log("query failed, error message : " + err); console.log("query failed, error message : " + err);
}else{ }else{
console.log("query succeed, ret : " + data.rowCount); console.log("query succeed, rowCount : " + data.rowCount);
} }
}); });
``` ```
### query ### query
query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;): Promise&lt;DataShareResultSet&gt; query(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array&lt;string&gt;): Promise&lt;DataShareResultSet&gt;
查询数据库中的数据。使用Promise异步回调。 查询数据库中的数据。使用Promise异步回调。
...@@ -800,7 +833,7 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt; ...@@ -800,7 +833,7 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;
| 名称 | 类型 | 必填 | 描述 | | 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| uri | string | 是 | 指示要查询的数据的路径。 | | uri | string | 是 | 指示要查询的数据的路径。 |
| predicates | [DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />query接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB目前仅支持inKeys和prefixKey。 | | predicates | [dataSharePredicates.DataSharePredicates](js-apis-data-DataSharePredicates.md#datasharepredicates) | 是 | 指示筛选条件。<br />query接口所支持的谓词方法取决于服务端所选用的数据库,如KVDB目前仅支持inKeys和prefixKey。 |
| columns | Array&lt;string&gt; | 是 | 指示要查询的列。如果此参数为空,则查询所有列。 | | columns | Array&lt;string&gt; | 是 | 指示要查询的列。如果此参数为空,则查询所有列。 |
**返回值:** **返回值:**
...@@ -812,11 +845,14 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt; ...@@ -812,11 +845,14 @@ query(uri: string, predicates: DataSharePredicates, columns: Array&lt;string&gt;
**示例:** **示例:**
```ts ```ts
import dataSharePredicates from '@ohos.data.dataSharePredicates'
let uri = ("datashare:///com.samples.datasharetest.DataShare");
let columns = ["*"]; let columns = ["*"];
let da = new dataShare.DataSharePredicates(); let da = new dataSharePredicates.DataSharePredicates();
da.equalTo("name", "ZhangSan"); da.equalTo("name", "ZhangSan");
dataShareHelper.query(uri, da, columns).then((data) => { dataShareHelper.query(uri, da, columns).then((data) => {
console.log("query succeed, ret : " + data.rowCount); console.log("query succeed, rowCount : " + data.rowCount);
}).catch((err) => { }).catch((err) => {
console.log("query failed, error message : " + err); console.log("query failed, error message : " + err);
}); });
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册