5.10节演示了如何通过DataAbilityHelper类访问当前应用的文件数据。本节将演示如何通过DataAbilityHelper类访问当前应用的数据库数据。采用Car设备类型,创建一个名为DataAbility-HelperAccessDatabase的应用。
在DevEco Studio中创建一个名为UserDataAbility的Data,如图5-24所示。
图5-24 创建一个名为UserDataAbility的Data
UserDataAbility初始化时代码如下:
UserDataAbility自动在配置文件中添加了相应的配置,内容如下:
从上述配置中可以看出,type类型设置为data;uri为对外提供的访问路径,全局唯一;permis-sions为访问该Data Ability时需要申请的访问权限。
HarmonyOS关系型数据库对外提供通用的操作接口,底层使用SQLite作为持久化存储引擎,支持SQLite具有的所有数据库特性,包括但不限于事务、索引、视图、触发器、外键、参数化查询和预编译SQL语句。初始化数据库,代码如下:
上述代码中:
(1)初始化了一个名为RdbStoreTest.db的数据库。
(2)创建了一个名为user_t的表结构。该表包含user_id、user_name和user_age三个字段,其中user_id为主键。
(3)初始化了RdbStore,用于方便后续关系型数据库(Relational DataBase,RDB)的管理。
重写UserDataAbility的query()方法,代码如下:
上述代码中:
(1)DataAbilityUtils工具类将入参DataAbilityPredicates转换为RdbStore所能处理的RdbPre-dicates。
(2)通过RdbStore查询所需要的字段。
重写UserDataAbility的insert()方法,代码如下:
上述代码中,通过RdbStore插入表对应的数据;RdbStore插入数据后的返回值是该插入数据的主键,即user_id字段值。
重写UserDataAbility的update()方法,代码如下:
上述代码中,DataAbilityUtils工具类将入参DataAbilityPredicates转换为RdbStore所能处理的RdbPredicates;通过RdbStore更新了对应条件的数据,更新后返回的value值代表更新的数量。
重写UserDataAbility的delete()方法,代码如下:
上述代码中,DataAbilityUtils工具类将入参DataAbilityPredicates转换为RdbStore所能处理的RdbPredicates;通过RdbStore删除了对应条件的数据,删除后返回的value值代表删除的数量。
修改MainAbilitySlice的onStart()方法,代码如下:
上述代码中:
(1)在Text中添加单击事件,触发访问数据库的操作。
(2)doDatabaseAction()方法用于执行数据库操作。借助DataAbilityHelper类的方法,访问当前UserDataAbility提供的数据库数据,分别执行了查询、插入、查询、更新、查询、删除和查询动作。
注意:上述代码中访问的URI与UserDataAbility在配置数据库中的添加的URI基本一致,唯一的区别是上述代码中访问的URI用三个斜杠。
运行应用后,效果如图5-25所示。
图5-25 应用运行效果
单击文本Hello World,触发访问数据库操作,可以看到控制台HiLog输出内容如下:
从上述运行日志,可以验证程序的运行状态。
(1)执行查询,数据库中的数据为空。
(2)插入一条用户数据,该数据的user_id是101。
(3)执行查询,返回user_id是101的用户数据,其中user_name是Way Lau,user_age是33。
(4)执行更新操作。
(5)执行查询,可以看到user_id是101的用户数据,user_age被改为35。
(6)执行删除操作。
(7)执行查询,数据库中的数据为空。