一、引言
在鸿蒙Next开发中，类属性的观测对于状态管理至关重要。本文将详细介绍@ObservedV2装饰器和@Trace装饰器的功能、使用方法、限制以及应用场景，帮助开发者更好地理解和运用这两个装饰器进行类属性变化观测，从而实现更高效的状态管理。
二、装饰器概述
（一）功能
@ObservedV2与@Trace装饰器配合使用，赋予类和属性深度观测能力，使被装饰的类和属性在变化时能触发相应UI组件刷新，增强状态管理框架对类对象属性的观测能力。
（二）版本支持
从API version 12开始支持@ObservedV2与@Trace装饰器。
（三）注意事项
当前状态管理（V2试用版）仍在开发中，功能尚未成熟，开发者可尝鲜试用。
三、装饰器说明
（一）@ObservedV2类装饰器
- 参数：无。
- 作用：装饰class，放在class定义前，用于创建类对象，使类具备被观测的能力。
（二）@Trace成员变量装饰器
- 参数：无。
- 作用：装饰class中的成员属性，属性类型可为number、string、boolean、class、Array、Date、Map、Set等，使被装饰属性变化时可被观测。
四、观察变化机制
（一）触发UI刷新条件
使用@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 |
五、使用限制
（一）UI刷新限制
非@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赋值也可观测。
七、总结
@ObservedV2装饰器和@Trace装饰器为鸿蒙Next开发者提供了强大的类属性观测能力，但在使用过程中需注意其使用限制，根据不同场景合理运用，以实现高效的状态管理和UI响应。随着状态管理框架的不断发展，这两个装饰器将在鸿蒙Next应用开发中发挥更重要的作用。
