1# DataAbilityHelper 2 3可以通过[acquireDataAbilityHelper](js-apis-ability-featureAbility.md#featureabilityacquiredataabilityhelper7)接口获取DataAbilityHelper对象。 4 5> **说明：** 6> 7> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 本模块接口仅可在FA模型下使用。 9 10## 导入模块 11 12```ts 13import ability from '@ohos.ability.ability'; 14``` 15 16## 使用说明 17 18使用前根据具体情况引入如下模块 19```ts 20import ohos_data_ability from '@ohos.data.dataAbility'; 21import relationalStore from '@ohos.data.relationalStore' 22``` 23 24## DataAbilityHelper.openFile 25 26openFile(uri: string, mode: string, callback: AsyncCallback\<number>): void 27 28打开指定uri对应的文件，返回文件描述符（callback形式）。 29 30**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 31 32**参数：** 33 34| 参数名 | 类型 | 必填 | 说明 | 35| -------- | ---------------------- | ---- | ---------------------------------- | 36| uri | string | 是 | 表示待打开文件的uri。 | 37| mode | string | 是 | 表示文件打开模式，可以设置为‘r’表示只读访问，‘w’表示只写访问，‘rw’表示读写访问等。 | 38| callback | AsyncCallback\<number> | 是 | 表示文件打开的回调方法，返回文件描述符。 | 39 40**示例：** 41 42```ts 43import ability from '@ohos.ability.ability'; 44import featureAbility from '@ohos.ability.featureAbility'; 45 46let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 47 'dataability:///com.example.DataAbility' 48); 49let mode = 'rw'; 50DAHelper.openFile('dataability:///com.example.DataAbility', mode, (error, data) => { 51 if (error && error.code !== 0) { 52 console.error(`openFile fail, error: ${JSON.stringify(error)}`); 53 } else { 54 console.log(`openFile success, data: ${JSON.stringify(data)}`); 55 } 56}); 57``` 58 59## DataAbilityHelper.openFile 60 61openFile(uri: string, mode: string): Promise\<number> 62 63打开指定uri对应的文件，返回文件描述符（promise形式）。 64 65**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 66 67**参数：** 68 69| 参数名 | 类型 | 必填 | 说明 | 70| ---- | ------ | ---- | ------------------------ | 71| uri | string | 是 | 表示待打开文件的uri。 | 72| mode | string | 是 | 表示文件打开模式，可以设置为‘r’表示只读访问，‘w’表示只写访问，‘rw’表示读写访问等。 | 73 74**返回值：** 75 76| 类型 | 说明 | 77| ---------------- | ---------------- | 78| Promise\<number> | 返回文件说明符。 | 79 80**示例：** 81 82```ts 83import ability from '@ohos.ability.ability'; 84import featureAbility from '@ohos.ability.featureAbility'; 85 86let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 87 'dataability:///com.example.DataAbility' 88); 89let mode = 'rw'; 90DAHelper.openFile('dataability:///com.example.DataAbility', mode).then((data) => { 91 console.info(`openFile data: ${JSON.stringify(data)}`); 92}); 93``` 94 95## DataAbilityHelper.on 96 97on(type: 'dataChange', uri: string, callback: AsyncCallback\<void>): void 98 99注册观察者以监听uri指定数据的数据变化通知。 100 101**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 102 103**参数：** 104 105| 参数名 | 类型 | 必填 | 说明 | 106| -------- | -------------------- | ---- | ------------------------ | 107| type | string | 是 | 表示监听操作类型，'dataChange'表示数据变化操作。 | 108| uri | string | 是 | 表示待监听数据变化的uri。 | 109| callback | AsyncCallback\<void> | 是 | 表示数据变化时的回调方法。 | 110 111**示例：** 112 113```ts 114import ability from '@ohos.ability.ability'; 115import featureAbility from '@ohos.ability.featureAbility'; 116 117let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 118 'dataability:///com.example.DataAbility' 119); 120function onChangeNotify() { 121 console.info('onChangeNotify call back'); 122}; 123DAHelper.on( 124 'dataChange', 125 'dataability:///com.example.DataAbility', 126 onChangeNotify 127); 128``` 129 130## DataAbilityHelper.off 131 132off(type: 'dataChange', uri: string, callback?: AsyncCallback\<void>): void 133 134注消观察者以停止监听uri指定数据的数据变化通知。 135 136**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 137 138**参数：** 139 140| 参数名 | 类型 | 必填 | 说明 | 141| -------- | -------------------- | ---- | ------------------------ | 142| type | string | 是 | 表示监听操作类型，'dataChange'表示数据变化操作。 | 143| uri | string | 是 | 表示待取消监听数据变化的uri。 | 144| callback | AsyncCallback\<void> | 否 | 表示已注册的数据变化回调方法。如果设置数据变化回调为空，将会取消所有数据变化监听。 | 145 146**示例：** 147 148```ts 149import ability from '@ohos.ability.ability'; 150import featureAbility from '@ohos.ability.featureAbility'; 151 152let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 153 'dataability:///com.example.DataAbility' 154); 155function onChangeNotify() { 156 console.info('onChangeNotify call back'); 157}; 158DAHelper.off( 159 'dataChange', 160 'dataability:///com.example.DataAbility', 161 onChangeNotify 162); 163DAHelper.off( 164 'dataChange', 165 'dataability:///com.example.DataAbility', 166); 167``` 168 169## DataAbilityHelper.getType 170 171getType(uri: string, callback: AsyncCallback\<string>): void 172 173获取给定uri指向数据的媒体资源类型（callback形式）。 174 175**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 176 177**参数：** 178 179| 参数名 | 类型 | 必填 | 说明 | 180| -------- | ---------------------- | ---- | --------------------------------------------- | 181| uri | string | 是 | 表示待获取数据的uri。 | 182| callback | AsyncCallback\<string> | 是 | 表示获取媒体资源类型的回调方法，返回与uri指向数据匹配的媒体资源类型。 | 183 184**示例：** 185 186```ts 187import ability from '@ohos.ability.ability'; 188import featureAbility from '@ohos.ability.featureAbility'; 189 190let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 191 'dataability:///com.example.DataAbility' 192); 193DAHelper.getType('dataability:///com.example.DataAbility', (error, data) => { 194 if (error && error.code !== 0) { 195 console.error(`getType fail, error: ${JSON.stringify(error)}`); 196 } else { 197 console.log(`getType success, data: ${JSON.stringify(data)}`); 198 } 199}); 200``` 201 202## DataAbilityHelper.getType 203 204getType(uri: string): Promise\<string> 205 206获取给定uri指向数据的媒体资源类型（Promise形式）。 207 208**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 209 210**参数：** 211 212| 参数名 | 类型 | 必填 | 说明 | 213| ---- | ------ | ---- | ------------------------ | 214| uri | string | 是 | 表示待获取数据的uri。 | 215 216**返回值：** 217 218| 类型 | 说明 | 219| ---------------- | ----------------------------------- | 220| Promise\<string> | 返回与uri指向数据匹配的媒体资源类型。 | 221 222**示例：** 223 224```ts 225import ability from '@ohos.ability.ability'; 226import featureAbility from '@ohos.ability.featureAbility'; 227 228let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 229 'dataability:///com.example.DataAbility' 230); 231DAHelper.getType('dataability:///com.example.DataAbility').then((data) => { 232 console.info(`getType data: ${JSON.stringify(data)}`); 233}); 234``` 235 236## DataAbilityHelper.getFileTypes 237 238getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array\<string>>): void 239 240获取支持的文件媒体资源类型（callback形式）。 241 242**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 243 244**参数：** 245 246| 参数名 | 类型 | 必填 | 说明 | 247| -------------- | ------------------------------ | ---- | ---------------------------------- | 248| uri | string | 是 | 表示待获取文件的uri。 | 249| mimeTypeFilter | string | 是 | 表示待获取文件的媒体资源类型。 | 250| callback | AsyncCallback\<Array\<string>> | 是 | 表示获取媒体资源类型的回调方法，返回匹配的媒体资源类型数组。 | 251 252**示例：** 253 254```ts 255import ability from '@ohos.ability.ability'; 256import featureAbility from '@ohos.ability.featureAbility'; 257 258let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 259 'dataability:///com.example.DataAbility' 260); 261DAHelper.getFileTypes( 'dataability:///com.example.DataAbility', 'image/*', (error, data) => { 262 if (error && error.code !== 0) { 263 console.error(`getFileTypes fail, error: ${JSON.stringify(error)}`); 264 } else { 265 console.log(`getFileTypes success, data: ${JSON.stringify(data)}`); 266 } 267}); 268``` 269 270## DataAbilityHelper.getFileTypes 271 272getFileTypes(uri: string, mimeTypeFilter: string): Promise\<Array\<string>> 273 274获取支持的文件媒体资源类型（Promise形式）。 275 276**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 277 278**参数：** 279 280| 参数名 | 类型 | 必填 | 说明 | 281| -------------- | ------ | ---- | ---------------------------- | 282| uri | string | 是 | 表示待获取文件的uri。 | 283| mimeTypeFilter | string | 是 | 表示待获取文件的媒体资源类型。 | 284 285**返回值：** 286 287| 类型 | 说明 | 288| ------------------------ | ------------------------ | 289| Promise\<Array\<string>> | 返回匹配的媒体资源类型数组。 | 290 291**示例：** 292 293```ts 294import ability from '@ohos.ability.ability'; 295import featureAbility from '@ohos.ability.featureAbility'; 296 297let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 298 'dataability:///com.example.DataAbility' 299); 300DAHelper.getFileTypes('dataability:///com.example.DataAbility', 'image/*').then((data) => { 301 console.info(`getFileTypes data: ${JSON.stringify(data)}`); 302}); 303``` 304 305## DataAbilityHelper.normalizeUri 306 307normalizeUri(uri: string, callback: AsyncCallback\<string>): void 308 309将引用数据功能的给定uri转换为规范化uri（callback形式）。 310 311**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 312 313**参数：** 314 315| 参数名 | 类型 | 必填 | 说明 | 316| -------- | ---------------------- | ---- | ------------------------------------------------------------ | 317| uri | string | 是 | 表示要规范化的uri对象。 | 318| callback | AsyncCallback\<string> | 是 | 表示uri规范化的回调方法。如果数据功能支持uri规范化，则返回规范化uri对象；否则返回null。 | 319 320**示例：** 321 322```ts 323import ability from '@ohos.ability.ability'; 324import featureAbility from '@ohos.ability.featureAbility'; 325 326let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 327 'dataability:///com.example.DataAbility' 328); 329DAHelper.normalizeUri('dataability:///com.example.DataAbility', (error, data) => { 330 if (error && error.code !== 0) { 331 console.error(`normalizeUri fail, error: ${JSON.stringify(error)}`); 332 } else { 333 console.log(`normalizeUri success, data: ${JSON.stringify(data)}`); 334 } 335}); 336``` 337 338## DataAbilityHelper.normalizeUri 339 340normalizeUri(uri: string): Promise\<string> 341 342将引用数据功能的给定uri转换为规范化uri（Promise形式）。 343 344**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 345 346**参数：** 347 348| 参数名 | 类型 | 必填 | 说明 | 349| ---- | ------ | ---- | ----------------------- | 350| uri | string | 是 | 表示要规范化的uri对象。 | 351 352**返回值：** 353 354| 类型 | 说明 | 355| ---------------- | ------------------------------------------------------ | 356| Promise\<string> | 如果数据功能支持uri规范化，则返回规范化uri对象；否则返回null。 | 357 358**示例：** 359 360```ts 361import ability from '@ohos.ability.ability'; 362import featureAbility from '@ohos.ability.featureAbility'; 363 364let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 365 'dataability:///com.example.DataAbility' 366); 367DAHelper.normalizeUri('dataability:///com.example.DataAbility',).then((data) => { 368 console.info(`normalizeUri data: ${JSON.stringify(data)}`); 369}); 370``` 371 372## DataAbilityHelper.denormalizeUri 373 374denormalizeUri(uri: string, callback: AsyncCallback\<string>): void 375 376将由normalizeUri（uri）生成的给定规范化uri转换为非规范化uri（callback形式）。 377 378**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 379 380**参数：** 381 382| 参数名 | 类型 | 必填 | 说明 | 383| -------- | ---------------------- | ---- | --------------------------------------------------- | 384| uri | string | 是 | 表示要反规范化的uri对象。 | 385| callback | AsyncCallback\<string> | 是 | 表示反规范化uri的回调方法。如果反规范化成功，则返回反规范化uri对象。 | 386 387**示例：** 388 389```ts 390import ability from '@ohos.ability.ability'; 391import featureAbility from '@ohos.ability.featureAbility'; 392 393let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 394 'dataability:///com.example.DataAbility' 395); 396DAHelper.denormalizeUri('dataability:///com.example.DataAbility', (error, data) => { 397 if (error && error.code !== 0) { 398 console.error(`denormalizeUri fail, error: ${JSON.stringify(error)}`); 399 } else { 400 console.log(`denormalizeUri success, data: ${JSON.stringify(data)}`); 401 } 402}); 403``` 404 405## DataAbilityHelper.denormalizeUri 406 407denormalizeUri(uri: string): Promise\<string> 408 409将由normalizeUri（uri）生成的给定规范化uri转换为非规范化uri（Promise形式）。 410 411**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 412 413**参数：** 414 415| 参数名 | 类型 | 必填 | 说明 | 416| ---- | ------ | ---- | ----------------------- | 417| uri | string | 是 | 表示要规范化的uri对象。 | 418 419**返回值：** 420 421| 类型 | 说明 | 422| ---------------- | ----------------------------------------- | 423| Promise\<string> | 如果反规范化成功，则返回反规范化uri对象。 | 424 425**示例：** 426 427```ts 428import ability from '@ohos.ability.ability'; 429import featureAbility from '@ohos.ability.featureAbility'; 430 431let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 432 'dataability:///com.example.DataAbility' 433); 434DAHelper.denormalizeUri('dataability:///com.example.DataAbility',).then((data) => { 435 console.info(`denormalizeUri data: ${JSON.stringify(data)}`); 436}); 437``` 438 439## DataAbilityHelper.notifyChange 440 441notifyChange(uri: string, callback: AsyncCallback\<void>): void 442 443通知注册的观察者，uri指定数据的数据变化（callback形式）。 444 445**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 446 447**参数：** 448 449| 参数名 | 类型 | 必填 | 说明 | 450| -------- | -------------------- | ---- | ------------------------ | 451| uri | string | 是 | 表示数据变化的uri。 | 452| callback | AsyncCallback\<void> | 是 | 回调方法。 | 453 454**示例：** 455 456```ts 457import ability from '@ohos.ability.ability'; 458import featureAbility from '@ohos.ability.featureAbility'; 459 460let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 461 'dataability:///com.example.DataAbility' 462); 463DAHelper.notifyChange('dataability:///com.example.DataAbility', (error) => { 464 if (error && error.code !== 0) { 465 console.error(`notifyChange fail, error: ${JSON.stringify(error)}`); 466 } else { 467 console.log('notifyChange success'); 468 } 469}); 470``` 471 472## DataAbilityHelper.notifyChange 473 474notifyChange(uri: string): Promise\<void> 475 476通知注册的观察者，uri指定数据的数据变化（Promise形式）。 477 478**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 479 480**参数：** 481 482| 参数名 | 类型 | 必填 | 说明 | 483| ---- | ------ | ---- | ------------------------ | 484| uri | string | 是 | 表示数据变化的uri。 | 485 486**返回值：** 487 488| 类型 | 说明 | 489| -------------- | --------------------- | 490| Promise\<void> | 返回值为Promise对象。 | 491 492**示例：** 493 494```ts 495import ability from '@ohos.ability.ability'; 496import featureAbility from '@ohos.ability.featureAbility'; 497 498let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 499 'dataability:///com.example.DataAbility' 500); 501DAHelper.notifyChange('dataability:///com.example.DataAbility').then(() => { 502 console.info('================>notifyChangeCallback================>'); 503}); 504``` 505 506## DataAbilityHelper.insert 507 508insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<number>): void 509 510将单个数据记录插入数据库（callback形式）。 511 512**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 513 514**参数：** 515 516| 参数名 | 类型 | 必填 | 说明 | 517| ------------ | ---------------------- | ---- | ------------------------------------------------------ | 518| uri | string | 是 | 表示要插入数据的uri。 | 519| valuesBucket | rdb.ValuesBucket | 是 | 表示要插入的数据记录。如果此参数为空，将插入一个空行。 | 520| callback | AsyncCallback\<number> | 是 | 表示数据插入的回调方法，返回插入数据记录的索引。 | 521 522**示例：** 523 524```ts 525import ability from '@ohos.ability.ability'; 526import featureAbility from '@ohos.ability.featureAbility'; 527import rdb from '@ohos.data.rdb'; 528 529let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 530 'dataability:///com.example.DataAbility' 531); 532const valueBucket: rdb.ValuesBucket = { 533 'name': 'rose', 534 'age': 22, 535 'salary': 200.5, 536 'blobType': 'u8', 537}; 538DAHelper.insert('dataability:///com.example.DataAbility', valueBucket, (error, data) => { 539 if (error && error.code !== 0) { 540 console.error(`insert fail, error: ${JSON.stringify(error)}`); 541 } else { 542 console.log(`insert success, data: ${JSON.stringify(data)}`); 543 } 544}); 545``` 546 547## DataAbilityHelper.insert 548 549insert(uri: string, valuesBucket: rdb.ValuesBucket): Promise\<number> 550 551将单个数据记录插入数据库（Promise形式）。 552 553**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 554 555**参数：** 556 557| 参数名 | 类型 | 必填 | 说明 | 558| ------------ | ---------------- | ---- | ------------------------------------------------------ | 559| uri | string | 是 | 表示要插入数据的uri。 | 560| valuesBucket | rdb.ValuesBucket | 是 | 表示要插入的数据记录。如果此参数为空，将插入一个空行。 | 561 562**返回值：** 563 564| 类型 | 说明 | 565| ---------------- | ------------------------ | 566| Promise\<number> | 返回插入数据记录的索引。 | 567 568**示例：** 569 570```ts 571import ability from '@ohos.ability.ability'; 572import featureAbility from '@ohos.ability.featureAbility'; 573import rdb from '@ohos.data.rdb'; 574 575let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 576 'dataability:///com.example.DataAbility' 577); 578const valueBucket: rdb.ValuesBucket = { 579 'name': 'rose1', 580 'age': 221, 581 'salary': 20.5, 582 'blobType': 'u8', 583}; 584DAHelper.insert('dataability:///com.example.DataAbility', valueBucket).then((data) => { 585 console.info(`insert data: ${JSON.stringify(data)}`); 586}); 587``` 588 589## DataAbilityHelper.batchInsert 590 591batchInsert(uri: string, valuesBuckets: Array\<rdb.ValuesBucket>, callback: AsyncCallback\<number>): void 592 593将多个数据记录插入数据库（callback形式）。 594 595**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 596 597**参数：** 598 599| 参数名 | 类型 | 必填 | 说明 | 600| ------------ | ----------------------- | ---- | -------------------------------- | 601| uri | string | 是 | 表示要插入数据的uri。 | 602| valuesBucket | Array\<rdb.ValuesBucket> | 是 | 表示要插入的数据记录数组。 | 603| callback | AsyncCallback\<number> | 是 | 表示批量数据插入的回调方法。返回插入的数据记录数。 | 604 605**示例：** 606 607```ts 608import ability from '@ohos.ability.ability'; 609import featureAbility from '@ohos.ability.featureAbility'; 610import rdb from '@ohos.data.rdb'; 611 612let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 613 'dataability:///com.example.DataAbility' 614); 615let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket, 616 {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket, 617 {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket); 618DAHelper.batchInsert('dataability:///com.example.DataAbility', cars, (error, data) => { 619 if (error && error.code !== 0) { 620 console.error(`batchInsert fail, error: ${JSON.stringify(error)}`); 621 } else { 622 console.log(`batchInsert success, data: ${JSON.stringify(data)}`); 623 } 624}); 625``` 626 627## DataAbilityHelper.batchInsert 628 629batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>): Promise\<number> 630 631将多个数据记录插入数据库（Promise形式）。 632 633**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 634 635**参数：** 636 637| 参数名 | 类型 | 必填 | 说明 | 638| ------------ | ----------------------- | ---- | ------------------------ | 639| uri | string | 是 | 表示要插入数据的uri。 | 640| valuesBucket | Array<rdb.ValuesBucket> | 是 | 表示要插入的数据记录数组。 | 641 642**返回值：** 643 644| 类型 | 说明 | 645| ---------------- | ---------------------- | 646| Promise\<number> | 返回插入的数据记录数。 | 647 648**示例：** 649 650```ts 651import ability from '@ohos.ability.ability'; 652import featureAbility from '@ohos.ability.featureAbility'; 653import rdb from '@ohos.data.rdb'; 654 655let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 656 'dataability:///com.example.DataAbility' 657); 658let cars = new Array({'name': 'roe11', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket, 659 {'name': 'roe12', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket, 660 {'name': 'roe13', 'age': 21, 'salary': 20.5, 'blobType': 'u8',} as rdb.ValuesBucket); 661DAHelper.batchInsert('dataability:///com.example.DataAbility', cars).then((data) => { 662 console.info(`batchInsert data: ${JSON.stringify(data)}`); 663}); 664``` 665 666## DataAbilityHelper.delete 667 668delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>): void 669 670从数据库中删除一个或多个数据记录（callback形式）。 671 672**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 673 674**参数：** 675 676| 参数名 | 类型 | 必填 | 说明 | 677| ------------ | --------------------------------- | ---- | ------------------------------------------------ | 678| uri | string | 是 | 表示要删除数据的uri。 | 679| predicates | dataAbility.DataAbilityPredicates | 是 | 表示筛选条件。当此参数为null时，应定义处理逻辑。 | 680| callback | AsyncCallback\<number> | 是 | 表示数据删除的回调方法。返回已删除的数据记录数。 | 681 682**示例：** 683 684```ts 685import ability from '@ohos.ability.ability'; 686import featureAbility from '@ohos.ability.featureAbility'; 687import ohos_data_ability from '@ohos.data.dataAbility'; 688 689let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 690 'dataability:///com.example.DataAbility' 691); 692let da = new ohos_data_ability.DataAbilityPredicates(); 693DAHelper.delete('dataability:///com.example.DataAbility', da, (error, data) => { 694 if (error && error.code !== 0) { 695 console.error(`delete fail, error: ${JSON.stringify(error)}`); 696 } else { 697 console.log(`delete success, data: ${JSON.stringify(data)}`); 698 } 699}); 700``` 701 702## DataAbilityHelper.delete 703 704delete(uri: string, predicates?: dataAbility.DataAbilityPredicates): Promise\<number>; 705 706从数据库中删除一个或多个数据记录（Promise形式）。 707 708**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 709 710**参数：** 711 712| 参数名 | 类型 | 必填 | 说明 | 713| ------------ | --------------------------------- | ---- | ------------------------------------------------ | 714| uri | string | 是 | 表示要删除数据的uri。 | 715| predicates | dataAbility.DataAbilityPredicates | 否 | 表示筛选条件。当此参数为null时，应定义处理逻辑。 | 716 717**返回值：** 718 719| 类型 | 说明 | 720| ---------------- | ------------------------ | 721| Promise\<number> | 返回已删除的数据记录数。 | 722 723**示例：** 724 725```ts 726import ability from '@ohos.ability.ability'; 727import featureAbility from '@ohos.ability.featureAbility'; 728import ohos_data_ability from '@ohos.data.dataAbility'; 729 730let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 731 'dataability:///com.example.DataAbility' 732); 733let da = new ohos_data_ability.DataAbilityPredicates(); 734DAHelper.delete('dataability:///com.example.DataAbility', da).then((data) => { 735 console.info(`delete data: ${JSON.stringify(data)}`); 736}); 737``` 738 739## DataAbilityHelper.delete 740 741delete(uri: string, callback: AsyncCallback\<number>): void 742 743predicates筛选条件为空，自定义数据库删除数据记录的处理逻辑（callback形式）。 744 745**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 746 747**参数：** 748 749| 参数名 | 类型 | 必填 | 说明 | 750| ------------ | --------------------------------- | ---- | ------------------------------------------------ | 751| uri | string | 是 | 表示要删除数据的uri。 | 752| callback | AsyncCallback\<number> | 是 | 表示数据删除的回调方法。返回已删除的数据记录数。 | 753 754**示例：** 755 756```ts 757import ability from '@ohos.ability.ability'; 758import featureAbility from '@ohos.ability.featureAbility'; 759import ohos_data_ability from '@ohos.data.dataAbility'; 760 761let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 762 'dataability:///com.example.DataAbility' 763); 764DAHelper.delete('dataability:///com.example.DataAbility', (error, data) => { 765 if (error && error.code !== 0) { 766 console.error(`delete fail, error: ${JSON.stringify(error)}`); 767 } else { 768 console.log(`delete success, data: ${JSON.stringify(data)}`); 769 } 770}); 771``` 772 773## DataAbilityHelper.update 774 775update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>): void 776 777更新数据库中的数据记录（callback形式）。 778 779**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 780 781**参数：** 782 783| 参数名 | 类型 | 必填 | 说明 | 784| ------------ | --------------------------------- | ---- | ------------------------------------------------ | 785| uri | string | 是 | 表示要更新数据的uri。 | 786| valuesBucket | rdb.ValuesBucket | 是 | 表示要更新的数据。 | 787| predicates | dataAbility.DataAbilityPredicates | 是 | 表示筛选条件。当此参数为null时，应定义处理逻辑。 | 788| callback | AsyncCallback\<number> | 是 | 表示数据更新的回调方法，返回更新的数据记录数。 | 789 790**示例：** 791 792```ts 793import ability from '@ohos.ability.ability'; 794import featureAbility from '@ohos.ability.featureAbility'; 795import ohos_data_ability from '@ohos.data.dataAbility'; 796import rdb from '@ohos.data.rdb'; 797 798let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 799 'dataability:///com.example.DataAbility' 800); 801const va: rdb.ValuesBucket = { 802 'name': 'roe1', 803 'age': 21, 804 'salary': 20.5, 805 'blobType': 'u8', 806}; 807let da = new ohos_data_ability.DataAbilityPredicates(); 808DAHelper.update('dataability:///com.example.DataAbility', va, da, (error, data) => { 809 if (error && error.code !== 0) { 810 console.error(`update fail, error: ${JSON.stringify(error)}`); 811 } else { 812 console.log(`update success, data: ${JSON.stringify(data)}`); 813 } 814}); 815``` 816 817## DataAbilityHelper.update 818 819update(uri: string, valuesBucket: rdb.ValuesBucket, predicates?: dataAbility.DataAbilityPredicates): Promise\<number>; 820 821更新数据库中的数据记录（Promise形式）。 822 823**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 824 825**参数：** 826 827| 参数名 | 类型 | 必填 | 说明 | 828| ------------ | --------------------------------- | ---- | ------------------------------------------------ | 829| uri | string | 是 | 表示要更新数据的uri。 | 830| valuesBucket | rdb.ValuesBucket | 是 | 表示要更新的数据。 | 831| predicates | dataAbility.DataAbilityPredicates | 否 | 表示筛选条件。当此参数为null时，应定义处理逻辑。 | 832 833**返回值：** 834 835| 类型 | 说明 | 836| ---------------- | -------------------------------------------- | 837| Promise\<number> | Promise中包含更新的数据记录数。 。 | 838 839**示例：** 840 841```ts 842import ability from '@ohos.ability.ability'; 843import featureAbility from '@ohos.ability.featureAbility'; 844import ohos_data_ability from '@ohos.data.dataAbility'; 845import rdb from '@ohos.data.rdb'; 846 847let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 848 'dataability:///com.example.DataAbility' 849); 850const va: rdb.ValuesBucket = { 851 'name': 'roe1', 852 'age': 21, 853 'salary': 20.5, 854 'blobType': 'u8', 855}; 856let da = new ohos_data_ability.DataAbilityPredicates(); 857DAHelper.update('dataability:///com.example.DataAbility', va, da).then((data) => { 858 console.info(`update data: ${JSON.stringify(data)}`); 859}); 860``` 861 862## DataAbilityHelper.update 863 864update(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<number>): void 865 866predicates筛选条件为空，自定义更新数据库的处理逻辑（callback形式）。 867 868**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 869 870**参数：** 871 872| 参数名 | 类型 | 必填 | 说明 | 873| ------------ | --------------------------------- | ---- | ------------------------------------------------ | 874| uri | string | 是 | 表示要更新数据的uri。 | 875| valuesBucket | rdb.ValuesBucket | 是 | 表示要更新的数据。 | 876| callback | AsyncCallback\<number> | 是 | 表示数据更新的回调方法，返回更新的数据记录数。 | 877 878**示例：** 879 880```ts 881import ability from '@ohos.ability.ability'; 882import featureAbility from '@ohos.ability.featureAbility'; 883import ohos_data_ability from '@ohos.data.dataAbility'; 884import rdb from '@ohos.data.rdb'; 885 886let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 887 'dataability:///com.example.DataAbility' 888); 889const va: rdb.ValuesBucket = { 890 'name': 'roe1', 891 'age': 21, 892 'salary': 20.5, 893 'blobType': 'u8', 894}; 895DAHelper.update('dataability:///com.example.DataAbility', va, (error, data) => { 896 if (error && error.code !== 0) { 897 console.error(`update fail, error: ${JSON.stringify(error)}`); 898 } else { 899 console.log(`update success, data: ${JSON.stringify(data)}`); 900 } 901}); 902``` 903 904## DataAbilityHelper.query 905 906query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<ResultSet>): void 907 908查询数据库中的数据（callback形式）。 909 910**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 911 912**参数：** 913 914| 参数名 | 类型 | 必填 | 说明 | 915| ---------- | --------------------------------- | ---- | ------------------------------------------------ | 916| uri | string | 是 | 表示要查询数据的uri。 | 917| columns | Array\<string> | 是 | 表示要查询的列。如果此参数为空，则查询所有列。 | 918| predicates | dataAbility.DataAbilityPredicates | 是 | 表示筛选条件。当此参数为null时，应定义处理逻辑。 | 919| callback | AsyncCallback\<ResultSet> | 是 | 表示数据查询的回调方法，返回查询结果。 | 920 921**示例：** 922 923```ts 924import ability from '@ohos.ability.ability'; 925import featureAbility from '@ohos.ability.featureAbility'; 926import ohos_data_ability from '@ohos.data.dataAbility'; 927 928let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 929 'dataability:///com.example.DataAbility' 930); 931let cars=new Array('value1', 'value2', 'value3', 'value4'); 932let da = new ohos_data_ability.DataAbilityPredicates(); 933DAHelper.query('dataability:///com.example.DataAbility', cars, da, (error, data) => { 934 if (error && error.code !== 0) { 935 console.error(`query fail, error: ${JSON.stringify(error)}`); 936 } else { 937 console.log(`query success, data: ${JSON.stringify(data)}`); 938 } 939}); 940``` 941 942## DataAbilityHelper.query 943 944query(uri: string, callback: AsyncCallback\<ResultSet>): void 945 946predicates筛选条件为空，自定义查询数据库中数据的处理逻辑（callback形式）。 947 948**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 949 950**参数：** 951 952| 参数名 | 类型 | 必填 | 说明 | 953| ---------- | --------------------------------- | ---- | ------------------------------------------------ | 954| uri | string | 是 | 表示要查询数据的uri。 | 955| callback | AsyncCallback\<ResultSet> | 是 | 表示数据查询的回调方法，返回查询结果。 | 956 957**示例：** 958 959```ts 960import ability from '@ohos.ability.ability'; 961import featureAbility from '@ohos.ability.featureAbility'; 962import ohos_data_ability from '@ohos.data.dataAbility'; 963 964let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 965 'dataability:///com.example.DataAbility' 966); 967DAHelper.query('dataability:///com.example.DataAbility', (error, data) => { 968 if (error && error.code !== 0) { 969 console.error(`query fail, error: ${JSON.stringify(error)}`); 970 } else { 971 console.log(`query success, data: ${JSON.stringify(data)}`); 972 } 973}); 974``` 975 976## DataAbilityHelper.query 977 978query(uri: string, columns: Array\<string>, callback: AsyncCallback\<ResultSet>): void 979 980predicates筛选条件为空，自定义查询数据库中数据的处理逻辑（callback形式）。 981 982**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 983 984**参数：** 985 986| 参数名 | 类型 | 必填 | 说明 | 987| ---------- | --------------------------------- | ---- | ------------------------------------------------ | 988| uri | string | 是 | 表示要查询数据的uri。 | 989| columns | Array\<string> | 是 | 表示要查询的列。如果此参数为空，则查询所有列。 | 990| callback | AsyncCallback\<ResultSet> | 是 | 表示数据查询的回调方法，返回查询结果。 | 991 992**示例：** 993 994```ts 995import ability from '@ohos.ability.ability'; 996import featureAbility from '@ohos.ability.featureAbility'; 997import ohos_data_ability from '@ohos.data.dataAbility'; 998 999let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 1000 'dataability:///com.example.DataAbility' 1001); 1002let cars = new Array('value1', 'value2', 'value3', 'value4'); 1003DAHelper.query('dataability:///com.example.DataAbility', cars, (error, data) => { 1004 if (error && error.code !== 0) { 1005 console.error(`query fail, error: ${JSON.stringify(error)}`); 1006 } else { 1007 console.log(`query success, data: ${JSON.stringify(data)}`); 1008 } 1009}); 1010``` 1011 1012## DataAbilityHelper.query 1013 1014query(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<ResultSet>): void 1015 1016predicates筛选条件为空，自定义查询数据库中数据的处理逻辑（callback形式）。 1017 1018**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 1019 1020**参数：** 1021 1022| 参数名 | 类型 | 必填 | 说明 | 1023| ---------- | --------------------------------- | ---- | ------------------------------------------------ | 1024| uri | string | 是 | 表示要查询数据的uri。 | 1025| predicates | dataAbility.DataAbilityPredicates | 是 | 表示筛选条件。当此参数为null时，应定义处理逻辑。 | 1026| callback | AsyncCallback\<ResultSet> | 是 | 表示数据查询的回调方法，返回查询结果。 | 1027 1028**示例：** 1029 1030```ts 1031import ability from '@ohos.ability.ability'; 1032import featureAbility from '@ohos.ability.featureAbility'; 1033import ohos_data_ability from '@ohos.data.dataAbility'; 1034 1035let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 1036 'dataability:///com.example.DataAbility' 1037); 1038let da = new ohos_data_ability.DataAbilityPredicates(); 1039DAHelper.query('dataability:///com.example.DataAbility', da, (error, data) => { 1040 if (error && error.code !== 0) { 1041 console.error(`query fail, error: ${JSON.stringify(error)}`); 1042 } else { 1043 console.log(`query success, data: ${JSON.stringify(data)}`); 1044 } 1045}); 1046``` 1047 1048## DataAbilityHelper.query 1049 1050query(uri: string, columns?: Array\<string>, predicates?: dataAbility.DataAbilityPredicates): Promise\<ResultSet>; 1051 1052查询数据库中的数据（Promise形式）。 1053 1054**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 1055 1056**参数：** 1057 1058| 参数名 | 类型 | 必填 | 说明 | 1059| ---------- | --------------------------------- | ---- | ------------------------------------------------ | 1060| uri | string | 是 | 表示要查询数据的uri。 | 1061| columns | Array\<string> | 否 | 表示要查询的列。如果此参数为空，则查询所有列。 | 1062| predicates | dataAbility.DataAbilityPredicates | 否 | 表示筛选条件。当此参数为null时，应定义处理逻辑。 | 1063 1064**返回值：** 1065 1066| 类型 | 说明 | 1067| ------------------- | -------------- | 1068| Promise\<ResultSet> | 返回查询结果。 | 1069 1070**示例：** 1071 1072```ts 1073import ability from '@ohos.ability.ability'; 1074import featureAbility from '@ohos.ability.featureAbility'; 1075import ohos_data_ability from '@ohos.data.dataAbility'; 1076 1077let DAHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 1078 'dataability:///com.example.DataAbility' 1079); 1080let cars = new Array('value1', 'value2', 'value3', 'value4'); 1081let da = new ohos_data_ability.DataAbilityPredicates(); 1082DAHelper.query('dataability:///com.example.DataAbility', cars, da).then((data) => { 1083 console.info(`query data: ${JSON.stringify(data)}`); 1084}); 1085``` 1086 1087## DataAbilityHelper.call 1088 1089call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCallback\<PacMap>): void 1090 1091调用DataAbility的扩展接口（callback形式）。 1092 1093**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 1094 1095**参数：** 1096 1097| 参数名 | 类型 | 必填 | 说明 | 1098| ---------- | --------------------------------- | ---- | ------------------------------------------------ | 1099| uri | string | 是 | 表示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx' | 1100| method | string | 是 | 表示被调用的方法名。 | 1101| arg | string | 是 | 表示需传入的参数。 | 1102| extras | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#pacmap) | 是 | 表示扩展的键值对参数。 | 1103| callback | AsyncCallback\<[PacMap](js-apis-inner-ability-dataAbilityHelper.md#pacmap)> | 是 | 表示数据操作的回调方法，返回操作结果。 | 1104 1105**示例：** 1106 1107```ts 1108import ability from '@ohos.ability.ability'; 1109import featureAbility from '@ohos.ability.featureAbility'; 1110 1111let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 1112 'dataability:///com.example.jsapidemo.UserDataAbility' 1113); 1114dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility', 1115 'method', 'arg', {'key1':'value1'}, (error, data) => { 1116 if (error && error.code !== 0) { 1117 console.error(`call fail, error: ${JSON.stringify(error)}`); 1118 } else { 1119 console.log(`call success, data: ${JSON.stringify(data)}`); 1120 } 1121}); 1122``` 1123 1124## DataAbilityHelper.call 1125 1126call(uri: string, method: string, arg: string, extras: PacMap): Promise\<PacMap> 1127 1128调用DataAbility的扩展接口（Promise形式）。 1129 1130**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 1131 1132**参数：** 1133 1134| 参数名 | 类型 | 必填 | 说明 | 1135| ---------- | --------------------------------- | ---- | ------------------------------------------------ | 1136| uri | string | 是 | 表示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx' | 1137| method | string | 是 | 表示被调用的方法名。 | 1138| arg | string | 是 | 表示需传入的参数。 | 1139| extras | [PacMap](js-apis-inner-ability-dataAbilityHelper.md#pacmap) | 是 | 表示扩展的键值对参数。 | 1140 1141**返回值：** 1142 1143| 类型 | 说明 | 1144|------ | ------- | 1145|Promise\<[PacMap](js-apis-inner-ability-dataAbilityHelper.md#pacmap)> | 返回操作结果。 | 1146 1147**示例：** 1148 1149```ts 1150import ability from '@ohos.ability.ability'; 1151import featureAbility from '@ohos.ability.featureAbility'; 1152import { BusinessError } from '@ohos.base'; 1153 1154let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 1155 'dataability:///com.example.jsapidemo.UserDataAbility' 1156); 1157dataAbilityHelper.call('dataability:///com.example.jsapidemo.UserDataAbility', 1158 'method', 'arg', {'key1':'value1'}).then((data) => { 1159 console.info('call success, data: ${data}'); 1160}).catch((error: BusinessError) => { 1161 console.error('call failed, error: ${error}'); 1162}); 1163``` 1164 1165## DataAbilityHelper.executeBatch 1166 1167executeBatch(uri: string, operations: Array\<DataAbilityOperation>, callback: AsyncCallback\<Array\<DataAbilityResult>>): void; 1168 1169批量操作数据库中的数据。 1170 1171**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 1172 1173**参数：** 1174 1175| 参数名 | 类型 | 必填 | 说明 | 1176| ----------| ---------------------------------| ---- | ------------------------------------------------ | 1177| uri | string | 是 | 表示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx'。| 1178| operations | Array\<[DataAbilityOperation](js-apis-inner-ability-dataAbilityOperation.md)> | 是 | 表示数据操作数组，其中可以包含对数据库的多个不同操作。 | 1179| callback | AsyncCallback\<Array\<[DataAbilityResult](js-apis-inner-ability-dataAbilityResult.md)>> | 是 | 表示批量操作的回调方法，在DataAbilityResult数组中返回每个操作的结果。 | 1180 1181**示例：** 1182 1183```ts 1184import ability from '@ohos.ability.ability'; 1185import featureAbility from '@ohos.ability.featureAbility'; 1186 1187// 根据DataAbilityOperation列表选择要对数据库做的操作 1188let op: Array<ability.DataAbilityOperation> = new Array(); 1189let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 1190 'dataability:///com.example.jsapidemo.UserDataAbility' 1191); 1192dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op, (error, data) => { 1193 if (error && error.code !== 0) { 1194 console.error(`executeBatch fail, error: ${JSON.stringify(error)}`); 1195 } else { 1196 console.log(`executeBatch success, data: ${JSON.stringify(data)}`); 1197 } 1198}); 1199``` 1200 1201## DataAbilityHelper.executeBatch 1202 1203executeBatch(uri: string, operations: Array\<DataAbilityOperation>): Promise\<Array\<DataAbilityResult>>; 1204 1205批量操作数据库中的数据。 1206 1207**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 1208 1209**参数：** 1210 1211| 参数名 | 类型 | 必填 | 说明 | 1212| ---------- | -------------------------------| ---- | ------------------------------------------------ | 1213| uri | string | 是 | 表示待处理的DataAbility。例：'dataability:///com.example.xxx.xxxx'。| 1214| operations | Array\<[DataAbilityOperation](js-apis-inner-ability-dataAbilityOperation.md)> | 是 | 表示数据操作数组，其中可以包含对数据库的多个不同操作。 | 1215 1216**返回值：** 1217 1218| 类型 | 说明 | 1219|------ | ------- | 1220|Promise\<Array\<[DataAbilityResult](js-apis-inner-ability-dataAbilityResult.md)>> | 在DataAbilityResult数组中返回每个操作的结果。 | 1221 1222**示例：** 1223 1224```ts 1225import ability from '@ohos.ability.ability'; 1226import featureAbility from '@ohos.ability.featureAbility'; 1227import { BusinessError } from '@ohos.base'; 1228 1229// 根据DataAbilityOperation列表选择要对数据库做的操作 1230let op: Array<ability.DataAbilityOperation> = new Array(); 1231let dataAbilityHelper: ability.DataAbilityHelper = featureAbility.acquireDataAbilityHelper( 1232 'dataability:///com.example.jsapidemo.UserDataAbility' 1233); 1234dataAbilityHelper.executeBatch('dataability:///com.example.jsapidemo.UserDataAbility', op).then((data) => { 1235 console.info('executeBatch success, data: ${data}'); 1236}).catch((error: BusinessError) => { 1237 console.error('executeBatch failed, error: ${error}'); 1238}); 1239 1240``` 1241 1242## PacMap 1243 1244[key: string]: number | string | boolean | Array\<string | number | boolean> | null; 1245 1246**系统能力**：SystemCapability.Ability.AbilityRuntime.FAModel 1247 1248| 参数名 | 参数类型 | 必填 | 说明 | 1249| ------ | ------ | ------ | ------ | 1250| [key: string] | number \| string \| boolean \| Array\<string \| number \| boolean\> \| null | Yes| 数据存储在键值对中。|