鸿蒙Next类属性观测器V2-编程知识

鸿蒙Next类属性观测器V2

在鸿蒙Next开发中，类属性的观测对于状态管理至关重要。本文将详细介绍@ObservedV2装饰器和@Trace装饰器的功能、使用方法、限制以及应用场景，帮助开发者更好地理解和运用这两个装饰器进行类属性变化观测，从而实现更高效的状态管理。

@ObservedV2与@Trace装饰器配合使用，赋予类和属性深度观测能力，使被装饰的类和属性在变化时能触发相应UI组件刷新，增强状态管理框架对类对象属性的观测能力。

从API version 12开始支持@ObservedV2与@Trace装饰器。

当前状态管理（V2试用版）仍在开发中，功能尚未成熟，开发者可尝鲜试用。

参数：无。
作用：装饰class中的成员属性，属性类型可为number、string、boolean、class、Array、Date、Map、Set等，使被装饰属性变化时可被观测。

使用@ObservedV2装饰的类中，被@Trace装饰的属性值变化时，会触发该属性绑定的UI组件刷新。

嵌套类场景
- 当嵌套类中的属性被@Trace装饰且嵌套类被@ObservedV2装饰时，该属性变化具有触发UI刷新的能力。
- 例如，在Pencil类（被@ObservedV2装饰）中，属性length（被@Trace装饰）变化时，关联的UI组件会刷新。但如果son变量（非状态变量）重新赋值，即使length属性变化，UI也不会刷新。
继承类场景
- 无论是在基类还是继承类中，被@Trace装饰的属性变化都可被观测并触发UI刷新。
- 如在GrandFather类（被@ObservedV2装饰）中，属性age（被@Trace装饰），在Son类或Cousin类实例中改变age值，UI会相应刷新。
静态属性场景
- 类中被@Trace装饰的静态属性变化时，也能触发UI刷新。

@Trace装饰内置类型（如Array、Date、Map、Set等）时，可观测各自API导致的变化，具体API如下：

类型	可观测变化的API
Array	push、pop、shift、unshift、splice、copyWithin、fill、reverse、sort
Date	setFullYear, setMonth, setDate, setHours, setMinutes, setSeconds, setMilliseconds, setTime, setUTCFullYear, setUTCMonth, setUTCDate, setUTCHours, setUTCMinutes, setUTCSeconds, setUTCMilliseconds
Map	set, clear, delete
Set	add, clear, delete

非@Trace装饰的成员属性用在UI上无法触发UI刷新。

@Trace不能用在未被@ObservedV2装饰的class上。
@Trace不能用在struct中。
@ObservedV2、@Trace不能与@Observed、@Track混合使用。
使用@ObservedV2与@Trace装饰的类不能和@State等V1的装饰器混合使用，继承自@ObservedV2的类也无法和@State等V1的装饰器混用。
@ObservedV2的类实例目前不支持使用JSON.stringify进行序列化。

在嵌套类结构中，如Pencil类（被@ObservedV2装饰）中的length属性（被@Trace装饰），其变化可触发关联UI组件刷新。但如果外层非状态变量重新赋值，会导致UI无法观测到内部属性变化。

在类继承关系中，如GrandFather类（被@ObservedV2装饰）的age属性（被@Trace装饰），在Son类或Cousin类实例中改变age值，UI会刷新。

基础类型数组：@Trace装饰Arr类中的numberArr数组（@ObservedV2装饰Arr类），使用支持的数组API操作时可观测到变化。
对象数组：@Trace装饰Info类中的personList对象数组（@ObservedV2装饰Info类）以及Person类中的age属性，当personList或age改变时可观测到变化。
Map类型：@Trace装饰Info类中的memberMap（@ObservedV2装饰Info类），调用set、clear、delete等API时可观测到变化，对memberMap赋值也可观测。