鸿蒙NEXT开辟-应用数据持久化之用户首选项（基于最新api12稳定版） ...

注意：博主有个鸿蒙专栏，里面从上到下有关于鸿蒙next的教学文档，各人感爱好可以学习下
如果各人觉得博主文章写的好的话，可以点下关注，博主会不停更新鸿蒙next相关知识
专栏地址: https://blog.csdn.net/qq_56760790/category_12794123.html

鸿蒙next学习交流
qq群号：767465523
目次
1. 应用数据持久化
2. 应用数据持久化-用户首选项
2.1 概述
2.2 约束限制
2.3 常用方法
2.3.1 封装用户首选项工具类
2.3.2 初始化用户首选项
2.3.3 使用用户首选项
4. 学习地址

---

1. 应用数据持久化


应用数据持久化，是指应用将内存中的数据通过文件或数据库的情势保存到设备上。内存中的数据形态通常是恣意的数据结构或数据对象，存储介质上的数据形态大概是文本、数据库、二进制文件等。
HarmonyOS标准系统支持典范的存储数据形态，包括用户首选项、键值型数据库、关系型数据库。

• 用户首选项（Preferences）：通常用于保存应用的设置信息。数据通过文本的情势保存在设备中，应用使用过程中会将文本中的数据全量加载到内存中，所以访问速度快、服从高，但不适合须要存储大量数据的场景。
  
• 键值型数据库（KV-Store）：一种非关系型数据库，其数据以“键值”对的情势举行构造、索引和存储，其中“键”作为唯一标识符。适合很少数据关系和业务关系的业务数据存储，同时因其在分布式场景中低落相识决数据库版本兼容问题的复杂度，和数据同步过程中辩论解决的复杂度而被广泛使用。相比于关系型数据库，更容易做到跨设备跨版本兼容。
  
• 关系型数据库（RelationalStore）：一种关系型数据库，以行和列的情势存储数据，广泛用于应用中的关系型数据的处理，包括一系列的增、删、改、查等接口，开辟者也可以运行本身界说的SQL语句来满足复杂业务场景的须要。
  

2. 应用数据持久化-用户首选项


2.1 概述


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

2.2 约束限制

• 首选项无法保证进程并发安全，会有文件损坏和数据丢失的风险，不支持在多进程场景下使用。
  
• Key键为string类型，要求非空且长度不超过1024个字节。
  
• 如果Value值为string类型，请使用UTF-8编码格式，可以为空，不为空时长度不超过16 * 1024 * 1024个字节。
  
• 内存会随着存储数据量的增大而增大，所以存储的数据量应该是轻量级的，发起存储的数据不超过一万条，否则会在内存方面产生较大的开销。
  

2.3 常用方法


参考华为官方文档：文档中心

注意：记得用真机或者模仿器运行

2.3.1 封装用户首选项工具类


注意：PreferencesUtil文件末端是ts不是ets

1. import dataPreferences from '@ohos.data.preferences'
2. import hilog from '@ohos.hilog';
4. /**
5. * 用户首选项(存储简单数据)
6. */
7. export default class PreferencesUtil {
8.   // 用户首选项名称
9.   private static preferenceName: string = 'myStore'
11.   /**
12.    * 创建
13.    * @param context
14.    */
15.   static createPreferences(context) {
16.     globalThis.getFontPreferences = (() => {
17.       let preferences: Promise<dataPreferences.Preferences> =
18.         dataPreferences.getPreferences(context, this.preferenceName);
19.       return preferences;
20.     });
21.   }
23.   /**
24.    * 存放数据
25.    * @param value
26.    */
27.   static savePreferencesValue(key: string, value: string) {
28.     globalThis.getFontPreferences().then((preferences) => {
29.       preferences.has(key).then(async (isExist) => {
30.         if (!isExist) {
31.           await preferences.put(key, value);
32.           preferences.flush();
33.         }
34.       }).catch((err) => {
35.         hilog.info(0xFF00, 'preferencesTag', '%{public}s', 'save PreferencesValue fail');
36.       });
37.     }).catch((err) => {
38.       hilog.info(0xFF00, 'preferencesTag', '%{public}s', 'save PreferencesValue fail');
39.     });
40.   }
42.   /**
43.    * 获取数据
44.    * @returns
45.    */
46.   static async getPreferencesValue(key: string) {
47.     let value: string = '';
48.     const preferences = await globalThis.getFontPreferences();
49.     value = await preferences.get(key, value);
50.     return value;
51.   }
53.   /**
54.    * 删除数据
55.    */
56.   static async deletePreferencesValue(key: string) {
57.     const preferences: dataPreferences.Preferences = await globalThis.getFontPreferences();
58.     let deleteValue = preferences.delete(key);
59.     deleteValue.then(() => {
60.       hilog.info(0xFF00, 'preferencesTag', '%{public}s', 'delete PreferencesValue success');
61.     }).catch((err) => {
62.       hilog.info(0xFF00, 'preferencesTag', '%{public}s', 'delete PreferencesValue fail');
63.     });
64.   }
65. }

复制代码

2.3.2 初始化用户首选项


在EntryAbility文件中初始化用户首选项

1.   onWindowStageCreate(windowStage: window.WindowStage): void {
2.     // 初始化用户首选项
3.     PreferencesUtil.createPreferences(this.context);
4.     // Main window is created, set main page for this ability
5.     hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
7.     windowStage.loadContent('pages/Index', (err) => {
8.       if (err.code) {
9.         hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
10.         return;
11.       }
12.         hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
13.     });
14.   }

复制代码

2.3.3 使用用户首选项


注意：用户首选项存的值全局都可以获取到

1. import PreferencesUtil from '../utils/PreferencesUtil'
3. @Entry
4.   @Component
5.   struct Index {
6.     build() {
7.       Column() {
8.         Text('存值')
9.           .onClick(() => {
10.             PreferencesUtil.savePreferencesValue('username', '东林')
11.             console.log('preferences save success')
12.           }).margin({bottom:50})
14.         Divider()
16.         Text('点我获取preferences值')
17.           .onClick(async () => {
18.             const username = await PreferencesUtil.getPreferencesValue('username')
19.             console.log('preferences username:' + JSON.stringify(username))
20.           }).margin({bottom:50})
22.         Divider()
24.         Text('删除')
25.           .onClick(async () => {
26.             await PreferencesUtil.deletePreferencesValue('username')
27.             console.log('preferences remove success')
28.           })
29.       }
30.       .height('100%')
31.         .width('100%')
32.     }
33.   }

复制代码

4. 学习地址

全网首发鸿蒙NEXT星河版零基础入门到实战，2024年最新版，企业级开辟！视频连续更新中！_哔哩哔哩_bilibili



免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。