class Student {
name: string;
age: number;
constructor(name: string, age: number) {
this.name = name;
this.age = age;
}
}
class Students {
students: Student[] = [new Student('Tom', 16), new Student('Gina', 18)];
}
PersistentStorage.persistProp('studentArr', new Students());
@Entry
@Component
struct SceneOne {
@StorageLink('studentArr') studentArrStr: Students | undefined = undefined;
build() {
Column({ space: 8 }) {
ForEach(this.studentArrStr?.students, (item: Student) => {
Column() {
Text(`Student Name: ${item.name}`)
.width('100%');
Text(`Student Age: ${item.age}`)
.width('100%');
}
.borderRadius(12)
.width('100%')
.backgroundColor('#f1f3f5')
.padding(16)
.onClick(() => {
this.studentArrStr!.students[0].age = 999;
this.studentArrStr!.students[1].age = 1000;
});
}, (item: Student) => JSON.stringify(item));
}
.width('100%')
.height('100%')
.padding(12);
}
} 场景 | 场景描述 | 解决方案 |
|---|---|---|
场景一 | 如何解决嵌套对象更新PersistentStorage持久化数据失效的问题? | AppStorage不具备深度观测能力的限制,导致嵌套对象持久化失效,只能监听第一层变化。 |
场景二 | 如何解决PersistentStorage无法获取持久化的数据的问题? | 初始化在loadContent之前导致获取失败,详情参考官网行业常见问题:PersistentStorage无法获取持久化的数据如何解决。 |
场景三 | 如何解决PersistentStorage持久化数据无法删除的问题? | 存在被注册了的监听,导致无法删除,详情参考官网行业常见问题:PersistentStorage持久化数据无法删除。 |
在PersistentStorage持久化数据时一般是依赖AppStorage中的相关API进行持久化更新,例如上述问题代码中,通过@StorageLink获取的PersistentStorage持久化数据,当UI内修改该数据时,同步修改回PersistentStorage进行本地持久化。所以此时受AppStorage不具备深度观测能力的限制,直接修改嵌套的深层属性,不会更新回PersistentStorage进行本地持久化。修改后完整示例代码如下:
class Student {
name: string;
age: number;
constructor(name: string, age: number) {
this.name = name;
this.age = age;
}
}
class Students {
students: Student[] = [new Student('Tom', 16), new Student('Gina', 18)];
}
PersistentStorage.persistProp('studentArr', new Students());
@Entry
@Component
struct SceneOne {
@StorageLink('studentArr') studentArrStr: Students | undefined = undefined;
build() {
Column({ space: 8 }) {
ForEach(this.studentArrStr?.students, (item: Student) => {
Column() {
Text(`Student Name: ${item.name}`)
.width('100%');
Text(`Student Age: ${item.age}`)
.width('100%');
}
.borderRadius(12)
.width('100%')
.backgroundColor('#f1f3f5')
.padding(16)
.onClick(() => {
this.studentArrStr!.students = [new Student('Tom', 999), new Student('Gina', 1000)];
});
}, (item: Student) => JSON.stringify(item));
}
.width('100%')
.height('100%')
.padding(12);
}
}
场景一实现效果如下:

PersistentStorage和UI实例相关联,持久化操作需要在UI实例初始化成功后(即loadContent传入的回调被调用时)才可以被调用,由于问题代码中PersistentStorage早于该时机调用,所以会导致持久化失败。详情参考官网行业常见问题:PersistentStorage无法获取持久化的数据如何解决。
当有页面使用@StorageLink的装饰器注册了监听时,可能存在无法删除的情况,详情参考官网行业常见问题:PersistentStorage持久化数据无法删除。
Q:如果PersistentStorage中存在大量数据,清空操作是否会导致性能问题?如何优化?
A:PersistentStorage主要用于持久化存储UI状态和其他少量数据。根据文档,PersistentStorage的写入操作是同步的,并且最好用于存储小于2KB的数据。这是因为大量的数据持久化会影响UI渲染性能,特别是在UI线程中执行时。因此执行清空操作也会导致性能问题。优化方式参考如下:
Q:使用了一个API来批量清空PersistentStorage中的数据,但返回了“UnsupportedOperationException”。这通常意味着什么?应该如何确保操作的支持?
A:“UnsupportedOperationException”通常在尝试调用一个不被当前环境或实现所支持的操作时抛出。这意味着使用的API可能不支持在当前的设备或系统环境中执行批量清空PersistentStorage的操作。确保操作的支持:
Q:如果PersistentStorage中的数据与其他组件或服务共享,清空操作前需要做哪些准备工作?
A:如果PersistentStorage中的数据与其他组件或服务共享,清空操作前建议备份数据。
Q:执行批量清空PersistentStorage数据时遇到了“NullPointerException”。应该如何排查和解决这个问题?
A:出现“NullPointerException”现象时,可参考以下原因排查:
解决方案参考如下:
Q:在使用PersistentStorage进行持久化存储UI状态时,有什么注意事项?
A:持久化数据是一个相对缓慢的操作,应用程序应避免以下情况:持久化大型数据集以及持久化经常变化的变量。
Q:如何监控PersistentStorage的使用情况,及时发现并处理异常访问?
A:可以通过以下方式监控PersistentStorage的使用情况: