theme: cyanosis
上一篇 《Flutter 组件集录 | InheritedModel 共享模型 》介绍了 InheritedModel 通过定义 Aspect(方面) 来更精细地控制依赖更新的粒度。本文看一下基于 InheritedModel 实现的 SharedAppData 组件,如何实现应用级数据的共享。
本组件案例已收录到 FlutterUnit:源码可详见 【 SharedAppData/node1.dart】
1.认识 SharedAppData 组件
SharedAppData 是新增的组件,其价值是提供键值对的映射关系,让子树节点可以访问数据。和 MediaQuery 、Theme、Navigator 组件类似,SharedAppData 组件也是内置在 WidgetsApp 状态类构建逻辑之中的。
也就是说,当使用 MaterialApp 时,组件树种会提供默认的 SharedAppData 组件,我们一般并不需要主动创建它:
2. 使用 SharedAppData 组件
还是拿这个例子说明共享 颜色 和 数值 的场景。SharedAppData 的使用包括:
- [1]. 如何访问读取数据。
- [2]. 如何更新设置数据。
SharedAppData 提供了 getValue 静态方法,可以让使用者通过上下文和键访问数据;如果键的值不存在,在回调中将返回初始值:
dart @override Widget build(BuildContext context) { final Color color = SharedAppData.getValue<String, Color>(context, 'color', () => Colors.black); final int counter = SharedAppData.getValue<String, int>(context, 'counter', () => 0); return Text( "Counter = $counter", style: TextStyle(color: color,fontWeight: FontWeight.bold), ); }
SharedAppData 提供了 setValue 静态方法,可以让使用者通过上下文和键设置数据。在设置值时,通过该键读取过值的 context,将会被通知更新 (无需 setState) 。
dart void _onSelectColor(Color value) { SharedAppData.setValue<String, Color?>(context, 'color', value); }
SharedAppData 的底层基于 InheritedModel 实现的,它将 key 视为方面,所以也具有精确控制粒度的能力。比如仅修改数字时,没有依赖数字 key 的 BoxDecorationWrap,其对应的元素将不会被通知更新。
``` ---->[修改颜色时]---- flutter: ======BoxDecorationWrap#didChangeDependencies========= flutter: ======CounterText#didChangeDependencies=========
---->[修改数字时]---- flutter: ======CounterText#didChangeDependencies========= ```
这就是 SharedAppData 所有的功能,它的目的很明确,就是:
向子树共享键值对数据,在更新数据时,通知所有依赖过 key 访问数据的 context 元素更新。
源码中对 SharedAppData 的介绍在表示: 它并不是替代 Provider 或任何其他状态管理系统的方案。一般会通过 SharedAppData 共享 package 内的,一个或几个可以惰性初始化的不可变数据对象。
4. SharedAppData 的源码实现
SharedAppData 是一个 StatefulWidget,其中定义了 setValue
和 getValue
两个静态方法;通过 _SharedAppDataState
状态类处理组件的构建任务。
_SharedAppDataState
中维护一个映射 data 对象,用于存储键值对,构建逻辑中返回 _SharedAppModel
组件:
```dart class _SharedAppDataState extends State { late Map
@override Widget build(BuildContext context) { return _SharedAppModel(sharedAppDataState: this, child: widget.child); }
V getValue (K key, SharedAppDataInitCallback init) { data[key] ??= init(); return data[key] as V; }
void setValue
(K key, V value) { if (data[key] != value) { setState(() { data = Map
_SharedAppModel
组件就是 InheritedModel 的派生类,负责存储数据,通过上下文向子树共享数据。在 updateShouldNotifyDependent
回调方法的处理中可以看出,数据的 key 被视为数据的 Aspect。只有依赖者使用到相关的 key, 当 key 对应数据发生变化时,才会通知该依赖者。
```dart class _SharedAppModel extends InheritedModel
final _SharedAppDataState sharedAppDataState; final Map
@override bool updateShouldNotify(_SharedAppModel old) { return data != old.data; }
@override bool updateShouldNotifyDependent(_SharedAppModel old, Set
这就是 SharedAppData 的所有源码内容,总的来看它的作用非常明确,向子树共享键值对数据。由于 MaterialApp 已经内置 SharedAppData,所以在应用中直接通过静态方法存取数据即可。那本文就到这里,谢谢观看 ~