【鸿蒙HarmonyOS开发笔记】应用数据持久化之通过用户首选项实现数据持久化

概述

应用数据持久化，是指应用将内存中的数据通过文件或数据库的形式保存到设备上。内存中的数据形态通常是任意的数据结构或数据对象，存储介质上的数据形态可能是文本、数据库、二进制文件等。

HarmonyOS标准系统支持典型的存储数据形态，包括用户首选项、键值型数据库、关系型数据库。

开发者可以根据如下功能介绍，选择合适的数据形态以满足自己应用数据的持久化需要。

用户首选项（Preferences）：通常用于保存应用的配置信息。数据通过文本的形式保存在设备中，应用使用过程中会将文本中的数据全量加载到内存中，所以访问速度快、效率高，但不适合需要存储大量数据的场景。

键值型数据库（KV-Store）：一种非关系型数据库，其数据以“键值”对的形式进行组织、索引和存储，其中“键”作为唯一标识符。适合很少数据关系和业务关系的业务数据存储，同时因其在分布式场景中降低了解决数据库版本兼容问题的复杂度，和数据同步过程中冲突解决的复杂度而被广泛使用。相比于关系型数据库，更容易做到跨设备跨版本兼容。

关系型数据库（RelationalStore）：一种关系型数据库，以行和列的形式存储数据，广泛用于应用中的关系型数据的处理，包括一系列的增、删、改、查等接口，开发者也可以运行自己定义的SQL语句来满足复杂业务场景的需要。

通过用户首选项实现数据持久化

场景介绍

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

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

应用首选项的持久化文件保存在应用沙箱内部，可以通过context获取其路径。

在这里插入图片描述

约束限制
Key键为string类型，要求非空且长度不超过80个字节。
如果Value值为string类型，可以为空，不为空时长度不超过8192个字节。
内存会随着存储数据量的增大而增大，所以存储的数据量应该是轻量级的，建议存储的数据不超过一万条，否则会在内存方面产生较大的开销。

接口说明

以下是用户首选项持久化功能的相关接口，大部分为异步接口。异步接口均有callback和Promise两种返回形式，下均以Promise形式为例

导入模块

import dataPreferences from '@ohos.data.preferences';

dataPreferences.getPreferences

获取Preferences实例，使用Promise异步回调。

getPreferences(context: Context, name: string): Promise<Preferences>

参数说明

context:Stage模型的应用Context

name: Preferences实例的名称

返回值

Promise<Preferences>：Promise对象，返回Preferences实例。

示例

import UIAbility from '@ohos.app.ability.UIAbility';let preferences = null;class EntryAbility extends UIAbility {onWindowStageCreate(windowStage) {try {let promise = dataPreferences.getPreferences(this.context, 'mystore');promise.then((object) => {preferences = object;console.info("Succeeded in getting preferences.");}).catch((err) => {console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);})} catch(err) {console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);}}
}

dataPreferences.deletePreferences

从内存中移除指定的Preferences实例，使用Promise异步回调。

若Preferences实例有对应的持久化文件，则同时删除其持久化文件。

调用该接口后，应用不允许再使用该Preferences实例进行数据操作，否则会出现数据一致性问题。

deletePreferences(context: Context, name: string): Promise<void>

参数说明

context:Stage模型的应用Context

name: Preferences实例的名称

返回值

Promise<Preferences>：Promise对象，返回Preferences实例。

示例

import UIAbility from '@ohos.app.ability.UIAbility';
class EntryAbility extends UIAbility {onWindowStageCreate(windowStage) {try{let promise = dataPreferences.deletePreferences(this.context, 'mystore');promise.then(() => {console.info("Succeeded in deleting preferences.");}).catch((err) => {console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);})} catch(err) {console.error("Failed to delete preferences. code =" + err.code + ", message =" + err.message);}}
}

Preferences

存储实例，提供获取和修改存储数据的接口。

下列接口都需先使用data_preferences.getPreferences获取到Preferences实例，再通过此实例调用对应接口。

get

get(key: string, defValue: ValueType): Promise<ValueType>

获取键对应的值，如果值为null或者非默认值类型，返回默认数据defValue，使用Promise异步回调。

参数说明

key:要获取的存储Key名称，不能为空。

defValue: 默认返回值。支持number、string、boolean、Array<number>、Array<string>、Array<boolean>类型。

返回值

Promise<Preferences>：Promise对象，返回键对应的值

示例：

try {let promise = preferences.get('startup', 'default');promise.then((data) => {console.info("Succeeded in getting value of 'startup'. Data: " + data);}).catch((err) => {console.error("Failed to get value of 'startup'. code =" + err.code + ", message =" + err.message);})
} catch(err) {console.error("Failed to get value of 'startup'. code =" + err.code + ", message =" + err.message);
}

put

put(key: string, value: ValueType): Promise<void>

将数据写入Preferences实例，可通过flush将Preferences实例持久化，使用Promise异步回调。

参数说明

key:要修改的存储的Key，不能为空。

value: 存储的新值。支持number、string、boolean、Array<number>、Array<string>、Array<boolean>类型。

返回值

Promise<Preferences>：无返回结果的Promise对象。

示例：

try {let promise = preferences.put('startup', 'auto');promise.then(() => {console.info("Succeeded in putting value of 'startup'.");}).catch((err) => {console.error("Failed to put value of 'startup'. code =" + err.code +", message =" + err.message);})
} catch(err) {console.error("Failed to put value of 'startup'. code =" + err.code +", message =" + err.message);
}

has

has(key: string): Promise<boolean>

检查Preferences实例是否包含名为给定Key的存储键值对，使用Promise异步回调。

参数说明

key:要检查的存储key名称，不能为空。

返回值

Promise<Preferences>：Promise对象。返回Preferences实例是否包含给定key的存储键值对，true表示存在，false表示不存在。

示例：

try {let promise = preferences.has('startup');promise.then((val) => {if (val) {console.info("The key 'startup' is contained.");} else {console.info("The key 'startup' dose not contain.");}}).catch((err) => {console.error("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message);})
} catch(err) {console.error("Failed to check the key 'startup'. code =" + err.code + ", message =" + err.message);
}

delete

delete(key: string): Promise<void>

从Preferences实例中删除名为给定Key的存储键值对，使用Promise异步回调。

参数说明

key: 要删除的存储key名称，不能为空。

返回值

Promise<Preferences>：无返回结果的Promise对象。

示例：

try {let promise = preferences.delete('startup');promise.then(() => {console.info("Succeeded in deleting the key 'startup'.");}).catch((err) => {console.error("Failed to delete the key 'startup'. code =" + err.code +", message =" + err.message);})
} catch(err) {console.error("Failed to delete the key 'startup'. code =" + err.code +", message =" + err.message);
}

flush

flush(): Promise<void>

将当前Preferences实例的数据异步存储到用户首选项的持久化文件中，使用Promise异步回调。

参数说明

返回值

Promise<Preferences>：无返回结果的Promise对象。

示例：

try {let promise = preferences.flush();promise.then(() => {console.info("Succeeded in flushing.");}).catch((err) => {console.error("Failed to flush. code =" + err.code + ", message =" + err.message);})
} catch (err) {console.error("Failed to flush. code =" + err.code + ", message =" + err.message);
}

clear

clear(callback: AsyncCallback<void>): void

清除此·Preferences·实例中的所有存储，使用·Promise·异步回调。

参数说明

返回值

Promise<Preferences>：无返回结果的Promise对象。

示例：

try {let promise = preferences.clear();promise.then(() => {console.info("Succeeded in clearing.");}).catch((err) => {console.error("Failed to clear. code =" + err.code + ", message =" + err.message);})
} catch(err) {console.error("Failed to clear. code =" + err.code + ", message =" + err.message);
}

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/765848.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

OceanPen Art AI绘画系统 运营教程（三）2.10绘画全新界面升级

OceanPen Art AI绘画系统 运营教程（三）2.10绘画全新界面升级

在一个崇高的目标支持下&#xff0c;不停地工作&#xff0c;即使慢&#xff0c;也一定会获得成功。 —— 爱因斯坦 演示站点&#xff1a; ai.oceanpen.art 官方论坛&#xff1a; www.jingyuai.com 一、前端用户界面全新体验 二、 MJ绘画分享 提示词自取&#xff1a;htt…
阅读更多...
如何使用 ArcGIS Pro 制作好看的高程渲染图

如何使用 ArcGIS Pro 制作好看的高程渲染图

虽然 ArcGIS Pro 已经提供了很多好看的配色方案&#xff0c;但是如果直接对高程DEM进行渲染效果不是很理想&#xff0c;我们可以结合山体阴影让高程渲染图看起来更加立体&#xff0c;这里为大家介绍一下制作方法&#xff0c;希望能对你有所帮助。 数据来源 教程所使用的数据是…
阅读更多...
component-右侧抽屉组件

component-右侧抽屉组件

1.右侧抽屉组件 点击筛选&#xff0c;右侧抽屉滑出&#xff0c;点击取消或者点击空白处抽屉收起。 2.代码 <template><div class"all" click"hidden()"><!-- 抽屉 --><div class"drawer"><div class"drawerBo…
阅读更多...
Android StateLayout状态页

Android StateLayout状态页

文章目录 Android StateLayout状态页概述源码使用源码下载 Android StateLayout状态页 概述 StateLayout&#xff08;状态页&#xff09;包含&#xff1a;加载中页面&#xff0c;错误页面&#xff0c;空页面&#xff0c;内含状态默认页面&#xff0c;支持自定义页面。 源码 …
阅读更多...
yolov8目标检测数据集制作——make sense

yolov8目标检测数据集制作——make sense

背景 在前几天我进行了录制视频以准备足够多的数据集&#xff0c;同时使用利用python自定义间隔帧数获取视频转存为图片&#xff0c;所以今天我准备对我要训练的数据集进行标注。我要做的是一个基于yolo的检测项目&#xff0c;在搜索资料后得知大家多是用labelme或者make sens…
阅读更多...
使用 VS Code + Github 搭建个人博客

使用 VS Code + Github 搭建个人博客

搭建个人博客的方案 现在&#xff0c;搭建个人博客的方式有很多&#xff0c;门槛也很低。 可以选择已有平台&#xff1a; 掘金语雀知乎简书博客园SegmentFault… 也可以选择一些主流的博客框架&#xff0c;自行搭建。 HexoGitBookVuePressdumi… 如何选择&#xff1f; 我…
阅读更多...
Chain of Note-CoN增强检索增强型语言模型的鲁棒性

Chain of Note-CoN增强检索增强型语言模型的鲁棒性

Enhancing Robustness in Retrieval-Augmented Language Models 检索增强型语言模型&#xff08;RALMs&#xff09;在大型语言模型的能力上取得了重大进步&#xff0c;特别是在利用外部知识源减少事实性幻觉方面。然而&#xff0c;检索到的信息的可靠性并不总是有保证的。检索…
阅读更多...
[ESP32]：基于HTTP实现百度AI识图

[ESP32]：基于HTTP实现百度AI识图

[ESP32]&#xff1a;基于HTTP实现百度AI识图 测试环境&#xff1a; esp32-s3esp idf 5.1 首先&#xff0c;先配置sdk&#xff0c;可以写入到sdkconfig.defaults CONFIG_IDF_TARGET"esp32s3" CONFIG_IDF_TARGET_ESP32S3yCONFIG_PARTITION_TABLE_CUSTOMy CONFIG_PA…
阅读更多...
值迭代和策略迭代【强化学习】

值迭代和策略迭代【强化学习】

强化学习笔记 主要基于b站西湖大学赵世钰老师的【强化学习的数学原理】课程&#xff0c;个人觉得赵老师的课件深入浅出&#xff0c;很适合入门. 第一章 强化学习基本概念 第二章 贝尔曼方程 第三章 贝尔曼最优方程 第四章 值迭代和策略迭代 文章目录 强化学习笔记一、Value It…
阅读更多...
江苏开放大学2024年春《中级会计实务（上） 050284》第1次任务第一单元总论、第二单元存货练习参考答案

江苏开放大学2024年春《中级会计实务（上） 050284》第1次任务第一单元总论、第二单元存货练习参考答案

答案&#xff1a;更多答案&#xff0c;请关注【电大搜题】微信公众号 答案&#xff1a;更多答案&#xff0c;请关注【电大搜题】微信公众号 答案&#xff1a;更多答案&#xff0c;请关注【电大搜题】微信公众号 电大搜题 多的用不完的题库&#xff…
阅读更多...
Qt教程 — 3.6 深入了解Qt 控件：Display Widgets部件(2)

Qt教程 — 3.6 深入了解Qt 控件：Display Widgets部件(2)

目录 1 Display Widgets简介 2 如何使用Display Widgets部件 2.1 QTextBrowser组件-简单的文本浏览器 ​2.2 QGraphicsView组件-简单的图像浏览器 Display Widgets将分为两篇文章介绍 文章1&#xff08;Qt教程 — 3.5 深入了解Qt 控件&#xff1a;Display Widgets部件-CSDN…
阅读更多...
Magic Copy：一键AI抠图，在浏览器中获得任何图像素材

Magic Copy：一键AI抠图，在浏览器中获得任何图像素材

Magic Copy&#xff1a;轻松一点&#xff0c;精准抠图&#xff0c;让创意无限放大&#xff01; - 精选真开源&#xff0c;释放新价值。 概览 Magic Copy&#xff08;AI智能抠图插件&#xff09;是一个创新型的浏览器扩展工具&#xff0c;其独特之处在于能够无缝集成于用户的网…
阅读更多...
CCDP.02.OS正确部署后的Dashboard摘图说明

CCDP.02.OS正确部署后的Dashboard摘图说明

前言 在部署成功OpenStack后&#xff0c;应该可以在浏览器打开Dashboard&#xff0c;并对计算资源&#xff08;这里主要是指VM&#xff09;进行管理&#xff0c;也可以在Dashboard上面查看OpenStack是否存在错误&#xff0c;下面&#xff0c;已针对检查的关键点&#xff0c;用红…
阅读更多...
Mysql之索引存储原理

Mysql之索引存储原理

在介绍索引实现之前&#xff0c;我们先来了解下几种树的数据结构&#xff1a; 一、二叉搜索树 二叉搜索树有以下性质&#xff1a; 1.每个节点有一个关键字 2.左右孩子至多有一个。 3.关键字大于左孩子&#xff0c;小于右孩子。 正因为二叉搜索树的特性&#xff0c;所以这种数…
阅读更多...
基于java+springboot+vue实现的游戏账号估价交易平台（文末源码+Lw+ppt）23-555

基于java+springboot+vue实现的游戏账号估价交易平台（文末源码+Lw+ppt）23-555

摘 要 系统根据现有的管理模块进行开发和扩展&#xff0c;采用面向对象的开发的思想和结构化的开发方法对游戏账号估价交易的现状进行系统调查。采用结构化的分析设计&#xff0c;该方法要求结合一定的图表&#xff0c;在模块化的基础上进行系统的开发工作。在设计中采用“自…
阅读更多...
Structured Knowledge Distillation for Accurate and Efficient Object Detection

Structured Knowledge Distillation for Accurate and Efficient Object Detection

摘要 许多之前的知识蒸馏方法是为图像分类而设计的&#xff0c;在具有挑战性的任务&#xff08;如目标检测&#xff09;中失败。本文首先提出了知识蒸馏在目标检测中失败的主要原因是&#xff1a;&#xff08;1&#xff09;前景和背景之间不平衡&#xff1a;(2)缺乏对不同像素…
阅读更多...
PTA L2-027 名人堂与代金券

PTA L2-027 名人堂与代金券

对于在中国大学MOOC&#xff08;http://www.icourse163.org/ &#xff09;学习“数据结构”课程的学生&#xff0c;想要获得一张合格证书&#xff0c;总评成绩必须达到 60 分及以上&#xff0c;并且有另加福利&#xff1a;总评分在 [G, 100] 区间内者&#xff0c;可以得到 50 元…
阅读更多...
公司内部局域网怎么适用飞书？

公司内部局域网怎么适用飞书？

随着数字化办公的普及&#xff0c;企业对于内部沟通和文件传输的需求日益增长。飞书作为一款集成了即时通讯、云文档、日程管理、视频会议等多种功能的智能协作平台&#xff0c;已经成为许多企业提高工作效率的首选工具。本文将详细介绍如何在公司内部局域网中应用飞书&#xf…
阅读更多...
【机器学习之---统计】统计学基础概念

【机器学习之---统计】统计学基础概念

every blog every motto: You can do more than you think. https://blog.csdn.net/weixin_39190382?typeblog 0. 前言 统计学基础 1. 频率派 频率学派&#xff08;传统学派&#xff09;认为样本信息来自总体&#xff0c;通过对样本信息的研究可以合理地推断和估计总体信息…
阅读更多...
docker 的八大技术架构(图解)

docker 的八大技术架构(图解)

docker 的八大技术架构 单机架构 概念&#xff1a; 应用服务和数据库服务公用一台服务器 出现背景&#xff1a; 出现在互联网早期&#xff0c;访问量比较小&#xff0c;单机足以满足需求 架构优缺点&#xff1a; 优点&#xff1a;部署简单&#xff0c;成本低 缺点&#xff1…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023