在正式介绍 Redux 为什么我们需要状态管理。如果你已经对此十分清楚,那么建议直接跳过这一节。
如果我们的应用足够简单,Flutter 作为一个声明式框架,你或许只需要将 数据 映射成 视图 就可以了。你可能并不需要状态管理,就像下面这样。
Flutter状态管理之Redux - 图1
但是随着功能的增加,你的应用程序将会有几十个甚至上百个状态。这个时候你的应用应该会是这样。
Flutter状态管理之Redux - 图2
这又是什么鬼。我们很难再清楚的测试维护我们的状态,因为它看上去实在是太复杂了!而且还会有多个页面共享同一个状态,例如当你进入一个文章点赞,退出到外部缩略展示的时候,外部也需要显示点赞数,这时候就需要同步这两个状态。
Flutter 实际上在一开始就为我们提供了一种状态管理方式,那就是 StatefulWidget。但是我们很快发现,它正是造成上述原因的罪魁祸首。
State 属于某一个特定的 Widget,在多个 Widget 之间进行交流的时候,虽然你可以使用 callback 解决,但是当嵌套足够深的话,我们增加非常多可怕的垃圾代码。
这时候,我们便迫切的需要一个架构来帮助我们理清这些关系,状态管理框架应运而生。

添加 redux/flutter_redux

首先在yaml中添加

  1. redux: ^4.0.0+3
  2. flutter_redux: ^0.6.0

最新版本版本请参考:pub.flutter-io.cn/flutter_redux / redux

然后运行

  1. flutter pub get

获取到最新的包到本地,在需要的文件夹内导入

  1. import 'package:flutter_redux/flutter_redux.dart';
  2. import 'package:redux/redux.dart';

例子

我们还用点击按钮新增数字的例子

首先需要在需要显示的的部件外部用StoreProvider包裹,比如这样:

  1. @override
  2. Widget build(BuildContext context) {
  3. _build += 'p1 build \n';
  4. return StoreProvider(
  5. store: store,
  6. child: Scaffold(
  7. appBar: AppBar(
  8. title: Text('ScopedModel'),
  9. ),
  10. body: Center(
  11. child: Column(
  12. mainAxisAlignment: MainAxisAlignment.center,
  13. children: <Widget>[
  14. Text(_build),
  15. StoreConnector<int, String>(
  16. converter: (store) => store.state.toString(),
  17. builder: (context, count) {
  18. _build += 's1';
  19. return Text('$count');
  20. },
  21. ),
  22. StoreConnector<int, VoidCallback>(
  23. converter: (store) {
  24. return () => store.dispatch(Actions.Increment);
  25. },
  26. builder: (context, callback) {
  27. return OutlineButton(
  28. child: Text('+'),
  29. onPressed: callback,
  30. );
  31. },
  32. ),
  33. StoreConnector<int, VoidCallback>(
  34. converter: (store) {
  35. return () => store.dispatch(Actions.Decrement);
  36. },
  37. builder: (context, callback) {
  38. return OutlineButton(
  39. child: Text('-'),
  40. onPressed: callback,
  41. );
  42. },
  43. ),
  44. Row(
  45. mainAxisAlignment: MainAxisAlignment.center,
  46. children: <Widget>[
  47. OutlineButton(
  48. child: Icon(Icons.refresh),
  49. onPressed: () {
  50. if (mounted) setState(() {});
  51. },
  52. ),
  53. OutlineButton(
  54. child: Icon(Icons.clear),
  55. onPressed: () {
  56. if (mounted)
  57. setState(() {
  58. _build = '';
  59. });
  60. },
  61. ),
  62. ],
  63. )
  64. ],
  65. ),
  66. )),
  67. );
  68. }

然后定义一下点击事件处理函数,这里使用enum来区分不同的事件,默认是不处理。

  1. enum Actions { Increment, Decrement }
  2. int counterReducer(int state, dynamic action) {
  3. if (action == Actions.Increment) {
  4. return state + 1;
  5. } else if (action == Actions.Decrement) {
  6. return state - 1;
  7. }
  8. return state;
  9. }

store是一个对象需要在使用前定义好

  1. final store = Store(counterReducer, initialState: 0);

显示的时候这样子

  1. StoreConnector<int, String>(
  2. converter: (store) => store.state.toString(),
  3. builder: (context, count) {
  4. _build += 's1';
  5. return Text('$count');
  6. },
  7. )

当然一个页面可以多个显示的数据可以使用store<Model>来显示不同的数据的。我们显示两个数据,当数据刷新则分别刷新,互相不影响。

Model定义如下:

  1. class _Model {
  2. int value, count;
  3. _Model({this.value, this.count}) {
  4. value ??= 0;
  5. count ??= 0;
  6. }
  7. }

操作的action和函数定义如下:

  1. _Model counterReducer(_Model state, dynamic action) {
  2. if (action == Actions.IncrementValue) {
  3. state.value += 1;
  4. return state;
  5. } else if (action == Actions.DecrementCount) {
  6. state.count -= 1;
  7. return state;
  8. } else if (action == Actions.IncrementCount) {
  9. state.count += 1;
  10. } else if (action == Actions.DecrementValue) {
  11. state.value -= 1;
  12. }
  13. return state;
  14. }
  15. enum Actions { IncrementValue, IncrementCount, DecrementCount, DecrementValue }

效果如下:

Flutter状态管理之Redux - 图3

在这里p1表示整个页面刷新一下,s1表示value刷新一次,s2表示刷新一次。
完整代码查看

其实这里写法已经是页面局部刷新了,性能也是达到了高水准。

原理

首先需要构建我们存储数据的model

model是存储在Store中,当我们点击按钮,点击事件会发送事件到Store.reducer中,我们在自己写的接受事件的函数中判断是哪个操作,分别来执行响应的操作。看下Store的构造函数:

  1. Store(
  2. this.reducer, {
  3. State initialState,
  4. List<Middleware<State>> middleware = const [],
  5. bool syncStream = false,
  6. bool distinct = false,
  7. }) : _changeController = StreamController.broadcast(sync: syncStream) {
  8. _state = initialState;
  9. _dispatchers = _createDispatchers(
  10. middleware,
  11. _createReduceAndNotify(distinct),
  12. );
  13. }

initialStatemodel初始化的状态是我们传入Store<T>T类型。
reducer类型是State Function(State state, dynamic action)action是回调类型,任意类型,为方便使用建议使用枚举。
middleware包含了一个数组,里边类型是Middleware<State>,用于传递事件的,传递顺序是从数组的开始到结束。

我们添加一个Middleware,看下例子:

  1. mw(Store<_Model> store, action, NextDispatcher next) {
  2. print('1:${new DateTime.now()}: $action');
  3. next(action);
  4. }
  5. mw2(Store<_Model> store, action, NextDispatcher next) {
  6. print('2:${new DateTime.now()}: $action');
  7. next(action);
  8. }

初始化的时候这样子写

  1. store = Store(counterReducer, initialState: _Model(), middleware: [
  2. mw,
  3. mw2,
  4. ]);

绑定数据到UI

首先我们使用StoreConnector<S,T>或者StoreBuilder<T>来显示内容。

  1. StoreConnector<_Model, String>(
  2. converter: (store) => store.state.value.toString(),
  3. builder: (context, count) {
  4. return Text('value:$count');
  5. },
  6. ),

那么消息是如何发送到builder中刷新UI呢?

StoreBuilder<T>是封装的StoreConnector<S,T>StoreConnector<S,T>是封装的_StoreStreamListener,那么我们来看下_StoreStreamListener的实现。

  1. const _StoreStreamListener({
  2. Key key,
  3. @required this.builder,/// 构造函数
  4. @required this.store,/// store
  5. @required this.converter,///转换函数
  6. this.distinct = false,
  7. this.onInit,/// init监听
  8. this.onDispose,/// 销毁监听
  9. this.rebuildOnChange = true,/// 默认当数据改变则进行重绘UI
  10. this.ignoreChange,///忽略改变
  11. this.onWillChange,/// 将要改变
  12. this.onDidChange,/// 已经改变
  13. this.onInitialBuild,/// 第一帧回调
  14. })

_StoreStreamListener是继承的StatefulWidget所以可以监听各种函数。
didUpdateWidget函数中根据latestValue = widget.converter(widget.store);来判断是否刷新当前UI.当参数rebuildOnChangetrue,返回一个StreamBuilder,为false返回一个widget.builder(context,lastValue),当lastValue变化而其他条件符合时,则发送streamStreamBuilder刷新UI.

关键代码:

  1. @override
  2. Widget build(BuildContext context) {
  3. return widget.rebuildOnChange
  4. ? StreamBuilder<ViewModel>(
  5. stream: stream,
  6. builder: (context, snapshot) => widget.builder(
  7. context,
  8. latestValue,
  9. ),
  10. )
  11. : widget.builder(context, latestValue);
  12. }

Redux 如何实现多个函数依次调用

再点击事件中调用了state.dispatch(action),其实在创建dispatchers已经将各个数组添加到了dispatchers数组中,在调用的的时候[A,B,C]顺序是A->B->C,

  1. dynamic dispatch(dynamic action) {
  2. return _dispatchers[0](action);
  3. }

在最开始的时候已经将广播_createReduceAndNotify插入到了dispatch中,每次dispatch(ac)则会调用_changeController.add(state),再调用_StoreStreamListenerState初始化中的init中的_createStream(),再此函数前者的_changeController已被监听,最终执行_handleChange->sink.add(vm)来触发_StoreStreamListenerState->StreamBuilder<ViewModel>(),关键代码:

  1. /// 创建 发送新的state的 stream
  2. NextDispatcher _createReduceAndNotify(bool distinct) {
  3. return (dynamic action) {
  4. final state = reducer(_state, action);
  5. if (distinct && state == _state) return;
  6. _state = state;
  7. _changeController.add(state);
  8. };
  9. }
  10. /// 创建用来通知刷新UI的stream
  11. void _createStream() {
  12. stream = widget.store.onChange
  13. .where(_ignoreChange)
  14. .map(_mapConverter)
  15. .where(_whereDistinct)
  16. .transform(StreamTransformer.fromHandlers(handleData: _handleChange));
  17. }
  18. /// 最终转换stream的函数
  19. void _handleChange(ViewModel vm, EventSink<ViewModel> sink) {
  20. if (widget.onWillChange != null) {
  21. widget.onWillChange(latestValue, vm);
  22. }
  23. latestValue = vm;
  24. if (widget.onDidChange != null) {
  25. WidgetsBinding.instance.addPostFrameCallback((_) {
  26. widget.onDidChange(latestValue);
  27. });
  28. }
  29. /// 发送新的值给StreamBuilder
  30. sink.add(vm);
  31. }

看到这里大概已经了解清楚redux的原理了,那么再看下下面的架构图更会清楚。

流程图如下:

Flutter状态管理之Redux - 图4
最终架构图如下:

Flutter状态管理之Redux - 图5

参考