共计 11037 个字符,预计需要花费 28 分钟才能阅读完成。
前言
文章原文地址:Nealyang/PersonalBlog
可能作为一个前端,在学习 Flutter 的过程中,总感觉非常非常相似 React Native,甚至于,其中还是有 state 的概念 setState,所以在 Flutter 中,也当然会存在非常多的解决方案,比如 redux、RxDart 还有 Scoped Model 等解决方案。今天,我们主要介绍下常用的两种 State 管理解决方案:redux、scoped model。
Scoped Model
介绍
Scoped Model 是 package 上 Dart 的一个第三方库 scoped_model。Scoped Model 主要是通过数据 model 的概念来实现数据传递,表现上类似于 react 中 context 的概念。它提供了让子代 widget 轻松获取父级数据 model 的功能。
从官网中的介绍可以了解到,它直接来自于 Google 正在开发的新系统 Fuchsia 核心 Widgets 中对 Model 类的简单提取,作为独立使用的独立 Flutter 插件发布。
在直接上手之前,我们先着重说一下 Scoped Model 中几个重要的概念
Model 类,通过继承 Model 类来创建自己的数据 model,例如 SearchModel 或者 UserModel,并且还可以监听 数据 model 的变化
ScopedModelDescendant widget , 如果你需要传递数据 model 到很深层级里面的 widget,那么你就需要用 ScopedModel 来包裹 Model,这样的话,后面所有的子 widget 都可以使用该数据 model 了(是不是更有一种 context 的感觉)
ScopedModelDescendant widget,使用此 widget 可以在 widget tree 中找到相应的 Scope 的 Model,当 数据 model 发生变化的时候,该 widget 会重新构建
当然,在 Scoped Model 的文档中,也介绍了一些 实现原理
Model 类实现了 Listenable 接口
AnimationController 和 TextEditingController 也是 Listenables
使用 InheritedWidget 将数据 model 传递到 Widget 树。重建 InheritedWidget 时,它将手动重建依赖于其数据的所有 Widgets。无需管理订阅!
它使用 AnimatedBuilder Widget 来监听 Model 并在模型更改时重建 InheritedWidget
实操 Demo
demo 地址
从 gif 上可以看到咱们的需求非常的简单,就是在当前页面更新了 count 后,在第二个页面也能够传递过去。当然,new ResultPage(count:count) 就没意思啦~ 咱不讨论哈
新建数据 model
lib/model/counter_model.dart
import ‘package:scoped_model/scoped_model.dart’;
class CounterModel extends Model{
int _counter = 0;
int get counter => _counter;
void increment(){
_counter++;
// 通知所有的 listener
notifyListeners();
}
}
这一步非常的简单,新建一个类去继承 Model
里面定义了一个 get 方法,以便于后面取数据 model
定义了 increment 方法,去改变我们的数据 model,调用 package 中的 通知方法 notifyListeners
lib/main.dart
import ‘package:flutter/material.dart’;
import ‘./model/counter_model.dart’;
import ‘package:scoped_model/scoped_model.dart’;
import ‘./count_page.dart’;
void main() {
runApp(MyApp(
model: CounterModel(),
));
}
class MyApp extends StatelessWidget {
final CounterModel model;
const MyApp({Key key,@required this.model}):super(key:key);
@override
Widget build(BuildContext context) {
return ScopedModel(
model: model,
child: MaterialApp(
title: ‘Scoped Model Demo’,
home:CountPage(),
),
);
}
}
这是 app 的入口文件,划重点
MyApp 类 中,我们传入一个定义好的数据 model,方便后面传递给子类
将 MaterialApp 用 ScopedModel 包裹一下,作用上面已经介绍了,方便子类可以拿到,类似于 redux 中 Provider 包裹一下
一定需要将数据 model 传递给 ScopedModel 的 model 属性中
lib/count_page.dart
class CountPage extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text(‘Scoped Model’),
actions: <Widget>[
IconButton(
tooltip: ‘to result’,
icon: Icon(Icons.home),
onPressed: (){
Navigator.push(context,MaterialPageRoute(builder: (context)=>ResultPage()));
},
)
],
),
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
Text(‘ 你都点击 ’),
ScopedModelDescendant<CounterModel>(
builder: (context, child, model) {
return Text(
‘${model.counter.toString()} 次了 ’,
style: TextStyle(
color: Colors.red,
fontSize: 33.0,
),
);
},
)
],
),
),
floatingActionButton: ScopedModelDescendant<CounterModel>(
builder: (context,child,model){
return FloatingActionButton(
onPressed: model.increment,
tooltip: ‘add’,
child: Icon(Icons.add),
);
},
),
);
}
}
常规布局和 widget 这里不再重复介绍,我们说下主角:Scoped Model
简单一句,哪里需要用数据 model,哪里就需要用 ScopedModelDescendant
ScopedModelDescendant 中的 build 方法需要返回一个 widget,在这个 widget 中我们可以使用数据 model 中的方法、数据等
最后在 lib/result_page.dart 中就可以看到我们数据 model 中的 count 值了,注意这里跳转页面,我们并没有通过参数传递的形式传递 Navigator.push(context,MaterialPageRoute(builder: (context)=>ResultPage()));
完整项目代码:flutter_scoped_model
flutter_redux
相信作为一个前端对于 redux 一定不会陌生,而 Flutter 中也同样存在 state 的概念,其实说白了,UI 只是数据(state)的另一种展现形式。study-redux 是笔者之前学习 redux 时候的一些笔记和心得。这里为了防止有新人不太清楚 redux,我们再来介绍下 redux 的一些基本概念
state
state 我们可以理解为前端 UI 的状态(数据)库,它存储着这个应用所有需要的数据。
action
既然这些 state 已经有了,那么我们是如何实现管理这些 state 中的数据的呢,当然,这里就要说到 action 了。什么是 action?E:action:动作。是的,就是这么简单。。。
只有当某一个动作发生的时候才能够触发这个 state 去改变,那么,触发 state 变化的原因那么多,比如这里的我们的点击事件,还有网络请求,页面进入,鼠标移入。。。所以 action 的出现,就是为了把这些操作所产生或者改变的数据从应用传到 store 中的有效载荷。需要说明的是,action 是 state 的唯一信号来源。
reducer
reducer 决定了 state 的最终格式。reducer 是一个纯函数,也就是说,只要传入参数相同,返回计算得到的下一个 state 就一定相同。没有特殊情况、没有副作用,没有 API 请求、没有变量修改,单纯执行计算。reducer 对传入的 action 进行判断,然后返回一个通过判断后的 state,这就是 reducer 的全部职责。从代码可以简单地看出:
import {INCREMENT_COUNTER,DECREMENT_COUNTER} from ‘../actions’;
export default function counter(state = 0,action) {
switch (action.type){
case INCREMENT_COUNTER:
return state+1;
case DECREMENT_COUNTER:
return state-1;
default:
return state;
}
}
对于一个比较大一点的应用来说,我们是需要将 reducer 拆分的,最后通过 redux 提供的 combineReducers 方法组合到一起。比如:
const rootReducer = combineReducers({
counter
});
export default rootReducer;
这里你要明白:每个 reducer 只负责管理全局 state 中它负责的一部分。每个 reducer 的 state 参数都不同,分别对应它管理的那部分 state 数据。combineReducers() 所做的只是生成一个函数,这个函数来调用你的一系列 reducer,每个 reducer 根据它们的 key 来筛选出 state 中的一部分数据并处理,然后这个生成的函数再将所有 reducer 的结果合并成一个大的对象。
store
store 是对之前说到一个联系和管理。具有如下职责
维持应用的 state;
提供 getState() 方法获取 state
提供 dispatch(action) 方法更新 state;
通过 subscribe(listener) 注册监听器;
通过 subscribe(listener) 返回的函数注销监听器。
再次强调一下 Redux 应用只有一个单一的 store。当需要拆分数据处理逻辑时,你应该使用 reducer 组合 而不是创建多个 store。store 的创建通过 redux 的 createStore 方法创建,这个方法还需要传入 reducer,很容易理解:毕竟我需要 dispatch 一个 action 来改变 state 嘛。应用一般会有一个初始化的 state,所以可选为第二个参数,这个参数通常是有服务端提供的,传说中的 Universal 渲染。后面会说。。。第三个参数一般是需要使用的中间件,通过 applyMiddleware 传入。
说了这么多,action,store,action creator,reducer 关系就是这么如下的简单明了:
结合 flutter_redux
一些工具集让你轻松地使用 redux 来轻松构建 Flutter widget,版本要求是 redux.dart 3.0.0+
Redux Widgets
StoreProvider:基础组件,它将给定的 Redux Store 传递给所欲请求它的的子代组件
StoreBuilder:一个子代组件,它从 StoreProvider 获取 Store 并将其传递给 widget 的 builder 方法中
StoreConnector:获取 Store 的一个子代组件
StoreProvider ancestor,使用给定的 converter 函数将 Store 转换为 ViewModel,并将 ViewModel 传递给 builder。只要 Store 发出更改事件(action),Widget 就会自动重建。无需管理订阅!
注意
Dart 2 需要更严格的类型!
1、确认你正使用的是 redux 3.0.0+2、在你的组件树中,将 new StoreProvider(…) 改为 new StoreProvider<StateClass>(…)3、如果需要从 StoreProvider<AppState> 中直接获取 Store<AppState>,则需要将 new StoreProvider.of(context) 改为 StoreProvider.of<StateClass> . 不需要直接访问 Store 中的字段,因为 Dart2 可以使用静态函数推断出正确的类型
实操演练
官方 demo 的代码先大概解释一下
import ‘package:flutter/material.dart’;
import ‘package:flutter_redux/flutter_redux.dart’;
import ‘package:redux/redux.dart’;
// 定义一个 action: Increment
enum Actions {Increment}
// 定义一个 reducer,响应传进来的 action
int counterReducer(int state, dynamic action) {
if (action == Actions.Increment) {
return state + 1;
}
return state;
}
void main() {
// 在 基础 widget 中创建一个 store,用 final 关键字修饰 这比直接在 build 方法中创建要好很多
final store = new Store<int>(counterReducer, initialState: 0);
runApp(new FlutterReduxApp(
title: ‘Flutter Redux Demo’,
store: store,
));
}
class FlutterReduxApp extends StatelessWidget {
final Store<int> store;
final String title;
FlutterReduxApp({Key key, this.store, this.title}) : super(key: key);
@override
Widget build(BuildContext context) {
// 用 StoreProvider 来包裹你的 MaterialApp 或者别的 widget,这样能够确保下面所有的 widget 能够获取到 store 中的数据
return new StoreProvider<int>(
// 将 store 传递给 StoreProvider
// Widgets 将使用 store 变量来使用它
store: store,
child: new MaterialApp(
theme: new ThemeData.dark(),
title: title,
home: new Scaffold(
appBar: new AppBar(
title: new Text(title),
),
body: new Center(
child: new Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
new Text(
‘You have pushed the button this many times:’,
),
// 通过 StoreConnector 将 store 和 Text 连接起来,以便于 Text 直接 render
// store 中的值。类似于 react-redux 中的 connect
//
// 将 Text widget 包裹在 StoreConnector 中,
// `StoreConnector` 将会在最近的一个祖先元素中找到 StoreProvider
// 拿到对应的值,然后传递给 build 函数
//
// 每次点击按钮的时候,将会 dispatch 一个 action 并且被 reducer 所接受。
// 等 reducer 处理得出最新结果后,widget 将会自动重建
new StoreConnector<int, String>(
converter: (store) => store.state.toString(),
builder: (context, count) {
return new Text(
count,
style: Theme.of(context).textTheme.display1,
);
},
)
],
),
),
// 同样使用 StoreConnector 来连接 Store 和 FloatingActionButton
// 在这个 demo 中,我们使用 store 去构建一个包含 dispatch、Increment
// action 的回调函数
//
// 将这个回调函数丢给 onPressed
floatingActionButton: new StoreConnector<int, VoidCallback>(
converter: (store) {
return () => store.dispatch(Actions.Increment);
},
builder: (context, callback) {
return new FloatingActionButton(
onPressed: callback,
tooltip: ‘Increment’,
child: new Icon(Icons.add),
);
},
),
),
),
);
}
}
上面的例子比较简单,鉴于小册 Flutter 入门实战:从 0 到 1 仿写 web 版掘金 App 下面有哥们在登陆那块评论了 Flutter 状态管理,
这里我简单使用 redux 模拟了一个登陆的 demo
lib/reducer/reducers.dart
首先我们定义 action 需要的一些 action type
enum Actions{
Login,
LoginSuccess,
LogoutSuccess
}
然后定义相应的类来管理登陆状态
class AuthState{
bool isLogin; // 是否登录
String account; // 用户名
AuthState({this.isLogin:false,this.account});
@override
String toString() {
return “{account:$account,isLogin:$isLogin}”;
}
}
然后我们需要定义一些 action,定义个基类,然后定义登陆成功的 action
class Action{
final Actions type;
Action({this.type});
}
class LoginSuccessAction extends Action{
final String account;
LoginSuccessAction({
this.account
}):super(type:Actions.LoginSuccess);
}
最后定义 AppState 以及我们自定义的一个中间件。
// 应用程序状态
class AppState {
AuthState auth; // 登录
MainPageState main; // 主页
AppState({this.main, this.auth});
@override
String toString() {
return “{auth:$auth,main:$main}”;
}
}
AppState mainReducer(AppState state, dynamic action) {
if (Actions.LogoutSuccess == action) {
state.auth.isLogin = false;
state.auth.account = null;
}
if (action is LoginSuccessAction) {
state.auth.isLogin = true;
state.auth.account = action.account;
}
print(“state changed:$state”);
return state;
}
loggingMiddleware(Store<AppState> store, action, NextDispatcher next) {
print(‘${new DateTime.now()}: $action’);
next(action);
}
在稍微大一点的项目中,其实就是 reducer、state 和 action 的组织会比较麻烦,当然,罗马也不是一日建成的,庞大的 state 也是一点一点累计起来的。
下面就是在入口文件中使用 redux 的代码了,跟基础 demo 没有差异。
import ‘package:flutter/material.dart’;
import ‘package:flutter_redux/flutter_redux.dart’;
import ‘package:redux/redux.dart’;
import ‘dart:async’ as Async;
import ‘./reducer/reducers.dart’;
import ‘./login_page.dart’;
void main() {
Store<AppState> store = Store<AppState>(mainReducer,
initialState: AppState(
main: MainPageState(),
auth: AuthState(),
),
middleware: [loggingMiddleware]);
runApp(new MyApp(
store: store,
));
}
class MyApp extends StatelessWidget {
final Store<AppState> store;
MyApp({Key key, this.store}) : super(key: key);
@override
Widget build(BuildContext context) {
return new StoreProvider(store: store, child: new MaterialApp(
title: ‘Flutter Demo’,
theme: new ThemeData(
primarySwatch: Colors.blue,
),
home: new StoreConnector<AppState,AppState>(builder: (BuildContext context,AppState state){
print(“isLogin:${state.auth.isLogin}”);
return new MyHomePage(title: ‘Flutter Demo Home Page’,
counter:state.main.counter,
isLogin: state.auth.isLogin,
account:state.auth.account);
}, converter: (Store<AppState> store){
return store.state;
}) ,
routes: {
“login”:(BuildContext context)=>new StoreConnector(builder: ( BuildContext context,Store<AppState> store){
return new LoginPage(callLogin: (String account,String pwd) async{
print(“ 正在登录,账号 $account, 密码:$pwd”);
// 为了模拟实际登录,这里等待一秒
await new Async.Future.delayed(new Duration(milliseconds: 1000));
if(pwd != “123456”){
throw (“ 登录失败,密码必须是 123456”);
}
print(“ 登录成功!”);
store.dispatch(new LoginSuccessAction(account: account));
},);
}, converter: (Store<AppState> store){
return store;
}),
},
));
}
}
class MyHomePage extends StatelessWidget {
MyHomePage({Key key, this.title, this.counter, this.isLogin, this.account})
: super(key: key);
final String title;
final int counter;
final bool isLogin;
final String account;
@override
Widget build(BuildContext context) {
print(“build:$isLogin”);
Widget loginPane;
if (isLogin) {
loginPane = new StoreConnector(
key: new ValueKey(“login”),
builder: (BuildContext context, VoidCallback logout) {
return new RaisedButton(
onPressed: logout, child: new Text(“ 您好:$account, 点击退出 ”),);
}, converter: (Store<AppState> store) {
return () =>
store.dispatch(
Actions.LogoutSuccess
);
});
} else {
loginPane = new RaisedButton(onPressed: () {
Navigator.of(context).pushNamed(“login”);
}, child: new Text(“ 登录 ”),);
}
return new Scaffold(
appBar: new AppBar(
title: new Text(title),
),
body: new Center(
child: new Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
/// 有登录,展示你好:xxx, 没登录,展示登录按钮
loginPane
],
),
),
);
}
}
完整项目代码:Nealyang/Flutter
最后
更多学习 Flutter 的小伙伴,欢迎入 QQ 群 Flutter Go :679476515
关于 Flutter 组件以及更多的学习,敬请关注我们正在开发的:alibaba/flutter-go
参考
flutter_architecture_samplesflutter_reduxflutter examplescoped_model