当前位置: 首页 > news >正文

鸿蒙用户首选项数据持久化

踏入鸿蒙世界的敲门砖,标志着您在技术征途上的全新起点,提升就业竞争力,获得行业认可,点亮职业成长先机,快人一步抢占未来应用开发赛道!https://developer.huawei.com/consumer/cn/training/dev-cert-detail/101666948302721398?ha_source=hmosclass-infoq&ha_sourceId=89000233

用户首选项为应用提供Key-Value键值型的数据处理能力,支持应用持久化轻量级数据,并对其修改和查询。当用户希望有一个全局唯一存储的地方,可以采用用户首选项来进行存储。Preferences会将该数据缓存在内存中,当用户读取的时候,能够快速从内存中获取数据,当需要持久化时可以使用flush接口将内存中的数据写入持久化文件中。Preferences会随着存放的数据量越多而导致应用占用的内存越大,因此,Preferences不适合存放过多的数据,也不支持通过配置加密,适用的场景一般为应用保存用户的个性化设置(字体大小,是否开启夜间模式)等。

动作机制

如图所示,用户程序通过ArkTS接口调用用户首选项读写对应的数据文件。开发者可以将用户首选项持久化文件的内容加载到Preferences实例,每个文件唯一对应到一个Preferences实例,系统会通过静态容器将该实例存储在内存中,直到主动从内存中移除该实例或者删除该文件。

约束限制

·首选项无法保证进程并发安全,会有文件损坏和数据丢失的风险,不支持在多进程场景下使用。

·Key键为string类型,要求非空且长度不超过1024个字节。

·如果Value值为string类型,请使用UTF-8编码格式,可以为空,不为空时长度不超过16MB。

·当存储的数据中包含非UTF-8格式的字符串时,请使用Uint8Array类型存储,否则会造成持久化文件出现格式错误造成文件损坏。

·当调用removePreferencesFromCache或者deletePreferences后,订阅的数据变更会主动取消订阅,重新getPreferences后需要重新订阅数据变更。

·不允许deletePreferences与其他接口多线程、多进程并发调用,否则会发生不可预期行为。

·内存会随着存储数据量的增大而增大,所以存储的数据量应该是轻量级的,建议存储的数据不超过50MB,当存储的数据较大时,在使用同步接口创建Preferences对象和持久化数据时会变成耗时操作,不建议在主线程中使用,否则可能出现appfreeze问题。

开发步骤

1. 导入@kit.ArkData模块

2. 获取Preferences实例

3. 写入数据

使用putSync()方法保存数据到缓存的Preferences实例中。在写入数据后,如有需要,可使用flush()方法将Preferences实例的数据存储到持久化文件。

4. 读取数据

使用getSync()方法获取数据,即指定键对应的值。如果值为null或者非默认值类型,则返回默认数据。

5. 删除数据

使用deleteSync()方法删除指定键值对。

6. 数据持久化

应用存入数据到Preferences实例后,可以使用flush()方法实现数据持久化。

7. 删除指定文件

使用deletePreferences()方法从内存中移除指定文件对应的Preferences实例,包括内存中的数据。若该Preference存在对应的持久化文件,则同时删除该持久化文件,包括指定文件及其备份文件、损坏文件。

(转载自51CTO,作者:龙儿筝)image.png

http://www.zskr.cn/news/3606.html

相关文章:

  • 基于Transformer的预训练大语言模型,如何区分文本位置?
  • UE RPC介绍
  • JS监听DOM元素的变化
  • CF1485F Copy or Prefix Sum
  • 云斗八月银组做题记录
  • 题解:P3323 [SDOI2015] 旅行计划
  • GAS_Aura-Implementing Auto Running
  • 深入解析:PostgreSQL 视图与物化视图(View / Materialized View)详解
  • win11专业版如何设置窗口不叠加的问题
  • JBoltAI:解锁企业AI应用开发新范式,驱动数智化升级核心引擎
  • kmp
  • NKOJ全TJ计划——NP11793
  • JBoltAI函数调用技术:自然语言即可查询数据库,重构企业数据交互方式
  • 题解:CF645B Mischievous Mess Makers
  • NKOJ全TJ计划——NP11792
  • 完整教程:Photo Lab PRO 图片编辑器 功能解锁版
  • Ubuntu 18.04 虚拟机 VScode无法正常输入中文解决办法
  • qoj1847 Elephants
  • 基于ArcGIS的通用界址点导入导出工具设计与实现
  • python 函数作用域
  • 文献阅读 | AutoCodeBench
  • Idea win 快捷键大全
  • VSCode+neovim工作环境快速构建
  • 25.9.12随笔联考总结
  • macos
  • 算法复杂度
  • Typescript中Type 类型的实现原理
  • 戒己谨言
  • 更美观的网页布局
  • 深入解析:每日一算:电话号码的字母组合