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

保存应用数据

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();
相关推荐
听麟4 小时前
HarmonyOS 6.0+ PC端离线翻译工具开发实战:端侧AI模型集成与多格式内容翻译落地
人工智能·华为·harmonyos
南村群童欺我老无力.4 小时前
鸿蒙pc中权限申请流程与用户拒绝处理
华为·harmonyos
@不误正业4 小时前
AI-Agent安全性实战-提示注入防御与工具调用沙箱隔离
人工智能·华为·harmonyos
南村群童欺我老无力.9 小时前
鸿蒙PC多端适配的断点设计与布局策略
华为·harmonyos
轻口味10 小时前
HarmonyOS 6.1 全栈实战录 - 04 镜像世界:Spatial Recon Kit 3D空间重建与企业级高精度建模实战
3d·华为·harmonyos
酿情师10 小时前
2026平航杯倩倩手机逆向包逆向全过程(逆向鸿蒙系统app包)
华为·智能手机·harmonyos·逆向·ctf·re·取证
南村群童欺我老无力.10 小时前
鸿蒙PC DevEco Studio调试器的使用技巧与局限
华为·harmonyos