《HarmonyOS应用开发基础》 课件知识点3-2 首选项.pptx

首选项

首选项概述首选项Preferences，适用于对Key-Value结构的数据进行存取和持久化操作。首选项基本概念Key-Value数据结构一种键值型的数据结构。Key是不重复的关键字，Value是数据值。在首选项中key的类型是字符串类型，Value的类型包括数字型、字符串型、布尔型以及这3种类型的数组类型。非关系型数据库区别于关系数据库，不保证遵循ACID（Atomic、Consistency、Isolation及Durability）特性，不采用关系模型来组织数据，数据之间无关系。比如，以Key-Value数据结构组成的数据库。

首选项概述运作机制

首选项概述约束和限制因Preferences实例会加载到内存中，建议存储的数据不超过一万条，并注意及时清理不再使用的实例，以便减少非内存开销。数据中的Key为string类型，要求非空且字符长度不超过80个字节。当数据中的Value为string类型时，允许为空，字符长度不超过8192个字节。

首选项的使用使用场景首选项功能通常用于保存应用的一些常用配置信息，并不适合需要存储大量数据和频繁改变数据的场景。应用的数据保存在文件中，这些文件可以持久化地存储在设备上。接口说明创建存储实例数据处理数据持久化订阅数据变更删除数据文件

首选项的使用创建存储实例读取指定文件，将数据加载到Preferences实例，即可创建一个存储实例，用于数据操作。PreferencesAPI提供两套接口来使用Preferences，一套使用Promise，另一套使用callback异步回调的方式。这里我们以callback异步回调为例：包名接口名描述ohos.data.preferencesgetPreferences(context:Context,name:string,callback:AsyncCallbackPreferences):void读取指定首选项持久化文件，将数据加载到Preferences实例，用于数据操作。

首选项的使用数据处理数据处理是对Preference实例的数据进行增删改查。类名接口名描述Preferencesput(key:string,value:ValueType,callback:AsyncCallbackvoid):void支持存入值为number、string、boolean、Arraynumber、Arraystring、Arrayboolean类型的数据。Preferencesget(key:string,defValue:ValueType,callback:AsyncCallbackValueType):void支持获取值为number、string、boolean、Arraynumber、Arraystring、Arrayboolean类型的数据。PreferencesgetAll(callback:AsyncCallbackObject):void支持获取含有所有键值的Object对象。Preferencesdelete(key:string,callback:AsyncCallbackvoid):void支持从Preferences实例中删除名为给定Key的存储键值对。Preferenceshas(key:string,callback:AsyncCallbackboolean):void检查Preferences实例是否包含名为给定Key的存储键值对

首选项的使用数据持久化通过执行flush方法，应用可以将缓存的数据再次写回文本文件中进行持久化存储。类名接口名描述Preferencesflush(callback:AsyncCallbackvoid):void将Preferences实例通过异步线程回写入文件中。

首选项的使用订阅数据变更订阅数据变更，订阅的Key的值发生变更后，在执行flush方法后，会触发callback回调。类名接口名描述Preferenceson(type:change,callback:Callback{key:string}):void订阅数据变更。Preferencesoff(type:change,callback:Callback{key:string}):void注销订阅。

首选项的使用删除数据文件通过调用以下两种接口，可以删除数据实例或对应的文件。类名接口名描述ohos.data.preferencesdeletePreferences(context:Context,name:string,callback:AsyncCallbackvoid)从缓存中移除已加载的Preferences对象，同时从