鸿蒙HarmonyOS NEXT开发：数据长期化方案剖析与实践

（一）PersistentStorage 实现应用长期化数据管理

功能概述：

        通过 PersistentStorage 类可管理应用长期化数据，能将特定标记的长期化数据链接到 AppStorage 中，再由 AppStorage 接口访问对应数据。长期化后的数据会生本钱地 xml 文件保存，文件路径为 /data/app/el2/100/base/<bundleName>/haps/<hapName>/files/persistent_storage。
特性：

• 自动同步：PersistentStorage 会自动和 AppStorage 中数据同步。
  
• 长期化存储：存储的数据为长期化存储。
  
• 初始值设置：利用 PersistentStorage.PersistProp (' 属性名 ', 初始值) 设置初始值时，只有第一次会收效。
  

代码示例及步骤

首先，进行长期化数据的设置
        在以下代码中，我们利用 PersistentStorage.persistProp 来设置长期化数据。这里我们设置了一个名为 'num' 的属性，初始值为 0。这一步是创建长期化数据的关键。

1. // 持久化模块，设置键值及初始化的值
2. PersistentStorage.persistProp('num',0)

复制代码

然后，在组件中绑定长期化数据
        在 @Entry 装饰的组件中，我们利用 @StorageLink('num') 来将组件中的 num 属性与之前设置的长期化数据 'num' 进行绑定。这样，组件中的数据变化会反映到长期化存储中。

1. @Entry
2. @Component
3. struct Index {
4.     // 绑定模块，使用AppStoage的API，如@StorageLink(键)、@StorageProp(键)修饰，使用AppStoage.get、AppStoage.set等方法调用
5.     @StorageLink('num') num :number = 0
6.     build() {
7.         RelativeContainer() {
8.             Text(this.num.toString())
9.               .onClick(() => {
10.                     this.num++
11.                 })
12.               .fontSize(50)
13.               .fontWeight(FontWeight.Bold)
14.               .alignRules({
15.                     center: { anchor: '__container__', align: VerticalAlign.Center },
16.                     middle: { anchor: '__container__', align: HorizontalAlign.Center }
17.                 })
18.         }
19.       .height('100%')
20.       .width('100%')
21.     }
22. }

复制代码

 完整代码：

1. // 代码示例
2. PersistentStorage.persistProp('num',0)      // 持久化模块，参数1：键， 参数2：初始化的值
4. @Entry
5. @Component
6. struct Index {
7.    // 绑定模块 使用AppStoage的API，如@StorageLink(键)、@StorageProp(键)修饰，使用AppStoage.get、AppStoage.set等方法调用
9.   @StorageLink('num') num :number = 0
10.   build() {
11.     RelativeContainer() {
12.       Text(this.num.toString())
13.         .onClick(() => {
14.           this.num++
15.         })
16.         .fontSize(50)
17.         .fontWeight(FontWeight.Bold)
18.         .alignRules({
19.           center: { anchor: '__container__', align: VerticalAlign.Center },
20.           middle: { anchor: '__container__', align: HorizontalAlign.Center }
21.         })
22.     }
23.     .height('100%')
24.     .width('100%')
25.   }
26. }

复制代码

（二）用户首选项长期化


功能概述：

为应用提供 Key-Value 键值型的数据处置惩罚能力，支持应用长期化轻量级数据，并可对其进行修改和查询。

操作步骤：

• 创建实例：需先创建用户首选项长期化实例存放到磁盘目录中，通过 preferences.getPreferencesSync (getContext (),{name:'xxx'}) 来创建，其中参数 1 为"上下文"，参数 2 为与 Preferences 实例相关的配置选项，name 为必填参数，指 Preferences 实例的名称。
  
• 修改数据：利用实例对象中的 putSync (key, 数据) 方法实现数据修改，有则改、无则加。
  
• 获取数据：通过 getSync (key, 默认值) 方法可获取对应的值，当 key 不存在时，则得到的值为默认值。
  
• 删除数据：调用 deleteSync (key) 方法可实现删除该键的数据。
  
• 刷盘同步：对实例进行操作后需要调用 flush () 方法进行刷盘，才会同步到当地磁盘。
  

封装工具类完整代码：

1. // 封装用户首选项持久化的工具类
2. import { preferences } from "@kit.ArkData";
4. export class preferencesUtil<T extends preferences.ValueType>{
5.     private pre: preferences.Preferences
6.     // 构造函数进行初始化，传name参数
7.     constructor(name: string) {
8.         this.pre = preferences.getPreferencesSync(getContext(),{name:name})
9.     }
10.     // 增、改 键-值
11.     put(key:string, value:T):T{
12.         this.pre.putSync(key,value)
13.         this.pre.flush()
14.         return value
15.     }
16.     // 查  键-默认值（查不到返回的为默认值）
17.     get(key:string, value:T):T{
18.         return this.pre.getSync(key,value) as T
19.     }
20.     // 删  键
21.     del(key:string){
22.         this.pre.deleteSync(key)
23.         this.pre.flush()
24.     }
25. }

复制代码

测试代码示例：

1. // 测试代码
2. import { preferencesUtil } from '../preferencesUtil'
4. @Entry
5. @Component
6. struct Index {
7.     // 实例化用户首选项工具
8.     pre = new preferencesUtil<number>('xxx')
9.     // 获取首次数据
10.     @State num :number = this.pre.get('xxx',0)
12.     build() {
13.         Column() {
14.             Text(this.num.toString())
15.             Button('加一')
16.                .onClick(()=>{
17.                     // 更新数据
18.                     this.num = this.pre.put('xxx', ++this.num)
19.                 })
20.         }
21.        .height('100%')
22.        .width('100%')
23.     }
24. }

复制代码

（三）数据库长期化（基于关系型数据库）

功能概述：

        关系型数据库（Relational Database，RDB）基于 SQLite 组件提供了一套完整的对当地数据库进行管理的机制，对外提供一系列增、删、改、查等接口，也可直接运行用户输入的 SQL 语句来满足复杂场景需要。
官方网址：

官方链接
封装工具类及测试代码示例：

1. import { relationalStore, ValuesBucket } from "@kit.ArkData";
2. // 定义数据的结构
3. export interface IRdb extends ValuesBucket{
4.   id:number
5.   title:string
6.   content:string
7. }
9. export class RDBUtil{
11.   private tableName = 'rdbName'
12.   store: relationalStore.RdbStore | undefined = undefined;
14.   // 初始化
15.   async init(){
16.     const store = await relationalStore.getRdbStore(getContext(), {
17.       // 数据库的名
18.       name: 'databaseName.db',
19.       // 安全级别
20.       securityLevel: relationalStore.SecurityLevel.S1
21.     })
22.     // 定义数据库的表
23.     store.executeSql(`
24.         CREATE TABLE IF NOT EXISTS ${this.tableName} (
25.           id INTEGER PRIMARY KEY AUTOINCREMENT,
26.           title TEXT NOT NULL,
27.           content TEXT NOT NULL
28.         )
29.       `)
30.     this.store = store
31.   }
33.   // 增
34.   async addSql(title:string, content:string){
35.     this.store?.executeSql(
36.       `
37.       INSERT INTO ${this.tableName} (id, title, content)
38.       VALUES (null, '${title}', '${content}')
39.       `
40.     )
41.   }
43.   // 删
44.   async delSqlById(id:number){
45.     this.store?.executeSql(`
46.     DELETE FROM ${this.tableName} WHERE id = ${id};
47.     `)
48.   }
50.   // 改
51.   async updateSql(id:number, title:string, content:string){
52.     this.store?.executeSql(`
53.     UPDATE ${this.tableName}
54.     SET title = '${title}', content = '${content}'
55.     WHERE id = ${id}
56.     `)
57.   }
59.   // 查
60.   async getSql(){
61.     let dataIndex = this.store?.querySqlSync(`
62.     SELECT * FROM ${this.tableName}
63.     `)
64.     let list:IRdb[] = []
65.     while (dataIndex?.goToNextRow()){
66.       list.push(dataIndex.getRow() as IRdb)
67.     }
68.     dataIndex?.close()
69.     return list
70.   }
72. }

复制代码

1. // 测试代码
2. import { IRdb, RDBUtil } from '../utils/RDBUtil'
4. @Entry
5. @Component
6. struct Index {
7.   @State list:IRdb[] = []
8.   rdb = new RDBUtil()
9.   aboutToAppear(): void {
10.     this.rdb.init()
11.   }
12.   build() {
13.     Column() {
14.       Text(JSON.stringify(this.list,null,2))
15.       Button('加')
16.         .onClick(()=>{
17.           this.rdb.addSql('xx','yyy')
18.         })
19.       Button('删')
20.         .onClick(async ()=>{
21.           await this.rdb.delSqlById(5)
22.         })
23.       Button('改')
24.         .onClick(()=>{
25.           this.rdb.updateSql(1,'jjj','ttt')
26.         })
27.       Button('查')
28.         .onClick(async () => {
29.           this.list = await this.rdb.getSql()
30.         })
31.     }
32.     .height('100%')
33.     .width('100%')
34.   }
35. }

复制代码

留意事项：

利用 SQL 语句存在一个 bug，即增、删、改之后不能立刻查到处置惩罚后的结果。解决方法可以是延迟查询大概查询官网看是否有不利用 SQL 语句的替代方式。比方以下代码情况：

1. // 如 一下代码，不能立刻得到处理后的结果，处理方法延迟或查询官网不使用SQL语句
2. Button('加')
3.   .onClick(async ()=>{
4.     this.rdb.addSql('xx','yyy')
5.     this.list = await this.rdb.getSql()
6.   })
7. Button('删')
8.   .onClick(async ()=>{
9.     await this.rdb.delSqlById(5)
10.     this.list = await this.rdb.getSql()
11.   })
12. Button('改')
13.   .onClick(async ()=>{
14.     this.rdb.updateSql(1,'jjj','ttt')
15.     this.list = await this.rdb.getSql()
16.   })

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。