当前位置：首页 > news >正文

【HarmonyOS】深入理解@Observed装饰器和@ObjectLink装饰器：嵌套类对象属性变化

news 2025/7/1 7:26:58

【HarmonyOS】深入理解@Observed装饰器和@ObjectLink装饰器：嵌套类对象属性变化

前言

之前就Observed和ObjectLink写过一篇讲解博客【HarmonyOS】多层嵌套对象通过@ObjectLink和@Observed实现渲染更新处理！

其中就@Observe监听类的使用，@ObjectLink进行数据传递进行了讲解。但是其中有些细节没有展开讲，对使用可能会有误解，所以新增一篇详细讲述。

特性明确

对于@ObjectLink和@Observed，我们一般理解为对嵌套对象进行属性监听的一组状态管理标签。
该组标签的诞生是为了解决嵌套对象or数组套数组，数组套对象等等，这种类似数据结构的监听问题，以便于ArkUI框架监听，来实现数据变化，UI渲染。

但是我们使用时，需要明确其作用范围，这样就可以避免一些奇怪的bug。

使用@ObjectLink和@Observed只能监听嵌套后的一级对象属性以及基类属性，无法监听子级及其以下的对象属性。

该结论以我上一篇博客举例，可以点击跳转到该博客，将DEMO示例代码copy下来，边看讲解，边操作DEMO效果更容易理解。

在列表操作数据变化时，我们即操作了一级属性，也操作了二级和三级属性，进行了数值修改。

if判断包裹的select属性为@ObjuectLink直接监听的对象一级属性，如果我们操作了该属性数值变化，就会导致UI刷新。所以if语句块下方的index和content内容变化也能刷新到UI。

该效果可参见前三个Item，点击后就无效果。只有后三个点击后才会有UI刷新。
在这里插入图片描述
如此情况如何解决呢？其实嵌套深层次数据结构监听问题，已反馈给华为官方。他们还在开发中，目前V2接口已经可实现嵌套深层次的监听问题。

@ObservedV2装饰器和@Trace装饰器：类属性变化观测，但是新的状态管理标签，还未开发完成，目前不推荐使用，因为不是最终版，随时会变化。

目前该问题的解决方案是：

1.进行二次拆分，继续往下监听对象，这样就可以实现多层数据监听。

但是如果嵌套层数过多，每一层都这样拆分，太过去繁琐。所以我推荐第二种方式，即：

2.对监听层的属性对象，进行操作赋值，不对属性对象之下的属性进行单独赋值。

以我上一篇demo示例代码举例：
在这里插入图片描述
当然了，还有一种最简单的方式就是，每次你改变嵌套数据时，监听层有属性也会变化，那UI就会及时刷新。如我DEMO示例一样，正常情况下，我们的Select属性是一定会改变，那UI就会及时刷新。

DEMO示例

以下DEMO示例验证过程【使用@ObjectLink和@Observed只能监听嵌套后的一级对象属性以及基类属性，无法监听子级及其以下的对象属性】

在这里插入图片描述

import { ButtonModifier, TextModifier } from '@ohos.arkui.modifier';let NextID: number = 1;@Observed
class Bag {public id: number;public size: number;constructor(size: number) {this.id = NextID++;this.size = size;}
}@Observed
class BagCopy {public id: number;public size: number;constructor(size: number) {this.id = NextID++;this.size = size;}
}@Observed
class Cup {public id: number;public size: number;constructor(size: number) {this.id = NextID++;this.size = size;}
}@Observed
class User {public bag: Bag;constructor(bag: Bag) {this.bag = bag;}
}@Observed
class Book {public bookName: BookName;constructor(bookName: BookName) {this.bookName = bookName;}
}@Observed
class BookName extends BagCopy {public nameSize: number;public cup: Cup;constructor(nameSize: number) {// 调用父类方法对nameSize进行处理super(nameSize);this.nameSize = nameSize;this.cup = new Cup(nameSize);}
}@Component
struct ViewA {label: string = 'ViewA';@ObjectLink bag: Bag;private mTextCommonStyle = new TextCommonStyle();private mButtonCommonStyle = new ButtonCommonStyle();build() {Column() {Text(`ViewA`).attributeModifier(this.mTextCommonStyle)Text(`this.bag.size = ${this.bag.size}`).attributeModifier(this.mTextCommonStyle)Button(`click this.bag.size add 1`).attributeModifier(this.mButtonCommonStyle).onClick(() => {this.bag.size += 1;})}.backgroundColor(Color.Blue)}
}@Component
struct ViewC {label: string = 'ViewC1';@ObjectLink bookName: BookName;private mTextCommonStyle = new TextCommonStyle();private mButtonCommonStyle = new ButtonCommonStyle();build() {Row() {Column() {Text(`ViewC`).attributeModifier(this.mTextCommonStyle)Text(`this.bookName.cup.size = ${this.bookName.cup.size}`).attributeModifier(this.mTextCommonStyle)Button(`click this.bookName.cup.size add 1`).attributeModifier(this.mButtonCommonStyle).onClick(() => {// 当前监听对象的属性，如果是嵌套对象，则该嵌套对象的属性赋值，不会被框架监听到，UI不刷新this.bookName.cup.size += 1;console.log('this.bookName.size:' + this.bookName.size)})Divider().height(5)Text(`this.bookName.size = ${this.bookName.size}`).attributeModifier(this.mTextCommonStyle)Button(`click this.bookName.size add 1`).attributeModifier(this.mButtonCommonStyle).onClick(() => {// 当前监听对象的基类属性被修改，依旧可以被监听到，UI会刷新this.bookName.size += 1;console.log('this.bookName.size:' + this.bookName.size)})}.width(320).backgroundColor(Color.Red)}}
}class TextCommonStyle implements AttributeModifier<TextModifier> {applyNormalAttribute(instance: TextModifier): void {instance.fontColor('#ffffffff').backgroundColor('#ff3d9dba').width(320).height(50).borderRadius(25).margin(10).textAlign(TextAlign.Center)}
}class ButtonCommonStyle implements AttributeModifier<ButtonModifier> {applyNormalAttribute(instance: ButtonModifier): void {instance.width(320).backgroundColor('#ff17a98d').margin(10)}
}@Entry
@Component
@Preview
struct ViewB {@State user: User = new User(new Bag(0));@State child: Book = new Book(new BookName(0));build() {Scroll(){Column() {ViewA({ bag: this.user.bag }).width(320)ViewC({ bookName: this.child.bookName }).width(320)Button(`ViewB: this.child.bookName.size add 10`).width(320).backgroundColor('#ff17a98d').margin(10).onClick(() => {this.child.bookName.size += 10console.log('this.child.bookName.size:' + this.child.bookName.size)})Button(`ViewB: this.user.bag = new Bag(10)`).width(320).backgroundColor('#ff17a98d').margin(10).onClick(() => {this.user.bag = new Bag(10);})Button(`ViewB: this.user = new User(new Bag(20))`).width(320).backgroundColor('#ff17a98d').margin(10).onClick(() => {this.user = new User(new Bag(20));})}}}
}