js-apis-dataAbilityHelper.md 33.4 KB
Newer Older
Z
zengyawen 已提交
1 2
# DataAbilityHelper模块(JS端SDK接口)

Y
yuyaozhi 已提交
3 4
> **说明:**
> 
5 6
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。  
> 本模块接口仅可在FA模型下使用。
7

8 9 10
## 使用说明

使用前根据具体情况引入如下模块
X
xuchenghua09 已提交
11 12
```
import featureAbility from '@ohos.ability.featureAbility'
Y
yuyaozhi 已提交
13
import ohos_data_ability from '@ohos.data.dataAbility'
X
xuchenghua09 已提交
14 15 16
import ohos_data_rdb from '@ohos.data.rdb'
```

Y
yuyaozhi 已提交
17
## DataAbilityHelper.openFile
X
xuchenghua09 已提交
18

Z
zengyawen 已提交
19
openFile(uri: string, mode: string, callback: AsyncCallback\<number>): void
X
xuchenghua09 已提交
20

Z
zengyawen 已提交
21
在指定的远程路径中打开文件(callback形式)。
X
xuchenghua09 已提交
22

Y
yuyaozhi 已提交
23
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
24

Z
zengyawen 已提交
25
**参数:**
X
xuchenghua09 已提交
26

Z
zengyawen 已提交
27 28 29 30 31
| 名称     | 类型                   | 必填 | 描述                               |
| -------- | ---------------------- | ---- | ---------------------------------- |
| uri      | string                 | 是   | 指示要打开的文件的路径。           |
| mode     | string                 | 是   | 指示文件打开模式‘rwt’。            |
| callback | AsyncCallback\<number> | 是   | 被指定的回调方法,返回文件描述符。 |
X
xuchenghua09 已提交
32

Z
zengyawen 已提交
33
**示例:**
X
xuchenghua09 已提交
34 35 36 37 38 39 40 41 42 43 44 45 46 47 48

```javascript
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
var mode = "rwt";
DAHelper.openFile(
    "dataability:///com.example.DataAbility",
    mode,
    (err) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
49
## DataAbilityHelper.openFile
X
xuchenghua09 已提交
50

Z
zengyawen 已提交
51
openFile(uri: string, mode: string): Promise\<number>
X
xuchenghua09 已提交
52

W
wusongqing 已提交
53 54
在指定的远程路径中打开文件(promise形式)。

Y
yuyaozhi 已提交
55
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
56

Z
zengyawen 已提交
57
**参数:**
X
xuchenghua09 已提交
58

Z
zengyawen 已提交
59 60 61 62
| 名称 | 类型   | 必填 | 描述                     |
| ---- | ------ | ---- | ------------------------ |
| uri  | string | 是   | 指示要打开的文件的路径。 |
| mode | string | 是   | 指示文件打开模式‘rwt’。  |
X
xuchenghua09 已提交
63

Z
zengyawen 已提交
64
**返回值:**
Y
yuyaozhi 已提交
65

Z
zengyawen 已提交
66 67 68
| 类型             | 说明             |
| ---------------- | ---------------- |
| Promise\<number> | 返回文件描述符。 |
X
xuchenghua09 已提交
69

Z
zengyawen 已提交
70
**示例:**
X
xuchenghua09 已提交
71 72 73 74 75 76 77 78

```javascript
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
var mode = "rwt";
DAHelper.openFile(
ahjxliubao2's avatar
ahjxliubao2 已提交
79 80
    "dataability:///com.example.DataAbility",
    mode).then((data) => {
X
xuchenghua09 已提交
81 82 83 84
		console.info("==========================>openFileCallback=======================>");
});
```

Y
yuyaozhi 已提交
85
## DataAbilityHelper.on
X
xuchenghua09 已提交
86

Z
zengyawen 已提交
87
on(type: 'dataChange', uri: string, callback: AsyncCallback\<void>): void
X
xuchenghua09 已提交
88

Z
zengyawen 已提交
89
注册观察者以观察给定uri指定的数据callback通知。
X
xuchenghua09 已提交
90

Y
yuyaozhi 已提交
91
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
92

Z
zengyawen 已提交
93
**参数:**
X
xuchenghua09 已提交
94

Z
zengyawen 已提交
95 96 97 98 99
| 名称     | 类型                 | 必填 | 描述                     |
| -------- | -------------------- | ---- | ------------------------ |
| type     | string               | 是   | 数据更改。               |
| uri      | string               | 是   | 指示要操作的数据的路径。 |
| callback | AsyncCallback\<void> | 是   | 指示数据更改时的回调。   |
X
xuchenghua09 已提交
100

Z
zengyawen 已提交
101
**示例:**
X
xuchenghua09 已提交
102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117

```js
import featureAbility from '@ohos.ability.featureAbility'
var helper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
function onChangeNotify() {
    console.info("==========================>onChangeNotify=======================>");
};
helper.on(
    "dataChange",
    "dataability:///com.example.DataAbility",
    onChangeNotify
)
```

Y
yuyaozhi 已提交
118
## DataAbilityHelper.off
X
xuchenghua09 已提交
119

Z
zengyawen 已提交
120
off(type: 'dataChange', uri: string, callback?: AsyncCallback\<void>): void
X
xuchenghua09 已提交
121

Z
zengyawen 已提交
122
注消观察者以停止观察给定uri指定的数据callback通知。
X
xuchenghua09 已提交
123

Y
yuyaozhi 已提交
124
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
125

Z
zengyawen 已提交
126
**参数:**
X
xuchenghua09 已提交
127

Z
zengyawen 已提交
128 129 130 131 132
| 名称     | 类型                 | 必填 | 描述                     |
| -------- | -------------------- | ---- | ------------------------ |
| type     | string               | 是   | 数据更改。               |
| uri      | string               | 是   | 指示要操作的数据的路径。 |
| callback | AsyncCallback\<void> | 否   | 指示已注册的回调。       |
X
xuchenghua09 已提交
133

Z
zengyawen 已提交
134
**示例:**
X
xuchenghua09 已提交
135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154

```js
import featureAbility from '@ohos.ability.featureAbility'
var helper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
function onChangeNotify() {
    console.info("==========================>onChangeNotify=======================>");
};
helper.off(
    "dataChange",
    "dataability:///com.example.DataAbility",
)
helper.off(
    "dataChange",
    "dataability:///com.example.DataAbility",
    onChangeNotify
)
```

Y
yuyaozhi 已提交
155
## DataAbilityHelper.getType
X
xuchenghua09 已提交
156

Z
zengyawen 已提交
157
getType(uri: string, callback: AsyncCallback\<string>): void
X
xuchenghua09 已提交
158

Z
zengyawen 已提交
159
获取给定URI指定数据的MIME类型(callback形式)。
X
xuchenghua09 已提交
160

Y
yuyaozhi 已提交
161
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
162

Z
zengyawen 已提交
163
**参数:**
X
xuchenghua09 已提交
164

Z
zengyawen 已提交
165 166 167 168
| 名称     | 类型                   | 必填 | 描述                                          |
| -------- | ---------------------- | ---- | --------------------------------------------- |
| uri      | string                 | 是   | 指示要操作的数据的路径。                      |
| callback | AsyncCallback\<string> | 是   | 回调方法,返回与uri指定的数据匹配的MIME类型。 |
X
xuchenghua09 已提交
169

Z
zengyawen 已提交
170
**示例:**
X
xuchenghua09 已提交
171 172 173 174 175 176 177 178 179 180 181 182 183

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.getType(
    "dataability:///com.example.DataAbility",
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
184
## DataAbilityHelper.getType
X
xuchenghua09 已提交
185

Z
zengyawen 已提交
186
getType(uri: string): Promise\<string>
X
xuchenghua09 已提交
187

Z
zengyawen 已提交
188
获取给定URI指定数据的MIME类型(Promise形式)。
X
xuchenghua09 已提交
189

Y
yuyaozhi 已提交
190
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
191

Z
zengyawen 已提交
192
**参数:**
X
xuchenghua09 已提交
193

Z
zengyawen 已提交
194 195 196
| 名称 | 类型   | 必填 | 描述                     |
| ---- | ------ | ---- | ------------------------ |
| uri  | string | 是   | 指示要操作的数据的路径。 |
X
xuchenghua09 已提交
197

Z
zengyawen 已提交
198
**返回值:**
Y
yuyaozhi 已提交
199

Z
zengyawen 已提交
200 201 202
| 类型             | 说明                                |
| ---------------- | ----------------------------------- |
| Promise\<string> | 返回与uri指定的数据匹配的MIME类型。 |
X
xuchenghua09 已提交
203

Z
zengyawen 已提交
204
**示例:**
X
xuchenghua09 已提交
205 206 207 208 209 210 211 212 213 214 215 216 217

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.getType(
    "dataability:///com.example.DataAbility"
	).then((data) => {
		console.info("==========================>getTypeCallback=======================>");
});
```

Y
yuyaozhi 已提交
218
## DataAbilityHelper.getFileTypes
X
xuchenghua09 已提交
219

Z
zengyawen 已提交
220
getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array\<string>>): void
X
xuchenghua09 已提交
221

Z
zengyawen 已提交
222
获取支持的文件的MIME类型(callback形式)。
X
xuchenghua09 已提交
223

Y
yuyaozhi 已提交
224
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
225

Z
zengyawen 已提交
226
**参数:**
X
xuchenghua09 已提交
227

Z
zengyawen 已提交
228 229 230 231 232
| 名称           | 类型                           | 必填 | 描述                               |
| -------------- | ------------------------------ | ---- | ---------------------------------- |
| uri            | string                         | 是   | 指示要获取的文件的路径。           |
| mimeTypeFilter | string                         | 是   | 指示要获取的文件的MIME类型。       |
| callback       | AsyncCallback\<Array\<string>> | 是   | 回调方法,返回匹配的MIME类型数组。 |
X
xuchenghua09 已提交
233

Z
zengyawen 已提交
234
**示例:**
X
xuchenghua09 已提交
235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.getFileTypes(
    "dataability:///com.example.DataAbility",
    "image/*",
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```



Y
yuyaozhi 已提交
251
## DataAbilityHelper.getFileTypes
Z
zengyawen 已提交
252 253

getFileTypes(uri: string, mimeTypeFilter: string): Promise\<Array\<string>>
X
xuchenghua09 已提交
254

Z
zengyawen 已提交
255
获取支持的文件的MIME类型(Promise形式)。
X
xuchenghua09 已提交
256

Y
yuyaozhi 已提交
257
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
258

Z
zengyawen 已提交
259
**参数:**
X
xuchenghua09 已提交
260

Z
zengyawen 已提交
261 262 263 264
| 名称           | 类型   | 必填 | 描述                         |
| -------------- | ------ | ---- | ---------------------------- |
| uri            | string | 是   | 指示要获取的文件的路径。     |
| mimeTypeFilter | string | 是   | 指示要获取的文件的MIME类型。 |
X
xuchenghua09 已提交
265

Z
zengyawen 已提交
266
**返回值:**
Y
yuyaozhi 已提交
267

Z
zengyawen 已提交
268 269 270
| 类型                     | 说明                     |
| ------------------------ | ------------------------ |
| Promise\<Array\<string>> | 返回匹配的MIME类型数组。 |
X
xuchenghua09 已提交
271

Z
zengyawen 已提交
272
**示例:**
X
xuchenghua09 已提交
273 274 275 276 277 278 279 280 281 282 283 284 285 286

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.getFileTypes(
    "dataability:///com.example.DataAbility",
    "image/*"
	).then((data) => {
		console.info("==========================>getFileTypesCallback=======================>");
});
```

Y
yuyaozhi 已提交
287
## DataAbilityHelper.normalizeUri
X
xuchenghua09 已提交
288

Z
zengyawen 已提交
289
normalizeUri(uri: string, callback: AsyncCallback\<string>): void
X
xuchenghua09 已提交
290

Z
zengyawen 已提交
291
将引用数据功能的给定uri转换为规范化uri(callback形式)。
X
xuchenghua09 已提交
292

Y
yuyaozhi 已提交
293
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
294

Z
zengyawen 已提交
295
**参数:**
X
xuchenghua09 已提交
296

Z
zengyawen 已提交
297 298 299
| 名称     | 类型                   | 必填 | 描述                                                         |
| -------- | ---------------------- | ---- | ------------------------------------------------------------ |
| uri      | string                 | 是   | 指示要规范化的uri对象。                                      |
W
wusongqing 已提交
300
| callback | AsyncCallback\<string> | 是   | 回调方法。如果数据功能支持uri规范化,则返回规范化uri对象;否则返回null。 |
X
xuchenghua09 已提交
301

Z
zengyawen 已提交
302
**示例:**
X
xuchenghua09 已提交
303 304 305 306 307 308 309 310 311 312 313 314 315

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.normalizeUri(
    "dataability:///com.example.DataAbility",
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
316
## DataAbilityHelper.normalizeUri
X
xuchenghua09 已提交
317

Z
zengyawen 已提交
318
normalizeUri(uri: string): Promise\<string>
X
xuchenghua09 已提交
319

Z
zengyawen 已提交
320
将引用数据功能的给定uri转换为规范化uri(Promise形式)。
X
xuchenghua09 已提交
321

Y
yuyaozhi 已提交
322
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
323

Z
zengyawen 已提交
324
**参数:**
X
xuchenghua09 已提交
325

Z
zengyawen 已提交
326 327 328
| 名称 | 类型   | 必填 | 描述                    |
| ---- | ------ | ---- | ----------------------- |
| uri  | string | 是   | 指示要规范化的uri对象。 |
X
xuchenghua09 已提交
329

Z
zengyawen 已提交
330
**返回值:**
Y
yuyaozhi 已提交
331

Z
zengyawen 已提交
332 333
| 类型             | 说明                                                   |
| ---------------- | ------------------------------------------------------ |
W
wusongqing 已提交
334
| Promise\<string> | 如果数据功能支持uri规范化,则返回规范化uri对象;否则返回null。 |
X
xuchenghua09 已提交
335

Z
zengyawen 已提交
336
**示例:**
X
xuchenghua09 已提交
337 338 339 340 341 342 343 344 345 346 347 348 349

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.normalizeUri(
    "dataability:///com.example.DataAbility",
	).then((data) => {
		console.info("==========================>normalizeUriCallback=======================>");
});
```

Y
yuyaozhi 已提交
350
## DataAbilityHelper.denormalizeUri
X
xuchenghua09 已提交
351

Z
zengyawen 已提交
352
denormalizeUri(uri: string, callback: AsyncCallback\<string>): void
X
xuchenghua09 已提交
353

Z
zengyawen 已提交
354
将由normalizeUri(uri)生成的给定规范化uri转换为非规范化uri(callback形式)。
X
xuchenghua09 已提交
355

Y
yuyaozhi 已提交
356
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
357

Z
zengyawen 已提交
358
**参数:**
X
xuchenghua09 已提交
359

Z
zengyawen 已提交
360 361 362 363
| 名称     | 类型                   | 必填 | 描述                                                |
| -------- | ---------------------- | ---- | --------------------------------------------------- |
| uri      | string                 | 是   | 指示要规范化的uri对象。                             |
| callback | AsyncCallback\<string> | 是   | 回调方法。如果反规范化成功,则返回反规范化uri对象。 |
X
xuchenghua09 已提交
364

Z
zengyawen 已提交
365
**示例:**
X
xuchenghua09 已提交
366 367 368 369 370 371 372

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.denormalizeUri(
ahjxliubao2's avatar
ahjxliubao2 已提交
373
    "dataability:///com.example.DataAbility",
X
xuchenghua09 已提交
374 375 376 377 378 379 380
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```



Y
yuyaozhi 已提交
381
## DataAbilityHelper.denormalizeUri
X
xuchenghua09 已提交
382

Z
zengyawen 已提交
383
denormalizeUri(uri: string): Promise\<string>
X
xuchenghua09 已提交
384

Z
zengyawen 已提交
385
将由normalizeUri(uri)生成的给定规范化uri转换为非规范化uri(Promise形式)。
X
xuchenghua09 已提交
386

Y
yuyaozhi 已提交
387
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
388

Z
zengyawen 已提交
389
**参数:**
X
xuchenghua09 已提交
390

Z
zengyawen 已提交
391 392 393
| 名称 | 类型   | 必填 | 描述                    |
| ---- | ------ | ---- | ----------------------- |
| uri  | string | 是   | 指示要规范化的uri对象。 |
X
xuchenghua09 已提交
394

Z
zengyawen 已提交
395
**返回值:**
Y
yuyaozhi 已提交
396

Z
zengyawen 已提交
397 398 399 400 401
| 类型             | 说明                                      |
| ---------------- | ----------------------------------------- |
| Promise\<string> | 如果反规范化成功,则返回反规范化uri对象。 |

**示例:**
X
xuchenghua09 已提交
402 403 404 405 406 407 408 409 410 411 412 413 414

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.denormalizeUri(
    "dataability:///com.example.DataAbility",
	).then((data) => {
		console.info("==========================>denormalizeUriCallback=======================>");
});
```

Y
yuyaozhi 已提交
415
## DataAbilityHelper.notifyChange
X
xuchenghua09 已提交
416

Z
zengyawen 已提交
417
notifyChange(uri: string, callback: AsyncCallback\<void>): void
X
xuchenghua09 已提交
418

Z
zengyawen 已提交
419
通知已注册的观察者uri指定的数据资源的更改(callback形式)。
X
xuchenghua09 已提交
420

Y
yuyaozhi 已提交
421
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
422

Z
zengyawen 已提交
423
**参数:**
X
xuchenghua09 已提交
424

Z
zengyawen 已提交
425 426 427 428
| 名称     | 类型                 | 必填 | 描述                     |
| -------- | -------------------- | ---- | ------------------------ |
| uri      | string               | 是   | 指示要操作的数据的路径。 |
| callback | AsyncCallback\<void> | 是   | 回调方法。               |
X
xuchenghua09 已提交
429

Z
zengyawen 已提交
430
**示例:**
X
xuchenghua09 已提交
431 432 433 434 435 436 437

```js
import featureAbility from '@ohos.ability.featureAbility'
var helper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
helper.notifyChange(
ahjxliubao2's avatar
ahjxliubao2 已提交
438
    "dataability:///com.example.DataAbility",
X
xuchenghua09 已提交
439 440 441 442 443
    (err) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
444
## DataAbilityHelper.notifyChange
X
xuchenghua09 已提交
445

Z
zengyawen 已提交
446
notifyChange(uri: string): Promise\<void>
X
xuchenghua09 已提交
447

Z
zengyawen 已提交
448
通知已注册的观察者uri指定的数据资源的更改(Promise形式)。
X
xuchenghua09 已提交
449

Y
yuyaozhi 已提交
450
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
451

Z
zengyawen 已提交
452
**参数:**
X
xuchenghua09 已提交
453

Z
zengyawen 已提交
454 455 456
| 名称 | 类型   | 必填 | 描述                     |
| ---- | ------ | ---- | ------------------------ |
| uri  | string | 是   | 指示要操作的数据的路径。 |
X
xuchenghua09 已提交
457

Z
zengyawen 已提交
458
**返回值:**
Y
yuyaozhi 已提交
459

Z
zengyawen 已提交
460 461 462
| 类型           | 说明                  |
| -------------- | --------------------- |
| Promise\<void> | 返回值为Promise对象。 |
X
xuchenghua09 已提交
463

Z
zengyawen 已提交
464
**示例:**
X
xuchenghua09 已提交
465 466 467 468 469 470 471 472

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
DAHelper.notifyChange(
    "dataability:///com.example.DataAbility",
ahjxliubao2's avatar
ahjxliubao2 已提交
473
	).then(() => {
X
xuchenghua09 已提交
474 475 476 477
		console.info("==========================>notifyChangeCallback=======================>");
});
```

Y
yuyaozhi 已提交
478
## DataAbilityHelper.insert
X
xuchenghua09 已提交
479

Z
zengyawen 已提交
480
insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<number>): void
X
xuchenghua09 已提交
481

Z
zengyawen 已提交
482
将单个数据记录插入数据库(callback形式)。
X
xuchenghua09 已提交
483

Y
yuyaozhi 已提交
484
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
485

Z
zengyawen 已提交
486
**参数:**
X
xuchenghua09 已提交
487

Z
zengyawen 已提交
488 489 490 491 492
| 名称         | 类型                   | 必填 | 描述                                                   |
| ------------ | ---------------------- | ---- | ------------------------------------------------------ |
| uri          | string                 | 是   | 指示要插入的数据的路径。                               |
| valuesBucket | rdb.ValuesBucket       | 是   | 指示要插入的数据记录。如果此参数为空,将插入一个空行。 |
| callback     | AsyncCallback\<number> | 是   | 回调方法,返回插入数据记录的索引。                     |
X
xuchenghua09 已提交
493

Z
zengyawen 已提交
494
**示例:**
X
xuchenghua09 已提交
495 496 497 498 499 500 501 502 503 504

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
const valueBucket = {
    "name": "rose",
    "age": 22,
    "salary": 200.5,
Y
yuyaozhi 已提交
505
    "blobType": "u8",
X
xuchenghua09 已提交
506 507 508 509 510 511 512 513 514
}
DAHelper.insert(
    "dataability:///com.example.DataAbility",
    valueBucket,
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
515
## DataAbilityHelper.insert
X
xuchenghua09 已提交
516

Z
zengyawen 已提交
517
insert(uri: string, valuesBucket: rdb.ValuesBucket): Promise\<number>
X
xuchenghua09 已提交
518

Z
zengyawen 已提交
519
将单个数据记录插入数据库(Promise形式)。
X
xuchenghua09 已提交
520

Y
yuyaozhi 已提交
521
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
522

Z
zengyawen 已提交
523
**参数:**
X
xuchenghua09 已提交
524

Z
zengyawen 已提交
525 526 527 528
| 名称         | 类型             | 必填 | 描述                                                   |
| ------------ | ---------------- | ---- | ------------------------------------------------------ |
| uri          | string           | 是   | 指示要插入的数据的路径。                               |
| valuesBucket | rdb.ValuesBucket | 是   | 指示要插入的数据记录。如果此参数为空,将插入一个空行。 |
X
xuchenghua09 已提交
529

Z
zengyawen 已提交
530
**返回值:**
Y
yuyaozhi 已提交
531

Z
zengyawen 已提交
532 533 534
| 类型             | 说明                     |
| ---------------- | ------------------------ |
| Promise\<number> | 返回插入数据记录的索引。 |
X
xuchenghua09 已提交
535

Z
zengyawen 已提交
536
**示例:**
X
xuchenghua09 已提交
537 538 539 540 541 542 543 544 545 546

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
const valueBucket = {
    "name": "rose1",
    "age": 221,
    "salary": 20.5,
Y
yuyaozhi 已提交
547
    "blobType": "u8",
X
xuchenghua09 已提交
548 549 550 551 552 553 554 555 556
}
DAHelper.insert(
    "dataability:///com.example.DataAbility",
    valueBucket
	).then((data) => {
		console.info("==========================>insertCallback=======================>");
});
```

Y
yuyaozhi 已提交
557
## DataAbilityHelper.batchInsert
X
xuchenghua09 已提交
558

Z
zengyawen 已提交
559
batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback\<number>): void
X
xuchenghua09 已提交
560

Z
zengyawen 已提交
561
插入数据库(callback形式)。
X
xuchenghua09 已提交
562

Y
yuyaozhi 已提交
563
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
564

Z
zengyawen 已提交
565
**参数:**
X
xuchenghua09 已提交
566

Z
zengyawen 已提交
567 568 569 570 571
| 名称         | 类型                    | 必填 | 描述                             |
| ------------ | ----------------------- | ---- | -------------------------------- |
| uri          | string                  | 是   | 指示要插入的数据的路径。         |
| valuesBucket | Array<rdb.ValuesBucket> | 是   | 指示要插入的数据记录。           |
| callback     | AsyncCallback\<number>  | 是   | 回调方法。返回插入的数据记录数。 |
X
xuchenghua09 已提交
572

Z
zengyawen 已提交
573
**示例:**
X
xuchenghua09 已提交
574 575 576 577 578 579

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
Y
yuyaozhi 已提交
580 581 582
var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": "u8",},
                     {"name": "roe12", "age": 21, "salary": 20.5, "blobType": "u8",},
                     {"name": "roe13", "age": 21, "salary": 20.5, "blobType": "u8",})
X
xuchenghua09 已提交
583 584 585 586 587 588 589 590
DAHelper.batchInsert(
    "dataability:///com.example.DataAbility",
    cars,
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
591
## DataAbilityHelper.batchInsert
X
xuchenghua09 已提交
592

Z
zengyawen 已提交
593
batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>): Promise\<number>
X
xuchenghua09 已提交
594

Z
zengyawen 已提交
595
将多个数据记录插入数据库(Promise形式)。
X
xuchenghua09 已提交
596

Y
yuyaozhi 已提交
597
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
598

Z
zengyawen 已提交
599
**参数:**
X
xuchenghua09 已提交
600

Z
zengyawen 已提交
601 602 603 604
| 名称         | 类型                    | 必填 | 描述                     |
| ------------ | ----------------------- | ---- | ------------------------ |
| uri          | string                  | 是   | 指示要插入的数据的路径。 |
| valuesBucket | Array<rdb.ValuesBucket> | 是   | 指示要插入的数据记录。   |
X
xuchenghua09 已提交
605

Z
zengyawen 已提交
606
**返回值:**
Y
yuyaozhi 已提交
607

Z
zengyawen 已提交
608 609 610
| 类型             | 说明                   |
| ---------------- | ---------------------- |
| Promise\<number> | 返回插入的数据记录数。 |
X
xuchenghua09 已提交
611

Z
zengyawen 已提交
612
**示例:**
X
xuchenghua09 已提交
613 614 615 616 617 618

```js
import featureAbility from '@ohos.ability.featureAbility'
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
Y
yuyaozhi 已提交
619 620 621
var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": "u8",},
                     {"name": "roe12", "age": 21, "salary": 20.5, "blobType": "u8",},
                     {"name": "roe13", "age": 21, "salary": 20.5, "blobType": "u8",})
X
xuchenghua09 已提交
622 623 624 625 626 627 628 629
DAHelper.batchInsert(
    "dataability:///com.example.DataAbility",
    cars
	).then((data) => {
		console.info("==========================>batchInsertCallback=======================>");
});
```

Y
yuyaozhi 已提交
630
## DataAbilityHelper.delete
X
xuchenghua09 已提交
631

Z
zengyawen 已提交
632
delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>): void
X
xuchenghua09 已提交
633

Z
zengyawen 已提交
634
从数据库中删除一个或多个数据记录(callback形式)。
X
xuchenghua09 已提交
635

Y
yuyaozhi 已提交
636
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
637

Z
zengyawen 已提交
638
**参数:**
X
xuchenghua09 已提交
639

Z
zengyawen 已提交
640 641 642 643 644
| 名称         | 类型                              | 必填 | 描述                                             |
| ------------ | --------------------------------- | ---- | ------------------------------------------------ |
| uri          | string                            | 是   | 指示要删除的数据的路径。                         |
| valuesBucket | dataAbility.DataAbilityPredicates | 是   | 指示筛选条件。当此参数为null时,应定义处理逻辑。 |
| callback     | AsyncCallback\<number>            | 是   | 回调方法。返回已删除的数据记录数。               |
X
xuchenghua09 已提交
645

Z
zengyawen 已提交
646
**示例:**
X
xuchenghua09 已提交
647 648 649

```js
import featureAbility from '@ohos.ability.featureAbility'
Y
yuyaozhi 已提交
650
import ohos_data_ability from '@ohos.data.dataAbility'
X
xuchenghua09 已提交
651 652 653 654 655 656 657 658 659 660 661 662
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.delete(
    "dataability:///com.example.DataAbility",
    da,
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
663
## DataAbilityHelper.delete
X
xuchenghua09 已提交
664

665
delete(uri: string, predicates?: dataAbility.DataAbilityPredicates): Promise\<number>;
X
xuchenghua09 已提交
666

Z
zengyawen 已提交
667
从数据库中删除一个或多个数据记录(Promise形式)。
X
xuchenghua09 已提交
668

Y
yuyaozhi 已提交
669
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
670

Z
zengyawen 已提交
671
**参数:**
X
xuchenghua09 已提交
672

Z
zengyawen 已提交
673 674 675 676
| 名称         | 类型                              | 必填 | 描述                                             |
| ------------ | --------------------------------- | ---- | ------------------------------------------------ |
| uri          | string                            | 是   | 指示要删除的数据的路径。                         |
| valuesBucket | dataAbility.DataAbilityPredicates | 是   | 指示筛选条件。当此参数为null时,应定义处理逻辑。 |
X
xuchenghua09 已提交
677

Z
zengyawen 已提交
678
**返回值:**
Y
yuyaozhi 已提交
679

Z
zengyawen 已提交
680 681 682
| 类型             | 说明                     |
| ---------------- | ------------------------ |
| Promise\<number> | 返回已删除的数据记录数。 |
X
xuchenghua09 已提交
683

Z
zengyawen 已提交
684
**示例:**
X
xuchenghua09 已提交
685 686 687

```js
import featureAbility from '@ohos.ability.featureAbility'
Y
yuyaozhi 已提交
688
import ohos_data_ability from '@ohos.dataAbility'
X
xuchenghua09 已提交
689 690 691 692 693 694 695 696 697 698 699 700
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.delete(
    "dataability:///com.example.DataAbility",
    da
	).then((data) => {
		console.info("==========================>deleteCallback=======================>");
});
```

Y
yuyaozhi 已提交
701
## DataAbilityHelper.update
X
xuchenghua09 已提交
702

Z
zengyawen 已提交
703
update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>): void
X
xuchenghua09 已提交
704

Z
zengyawen 已提交
705
更新数据库中的数据记录(callback形式)。
X
xuchenghua09 已提交
706

Y
yuyaozhi 已提交
707
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
708

Z
zengyawen 已提交
709
**参数:**
X
xuchenghua09 已提交
710

Z
zengyawen 已提交
711 712 713 714 715 716
| 名称         | 类型                              | 必填 | 描述                                             |
| ------------ | --------------------------------- | ---- | ------------------------------------------------ |
| uri          | string                            | 是   | 指示要更新的数据的路径。                         |
| valuesBucket | rdb.ValuesBucket                  | 是   | 指示要更新的数据。                               |
| predicates   | dataAbility.DataAbilityPredicates | 是   | 指示筛选条件。当此参数为null时,应定义处理逻辑。 |
| callback     | AsyncCallback\<number>            | 是   | 回调方法,返回更新的数据记录数。                 |
X
xuchenghua09 已提交
717

Z
zengyawen 已提交
718
**示例:**
X
xuchenghua09 已提交
719 720 721

```js
import featureAbility from '@ohos.ability.featureAbility'
Y
yuyaozhi 已提交
722
import ohos_data_ability from '@ohos.data.dataAbility'
X
xuchenghua09 已提交
723 724 725 726 727 728 729
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
const va = {
    "name": "roe1",
    "age": 21,
    "salary": 20.5,
Y
yuyaozhi 已提交
730
    "blobType": "u8",
X
xuchenghua09 已提交
731 732 733 734 735 736 737 738 739 740 741
}
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.update(
    "dataability:///com.example.DataAbility",
    va,
    da,
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```

Y
yuyaozhi 已提交
742
## DataAbilityHelper.update
X
xuchenghua09 已提交
743

744
update(uri: string, valuesBucket: rdb.ValuesBucket, predicates?: dataAbility.DataAbilityPredicates): Promise\<number>;
X
xuchenghua09 已提交
745

Z
zengyawen 已提交
746
更新数据库中的数据记录(Promise形式)。
X
xuchenghua09 已提交
747

Y
yuyaozhi 已提交
748
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
749

Z
zengyawen 已提交
750
**参数:**
X
xuchenghua09 已提交
751

Z
zengyawen 已提交
752 753 754 755 756
| 名称         | 类型                              | 必填 | 描述                                             |
| ------------ | --------------------------------- | ---- | ------------------------------------------------ |
| uri          | string                            | 是   | 指示要更新的数据的路径。                         |
| valuesBucket | rdb.ValuesBucket                  | 是   | 指示要更新的数据。                               |
| predicates   | dataAbility.DataAbilityPredicates | 是   | 指示筛选条件。当此参数为null时,应定义处理逻辑。 |
X
xuchenghua09 已提交
757

Z
zengyawen 已提交
758
**返回值:**
Y
yuyaozhi 已提交
759

Z
zengyawen 已提交
760 761
| 类型             | 说明                                         |
| ---------------- | -------------------------------------------- |
W
wusongqing 已提交
762
| Promise\<number> | Promise中包含更新的数据记录数。 。 |
X
xuchenghua09 已提交
763

Z
zengyawen 已提交
764
**示例:**
X
xuchenghua09 已提交
765 766 767

```js
import featureAbility from '@ohos.ability.featureAbility'
Y
yuyaozhi 已提交
768
import ohos_data_ability from '@ohos.data.dataAbility'
X
xuchenghua09 已提交
769 770 771 772 773 774 775
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
const va = {
    "name": "roe1",
    "age": 21,
    "salary": 20.5,
Y
yuyaozhi 已提交
776
    "blobType": "u8",
X
xuchenghua09 已提交
777 778 779 780 781 782 783 784 785 786 787
}
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.update(
    "dataability:///com.example.DataAbility",
    va,
    da
	).then((data) => {
		console.info("==========================>updateCallback=======================>");
});
```

Y
yuyaozhi 已提交
788
## DataAbilityHelper.query
X
xuchenghua09 已提交
789

Z
zengyawen 已提交
790
query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<ResultSet>): void
X
xuchenghua09 已提交
791

Z
zengyawen 已提交
792
查询数据库中的数据(callback形式)。
X
xuchenghua09 已提交
793

Y
yuyaozhi 已提交
794
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
795

Z
zengyawen 已提交
796
**参数:**
X
xuchenghua09 已提交
797

Z
zengyawen 已提交
798 799 800 801 802 803
| 名称       | 类型                              | 必填 | 描述                                             |
| ---------- | --------------------------------- | ---- | ------------------------------------------------ |
| uri        | string                            | 是   | 指示要查询的数据的路径。                         |
| columns    | rdb.ValuesBucket                  | 是   | 指示要查询的列。如果此参数为空,则查询所有列。   |
| predicates | dataAbility.DataAbilityPredicates | 是   | 指示筛选条件。当此参数为null时,应定义处理逻辑。 |
| callback   | AsyncCallback\<ResultSet>         | 是   | 回调方法,返回查询结果。                         |
X
xuchenghua09 已提交
804

Z
zengyawen 已提交
805
**示例:**
X
xuchenghua09 已提交
806 807 808

```js
import featureAbility from '@ohos.ability.featureAbility'
Y
yuyaozhi 已提交
809
import ohos_data_ability from '@ohos.data.dataAbility'
X
xuchenghua09 已提交
810 811 812
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
ahjxliubao2's avatar
ahjxliubao2 已提交
813
var cars=new Array("value1", "value2", "value3", "value4");
X
xuchenghua09 已提交
814 815 816 817 818 819 820 821 822 823 824 825
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.query(
    "dataability:///com.example.DataAbility",
    cars,
    da,
    (err, data) => {
		console.info("==========================>Called=======================>");
});
```



Y
yuyaozhi 已提交
826
## DataAbilityHelper.query
X
xuchenghua09 已提交
827

828
query(uri: string, columns?: Array<string>, predicates?: dataAbility.DataAbilityPredicates): Promise\<ResultSet>;
X
xuchenghua09 已提交
829

Z
zengyawen 已提交
830
查询数据库中的数据(Promise形式)。
X
xuchenghua09 已提交
831

Y
yuyaozhi 已提交
832
**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel
ahjxliubao2's avatar
ahjxliubao2 已提交
833

Z
zengyawen 已提交
834
**参数:**
X
xuchenghua09 已提交
835

Z
zengyawen 已提交
836 837 838 839 840
| 名称       | 类型                              | 必填 | 描述                                             |
| ---------- | --------------------------------- | ---- | ------------------------------------------------ |
| uri        | string                            | 是   | 指示要查询的数据的路径。                         |
| columns    | rdb.ValuesBucket                  | 是   | 指示要查询的列。如果此参数为空,则查询所有列。   |
| predicates | dataAbility.DataAbilityPredicates | 是   | 指示筛选条件。当此参数为null时,应定义处理逻辑。 |
X
xuchenghua09 已提交
841

Z
zengyawen 已提交
842
**返回值:**
Y
yuyaozhi 已提交
843

Z
zengyawen 已提交
844 845 846
| 类型                | 说明           |
| ------------------- | -------------- |
| Promise\<ResultSet> | 返回查询结果。 |
X
xuchenghua09 已提交
847

Z
zengyawen 已提交
848
**示例:**
X
xuchenghua09 已提交
849 850 851

```js
import featureAbility from '@ohos.ability.featureAbility'
Y
yuyaozhi 已提交
852
import ohos_data_ability from '@ohos.data.dataAbility'
X
xuchenghua09 已提交
853 854 855
var DAHelper = featureAbility.acquireDataAbilityHelper(
    "dataability:///com.example.DataAbility"
);
ahjxliubao2's avatar
ahjxliubao2 已提交
856
var cars=new Array("value1", "value2", "value3", "value4");
X
xuchenghua09 已提交
857 858 859 860 861 862 863 864
let da = new ohos_data_ability.DataAbilityPredicates()
DAHelper.query(
    "dataability:///com.example.DataAbility",
    cars,
    da
	).then((data) => {
		console.info("==========================>queryCallback=======================>");
});
D
dy 已提交
865 866 867 868
```

## DataAbilityHelper.call

Z
zengyawen 已提交
869
call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap>
D
dy 已提交
870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887

调用DataAbility的扩展接口,使用Promise方式作为异步方法。

**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel

**参数:**

| 名称       | 类型                              | 必填 | 描述                                             |
| ---------- | --------------------------------- | ---- | ------------------------------------------------ |
| uri        | string                 | 是   | 指定待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"           |
| method    | string                  | 是   | 被调用的方法名。   |
| arg      | string                   | 是   |需传入的参数。      |
| extras   | [PacMap](#pacmap)        | 是   | 键值对参数。       |

**返回值:**

| 类型 | 说明 |
|------ | ------- |
Z
zengyawen 已提交
888
|Promise\<[PacMap](#pacmap)> | 调用的返回值。 |
D
dy 已提交
889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904

**示例:**

```js
import featureAbility from '@ohos.ability.featureAbility';

let dataAbilityHelper = featureAbility.acquireDataAbilityHelper("dataability:///com.example.jsapidemo.UserDataAbility");
dataAbilityHelper.call("dataability:///com.example.jsapidemo.UserDataAbility", "method", "arg", {"key1":"value1"}).then((data) => {
    console.info('Operation succeeded: ' + data);
}).catch((error) => {
    console.error('Operation failed. Cause: ' + error);
});
```

## DataAbilityHelper.call

Z
zengyawen 已提交
905
call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCallback\<PacMap>): void
D
dy 已提交
906 907 908 909 910 911 912 913 914 915 916 917 918

调用DataAbility的扩展接口,使用callback方式作为异步方法。

**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel

**参数:**

| 名称       | 类型                              | 必填 | 描述                                             |
| ---------- | --------------------------------- | ---- | ------------------------------------------------ |
| uri        | string                 | 是   | 指定待处理的DataAbility。例:"dataability:///com.example.xxx.xxxx"           |
| method    | string                  | 是   | 被调用的方法名。   |
| arg      | string                   | 是   |需传入的参数。      |
| extras   | [PacMap](#pacmap)        | 是   | 键值对参数。       |
Z
zengyawen 已提交
919
| callback | AsyncCallback\<[PacMap](#pacmap)> | 是 | 返回值。     |
D
dy 已提交
920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936

**示例:**

```js
import featureAbility from '@ohos.ability.featureAbility';

let dataAbilityHelper = featureAbility.acquireDataAbilityHelper("dataability:///com.example.jsapidemo.UserDataAbility");
dataAbilityHelper.call("dataability:///com.example.jsapidemo.UserDataAbility", "method", "arg", {"key1":"value1"}, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + err);
        return;
    }
    console.info('Operation succeeded: ' + data);
});
```
## PacMap

937 938 939 940
[key: string]: number | string | boolean | Array\<string | number | boolean> | null;

**系统能力**:SystemCapability.Ability.AbilityRuntime.FAModel

D
dy 已提交
941 942
| 名称 | 参数类型 | 必填 | 说明 |
| ------ | ------ | ------ | ------ |
943
| [key: string] | number \| string \| boolean \| Array\<string \| number \| boolean\> \| null | Yes| 数据存储在键值对中。|