• React:管理View
  • react-router:管理路由
  • Redux:管理Model
  • redux-saga:管理异步调用(副作用)

 

对dva的研究_数据

 

 

当然,也不是完全没有新东西,其中有一个Subscription好像之前没有见过,这是一种数据源订阅机制,数据源可以是键盘输入事件、路由变化、服务器的 websocket 连接等等。你可以在数据发生变化时收到通知,并派发必要的action。

实际上,dva是一个整合者,它的目标是解决“Code is everywhere”问题。当我们同时使用上面这些框架时,一般会呈现下面这种类型的文件结构:

+ src
+ sagas
- user.js
+ reducers
- user.js
+ actions
- user.js

另一方面,dva还试图隐藏一些经常重复书写的routine代码,让开发者能够更加专注于业务逻辑。比如我们写一个应用的入口文件,需要做下面这么多事情:

配置middleware
创建store
添加<Provider>绑定
创建watcher saga和root saga
启动saga
。。。
实际上,可能95%以上的项目中这些代码都是一模一样的,我们不需要每次都花费时间来重新写一遍这些代码。

下面开始正式介绍dva 1.0相关的内容,dva 2.0做了一些优化升级,后面专门有一节介绍具体变化。

8个概念
其实基本都是前面几篇文章里介绍过的概念:

state:也就是全局唯一的Store
action:即Redux中的action
model:这是dva抽象出来的一个概念,为了把下面这些东西放到一个统一的文件里
reducer:即Redux中的reducer
effect:即redux-saga中的worker saga
subscription:前面介绍过,用于订阅数据源
router:即react-router中的<Router>
route:即react-router中的<Route/>
最终写出来的model.js会类似下面这个样子,可以发现所有相关代码都放到一起了,不需要在多个文件之间来回切换了(这里的namespace就是以前Redux中的reducer的名字):

export default {
namespace: 'transactions',
state: {
txs: []
},
subscriptions: {
setup({ dispatch, history }) {
history.listen(location => {
if (location.pathname === '/transactions/list') {
dispatch({type: 'fetch'});
}
});
},
},
effects: {
*fetch({ payload }, {call, select, put}) {
const { result } = yield call(apis.fetchTxs)
yield put({type:'addTx', payload: result})
},
},
reducers: {
addTx(state, { payload }) {
return { ...state, txs: payload };
},
},
}

dva只有7个API,所以上手基本上没有什么难度:

app = dva(opts):创建dva对象
app.use(hooks):使用插件(后面介绍)
app.model(model):注册model
app.unmodel(namespace):取消model注册
app.replaceModel(model):替换model
app.router(({ history, app }) => RouterConfig):配置路由
app.start(selector?):启动应用(参数是根组件id)

4大模块
这个主要是从代码结构上来划分的,一般分为下面4类模块:

service:执行异步任务的API
model:包含effect, reducer, subscription
component:无状态组件
发送action触发状态更新
action = ‘namespace/effect’或者’namespace/reducer’
route:各种container(这个名字取得不太好)
通过connect()连接到model

另外,由于dva 1.0使用的是react-router v3,所以最外层还有一个router.js用于配置静态路由。所以一般的目录结构如下所示:

+ src/
+ services/
- users.js
+ models/
- users.js
+ components/
+ users/
- users.js
- users.css
+ routes/
- users.js
- router.js
可以发现,把route以及相关联的model都放到pages目录中了,可以达到减少耦合,一删全删的功能。

插件(Plugin)

前面提到过一个API可以注册“插件”,所谓插件就是一些生命周期“钩子(hooks)”,可以在事件发生时做一些额外处理。包括下面这些类型的钩子:

onError
onStateChange
onAction
onHmr:热替换(Hot Module Replacement)
onReducer:reducer被调用
onEffect:effect被调用
extraReducers:额外的reducer被调用(比如搭配合redux-form)
extraEnhancers:额外的store enhancer被调用(比如搭配redux-persist)

一个比较典型的例子是页面加载数据时转圈圈,加载完毕后隐藏,这是一个很多地方都需要用到的场景。官方提供了一个dva-loading插件,可以自动在异步请求数据时把loading设置为true,获得数据后把loading设置为false。这样你就可以在组件中绑定loading实现转圈圈的自动控制了:

import createLoading from 'dva-loading';
app.use(createLoading());

// components
function mapStateToProps(state) {
const { list, total, page } = state.users;
return {
loading: state.loading.models.users,
list,
total,
page,
};
}

和redux+saga的对应关系
虽然dva只是一层轻量级封装,但是做了一些特殊的命名约定,刚开始写代码的时候会有点迷糊,搞不清楚跟之前直接使用redux+saga的时候的对应关系,这里也帮大家梳理一下。

直接使用redux+saga的流程如下所示:

component发送请求action
saga调用service,然后put一个结果action
reducer从action中获取type和payload,修改state(可以使用combinedReducer,会依次遍历)
component在mapStateToProps()中通过state.<reducer名字>获取更新

使用dva时的流程如下所示:(触发effect为例)

component发送请求action,type约定为namespace/effect
effect调用service,然后put一个结果action,type约定为namespace/reducer(同一个model中可以省略namespace)
reducer从action中获取type和payload,修改state(每个reducer只处理一种类型的action,type约定为reducer的名字)
component在mapStateToProps()中通过state.<namespace>获取更新

dva2.0的变动
目前dva已经进化到2.0版本,除了采用了react-router v4以外,还有一些细节上的变动:

dispatch一个effect 类型的action时返回一个Promise,方便视图层回调

新增 dynamic 接口,配合 react-router@4 处理组件的按需加载

take 自动补全 namespace 前缀

effect 前后会额外触发 /@@start 和 /@@end 的 action,可利用此约定实现 put 的同步执行

同名 reducer 和 effect 不会 fallthrough(即两者都执行),而是仅执行 effect

对dva的研究_数据源_02