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

保存应用数据

harmonyOS系统提供了四种数据存储方式

数据存储方式

首选项

关系型数据库

分布式数据服务

分布式数据对象

首选项

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

特点

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

注意点

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

使用

导入preference模块

获取preference实例

保存数据

是否包含指定的key

获取数据

导入preference模块

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

获取preference实例

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

保存数据

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

获取数据

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

是否包含指定的key

 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方法把应用数据保存到文件中，使得应用数据保存期限变长

preferences.flush();