HarmonyOS 状态管理（一）

1. HarmonyOS 状态管理

1.1. 说明

  官方文档（https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-state-management-V5）

1.1.1. 状态管理（V1稳定版）

  状态管理（V1稳定版）提供了多种装饰器，用于在组件级别管理状态 。这些装饰器包括：
  @State：用于声明组件的状态变量，可以作为其子组件的单向和双向同步数据源 。
  @Prop：用于建立组件与父组件的单向数据同步关系 。
  @Link：用于建立组件与父组件的双向数据同步关系 。
  @Observed：用于观察多层嵌套的变化。
  @ObjectLink：用于观察嵌套的数据变化，并与父组件的数据源建立双向同步。
  @Provide和**@Consume**：用于跨组件层级同步状态变量 。
  @Watch：用于监听状态变量的变化 。
  这些装饰器主要用于在组件内部管理状态变量，并通过不同的同步方式（单向、双向）与父组件或其他组件进行数据交换。

1.1.2. 状态管理（V2试用版）

  状态管理（V2试用版）在V1版本的基础上进行了增强，主要特点包括：
（1）深度观察：状态变量独立于UI，更改数据会触发相应视图的更新。
（2）对象深度观测：支持对象的深度观测和深度监听。
（3）属性级更新：支持对象中属性级精准更新及数组中元素的最小化更新 。
（4）装饰器易用性高：装饰器间配合使用更灵活，有利于组件化 。
（5）状态管理（V2试用版）引入了一些新的装饰器，如：
  @ObservedV2：用于装饰class，使得被装饰的class具有深度监听的能力。
  @Trace：用于装饰被@ObservedV2装饰的class中的属性，使得属性具有深度观测的能力 。
  @ComponentV2：用于装饰struct，支持新的装饰器，如@Local、@Param、@Once、@Event、@Monitor、@Provider、@Consumer等 。

1.1.3. 关系总结

  虽然两者不能混合使用，但V2版本在V1版本的基础上进行了扩展和优化，为开发者提供了更强大的状态管理能力。
  状态管理（V1稳定版）和状态管理（V2试用版）在功能上有以下关系：

1.1.3.1. V1版本

（1）状态变量不能独立于UI，需要通过UI组件来同步更新 。
（2）支持多层嵌套的状态变化，但观测性能有限。
（3）提供了多种装饰器用于组件级别的状态管理和双向数据同步 。

1.1.3.2. V2版本

（1）状态变量独立于UI，支持深度观测和深度监听 。
（2）提供了更灵活的装饰器，支持对象级的精准更新和数组元素的最小化更新。
（3）增强了观测性能和装饰器的易用性，更有利于组件化开发。

1.2. 状态管理（V1稳定版）组件间数据共享

1.2.1. 共享方向：父到子

  @Prop 作用：@Prop从父组件接收数据，组件间数据共享。

@Entry
@Component
struct PropPage {
  //共享方向：父到子, @Prop只能用于子组件获取父组件的数据，无法同步
  @State num: number = 0
  build() {
    Column() {
      //第一个num为子组件中的变量名，第二个num为父组件中的变量名
      PropComponent({ num: this.num })
      Button("父组件+1").onClick(() => {
        this.num++
      })
    }.width("100%")
  }
}

@Component
struct PropComponent {
  //这里的变量名必须与父组件传值中冒号前的变量名一致
  @Prop num: number
  build() {
    Text("子组件："+this.num.toString())
      .margin({top:30,bottom:20})
  }
}

1.2.2. 共享方向：双向

  @Provide与@Consume 作用：@Provide作为数据的提供方，可以更新其子孙节点的数据；@Consume接收@Provide的数据

@Entry
@Component
struct ProvidePage {
  //@Provide配合@Consume可以同步父组件与子孙组件之间的数据，优点是不用传参
  @Provide count: number = 1

  build() {
    Column() {
      Text("父组件："+this.count )
      //调用子组件时不用传递数据
      ConsumeComponent()
    }
    .width('100%')
    .alignItems(HorizontalAlign.Center)
    .padding(30)
  }
}

//子组件
@Component
struct ConsumeComponent {
  //变量名要跟@Provide一样
  @Consume count: number
  build() {
    Column() {
      Text("子组件"+this.count.toString())
      //点击+1
      Text("子组件点击+1").onClick(() => {
        this.count++
      })
    }
  }
}

1.2.3. 共享方向：双向

  @Provide与@Consume 作用：@Provide作为数据的提供方，可以更新其子孙节点的数据；@Consume接收@Provide的数据

@Entry
@Component
struct LinkPage {
  //@Link 作用：将数据与父组件的数据共享
  // 共享方向：双向
  @State count: number = 1
  build() {
    Column() {
      Text("父组件中的count：" + this.count.toString())
      //第一个count为在子组件中的变量名，第二个count为在父组件中的变量名
      LinkComponent({ count: $count })
    }.width("100%")
  }
}
//子组件
@Component
struct LinkComponent {
  //变量名要跟父组件传值中冒号前的变量名一致
  @Link count: number

  build() {
    Column() {
      Text("子组件中的count：" +
      this.count.toString())
      //点击+1
      Text("子组件点击+1").onClick(() => {
        this.count++
      })
    }
  }
}

1.2.4. 共享方向：双向

  @Provide与@Consume 作用：@Provide作为数据的提供方，可以更新其子孙节点的数据；@Consume接收@Provide的数据

//@Observe用于类、对象、数组的声明
@Observed
class stu {
  public id: string
  name: string

  constructor(id: string, name: string) {
    this.id = id
    this.name = name
  }
}


@Entry
@Component
struct ObjectLinkPage {
  //@ObjectLink与@Observe
  // 作用：类、对象、数组类型数据的数据共享
  // 共享方向：双向
  @State me: stu = new stu("001", "张三")

  build() {
    Column() {
      Text("学号：" + this.me.id)
      Text("姓名：" +
      this.me.name)
      //第一个me为子组件中的变量名，第二个me为父组件中的变量名
      ObjectLinkComponent({ me: this.me })
    }.padding(20)
  }
}

@Component
struct ObjectLinkComponent {
  //变量名要与父组件传值中冒号前的变量名一致
  @ObjectLink me: stu

  build() {
    TextInput({ placeholder: "请输入学号" })
      .onChange((value) => {
        this.me.id = value
      })
  }
}

1.2.5. 总结

  @Prop只能用于子组件获取父组件的数据，无法同步
  @Link可以同步父子组件的数据
  @Provide配合@Consume可以同步父组件与子孙组件之间的数据，优点是不用传参，代码简单
  @ObjectLink配合@Observe可以同步父子组件的类、对象、数组类型的数据