1### DataAbilityHelper模块(JS端SDK接口) 2 3#### 支持设备 4 5| API | 手机 | 平板 | 智慧屏 | 智能穿戴 | 轻量级智能穿戴 | 智慧视觉设备 | 6| ------------------------------------------------------------ | ---- | ---- | ------ | -------- | -------------- | ------------ | 7| DataAbilityHelper.openFile(uri: string, mode: string, callback: AsyncCallback\<number>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 8| DataAbilityHelper.openFile(uri: string, mode: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 9| DataAbilityHelper.on(type: 'dataChange', uri: string, callback: AsyncCallback\<void>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 10| DataAbilityHelper.off(type: 'dataChange', uri: string, callback?: AsyncCallback\<void>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 11| DataAbilityHelper.getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array\<string>>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 12| DataAbilityHelper.getFileTypes(uri: string, mimeTypeFilter: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 13| DataAbilityHelper.getType(uri: string, callback: AsyncCallback\<string>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 14| DataAbilityHelper.getType(uri: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 15| DataAbilityHelper.normalizeUri(uri: string, callback: AsyncCallback\<string>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 16| DataAbilityHelper.normalizeUri(uri: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 17| DataAbilityHelper.denormalizeUri(uri: string, callback: AsyncCallback\<string>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 18| DataAbilityHelper.denormalizeUri(uri: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 19| DataAbilityHelper.notifyChange(uri: string, callback: AsyncCallback\<void>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 20| DataAbilityHelper.notifyChange(uri: string) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 21| DataAbilityHelper.insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<number>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 22| DataAbilityHelper.insert(uri: string, valuesBucket: rdb.ValuesBucket) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 23| DataAbilityHelper.batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback\<number>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 24| DataAbilityHelper.batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 25| DataAbilityHelper.delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 26| DataAbilityHelper.delete(uri: string, predicates: dataAbility.DataAbilityPredicates) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 27| DataAbilityHelper.update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 28| DataAbilityHelper.update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 29| DataAbilityHelper.query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<ResultSet>) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 30| DataAbilityHelper.query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityPredicates) | 支持 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 31 32#### 权限列表 33 34ohos.permission.RUNNING_LOCK permission 35 36#### 导入模块 37 38``` 39import featureAbility from '@ohos.ability.featureAbility' 40import ohos_data_ability from '@ohos.data.dataability' 41import ohos_data_rdb from '@ohos.data.rdb' 42``` 43 44#### DataAbilityHelper.openFile(uri: string, mode: string, callback: AsyncCallback\<number>) 45 46- 接口说明 47 48 在指定的远程路径中打开文件(callback形式) 49 50 51* 参数描述 52 53 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 54 | -------- | -------- | -------------------- | ---- | ------------------------ | 55 | uri | 只读 | string | 是 | 指示要打开的文件的路径。 | 56 | mode | 只读 | string | 是 | 指示文件打开模式‘rwt’。 | 57 | callback | 只读 | AsyncCallback\<void> | 是 | 被指定的回调方法 | 58 59* 返回值 60 61 返回文件描述符。 62 63* 示例 64 65```javascript 66import featureAbility from '@ohos.ability.featureAbility' 67var DAHelper = await featureAbility.getDataAbilityHelper( 68 "dataability:///com.example.DataAbility" 69); 70var mode = "rwt"; 71DAHelper.openFile( 72 "dataability:///com.example.DataAbility", 73 mode, 74) 75``` 76 77#### DataAbilityHelper.openFile(uri: string, mode: string) 78 79- 接口说明 80 81 在指定的远程路径中打开文件(Promise形式) 82 83* 参数描述 84 85 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 86 | ---- | -------- | ------ | ---- | ------------------------ | 87 | uri | 只读 | string | 是 | 指示要打开的文件的路径。 | 88 | mode | 只读 | string | 是 | 指示文件打开模式‘rwt’。 | 89 90* 返回值 91 92 返回文件描述符。 93 94* 示例 95 96```javascript 97import featureAbility from '@ohos.ability.featureAbility' 98var DAHelper = await featureAbility.getDataAbilityHelper( 99 "dataability:///com.example.DataAbility" 100); 101var mode = "rwt"; 102DAHelper.openFile( 103 "dataability:///com.example.DataAbility"， 104 mode).then((void) => { 105 console.info("==========================>openFileCallback=======================>"); 106}); 107``` 108 109#### DataAbilityHelper.on(type: 'dataChange', uri: string, callback: AsyncCallback\<void>) 110 111- 接口说明 112 113 注册观察者以观察给定uri指定的数据(callback形式) 114 115- 参数描述 116 117 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 118 | -------- | -------- | -------------------- | ---- | ------------------------ | 119 | type | 只读 | string | 是 | 数据更改。 | 120 | uri | 只读 | string | 是 | 指示要操作的数据的路径。 | 121 | callback | 只读 | AsyncCallback\<void> | 是 | 指示数据更改时的回调。 | 122 123- 返回值 124 125 void 126 127- 示例 128 129```js 130import featureAbility from '@ohos.ability.featureAbility' 131var helper = await featureAbility.getDataAbilityHelper( 132 "dataability:///com.example.DataAbility" 133); 134helper.on( 135 "dataChange", 136 "dataability:///com.example.DataAbility", 137) 138``` 139 140#### DataAbilityHelper.off(type: 'dataChange', uri: string, callback?: AsyncCallback\<void>) 141 142- 接口说明 143 144 注册观察者以观察给定uri指定的数据(callback形式) 145 146- 参数描述 147 148 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 149 | -------- | -------- | -------------------- | ---- | ------------------------ | 150 | type | 只读 | string | 是 | 数据更改。 | 151 | uri | 只读 | string | 是 | 指示要操作的数据的路径。 | 152 | callback | 只读 | AsyncCallback\<void> | 否 | 指示已注册的回调。 | 153 154- 返回值 155 156 void 157 158- 示例 159 160```js 161import featureAbility from '@ohos.ability.featureAbility' 162var helper = await featureAbility.getDataAbilityHelper( 163 "dataability:///com.example.DataAbility" 164); 165helper.off( 166 "dataChange", 167 "dataability:///com.example.DataAbility", 168) 169``` 170 171#### DataAbilityHelper.getType(uri: string, callback: AsyncCallback\<string>) 172 173- 接口说明 174 175 获取给定URI指定的日期的MIME类型(callback形式) 176 177- 参数描述 178 179 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 180 | -------- | -------- | ---------------------- | ---- | ------------------------ | 181 | uri | 只读 | string | 是 | 指示要操作的数据的路径。 | 182 | callback | 只读 | AsyncCallback\<string> | 是 | 回调方法 | 183 184- 返回值 185 186 返回与uri指定的数据匹配的MIME类型。 187 188- 示例 189 190```js 191import featureAbility from '@ohos.ability.featureAbility' 192var DAHelper = await featureAbility.getDataAbilityHelper( 193 "dataability:///com.example.DataAbility" 194); 195DAHelper.getType( 196 "dataability:///com.example.DataAbility" 197) 198``` 199 200#### DataAbilityHelper.getType(uri: string) 201 202- 接口说明 203 204 获取给定URI指定的日期的MIME类型(Promise形式) 205 206- 参数描述 207 208 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 209 | ---- | -------- | ------ | ---- | ------------------------ | 210 | uri | 只读 | string | 是 | 指示要操作的数据的路径。 | 211 212- 返回值 213 214 返回与uri指定的数据匹配的MIME类型。 215 216- 示例 217 218```js 219import featureAbility from '@ohos.ability.featureAbility' 220var DAHelper = await featureAbility.getDataAbilityHelper( 221 "dataability:///com.example.DataAbility" 222); 223DAHelper.getType( 224 "dataability:///com.example.DataAbility" 225 ).then((void) => { 226 console.info("==========================>getTypeCallback=======================>"); 227}); 228``` 229 230#### DataAbilityHelper.getFileTypes(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array\<string>>) 231 232- 接口说明 233 234 获取支持的文件的MIME类型(callback形式) 235 236- 参数描述 237 238 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 239 | -------------- | -------- | ---------------------- | ---- | ---------------------------- | 240 | uri | 只读 | string | 是 | 指示要获取的文件的路径。 | 241 | mimeTypeFilter | 只读 | string | 是 | 指示要获取的文件的MIME类型。 | 242 | callback | 只读 | AsyncCallback\<string> | 是 | 回调方法 | 243 244- 返回值 245 246 返回匹配的MIME类型数组。 247 248- 示例 249 250```js 251import featureAbility from '@ohos.ability.featureAbility' 252var DAHelper = await featureAbility.getDataAbilityHelper( 253 "dataability:///com.example.DataAbility" 254); 255DAHelper.getFileTypes( 256 "dataability:///com.example.DataAbility", 257 "image/*" 258) 259``` 260 261#### DataAbilityHelper.getFileTypes(uri: string, mimeTypeFilter: string) 262 263- 接口说明 264 265 获取支持的文件的MIME类型(Promise形式) 266 267- 参数描述 268 269 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 270 | -------------- | -------- | ------ | ---- | ---------------------------- | 271 | uri | 只读 | string | 是 | 指示要获取的文件的路径。 | 272 | mimeTypeFilter | 只读 | string | 是 | 指示要获取的文件的MIME类型。 | 273 274- 返回值 275 276 返回匹配的MIME类型数组。 277 278- 示例 279 280```js 281import featureAbility from '@ohos.ability.featureAbility' 282var DAHelper = await featureAbility.getDataAbilityHelper( 283 "dataability:///com.example.DataAbility" 284); 285DAHelper.getFileTypes( 286 "dataability:///com.example.DataAbility", 287 "image/*" 288 ).then((void) => { 289 console.info("==========================>getFileTypesCallback=======================>"); 290}); 291``` 292 293#### DataAbilityHelper.normalizeUri(uri: string, callback: AsyncCallback\<string>) 294 295- 接口说明 296 297 将引用数据功能的给定uri转换为规范化uri(callback形式) 298 299- 参数描述 300 301 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 302 | -------- | -------- | ---------------------- | ---- | ----------------------- | 303 | uri | 只读 | string | 是 | 指示要规范化的uri对象。 | 304 | callback | 只读 | AsyncCallback\<string> | 是 | 回调方法 | 305 306- 返回值 307 308 如果数据功能支持uri规范化或null，则返回规范化uri对象。 309 310- 示例 311 312```js 313import featureAbility from '@ohos.ability.featureAbility' 314var DAHelper = await featureAbility.getDataAbilityHelper( 315 "dataability:///com.example.DataAbility" 316); 317DAHelper.normalizeUri( 318 "dataability:///com.example.DataAbility", 319) 320``` 321 322#### DataAbilityHelper.normalizeUri(uri: string) 323 324- 接口说明 325 326 将引用数据功能的给定uri转换为规范化uri(Promise形式) 327 328- 参数描述 329 330 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 331 | ---- | -------- | ------ | ---- | ----------------------- | 332 | uri | 只读 | string | 是 | 指示要规范化的uri对象。 | 333 334- 返回值 335 336 如果数据功能支持uri规范化或null，则返回规范化uri对象。 337 338- 示例 339 340```js 341import featureAbility from '@ohos.ability.featureAbility' 342var DAHelper = await featureAbility.getDataAbilityHelper( 343 "dataability:///com.example.DataAbility" 344); 345DAHelper.normalizeUri( 346 "dataability:///com.example.DataAbility", 347 ).then((void) => { 348 console.info("==========================>normalizeUriCallback=======================>"); 349}); 350``` 351 352#### DataAbilityHelper.denormalizeUri(uri: string, callback: AsyncCallback\<string>) 353 354- 接口说明 355 356 将由normalizeUri（uri）生成的给定规范化uri转换为非规范化uri(callback形式) 357 358- 参数描述 359 360 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 361 | -------- | -------- | ---------------------- | ---- | ----------------------- | 362 | uri | 只读 | string | 是 | 指示要规范化的uri对象。 | 363 | callback | 只读 | AsyncCallback\<string> | 是 | 回调方法 | 364 365- 返回值 366 367 如果反规范化成功，则返回反规范化uri对象。 368 369- 示例 370 371```js 372import featureAbility from '@ohos.ability.featureAbility' 373var DAHelper = await featureAbility.getDataAbilityHelper( 374 "dataability:///com.example.DataAbility" 375); 376DAHelper.denormalizeUri( 377 "dataability:///com.example.DataAbility", 378) 379``` 380 381#### DataAbilityHelper.denormalizeUri(uri: string) 382 383- 接口说明 384 385 将由normalizeUri（uri）生成的给定规范化uri转换为非规范化uri(Promise形式) 386 387- 参数描述 388 389 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 390 | ---- | -------- | ------ | ---- | ----------------------- | 391 | uri | 只读 | string | 是 | 指示要规范化的uri对象。 | 392 393- 返回值 394 395 如果反规范化成功，则返回反规范化uri对象。 396 397- 示例 398 399```js 400import featureAbility from '@ohos.ability.featureAbility' 401var DAHelper = await featureAbility.getDataAbilityHelper( 402 "dataability:///com.example.DataAbility" 403); 404DAHelper.denormalizeUri( 405 "dataability:///com.example.DataAbility", 406 ).then((void) => { 407 console.info("==========================>denormalizeUriCallback=======================>"); 408}); 409``` 410 411#### DataAbilityHelper.notifyChange(uri: string, callback: AsyncCallback\<void>) 412 413- 接口说明 414 415 通知已注册的观察者uri指定的数据资源的更改(callback形式) 416 417- 参数描述 418 419 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 420 | -------- | -------- | -------------------- | ---- | ------------------------ | 421 | uri | 只读 | string | 是 | 指示要操作的数据的路径。 | 422 | callback | 只读 | AsyncCallback\<void> | 是 | 回调方法 | 423 424- 返回值 425 426 void 427 428- 示例 429 430```js 431import featureAbility from '@ohos.ability.featureAbility' 432var helper = await featureAbility.getDataAbilityHelper( 433 "dataability:///com.example.DataAbility" 434); 435helper.notifyChange( 436 "dataability:///com.example.DataAbility", 437) 438``` 439 440#### DataAbilityHelper.notifyChange(uri: string) 441 442- 接口说明 443 444 通知已注册的观察者uri指定的数据资源的更改(Promise形式) 445 446- 参数描述 447 448 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 449 | ---- | -------- | ------ | ---- | ------------------------ | 450 | uri | 只读 | string | 是 | 指示要操作的数据的路径。 | 451 452- 返回值 453 454 void 455 456- 示例 457 458```js 459import featureAbility from '@ohos.ability.featureAbility' 460var DAHelper = await featureAbility.getDataAbilityHelper( 461 "dataability:///com.example.DataAbility" 462); 463DAHelper.notifyChange( 464 "dataability:///com.example.DataAbility", 465 ).then((void) => { 466 console.info("==========================>notifyChangeCallback=======================>"); 467}); 468``` 469 470#### DataAbilityHelper.insert(uri: string, valuesBucket: rdb.ValuesBucket, callback: AsyncCallback\<number>) 471 472- 接口说明 473 474 将单个数据记录插入数据库(callback形式) 475 476- 参数描述 477 478 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 479 | ------------ | -------- | ---------------------- | ---- | ------------------------------------------------------ | 480 | uri | 只读 | string | 是 | 指示要插入的数据的路径。 | 481 | valuesBucket | 只读 | rdb.ValuesBucket | 是 | 指示要插入的数据记录。如果此参数为空，将插入一个空行。 | 482 | callback | 只读 | AsyncCallback\<number> | 是 | 回调方法 | 483 484- 返回值 485 486 返回插入数据记录的索引。 487 488- 示例 489 490```js 491import featureAbility from '@ohos.ability.featureAbility' 492var DAHelper = await featureAbility.getDataAbilityHelper( 493 "dataability:///com.example.DataAbility" 494); 495const valueBucket = { 496 "name": "rose", 497 "age": 22, 498 "salary": 200.5, 499 "blobType": u8, 500} 501DAHelper.insert( 502 "dataability:///com.example.DataAbility", 503 valueBucket 504) 505``` 506 507#### DataAbilityHelper.insert(uri: string, valuesBucket: rdb.ValuesBucket) 508 509- 接口说明 510 511 将单个数据记录插入数据库(Promise形式) 512 513- 参数描述 514 515 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 516 | ------------ | -------- | ---------------- | ---- | ------------------------------------------------------ | 517 | uri | 只读 | string | 是 | 指示要插入的数据的路径。 | 518 | valuesBucket | 只读 | rdb.ValuesBucket | 是 | 指示要插入的数据记录。如果此参数为空，将插入一个空行。 | 519 520- 返回值 521 522 返回插入数据记录的索引。 523 524- 示例 525 526```js 527import featureAbility from '@ohos.ability.featureAbility' 528var DAHelper = await featureAbility.getDataAbilityHelper( 529 "dataability:///com.example.DataAbility" 530); 531const valueBucket = { 532 "name": "rose1", 533 "age": 221, 534 "salary": 20.5, 535 "blobType": u8, 536} 537DAHelper.insert( 538 "dataability:///com.example.DataAbility", 539 valueBucket 540 ).then((void) => { 541 console.info("==========================>insertCallback=======================>"); 542}); 543``` 544 545#### DataAbilityHelper.batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback\<number>) 546 547- 接口说明 548 549 将多个数据记录插入数据库(callback形式) 550 551- 参数描述 552 553 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 554 | ------------ | -------- | ----------------------- | ---- | ------------------------ | 555 | uri | 只读 | string | 是 | 指示要插入的数据的路径。 | 556 | valuesBucket | 只读 | Array<rdb.ValuesBucket> | 是 | 指示要插入的数据记录。 | 557 | callback | 只读 | AsyncCallback\<number> | 是 | 回调方法 | 558 559- 返回值 560 561 返回插入的数据记录数。 562 563- 示例 564 565```js 566import featureAbility from '@ohos.ability.featureAbility' 567var DAHelper = await featureAbility.getDataAbilityHelper( 568 "dataability:///com.example.DataAbility" 569); 570var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": u8,}, 571 {"name": "roe12", "age": 21, "salary": 20.5, "blobType": u8,}, 572 {"name": "roe13", "age": 21, "salary": 20.5, "blobType": u8,}) 573DAHelper.batchInsert( 574 "dataability:///com.example.DataAbility", 575 cars 576) 577``` 578 579#### DataAbilityHelper.batchInsert(uri: string, valuesBuckets: Array<rdb.ValuesBucket>) 580 581- 接口说明 582 583 将多个数据记录插入数据库(Promise形式) 584 585- 参数描述 586 587 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 588 | ------------ | -------- | ----------------------- | ---- | ------------------------ | 589 | uri | 只读 | string | 是 | 指示要插入的数据的路径。 | 590 | valuesBucket | 只读 | Array<rdb.ValuesBucket> | 是 | 指示要插入的数据记录。 | 591 592- 返回值 593 594 返回插入的数据记录数。 595 596- 示例 597 598```js 599import featureAbility from '@ohos.ability.featureAbility' 600var DAHelper = await featureAbility.getDataAbilityHelper( 601 "dataability:///com.example.DataAbility" 602); 603var cars = new Array({"name": "roe11", "age": 21, "salary": 20.5, "blobType": u8,}, 604 {"name": "roe12", "age": 21, "salary": 20.5, "blobType": u8,}, 605 {"name": "roe13", "age": 21, "salary": 20.5, "blobType": u8,}) 606DAHelper.batchInsert( 607 "dataability:///com.example.DataAbility", 608 cars 609 ).then((void) => { 610 console.info("==========================>batchInsertCallback=======================>"); 611}); 612``` 613 614#### DataAbilityHelper.delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>) 615 616- 接口说明 617 618 从数据库中删除一个或多个数据记录(callback形式) 619 620- 参数描述 621 622 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 623 | ------------ | -------- | --------------------------------- | ---- | ------------------------------------------------ | 624 | uri | 只读 | string | 是 | 指示要删除的数据的路径。 | 625 | valuesBucket | 只读 | dataAbility.DataAbilityPredicates | 是 | 指示筛选条件。当此参数为null时，应定义处理逻辑。 | 626 | callback | 只读 | AsyncCallback\<number> | 是 | 回调方法 | 627 628- 返回值 629 630 返回已删除的数据记录数。 631 632- 示例 633 634```js 635import featureAbility from '@ohos.ability.featureAbility' 636import ohos_data_ability from '@ohos.data.dataability' 637var DAHelper = await featureAbility.getDataAbilityHelper( 638 "dataability:///com.example.DataAbility" 639); 640let da = new ohos_data_ability.DataAbilityPredicates() 641DAHelper.delete( 642 "dataability:///com.example.DataAbility", 643 da 644) 645``` 646 647#### DataAbilityHelper.delete(uri: string, predicates: dataAbility.DataAbilityPredicates) 648 649- 接口说明 650 651 从数据库中删除一个或多个数据记录(Promise形式) 652 653- 参数描述 654 655 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 656 | ------------ | -------- | --------------------------------- | ---- | ------------------------------------------------ | 657 | uri | 只读 | string | 是 | 指示要删除的数据的路径。 | 658 | valuesBucket | 只读 | dataAbility.DataAbilityPredicates | 是 | 指示筛选条件。当此参数为null时，应定义处理逻辑。 | 659 660- 返回值 661 662 返回已删除的数据记录数。 663 664- 示例 665 666```js 667import featureAbility from '@ohos.ability.featureAbility' 668var DAHelper = await featureAbility.getDataAbilityHelper( 669 "dataability:///com.example.DataAbility" 670); 671let da = new ohos_data_ability.DataAbilityPredicates() 672DAHelper.delete( 673 "dataability:///com.example.DataAbility", 674 da 675 ).then((void) => { 676 console.info("==========================>deleteCallback=======================>"); 677}); 678``` 679 680#### DataAbilityHelper.update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<number>) 681 682- 接口说明 683 684 更新数据库中的数据记录(callback形式) 685 686- 参数描述 687 688 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 689 | ------------ | -------- | --------------------------------- | ---- | ------------------------------------------------ | 690 | uri | 只读 | string | 是 | 指示要更新的数据的路径。 | 691 | valuesBucket | 只读 | rdb.ValuesBucket | 是 | 指示要更新的数据。 | 692 | predicates | 只读 | dataAbility.DataAbilityPredicates | 是 | 指示筛选条件。当此参数为null时，应定义处理逻辑。 | 693 | callback | 只读 | AsyncCallback\<number> | 是 | 回调方法 | 694 695- 返回值 696 697 返回更新的数据记录数。 698 699- 示例 700 701```js 702import featureAbility from '@ohos.ability.featureAbility' 703import ohos_data_ability from '@ohos.data.dataability' 704var DAHelper = await featureAbility.getDataAbilityHelper( 705 "dataability:///com.example.DataAbility" 706); 707const va = { 708 "name": "roe1", 709 "age": 21, 710 "salary": 20.5, 711 "blobType": u8, 712} 713let da = new ohos_data_ability.DataAbilityPredicates() 714DAHelper.update( 715 "dataability:///com.example.DataAbility", 716 va, 717 da 718) 719``` 720 721#### DataAbilityHelper.update(uri: string, valuesBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates) 722 723- 接口说明 724 725 更新数据库中的数据记录(Promise形式) 726 727- 参数描述 728 729 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 730 | ------------ | -------- | --------------------------------- | ---- | ------------------------------------------------ | 731 | uri | 只读 | string | 是 | 指示要更新的数据的路径。 | 732 | valuesBucket | 只读 | rdb.ValuesBucket | 是 | 指示要更新的数据。 | 733 | predicates | 只读 | dataAbility.DataAbilityPredicates | 是 | 指示筛选条件。当此参数为null时，应定义处理逻辑。 | 734 735- 返回值 736 737 返回更新的数据记录数。 738 739- 示例 740 741```js 742import featureAbility from '@ohos.ability.featureAbility' 743import ohos_data_ability from '@ohos.data.dataability' 744var DAHelper = await featureAbility.getDataAbilityHelper( 745 "dataability:///com.example.DataAbility" 746); 747const va = { 748 "name": "roe1", 749 "age": 21, 750 "salary": 20.5, 751 "blobType": u8, 752} 753let da = new ohos_data_ability.DataAbilityPredicates() 754DAHelper.update( 755 "dataability:///com.example.DataAbility", 756 va, 757 da 758 ).then((void) => { 759 console.info("==========================>updateCallback=======================>"); 760}); 761``` 762 763#### DataAbilityHelper.query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback\<ResultSet>) 764 765- 接口说明 766 767 查询数据库中的数据(callback形式) 768 769- 参数描述 770 771 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 772 | ---------- | -------- | --------------------------------- | ---- | ------------------------------------------------ | 773 | uri | 只读 | string | 是 | 指示要查询的数据的路径。 | 774 | columns | 只读 | rdb.ValuesBucket | 是 | 指示要查询的列。如果此参数为空，则查询所有列。 | 775 | predicates | 只读 | dataAbility.DataAbilityPredicates | 是 | 指示筛选条件。当此参数为null时，应定义处理逻辑。 | 776 | callback | 只读 | AsyncCallback\<ResultSet> | 是 | 回调方法 | 777 778- 返回值 779 780 返回查询结果 781 782- 示例 783 784```js 785import featureAbility from '@ohos.ability.featureAbility' 786import ohos_data_ability from '@ohos.data.dataability' 787var DAHelper = await featureAbility.getDataAbilityHelper( 788 "dataability:///com.example.DataAbility" 789); 790var cars=new Array({"value1"}, {"value2"}, {"value3"}, {"value4"}); 791let da = new ohos_data_ability.DataAbilityPredicates() 792DAHelper.query( 793 "dataability:///com.example.DataAbility", 794 cars, 795 da 796) 797``` 798 799 800 801#### DataAbilityHelper.query(uri: string, columns: Array\<string>, predicates: dataAbility.DataAbilityPredicates) 802 803- 接口说明 804 805 查询数据库中的数据(Promise形式) 806 807- 参数描述 808 809 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 810 | ---------- | -------- | --------------------------------- | ---- | ------------------------------------------------ | 811 | uri | 读写 | string | 是 | 指示要查询的数据的路径。 | 812 | columns | 读写 | rdb.ValuesBucket | 是 | 指示要查询的列。如果此参数为空，则查询所有列。 | 813 | predicates | 读写 | dataAbility.DataAbilityPredicates | 是 | 指示筛选条件。当此参数为null时，应定义处理逻辑。 | 814 815- 返回值 816 817 返回查询结果 818 819- 示例 820 821```js 822import featureAbility from '@ohos.ability.featureAbility' 823import ohos_data_ability from '@ohos.data.dataability' 824var DAHelper = await featureAbility.getDataAbilityHelper( 825 "dataability:///com.example.DataAbility" 826); 827var cars=new Array({"value1"}, {"value2"}, {"value3"}, {"value4"}); 828let da = new ohos_data_ability.DataAbilityPredicates() 829DAHelper.query( 830 "dataability:///com.example.DataAbility", 831 cars, 832 da 833 ).then((void) => { 834 console.info("==========================>queryCallback=======================>"); 835}); 836``` 837 838