@Type装饰类属性,用于状态管理V2,确保序列化类时不丢失属性的复杂类型。在使用PersistenceV2等持久化能力对复杂类对象进行序列化和反序列化时,类的属性类型信息可能会丢失。通过@Type标记属性的原始类型,可确保在序列化过程中正确保留和还原属性的复杂类型信息,适用于需要持久化或序列化复杂对象的场景,例如应用状态持久化存储、跨组件复杂数据传递等。
开发指南参考:@Type装饰器:标记类属性的类型。
从API version 12开始,支持该装饰器。
const Type: TypeDecorator
@Type标记属性的原始类型,可确保在序列化过程中正确保留和还原属性的复杂类型信息。
模型约束: 此接口仅可在Stage模型下使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | TypeConstructor<T> | 是 | 标记类属性的原始类型,取值为对应类的构造函数,需与被装饰属性的类型一致。 |
示例:
import { PersistenceV2, Type } from '@kit.ArkUI';
@ObservedV2
class SampleChild {
@Trace childNumber: number = 1;
}
@ObservedV2
class Sample {
// 使用@Type装饰器标记sampleChild属性的类型为SampleChild
// 确保序列化时不会丢失属性的复杂类型信息
@Type(SampleChild)
@Trace sampleChild?: SampleChild = undefined;
}
@Entry
@ComponentV2
struct Index {
// 使用@Local装饰器声明组件内部状态变量
// 通过PersistenceV2.connect连接持久化数据,若不存在则创建新的Sample实例
@Local sample: Sample = PersistenceV2.connect(Sample, () => new Sample)!;
build() {
Column() {
Text(`childNumber value: ${this.sample.sampleChild?.childNumber}`)
.onClick(() => {
this.sample.sampleChild = new SampleChild();
this.sample.sampleChild.childNumber = 2;
PersistenceV2.save(Sample);
})
.fontSize(30)
}
}
}