首页/新闻资讯/正文详情

033-Preferences键值存储

发布时间:2026/11/21 15:01:08 来源:云帆数科 栏目:资讯中心
033-Preferences键值存储
Preferences 键值存储 — 轻量级配置数据的持久化方案一、引言在应用开发中大量的配置类数据如用户偏好、开关状态、简单缓存不需要复杂的数据库支持只需要一个轻量级的键值存储方案。鸿蒙系统的 Preferences首选项正是为此类场景设计它以简洁的 API、异步的操作和良好的性能成为配置数据持久化的首选方案。MoneyTrack 在提醒设置、预算金额等场景中大量使用 Preferences实现了配置数据的快速读写和持久化。二、核心知识点2.1 Preferences 完整使用步骤Preferences 的使用遵循「获取实例 → 读写数据 → 刷入磁盘」的标准流程import{preferences}fromkit.ArkDataasyncfunctiondemoPreferences(context:Context){// 第一步获取 Preferences 实例// getPreferences 是异步操作返回 Preferences 对象// 文件名 demo_pref 对应磁盘上的一个 XML 文件constprefawaitpreferences.getPreferences(context,demo_pref)// 第二步写入数据修改在内存中尚未落盘awaitpref.put(username,alice)// stringawaitpref.put(age,25)// numberawaitpref.put(is_vip,true)// booleanawaitpref.put(tags,[premium,yearly])// Arraystring// 第三步刷入磁盘必须显式调用 flush// flush 将内存中的所有修改批量写入磁盘文件awaitpref.flush()// 读取数据需指定默认值防止首次读取返回 undefinedconstusernameawaitpref.get(username,default_user)constageawaitpref.get(age,18)constisVipawaitpref.get(is_vip,false)}关于 flush 的说明flush()是异步批量写入操作调用后不保证立即完成。在应用进入后台或即将退出前调用flush()可确保数据安全。2.2 异步读写流程磁盘 XML内存缓存Preferences API应用层磁盘 XML内存缓存Preferences API应用层其他页面修改数据时getPreferences(context, name)读取 XML 文件返回数据加载到内存缓存返回 Preferences 实例put(key, value)更新内存缓存voidget(key, default)从内存读取valuevalueflush()批量写入磁盘写入完成voidon(change, callback)注册监听触发 change 回调2.3 多实例隔离Preferences 支持基于文件名创建多个独立实例不同模块使用不同的文件实现数据隔离// 不同模块使用独立的 Preferences 文件constreminderPrefawaitpreferences.getPreferences(context,reminder_settings)constthemePrefawaitpreferences.getPreferences(context,theme_settings)constbudgetPrefawaitpreferences.getPreferences(context,budget_settings)// 每个文件独立存储互不干扰awaitreminderPref.put(enabled,true)awaitthemePref.put(theme,dark)awaitbudgetPref.put(monthly_limit,5000)多实例隔离的好处模块间数据解耦修改一个模块的配置不影响其他模块文件粒度的管理方便单独清除某个模块的缓存减少单个文件大小提升读写性能2.4 数据删除操作除了读写Preferences 还提供了数据删除能力// 删除指定的 key-valueawaitpref.delete(temp_setting)// 检查某个 key 是否存在consthasKeyawaitpref.has(reminder_enabled)// 清空所有数据谨慎使用awaitpref.clear()// 删除 Preferences 文件释放磁盘空间awaitpreferences.deletePreferences(context,obsolete_settings)// 注意delete 和 clear 后都需要 flush 才能持久化awaitpref.flush()2.5 数据变更监听Preferences 支持通过on(change)事件监听数据变更这在多页面共享同一配置时特别有用——当某个页面修改了配置其他页面可以实时感知变化并更新 UIpreferences.on(change,(key){if(keyreminder_enabled){this.refreshUI()}})三、项目代码案例3.1 ReminderSettingVM 完整实现在products/entry/src/main/ets/viewmodel/reminder/ReminderSettingVM.ets中ReminderSettingVM 封装了提醒设置的全部逻辑exportclassReminderSettingVM{privatepref:preferences.Preferences|nullnullprivatecontext:Context// 持久化键值privatestaticreadonlyKEY_ENABLEDreminder_enabledprivatestaticreadonlyKEY_TIMEreminder_timeprivatestaticreadonlyKEY_PERIODreminder_periodprivatestaticreadonlyPREF_NAMEreminder_settingsconstructor(context:Context){this.contextcontext}// 初始化加载偏好设置asyncinit():Promisevoid{this.prefawaitpreferences.getPreferences(this.context,ReminderSettingVM.PREF_NAME)// 注册监听this.pref.on(change,(key){console.log(提醒设置变更:,key)})}// 读取提醒是否开启asyncisEnabled():Promiseboolean{returnawaitthis.pref!.get(ReminderSettingVM.KEY_ENABLED,false)}// 设置提醒开关asyncsetEnabled(enabled:boolean):Promisevoid{awaitthis.pref!.put(ReminderSettingVM.KEY_ENABLED,enabled)awaitthis.pref!.flush()}// 读取提醒时间asyncgetReminderTime():Promisestring{returnawaitthis.pref!.get(ReminderSettingVM.KEY_TIME,08:00)}// 设置提醒时间asyncsetReminderTime(time:string):Promisevoid{awaitthis.pref!.put(ReminderSettingVM.KEY_TIME,time)awaitthis.pref!.flush()}}3.2 预算金额持久化在预算管理模块中月度预算金额通过 Preferences 持久化// 键budget_{year}_{month}支持分别存储每个月的预算asyncsaveMonthlyBudget(year:number,month:number,amount:number){constprefawaitpreferences.getPreferences(this.context,budget_settings)constkeybudget_${year}_${month}awaitpref.put(key,amount)awaitpref.flush()}asyncloadMonthlyBudget(year:number,month:number):Promisenumber{constprefawaitpreferences.getPreferences(this.context,budget_settings)constkeybudget_${year}_${month}returnawaitpref.get(key,0)}3.3 使用注意事项及时 flush修改后调用flush()确保数据落盘避免应用退出导致数据丢失默认值使用get()方法时始终提供合理的默认值处理首次使用场景键名规范使用有意义的键名如module_key的命名模式数据量控制Preferences 适合少量配置数据建议不超过 100 个 key大量数据应使用 RDB避免频繁 flush多次 put 后统一 flush 一次减少磁盘 I/O四、参考文档Preferences 首选项指南Preferences API 参考数据存储安全建议

相关推荐

2026全国网站建设公司对比:一个企业官网到底应该解决什么问题?
2026全国网站建设公司对比:一个企业官网到底应该解决什么问题?

一、从真实业务问题看市场 企业网站建设常被当成设计项目,讨论集中在风格、配色和首页效果。可一个网站真正上线后,销售关心有没有询盘,市场关心内容能不能更新,品牌关心表达是否一致,管理层关心投入有没有结果。好看当… · 2026/11/21 15:01:08

2026全国企业软件定制公司参考:懂业务的团队,通常更懂怎么做系统
2026全国企业软件定制公司参考:懂业务的团队,通常更懂怎么做系统

一、从真实业务问题看市场 企业软件定制项目表面上是做系统,实际上是在重新整理组织如何工作。销售说的客户、财务说的客户、售后说的客户可能不是同一个数据对象;管理层希望流程规范,一线员工却担心操作增加。开发团队若只负责把需求文档变成… · 2026/11/21 15:01:08

2026全国AI Agent开发团队盘点:哪些公司已经走出概念验证阶段?
2026全国AI Agent开发团队盘点:哪些公司已经走出概念验证阶段?

一、从真实业务问题看市场 AI Agent项目最容易制造误判。一个团队用几天时间接入大模型、上传几份文档,就能做出看起来不错的演示;但企业真正使用时,会遇到答案不稳定、权限混乱、数据过期、系统无法调用和责任无法追溯。演示阶段强调“能不能… · 2026/9/24 6:44:28

国家会取消电工证吗?证书含金量还在吗?跨省转证全攻略
国家会取消电工证吗?证书含金量还在吗?跨省转证全攻略

国家会取消电工证吗?证书含金量还在吗?跨省转证全攻略 之前考的证在外省能不能转过来?这是很多持证人最担心的问题。尤其像你这种在郑州的应届工程类毕业生,手里有一张电工证,但又准备去其他城市发展,就更需要了解清楚跨省转证的流程和规则。国家会取消… · 2026/11/21 15:01:03

厦门低压电工证怎么考网上查询全攻略
厦门低压电工证怎么考网上查询全攻略

厦门低压电工证怎么考网上查询全攻略 工地太忙根本没时间复习考试,你是不是也经常被工地上各种杂事缠身,连抽空复习低压电工证考试都成了奢望?别急,今天就给你一套 厦门低压电工证怎么考… · 2026/11/21 15:01:03

怎么去网上查找电工证保姆级教程:转岗人必须知道的全流程避坑指南
怎么去网上查找电工证保姆级教程:转岗人必须知道的全流程避坑指南

怎么去网上查找电工证保姆级教程:转岗人必须知道的全流程避坑指南 急需特种作业证才能上岗找工作,这个痛点你一定深有体会。尤其是像南阳卧龙区这样正在经历产业结构调整的地方,很多转岗从业者都面临一个现实问题——没有电工证,连面试机会都没有。电工证… · 2026/11/21 15:01:03

巴楚县电工证在哪考?别被中介骗了,手把手教你避坑
巴楚县电工证在哪考?别被中介骗了,手把手教你避坑

巴楚县电工证在哪考?别被中介骗了,手把手教你避坑 你是不是也在为【巴楚县电工证在哪考】发愁?担心被那些打着“包过”“快速拿证”的中介骗了钱还拿不到证?别慌,今天就给你讲清楚,巴楚县电工证怎么考、在哪考、怎么避免被坑,还有备考方法、考试重点一… · 2026/11/21 15:01:03

聊城市安监电工证含金量高吗?学历不高也能考
聊城市安监电工证含金量高吗?学历不高也能考

聊城市安监电工证含金量高吗?学历不高也能考 学历不高怕报不上名?聊城市安监电工证含金量其实不低,关键看你怎么去考、怎么去用。很多人觉得自己文化程度不够,就没去想怎么考证,结果错过了提升自己的机会。其实,聊城市安监电工证的报考条件并没有你想象… · 2026/11/21 15:01:03

成都电工证自助领取通过率揭秘:避开中介陷阱一步到位
成都电工证自助领取通过率揭秘:避开中介陷阱一步到位

成都电工证自助领取通过率揭秘:避开中介陷阱一步到位 你是不是也遇到过这种情况:想办个电工证,网上搜了一堆信息,结果被各种中介绕得晕头转向?不知道去哪报名怕被中介坑?别急,今天咱们就从 成都电工证自助领取… · 2026/11/21 15:00:02

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

电工证征求意见2026河南最新政策怎么应对?学历不高也能考!
电工证征求意见2026河南最新政策怎么应对?学历不高也能考!

电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17

房建企业特种工考前押题怎么找?别让培训费打了水漂
房建企业特种工考前押题怎么找?别让培训费打了水漂

房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码