鸿蒙(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();
相关推荐
AlbertZein4 分钟前
鸿蒙工程化:build-profile.json5 逐字段解析
harmonyos
weixin_417197051 小时前
DeepSeek V4绑定华为:一场飞行中换引擎的国产算力革命
人工智能·华为
前端技术3 小时前
鸿蒙ArkTS 自定义底部导航栏(Tabs+@Builder 极简实现)
harmonyos·鸿蒙
Swift社区4 小时前
为什么“页面跳转”在鸿蒙 PC 上是错误设计?
华为·harmonyos
熬夜敲代码的小N7 小时前
鸿蒙PC开发者必备!GitNext深度测评:一站式Git管理工具
git·华为·harmonyos
秋の本名8 小时前
第一章 鸿蒙生态架构与开发理念
华为·wpf·harmonyos
Ww.xh9 小时前
鸿蒙系统中HTML与Vue集成方案
vue.js·html·harmonyos
前端不太难9 小时前
鸿蒙游戏 CI/CD:为什么你还在手动打包?
游戏·ci/cd·harmonyos
全栈若城9 小时前
HarmonyOS Pen Kit 实战:手写笔轻捏、双击与取色器完整集成
华为·harmonyos·手写笔·harmonyos6