HarmonyOS应用开发：应用程序的数据存储AppStorage_harmony 数据存储工具类

作者：IT小白 | 2024-03-21 00:55:28

踩

harmony 数据存储工具类

AppStorage接口

方法	参数说明	返回值	定义
SetAndLink	key: string, defaultValue: T	@Link	与Link接口类似，如果当前的key保存于AppStorage，则返回该key对应的value。如果该key未被创建，则创建一个对应default值的Link返回。
Set	key: string, newValue: T	void	对已保存的key值，替换其value值。
Link	key: string	@Link	如果存在具有给定键的数据，则返回到此属性的双向数据绑定，该双向绑定意味着变量或者组件对数据的更改将同步到AppStorage，通过AppStorage对数据的修改将同步到变量或者组件。如果具有此键的属性不存在或属性为只读，则返回undefined。
SetAndProp	propName: string, defaultValue: S	@Prop	与Prop接口类似，如果当前的key保存于AppStorage，则返回该key对应的value。如果该key未被创建，则创建一个对应default值的Prop返回。
Prop	key: string	@Prop	如果存在具有给定键的属性，则返回此属性的单向数据绑定。该单向绑定意味着只能通过AppStorage将属性的更改同步到变量或者组件。该方法返回的变量为不可变变量，适用于可变和不可变的状态属性，如果具有此键的属性不存在则返回undefined。 > 说明： > prop方法对应的属性值类型为简单类型。
SetOrCreate	key: string, newValue: T	boolean	如果已存在与给定键名字相同的属性，如果此属性可以被更改则替换其value值且返回true，否则不替换且返回false。如果不存在存在与给定键名字相同的属性, 则创建一个键为key, 值为newValue的属性，属性值不支持null和undefined。
Get	key: string	T或undefined	通过此接口获取对应key值的value。
Has	propName: string	boolean	判断对应键值的属性是否存在。
Keys	void	array<string>	返回包含所有键的字符串数组。
Delete	key: string	boolean	删除key指定的键值对，如果存在且删除成功返回true，不存在或删除失败返回false。
Clear	void	boolean	删除所有的属性，如果当前有状态变量依旧引用此属性，则返回false。
IsMutable	key: string	boolean	返回此属性是否存在并且是否可以改变。

AppStorage与组件同步

@StorageLink装饰器

组件通过使用@StorageLink(key)装饰的状态变量，与AppStorage建立双向数据绑定，key为AppStorage中的属性键值。当创建包含@StorageLink的状态变量的组件时，该状态变量的值将使用AppStorage中的值进行初始化。在UI组件中对@StorageLink的状态变量所做的更改将同步到AppStorage，并从AppStorage同步到任何其他绑定实例中，如PersistentStorage或其他绑定的UI组件。

@StorageProp装饰器

组件通过使用@StorageProp(key)装饰的状态变量，将与AppStorage建立单向数据绑定，key标识AppStorage中的属性键值。当创建包含@StoageProp的状态变量的组件时，该状态变量的值将使用AppStorage中的值进行初始化。AppStorage中的属性值的更改会导致绑定的UI组件进行状态更新。反过来，UI组件的状态变量改变不会修改AppStorage里对应属性的值，更不会刷新其它UI组件。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/IT小白/article/detail/277222