简单讲:使用Preferences
场景介绍
轻量级偏好数据库是轻量级存储,主要用于保存应用的一些常用配置,并不适合存储大量数据和频繁改变数据的场景。用户的数据保存在文件中,可以持久化的存储在设备上。需要注意的是用户访问的实例包含文件所有数据,并一直加载在设备的内存中,并通过轻量级偏好数据库的API完成数据操作。
接口说明
轻量级偏好数据库向本地应用提供了操作偏好型数据库的API,支持本地应用读写少量数据及观察数据变化。数据存储形式为键值对,键的类型为字符串型,值的存储数据类型包括整型、字符串型、布尔型、浮点型、长整型、字符串型Set集合。
不太会讲,直接上代码吧
开发步骤
准备工作,导入对轻量级偏好数据库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 == 1 int 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);
-
移动指定文件。
从源路径移动文件到目标路径。移动文件时,应用不允许再操作该文件数据,否则会出现数据一致性问题。
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()