HarmonyOS鸿蒙应用开辟——数据长期化之Preferences

数据长期化简述

数据长期化就是将内存数据通过文件大概数据库的方式生存到设备中。HarmonyOS提供两两种长期化方案：

• Preferences：主要用于生存一些配置信息，是通过文本的形式存储的，在使用中会将文本中的数据全量加载到内存中，不太适合存储大量数据的场景。
  
• 数据库：分为两种，一种黑白关系型数据库，数据是键值对的形式存储；别的一种事关系型数据库，数据是行和列的形式存储，提供一个系列的增删改查等SQL操纵，适合数据复杂的场景，比如聊天会话记录等等。
  

基本使用与封装

Preferences提供了获取实例、读、取、删对应操纵的方法：

• getPreferences(context,name)：获取Preferences实例，name是存储的文件名；
  
• get(k)：通过key获取value值；
  
• getAll()：获取文件全部的值；
  
• put(k,v)：添加值，同一个key会将之前的值覆盖掉，需要通过flush()革新到文件中；
  
• delete(k)：通过key删除对应的value值；
  
• clear()：删除全部的存储值。
  

   留意：以上方法都是异步的。
  通常会在EntryAbility#onCreate()方法中创建实例，其中context便是EntryAbility的上下文，获取preferences 实例就可以对数据增删改查操纵。

1. // 导入包
2. import dataPreferences from '@ohos.data.preferences'
3. // 获取实例
4. let preferences = dataPreferences.getPreferences(context, this.preferencesName)

复制代码

下面临preferences 进行封装，基本思绪：
在获取preferences实例后会将其生存单例中，这个单例是GlobalContext，方便后期可以通过单例直接获取实例；由于get()返回值类型是不确定性，定义一个联合类型的别名ValueType 来接收。

1. const TAG = "PreferencesUtils"
2. // 默认文件名，可以在构造函数进行修改
3. const PREFERENCES_NAME = 'yiPreferences'
4. const KEY_PREFERENCES = "preferences"
5. type ValueType = number | string | boolean | Array<number> | Array<string> | Array<boolean>;
7. export class PreferencesUtils{
8.   // preferences的文件名
9.   private preferencesName: string = PREFERENCES_NAME
10.   // 用于获取preferences实例的key值，保存到单例中
11.   private keyPreferences: string = KEY_PREFERENCES
13.   constructor(name: string = PREFERENCES_NAME, keyP: string = KEY_PREFERENCES) {
14.     this.preferencesName = name
15.     this.keyPreferences = keyP
16.   }
18.   createPreferences(context: Context): Promise<dataPreferences.Preferences> {
19.     let preferences = dataPreferences.getPreferences(context, this.preferencesName)
20.     GlobalContext.getContext().setObject(this.keyPreferences, preferences)
21.     return preferences
22.   }
24.   getPreferences(): Promise<dataPreferences.Preferences> {
25.     return GlobalContext.getContext().getObject(KEY_PREFERENCES) as Promise<dataPreferences.Preferences>
26.   }
28.   async get(key: string, def?: ValueType): Promise<ValueType> {
29.    return (await this.getPreferences()).get(key, def)
30.   }
32.   async getAll(): Promise<Object> {
33.     let  preferences = await this.getPreferences()
34.     return preferences.getAll()
35.   }
37.   async put(key: string, value: ValueType): Promise<void> {
38.     let promise = await this.getPreferences().then(async (p) => {
39.       await p.put(key, value)
40.       await p.flush();
41.     }).catch((err)=>{
42.       Logger.d(TAG, err)
43.     })
44.     return promise
45.   }
49.   async delete(key: string): Promise<void> {
50.     return (await this.getPreferences()).delete(key).finally(async () => {
51.       (await this.getPreferences()).flush()
52.     })
53.   }
55.   async clear(): Promise<void> {
56.     return (await this.getPreferences()).clear().finally(async () => {
57.       (await this.getPreferences()).flush()
58.     })
59.   }
61. }
63. export default new PreferencesUtils()

复制代码

在EntryAbility#onCreate()方法初始化：

1. export default class EntryAbility extends UIAbility {
2.   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
3.     PreferencesUtils.createPreferences(this.context)
4.   }
5. }

复制代码

GlobalContext

1. export default class GlobalContext {
2.   private constructor() { }
3.   private static instance: GlobalContext;
4.   private _objects = new Map<string, Object>();
6.   public static getContext(): GlobalContext {
7.     if (!GlobalContext.instance) {
8.       GlobalContext.instance = new GlobalContext();
9.     }
10.     return GlobalContext.instance;
11.   }
13.   getObject(value: string): Object | undefined {
14.     return this._objects.get(value);
15.   }
17.   setObject(key: string, objectClass: Object): void {
18.     this._objects.set(key, objectClass);
19.   }
20. }

复制代码

测试用例

通过异步async 和await来直接获取操纵结果，也可以在then方法回调中获取结果。

1. @Component
2. @Entry
3. struct PreferencesPage {
4.   @State text: string = ""
5.   aboutToAppear() {
6.     PreferencesUtils.put("username", "Harden")
7.     PreferencesUtils.put("age", 28)
8.     PreferencesUtils.put("isStaff", true)
9.   }
10.   build() {
11.     Column() {
12.       Text(this.text)
13.         .width('100%')
14.         .height(60)
15.       Row() {
16.         Button("get")
17.           .onClick(async () => {
18.             this.text = await PreferencesUtils.get('username') as string
19.           })
20.         Button("getAll")
21.           .onClick(async () => {
22.             this.getAll()
23.           })
24.         Button("put")
25.           .onClick(async () => {
26.             await PreferencesUtils.put("username", "Kobe")
27.             await  PreferencesUtils.put("age", 28)
28.             await PreferencesUtils.put("isStaff", false)
29.             this.getAll()
30.           })
31.         Button("delete")
32.           .onClick(async () => {
33.             await PreferencesUtils.delete("isStaff")
34.             this.getAll()
35.           })
36.         Button("clear")
37.           .onClick(async () => {
38.             await PreferencesUtils.clear()
39.             this.getAll()
40.           })
41.       }
42.       .width('100%')
43.       .justifyContent(FlexAlign.Center)
44.     }
45.   }
47.   async getAll() {
48.     let v = await PreferencesUtils.getAll() as Object
49.     this.text = JSON.stringify(v)
50.   }
51. }

复制代码

参考

• https://developer.huawei.com/consumer/cn/training/course/slightMooc/C101667367018821971?ha_linker=eyJ0cyI6MTcwMjM5NzEzNzM3MywiaWQiOiI4MmM3ZTI1MmFmMDJlMDZiODBmOGU1ZDM5ZTI5YmMyOCJ9
  

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