HarmonyOS之数据管理·轻量级偏好数据库的应用

一、简介

① 基本概念

轻量级偏好数据库主要提供轻量级 Key-Value 操作，支持本地应用存储少量数据，数据存储在本地文件中，同时也加载在内存中的，所以访问速度更快，效率更高。轻量级偏好数据库属于非关系型数据库，不宜存储大量数据，经常用于操作键值对形式数据的场景。
Key-Value 数据库：一种以键值对存储数据的一种数据库，类似 Java 中的 map，Key 是关键字，Value 是值。
非关系型数据库：区别于关系数据库，不保证遵循 ACID（Atomic、Consistency、Isolation 及 Durability）特性，不采用关系模型来组织数据，数据之间无关系，扩展性好。
偏好数据：用户经常访问和使用的数据。

② 运作机制

本模块提供偏好型数据库的操作类，应用通过这些操作类完成数据库操作。
借助 DatabaseHelper API，应用可以将指定文件的内容加载到 Preferences 实例，每个文件最多有一个 Preferences 实例，系统会通过静态容器将该实例存储在内存中，直到应用主动从内存中移除该实例或者删除该文件。
获取到文件对应的 Preferences 实例后，应用可以借助 Preferences API，从 Preferences 实例中读取数据或者将数据写入 Preferences 实例，通过 flush 或者 flushSync 将 Preferences 实例持久化。
轻量级偏好数据库运作机制如下图所示：

在这里插入图片描述

③ 使用限制

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

④ 应用场景

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

二、轻量级偏好数据库 API

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

① 创建数据库

通过数据库操作的辅助类可以获取到要操作的 Preferences 实例，用于进行数据库的操作。
轻量级偏好数据库创建接口：

类名	接口名	描述
DatabaseHelper	Preferences getPreferences(String name)	获取文件对应的Preferences单实例，用于数据操作

② 查询数据

通过调用 Get 系列的方法，可以查询不同类型的数据。
轻量级偏好数据库查询接口如下表所示：

类名	接口名	描述
Preferences	int getInt(String key, int defValue)	获取键对应的int类型的值
Preferences	float getFloat(String key, float defValue)	获取键对应的float类型的值

③ 插入数据

通过 Put 系列的方法可以修改 Preferences 实例中的数据，通过 flush 或者 flushSync 将 Preferences 实例持久化。
轻量级偏好数据库插入接口如下表所示：

类名	接口名	描述
Preferences	Preferences putInt(String key, int value)	设置Preferences实例中键对应的int类型的值
Preferences	Preferences putString(String key, String value)	设置Preferences实例中键对应的String类型的值
Preferences	void flush()	将Preferences实例异步写入文件
Preferences	boolean flushSync()	将Preferences实例同步写入文件

④ 观察数据变化

轻量级偏好数据库还提供了一系列的接口变化回调，用于观察数据的变化。开发者可以通过重写 onChange 方法来定义观察者的行为。
轻量级偏好数据库接口变化回调如下表所示：

类名	接口名	描述
Preferences	void registerObserver(PreferencesObserver preferencesObserver)	注册观察者，用于观察数据变化
Preferences	void unRegisterObserver(PreferencesObserver preferencesObserver)	注销观察者
Preferences.PreferencesObserver	void onChange(Preferences preferences, String key)	观察者的回调方法，任意数据变化都会回调该方法

⑦ 删除数据文件

通过调用以下两种接口，可以删除数据文件。
轻量级偏好数据库删除接口如下表所示：

类名	接口名	描述
DatabaseHelper	boolean deletePreferences(String name)	删除文件和文件对应的Preferences单实例
DatabaseHelper	void removePreferencesFromCache(String name)	删除文件对应的Preferences单实例

⑧ 移动数据库文件

轻量级偏好数据库移动接口如下所示：

类名	接口名	描述
DatabaseHelper	boolean movePreferences(Context sourceContext, String sourceName, String targetName)	移动数据库文件

三、轻量级偏好数据库的使用开发流程

准备工作，导入对轻量级偏好数据库 SDK 到开发环境。
获取 Preferences 实例，读取指定文件，将数据加载到 Preferences 实例，用于数据操作。

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

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

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

将数据写入指定文件，首先获取指定文件对应的 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();

注册观察者：开发者可以向 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 == 1int notifyTimes = counter.notifyTimes.intValue();// 向preferences实例注销观察者preferences.unRegisterObserver(counter);

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

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

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

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