鸿蒙Harmony应用开发（5.0 ）DataAbility生命周期/组件配置

 鸿蒙开发往期必看：

HarmonyOS NEXT应用开发性能实践总结

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

 “一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径！

---

DataAbility组件概述

DataAbility，即"使用Data模板的Ability"，主要用于对外部提供统一的数据访问抽象，不提供用户交互界面。DataAbility可由PageAbility、ServiceAbility或其他应用启动，即使用户切换到其他应用，DataAbility仍将在后台继续运行。

使用DataAbility有助于应用管理其自身和其他应用存储数据的访问，并提供与其他应用共享数据的方法。DataAbility既可用于同设备不同应用的数据共享，也支持跨设备不同应用的数据共享。

数据的存放形式多样，可以是数据库，也可以是磁盘上的文件。DataAbility对外提供对数据的增、删、改、查，以及打开文件等接口，这些接口的具体实现由开发者提供。

DataAbility组件配置

URI介绍

DataAbility的提供方和使用方都通过URI（Uniform Resource Identifier）来标识一个具体的数据，例如数据库中的某个表或磁盘上的某个文件。此处的URI仍基于URI通用标准，格式如下：

• scheme：协议方案名，固定为"dataability"，代表Data Ability所使用的协议类型。

• authority：设备ID。如果为跨设备场景，则为目标设备的ID；如果为本地设备场景，则不需要填写。

• path：资源的路径信息，代表特定资源的位置信息。

• query：查询参数。

• fragment：可以用于指示要访问的子资源。

URI示例：

• 跨设备场景：dataability://device_id/com.domainname.dataability.persondata/person/10

• 本地设备：dataability:///com.domainname.dataability.persondata/person/1

说明： 本地设备的"device_id"字段为空，因此在"dataability:“后面有三个”/"。

部分配置项介绍

与PageAbility类似，DataAbility的相关配置在config.json配置文件的"module"对象的"abilities"对象中，与PageAbility的区别在于"type"属性及"uri"属性。

表1 DataAbility的部分配置项说明

Json重要字段	备注说明
“name”	Ability名称。
“type”	UIAbility类型，DataAbility的类型为"data"。
“uri”	通信使用的URI。
“visible”	对其他应用是否可见，设置为true时，DataAbility才能与其他应用进行通信传输数据。

config.json配置样例

"abilities": [
  ...
  {
    "name": ".DataAbility",
    "srcLanguage": "ets",
    "srcPath": "DataAbility",
    "icon": "$media:icon",
    "description": "$string:DataAbility_desc",
    "type": "data",
    "visible": true,
    "uri": "dataability://com.samples.famodelabilitydevelop.DataAbility",
    "readPermission": "ohos.permission.READ_CONTACTS",
    "writePermission": "ohos.permission.WRITE_CONTACTS"
  },
  ...
]

DataAbility支持的配置项及详细说明详见module对象内部结构。

DataAbility的生命周期

应用开发者可以根据业务场景实现data.js/data.ets中的生命周期相关接口。DataAbility生命周期接口说明见下表。

表1 DataAbility相关生命周期API功能介绍

接口名	描述
onInitialized?(info: AbilityInfo): void	在Ability初始化调用，通过此回调方法执行RDB等初始化操作。
update?(uri: string, valueBucket: rdb.ValuesBucket, predicates:  dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void	更新数据库中的数据。
query?(uri: string, columns: Array<string>, predicates: dataAbility. DataAbilityPredicates, callback: AsyncCallback<ResultSet>): void	查询数据库中的数据。
delete?(uri: string, predicates: dataAbility.DataAbilityPredicates,  callback: AsyncCallback<number>): void	删除一条或多条数据。
normalizeUri?(uri: string, callback: AsyncCallback<string>): void	对URI进行规范化。一个规范化的URI可以支持跨设备使用、持久化、备份和还原等，当上下文改变时仍然可以引用到相同的数据项。
batchInsert?(uri: string, valueBuckets: Array<rdb.ValuesBucket>,  callback: AsyncCallback<number>): void	向数据库中插入多条数据。
denormalizeUri?(uri: string, callback: AsyncCallback<string>): void	将一个由normalizeUri生产的规范化URI转换成非规范化的URI。
insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback<number>): void	向数据中插入一条数据。
openFile?(uri: string, mode: string, callback: AsyncCallback<number>): void	打开一个文件。
getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array<string>>): void	获取文件的MIME类型。
getType?(uri: string, callback: AsyncCallback<string>): void	获取URI指定数据相匹配的MIME类型。
executeBatch?(ops: Array<DataAbilityOperation>, callback: AsyncCallback<Array<DataAbilityResult>>): void	批量操作数据库中的数据。
call?(method: string, arg: string, extras: PacMap, callback: AsyncCallback<PacMap>): void	自定义方法。

最后

小编在之前的鸿蒙系统扫盲中，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）路线图、文档、视频、用来跟着学习是非常有必要的。 

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员

→ 鸿蒙全栈开发学习笔记 希望这一份鸿蒙学习文档能够给大家带来帮助~