前两个小阶介绍的LocalStorage和AppSotrage都是运行时的内存,但是在应用退出再次启动后,依然能保存选定的结果,是应用开发中非常常见的现象,这就需要用到PersistentStorage。
PersistentStorage是应用程序找那个的可选单例对象。此对象的作用是持久化存储选定的AppStorage属性,以确保这些属性在应用程序重新启动时的值与应用程序关闭时的值相同。
PersistentStorage将选定的AppStorage属性保留在设备磁盘上。应用程序通过API,以决定哪些AppStorage属性应结束PersistentStorage持久化。UI和业务逻辑不直接访问PersistentStorage中的属性,所有属性访问都是对AppStorage的访问,AppStorage中的更改会自动同步到PersistentStorage。
PersistentStorage和AppStorage中的属性建立双向同步。应用开发通常通过AppStorage访问PersistentStorage,另外还有一些接口可以用于管理持久化属性,但是业务逻辑始终是通过AppStorage获取和设置属性的。
持久化数据是一个相对缓慢的操作,应用逻辑应避免以下情况:
当持久化更改的过程变得太繁重时,PersistentStorage实现可能会限制持久化属性更改的频率。
PersistentStorage.PersistentProp('aProp',47);
AppStorage.Get('aProp');//returns 47
或在组件内部定义:
@StorageLink('aProp') aProp: number = 48;
完整代码如下:
PersistentStorage.PersistProp('aProp',47)
@Entry
@Component
struct Index{
@State message: string = 'Hello World'
@StorageLink('aProp') aProp:number = 48
build(){
Row(){
Column(){
Text(this.message)
//应用退出时会保存当前结果。重新启动后,会显示上一次的保存结果
Text(`${this.aProp}`)
.onClick(()=>{
this.aProp +=1;
})
}
}
}
}
该示例为反例。在调用PersistentStorage.PersistProp或者PersistProps之前使用接口访问AppStorage中的属性是错误的,因为这样的调用顺序会丢失上一次应用程序运行中的属性值:
let aProp = AppStorage.SetOrCreate('aProp',47);
PersistentStorage.PersistProp('aProp',48);
应用在非首次运行时,先执行AppStorage.SetOrCreate(‘aProp’,47):属性“aProp”在AppStorage中创建,其类型为number,其值设置为指定的默认值47.’aProp‘是持久化的属性,所以会被写回PersistentStorage磁盘中,PersistentStorage存储的上次退出应用的值丢失。
PersistentStorage.PersistProp(‘aProp’,48): 在PersistentStorage中查找到“aProp”,找到,值为47.