【鸿蒙 HarmonyOS】数据持久化

一、数据持久化先容

数据持久化是将内存数据(内存是临时的存储空间)，通过文件或数据库的形式保存在设备中。
HarmonyOS提供两种数据持久化方案：
1.1、用户首选项（Preferences）：

通常用于保存应用的配置信息。数据通过文本的形式保存在设备中，应用使用过程中会将文本中的数据全量加载到内存中，所以访问速度快、服从高，但不得当需要存储大量数据的场景。
1.2、数据库：

键值型数据库（KV-Store）：一种非关系型数据库，其数据以“键值”对的形式举行组织、索引和存储，此中“键”作为唯一标识符。得当很少数据关系和业务关系的业务数据存储，同时因其在分布式场景中低沉相识决数据库版本兼容问题的复杂度，和数据同步过程中辩说办理的复杂度而被广泛使用。相比于关系型数据库，更容易做到跨设备跨版本兼容。
关系型数据库（RelationalStore）：一种关系型数据库，以行和列的形式存储数据，广泛用于应用中的关系型数据的处理，包罗一系列的增、删、改、查等接口，开发者也可以运行自己定义的SQL语句来满足复杂业务场景的需要。
二、通过用户首选项实现数据持久化

使用场景：用户首选项为应用提供Key-Value键值型的数据处理本领，支持应用持久化轻量级数据，并对其修改和查询。

   说明：
  ①Key键为string类型，要求非空且长度不超过80个字节。
  ②Value可以是string、number、boolean及以上类型数组，大小不超过8192字节
  ③数据量建议不超过一万条
  

2.1、基本案例

2.1.1、案例代码

1. @Entry
2. @Component
3. struct Index {
4.   @State message: string = '页面列表'
5.   @State showPanel: boolean = false
6.   @Provide fontSize: number = 16
8.   build() {
9.     Column(){
10.       // 顶部标题
11.       this.Title()
12.       // 导航列表
13.       this.RouterList()
14.       // 字体修改面板
15.       if(this.showPanel){
16.         IndexFontSizePanel()
17.           .transition({
18.             translate: { y: 115 }
19.           })
20.       }
21.     }
22.     .width('100%')
23.     .height('100%')
24.   }
26.   @Builder Title(){
27.     Row() {
28.       Text(this.message)
29.         .fontSize(50)
30.         .fontWeight(FontWeight.Bold)
31.         .height(80)
32.       Image($r('app.media.ic_public_settings'))
33.         .width(30)
34.         .onClick(() => {
35.           animateTo({ duration: 500, curve: Curve.EaseOut }, () => this.showPanel = !this.showPanel)
36.         })
37.     }
38.     .justifyContent(FlexAlign.SpaceAround)
39.     .width('100%')
40.   }
42.   @Builder RouterList() {
43.     List({ space: 15 }) {
44.       ForEach(
45.         ['导航','屏幕','图片','图书','书架'],
46.         (item,index) => {
47.           ListItem() {
48.             Row(){
49.               Text((index+1) + '.')
50.                 .fontSize(this.fontSize)
51.                 .fontColor(Color.White)
52.               Blank()
53.               Text(item)
54.                 .fontSize(this.fontSize)
55.                 .fontColor(Color.White)
56.             }
57.             .width('90%')
58.             .padding(12)
59.             .backgroundColor('#38f')
60.             .borderRadius(20)
61.             .shadow({radius: 6, color: '#4F000000', offsetX: 2, offsetY: 4})
62.           }
63.         }
64.       )
65.     }
66.     .layoutWeight(1)
67.     .alignListItem(ListItemAlign.Center)
68.     .width('100%')
69.   }
70. }
73. @Component
74. struct IndexFontSizePanel {
75.   @Consume fontSize: number
76.   fontSizLabel: object = {
77.     14: '小',
78.     16: '标准',
79.     18: '大',
80.     20: '特大',
81.   }
82.   build() {
83.     Column() {
84.       Text(this.fontSizLabel[this.fontSize]).fontSize(20)
85.       Row({ space: 5 }) {
86.         Text('A').fontSize(14).fontWeight(FontWeight.Bold)
87.         Slider({
88.           min: 14,
89.           max: 20,
90.           step: 2,
91.           value: this.fontSize
92.         })
93.           .showSteps(true)
94.           .trackThickness(6)
95.           .layoutWeight(1)
96.           .onChange(val => {
97.             // 修改字体大小
98.             this.fontSize = val
99.           })
100.         Text('A').fontSize(20).fontWeight(FontWeight.Bold)
101.       }.width('100%')
102.     }
103.     .width('100%')
104.     .padding(15)
105.     .backgroundColor('#fff1f0f0')
106.     .borderRadius(20)
107.   }
108. }

复制代码

2.1.2、案例结果：

   案例说明：
  这是一个页面列表展示案例，点击右上角的设置按钮，底部会弹出字体修改面板，字体有4个不同的大小(小/尺度/大/特大)，当点击滑动条可以修改字体大小
  目前更改了滑动条的字体大小数据是保存在内存的，关闭页面后再进来数据体现默认大小，如今是想通过用户首选项实现数据持久化，持久化保存设置的字体大小
  2.2、详细实现

2.2.1、定义用户首选项操作文件

1. import preferences from '@ohos.data.preferences';
3. class PreferencesUtil{
5.   prefMap: Map<string, preferences.Preferences> = new Map()
7.   async loadPreference(context, name: string){
8.     try { // 加载preferences
9.       let pref = await preferences.getPreferences(context, name)
10.       this.prefMap.set(name, pref)
11.       console.log('testTag', `加载Preferences[${name}]成功`)
12.     } catch (e) {
13.       console.log('testTag', `加载Preferences[${name}]失败`, JSON.stringify(e))
14.     }
15.   }
17.   async putPreferenceValue(name: string, key: string, value: preferences.ValueType){
18.     if (!this.prefMap.has(name)) {
19.       console.log('testTag', `Preferences[${name}]尚未初始化！`)
20.       return
21.     }
22.     try {
23.       let pref = this.prefMap.get(name)
24.       // 写入数据
25.       await pref.put(key, value)
26.       // 刷盘
27.       await pref.flush()
28.       console.log('testTag', `保存Preferences[${name}.${key} = ${value}]成功`)
29.     } catch (e) {
30.       console.log('testTag', `保存Preferences[${name}.${key} = ${value}]失败`, JSON.stringify(e))
31.     }
32.   }
34.   async getPreferenceValue(name: string, key: string, defaultValue: preferences.ValueType){
35.     if (!this.prefMap.has(name)) {
36.       console.log('testTag', `Preferences[${name}]尚未初始化！`)
37.       return
38.     }
39.     try {
40.       let pref = this.prefMap.get(name)
41.       // 读数据
42.       let value = await pref.get(key, defaultValue)
43.       console.log('testTag', `读取Preferences[${name}.${key} = ${value}]成功`)
44.       return value
45.     } catch (e) {
46.       console.log('testTag', `读取Preferences[${name}.${key} ]失败`, JSON.stringify(e))
47.     }
48.   }
49. }
51. const preferencesUtil = new PreferencesUtil()
53. export default preferencesUtil as PreferencesUtil

复制代码

2.2.2、将数据加载到Preferences实例，用于数据操作。

放入应用启动时来操作，找到EntryAbility文件，在onCreate应用创建时，加载Preferences实例

2.2.3、Index页面使用

第一步：一进入首页就举行读取
使用页面生命周期aboutToAppear来执行

第二步：修改字体大小时写入Preferences

   末了：