鸿蒙轻量级数据存储Preferences

1，概述

鸿蒙轻量级偏好数据库-Preferences。
轻量级偏好数据库主要提供轻量级Key-Value键值对形式操作，支持少量数据，数据存在在本地文件中，同时也加载在内存中，所以速度快，效率高，属于非关系型数据库，不宜存储大量数据。
运作机制如图：

约束与限制:
（1）Key键为String类型，要求非空且大小不超过80个字符。
（2）如果Value值为String类型，可以为空但是长度不超过8193个字符。
（3）存储的数据应该是轻量级的，建议存储的数据不超过一万条，否则会在内存方面产生较大的开销。

2，使用

数据存储形式为键值对，键的类型为字符串型，值的存储数据类型包括整型、字符串型、布尔型、浮点型、长整型、字符串型 Set 集合。

（1）获取 Preferences 实例

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

   DatabaseHelper databaseHelper = new DatabaseHelper(context);// context入 参类型为ohos.app.Context
   String fileName = "name";
   Preferences preferences = databaseHelper.getPreferences(fileName);

（2）从指定文件读取数据

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

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

（3）将数据写入指定文件

首先获取指定文件对应的 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();

区别：
flush 异步：插入数据不需要等待反馈即可插入下一组数据。
flushSync 同步：插入数据有反馈后再插入下一组数据。

（4）注册观察者

开发者可以向 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);

（5）移除 Preferences 实例

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

  DatabaseHelper databaseHelper = new DatabaseHelper(context);
   // 指定文件名称
   String fileName = "name";
   databaseHelper.removePreferencesFromCache(fileName);

（6）删除指定文件

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

   DatabaseHelper databaseHelper = new DatabaseHelper(context);
   // 指定文件名称
   String fileName = "name";
   boolean result = databaseHelper.deletePreferences(fileName);

（7）移动指定文件

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

 Context targetContext = XXX;
   DatabaseHelper databaseHelper = new DatabaseHelper(targetContext);
   // 指定文件名称
   String srcFile = "srcFile";
   String targetFile = "targetFile";
   Context srcContext = XXX;
   boolean result = databaseHelper.movePreferences(srcContext,srcFile,targetFile);

3，总结

（1）Preferences数据既写入到本地文件中又在内存缓存map中，数据写入在内存中占用内存资源，说明不宜大量数据存储。
（2）鸿蒙Preferences在写入或更新数据的时候会有同步或异步两种选择，在数据较少，操作量不大的时候建议使用同步flushSync操作方式。而异步操作一般是在数据量大，操作时间长情况下通过队列排队处理，一般较少使用。
（3）鸿蒙Preferences的存储数据每次都会清空之前的数据，每次会保留新的数据，而不是增量存储。
（4）跟安卓相比鸿蒙已经不需要通过Editor去put数据了，而通过Preferences实例直接存取。

声明：该博客大部分信息来自于鸿蒙官方文档。少部分自己总结，如果不明白请参考官方文档。