鸿蒙(HarmonyOS)应用开发——保存应用数据

layman05282023-12-12 17:22

保存应用数据

harmonyOS系统提供了四种数据存储方式
数据存储方式首选项关系型数据库分布式数据服务分布式数据对象

首选项

适用于对key-value结构的数据进行存取和持久化操作。

特点

key-value 数据接口
Key是不重复的关键字，Value是数据值
非关系型数据库
不保证遵循ACID(Atomicity, Consistency, Isolation 以及Durability) 特性

注意点

因首选项实例会加载到内存中，建议存储到数据不超过一万条
数据中的key为string类型，要求非空且自负长度不超过80个字节
当数据中的value为string类型时，运行为空，字符长度不超过8192

使用

导入preference模块获取preference实例保存数据是否包含指定的key 获取数据

导入preference模块

javascript 复制代码

import dataPreferences from '@ohos.data.preferences';
const PREFERENCES_NAME = 'myPreferences'; // 数据库表名字
const KEY_APP_FONT_SIZE = 'appFontSize';  // 首选项Key

获取preference实例

javascript 复制代码

globalThis.getFontPreferences = (() => {
      // 获取首选项实例
      let preferences: Promise<dataPreferences.Preferences> = dataPreferences.getPreferences(context, PREFERENCES_NAME);
      return preferences;
    });

保存数据

javascript 复制代码

 	await preferences.put(KEY_APP_FONT_SIZE, fontSize);
	preferences.flush();

获取数据

javascript 复制代码

	let fontSize: number = 0;
    const preferences = await globalThis.getFontPreferences();
    fontSize = await preferences.get(KEY_APP_FONT_SIZE, fontSize);

是否包含指定的key

javascript 复制代码

 preferences.has(KEY_APP_FONT_SIZE).then(async (isExist) => {
        Logger.info(TAG, 'preferences has changeFontSize is ' + isExist);
      }).catch((err) => {
        Logger.error(TAG, 'Has the value failed with err: ' + err);
 });

数据持久化

通过flush方法把应用数据保存到文件中，使得应用数据保存期限变长

javascript 复制代码

preferences.flush();