• 如何使用MobX库进行状态管理
  • 发布于 2个月前
  • 368 热度
    0 评论
MobX 简介
MobX 是一个状态管理框架,它可以轻松地将应用的响应式数据和 UI 绑定起来。这个绑定是完全自动的,而且不会感觉到别扭。MobX 使得应用开发者只需要关注 UI 需要消费哪些响应式数据,而无需关注如何保持二者同步。

MobX 的实现并没有什么神奇之处,但是使用了一些技巧来包裹消费(observables)的对象,哪里需要这些对象(reactions),并且自动跟踪这些对象。一旦observables对象发生了改变,所有 reactions 会被重新运行。有趣的是,这些reactions可以是来自例如控制台日志、UI 所需的网络接口数据等任何对象。

注:MobX 原先是 JavaScript 的一个高效的状态管理库,Dart 版本页试图带来同样的效果。关于 JavaScript 版本,可以到 npm 上查看:JavaScript版本MobX。

核心元素
MobX 的核心要素有三个:、Observables 、Actions、和 Reactions,如下图所示。接下来以简单的 Counter 计数器应用来介绍各个元素的使用。

Observables
Observables 代表着应用的响应式状态,它们可以是简单对象到复杂的对象树。如果定义应用的状态为一棵 observables 树,那么可以向消费状态的 UI(或应用中的其他观察者)暴露一棵响应式的状态树(reactive-state-tree)。对于计数器应用,可以通过下面的方式定义:
import 'package:mobx/mobx.dart';
final counter = Observable(0);
对于复杂的observables,例如类,也是一样。
class Counter {
  Counter() {
    increment = Action(_increment);
  }

  final _value = Observable(0);
  int get value => _value.value;

  set value(int newValue) => _value.value = newValue;
  Action increment;

  void _increment() {
    _value.value++;
  }
}
这些代码看起来有点重复。因此可以使用MobX 代码生成器来简化编写(*.g.dart文件会由代码生成器自动生成)。使用代码生成器,需要在开发依赖中加入builder_runner 和 mobx_codegen 插件,并在代码目录下执行命令生成对应的*.g.dart 文件。
flutter packages pub run build_runner build
import 'package:mobx/mobx.dart';
part 'counter.g.dart';
class Counter = CounterBase with _$Counter;
abstract class CounterBase with Store {
  @observable
  int value = 0;

  @action
  void increment() {
    value++;
  }
}
需要注意的是,需要使用注解来标记类的哪些属性是 observable 属性。这些注解是在 MobX 的代码生成器中定义的。如果想减少代码量,可以将@observable注解换成@readonly注解。更换后,私有属性将只提供 get 方法,而不会提供set方法。并且这样状态的使用者也无法更改他们的值。

对于应用状态由核心状态和派生状态组成的情况,核心状态是指处理的业务领域固有的状态。例如,如果有个 Contact实体类,其中 firstName 和 lastName 组成了 Contact 的核心状态。然而,fullName 是一个派生状态,通过 firstName 和 lastName 组合得到。对于这种情况,依赖于核心状态或其他派生状态的称之为Computed Observables(有点类似 Vue 的计算属性)。这种属性也会在其依赖的状态对象改变时自动保持同步。这类派生的对象使用@computed 注解即可。
import 'package:mobx/mobx.dart';
part 'contact.g.dart';
class Contact = ContactBase with _$Contact;
abstract class ContactBase with Store {
  @observable
  String firstName;
  @observable
  String lastName;
  @computed
  String get fullName => '$firstName, $lastName';

}

Actions
Actions 定义了如何改变 observables对象。相比直接更改,actions 让更改操作更有语义学的意义(更易于理解和维护)。例如,相比如直接使用 value++,调用一个 increment()动作将携带更多意义。除此之外,actions 能够分批次处理通知,以确保改变只有在完成之后才会被通知。从而使得观察者是基于 action 的完成这一原子操作通知的。注意,actions 是可以嵌套的,这种情况下,只有 最顶层的 action完成后才会发出通知。
final counter = Observable(0);

final increment = Action((){
  counter.value++;
});
在类里面使用 actions 的时候,可以利用注解@action 来简化代码。
//...

abstract class CounterBase with Store {
  //...
  
  @action
  void increment() {
    value++;
  }
}
对于异步操作,MobX 会自动处理,而无需使用 runInAction 来包裹。
@observable
String stuff = '';

@observable
loading = false;

@action
Future<void> loadStuff() async {
  loading = true; //This notifies observers
  stuff = await fetchStuff();
  loading = false; //This also notifies observers
}

Reactions
Reactions是 Mobx 三元素的observables、actions和reactions的完结部分。Reactions是响应式系统中的观察者,一旦跟踪的 observable对象发生改变后就会被通知到。Reactions 有几种不同的方式。所有方式都会返回一个 ReactionDisposer 方法,调用该方法可以销毁该 reaction。Reactions 的一个典型特性是自动跟踪所有的observable对象,而无需显式地与其绑定。在 reaction 中读取observables时就已经自动跟踪该对象了。
Reactions方式一,autorun 方法
import 'package:mobx/mobx.dart';

String greeting = Observable('Hello World');

final dispose = autorun((_){
  print(greeting.value);
});

greeting.value = 'Hello MobX';
// 堆代码 duidaima.com
// Done with the autorun()
dispose();


// 打印结果:
// Hello World
// Hello MobX
Reactions 方式二,reaction方法:
ReactionDisposer reaction<T>(T Function(Reaction) predicate, void Function(T) effect)
在 predicate 方法中监测 observables 对象,然后当predicate返回不同的值时会执行 effect 方法。且只有 predicate 中的observables对象会被跟踪。
import 'package:mobx/mobx.dart';
String greeting = Observable('Hello World');
final dispose = reaction((_) => greeting.value, (msg) => print(msg));
greeting.value = 'Hello MobX'; // Cause a change
// Done with the reaction()
dispose();

// 打印结果:
// Hello MobX
Reactions 方式三,when 方法:
ReactionDisposer when(bool Function(Reaction) predicate, void Function() effect)
当predicate方法返回 true 时才执行 effect 方法。当 effect 方法运行后,将会自动销毁。因此可以当作是一次性的 reaction。当然也可以提前手动销毁该 reaction。
import 'package:mobx/mobx.dart';
String greeting = Observable('Hello World');
final dispose = when((_) => greeting.value == 'Hello MobX', () => print('Someone greeted MobX'));
greeting.value = 'Hello MobX'; // Causes a change, runs effect and disposes


// Prints:
// Someone greeted MobX
Reactions 方式四,Future 异步方法:
Future<void> asyncWhen(bool Function(Reaction) predicate)
和 when 方式类似,只是返回的结果是一个 Future 对象——在 predicate 方法返回 true 的时候完成。这对于等待 predicate 方法的返回值为 true 时很方便。
final completed = Observable(false);

void waitForCompletion() async {
  await asyncWhen(() => _completed.value == true);

  print('Completed');
}

Observer
对于 app 而言,UI 是使用最多的可视化 reactions 之一。Observer 组件(在 flutter_mobx 插件中定义),在它的 build方法中,为 observables 对象提供了一个颗粒度可控的观察者。当observables发生改变的时候,Observer 将重建并重新绘制。

总结
从官方的介绍可以看到,MobX 的使用方面还是挺简洁的,而且有了代码生成器加持后,状态管理部分的代码相对会容易编写很多。比如 Actions无需自己编写,状态属性也只需要加注解就行。对于无法生成的部分,其实可以使用 VSCode 的代码模板来完成,这样整个代码的编写效率就会很高了。
用户评论