鸿蒙(HarmonyOS)-Fa应用级轻量存储(数据库)

简单讲：使用Preferences

场景介绍

轻量级偏好数据库是轻量级存储，主要用于保存应用的一些常用配置，并不适合存储大量数据和频繁改变数据的场景。用户的数据保存在文件中，可以持久化的存储在设备上。需要注意的是用户访问的实例包含文件所有数据，并一直加载在设备的内存中，并通过轻量级偏好数据库的API完成数据操作。

接口说明

轻量级偏好数据库向本地应用提供了操作偏好型数据库的API，支持本地应用读写少量数据及观察数据变化。数据存储形式为键值对，键的类型为字符串型，值的存储数据类型包括整型、字符串型、布尔型、浮点型、长整型、字符串型Set集合。

不太会讲，直接上代码吧

开发步骤

1. 准备工作，导入对轻量级偏好数据库SDK到开发环境。

2. 获取Preferences实例。

   读取指定文件，将数据加载到Preferences实例，用于数据操作。

     DatabaseHelper databaseHelper = new DatabaseHelper(context); // context入参类型为ohos.app.Context。
     String fileName = "name"; // fileName表示文件名，其取值不能为空，也不能包含路径，默认存储目录可以通过context.getPreferencesDir()获取。
     Preferences preferences = databaseHelper.getPreferences(fileName);
   

3. 从指定文件读取数据。

   首先获取指定文件对应的Preferences实例，然后借助Preferences API读取数据。

   java接口 读取整型数据

   int value = preferences.getInt("intKey", 0);
   

4. 将数据写入指定文件。

   首先获取指定文件对应的Preferences实例，然后借助Preferences API将数据写入Preferences实例，通过flush或者flushSync将Preferences实例持久化。

   异步：

   preferences.putInt("intKey", 3);
   preferences.putString("StringKey", "String value");
   preferences.flush();
   

   同步：

     preferences.putInt("intKey", 3);
     preferences.putString("StringKey", "String value");
     preferences.flushSync();
   

5. 注册观察者。

   开发者可以向Preferences实例注册观察者，观察者对象需实现Preferences.PreferencesObserver接口。flushSync()或flush()执行后，该Preferences实例注册的所有观察者的onChange()方法都会被回调。不再需要观察者时请注销。

   private class PreferencesChangeCounter implements Preferences.PreferencesObserver {
       final AtomicInteger notifyTimes = new AtomicInteger(0);
       @Override    
       public void onChange(Preferences preferences, String key) {
           if ("intKey".equals(key)) {
               notifyTimes.incrementAndGet();        
           }    
       }
   }
   // 向preferences实例注册观察者
   PreferencesChangeCounter counter = new PreferencesChangeCounter();
   preferences.registerObserver(counter);
   // 修改数据preferences.putInt("intKey", 3);
   boolean result = preferences.flushSync();
   // 修改数据后，onChange方法会被回调，notifyTimes == 1
   int notifyTimes = counter.notifyTimes.intValue();
   // 向preferences实例注销观察者
   preferences.unRegisterObserver(counter);
   

6. 移除Preferences实例。

   从内存中移除指定文件对应的Preferences单实例。移除Preferences单实例时，应用不允许再使用该实例进行数据操作，否则会出现数据一致性问题。

   DatabaseHelper databaseHelper = new DatabaseHelper(context);
   String fileName = "name"; // fileName表示文件名，其取值不能为空，也不能包含路径。
   databaseHelper.removePreferencesFromCache(fileName);
   

7. 删除指定文件。

   从内存中移除指定文件对应的Preferences单实例，并删除指定文件及其备份文件、损坏文件。删除指定文件时，应用不允许再使用该实例进行数据操作，否则会出现数据一致性问题

   DatabaseHelper databaseHelper = new DatabaseHelper(context);
   String fileName = "name"; // fileName表示文件名，其取值不能为空，也不能包含路径。
   boolean result = databaseHelper.deletePreferences(fileName);
   

8. 移动指定文件。

   从源路径移动文件到目标路径。移动文件时，应用不允许再操作该文件数据，否则会出现数据一致性问题。

   Context targetContext = XXX;
   DatabaseHelper databaseHelper = new DatabaseHelper(targetContext);
   String srcFile = "srcFile"; // srcFile表示源文件名或者源文件的绝对路径，不能为相对路径，其取值不能为空。当srcFile只传入文件名时，srcContext不能为空。
   String targetFile = "targetFile"; // targetFile表示目标文件名，其取值不能为空，也不能包含路径。
   Context srcContext = XXX;
   boolean result = databaseHelper.movePreferences(srcContext, srcFile, targetFile);
   

注意：本段代码中，targetContext和srcContext需通过在对应AbilitySlice或Ability中，使用“getApplicationContext()”方法获取。

再注意：this.getContext()是作用于当前Ability，如果想在整个Fa应用中公用，一定要用this.getApplicationContext()

参考文档