HarmonyOS 用户首选项数据持久化详解

前端 潘老师 3个月前 (12-07) 104 ℃ (0) 扫码查看

本文主要讲解关于HarmonyOS 用户首选项数据持久化详解相关内容,让我们来一起学习下吧!

HarmonyOS 数据持久化能力- 用户首选项(Preferences)

用户首选项(Preferences):以文本的形式保存数据,使用时数据会加载到内存中,范围速度快,效率高,但是不适合存储大量数据。

用户首选项(Preferences)

通过Preferences 提供接口,将持久化文件加载Preferences实例中,每一个文件对应一个Preferences 实例,系统会将Preferences实例存储在内存中,达到快速,高效访问的效果。

约束条件

  1. 键必须为string 类型,不能为空并且长度小于80个字节。
  2. 值(Value)为string 类型时,可以为空,最大限制为 8192个字节。
  3. 存储数据不要超过1万条,否则会造成内存较大开销。

核心功能

核心功能,均以异步接口的形式提供。除常用的get(获取)、has(判断是否存在)、put(写入)、delete(时删除)、flush(持久化到文件)等功能外,还提供on(订阅数据变更)、off(取消订阅)功能,便于应用根据数据变化进行业务处理。

封装事例:

import dataPreferences from '@ohos.data.preferences';
import { IMDatabaseConst } from '../service/IMDatebaseConst';

let context = getContext(this)
let preference: dataPreferences.Preferences

class IMPreference {
 async getPreferences() {
   try {
  preference = await dataPreferences.getPreferences(context, IMDatabaseConst.PREFERENCES_NAME)
   }
   catch (err) {
  console.error(`error:${err}`)
   }
 }

  async deletePreferences() {
  try {
   await dataPreferences.deletePreferences(context, IMDatabaseConst.PREFERENCES_NAME);
  } catch(err) {
   console.error('TAG', `Failed to delete preferences, Cause: ${err}`);
  };
  }

  async putPreference(key: string, value: string) {
  if (!key || !value) {
   return
  }

  if (!preference) {
   await this.getPreferences();
  }
  // The fruit name and fruit quantity data entered by the user are saved to the cached Preference instance.
  try {
   await preference.put(key, value);
  } catch (err) {
   console.error('TAG', `Failed to put value, Cause: ${err}`);
  }
  // Store the Preference instance in the preference persistence file
  await preference.flush();
  }

  /**
   * Get preference data.
   */
  async getPreference(key: string) {
  if (!key) {
   return
  }

  let value: number | string | boolean | Array<number> | Array<string> | Array<boolean>;
  if (!preference) {
   await this.getPreferences();
  }
  try {
   value = await preference.get(key, '')
  } catch (err) {
   console.error('TAG', `Failed to get value, Cause: ${err}`)
  }
  // If the data is empty, a message is displayed indicating that data needs to be written.
  if (value === '') {
   return
  }

  return value;
  }
}

export default new IMPreference();

以上就是关于HarmonyOS 用户首选项数据持久化详解相关的全部内容,希望对你有帮助。欢迎持续关注潘子夜个人博客(www.panziye.com),学习愉快哦!


版权声明:本站文章,如无说明,均为本站原创,转载请注明文章来源。如有侵权,请联系博主删除。
本文链接:https://www.panziye.com/front/12243.html
喜欢 (0)
请潘老师喝杯Coffee吧!】
分享 (0)
用户头像
发表我的评论
取消评论
表情 贴图 签到 代码

Hi,您需要填写昵称和邮箱!

  • 昵称【必填】
  • 邮箱【必填】
  • 网址【可选】