Redux源码解读
前言
阅读对象:使用过redux,对redux实现原理不是很理解的开发者。
在我实习入职培训的时候,给我培训的老哥就跟我说过,redux的核心源码很简洁,建议我有空去看一下,提升对redux系列的理解。
入职一个多月了,已经参与了公司的不少项目,redux也使用了一段时间,对于redux的理解却一直没有深入,还停留在“知道怎么用,但是不知道其核心原理”的阶段。
所以就在github上拉了redux的源码,看了一会,发现东西确实不多,比较简洁。
redux本身的功能是什么
在项目中,我们往往不会纯粹的使用redux,而是会配合其他的一些工具库提升效率,比如
react-redux
,让react应用使用redux更容易,类似的也有wepy-redux
,提供给小程序框架wepy的工具库。
但是在本文中,我们讨论的范围就纯粹些,仅仅讨论redux本身。
redux本身有哪些作用?我们先来快速的过一下redux的核心思想(工作流程):
- 将状态统一放在一个state中,由store来管理这个state。
- 这个store按照reducer的“shape”(形状)创建。
- reducer的作用是接收到action后,输出一个新的状态,对应地更新store上的状态。
- 根据redux的原则指导,外部改变state的最佳方式是通过调用store的dispatch方法,触发一个action,这个action被对应的reducer处理,完成state更新。
- 可以通过subscribe在store上添加一个监听函数。每当调用dispatch方法时,会执行所有的监听函数。
- 可以添加中间件(中间件是干什么的我们后面讲)处理副作用。
在这个工作流程中,redux需要提供的功能是:
- 创建store,即:
createStore()
- 创建出来的store提供
subscribe
,dispatch
,getState
这些方法。 - 将多个reducer合并为一个reducer,即:
combineReducers()
- 应用中间件,即
applyMiddleware()
没错,就这么多功能,我们看下redux的源码目录:
确实也就这么多,至于compose
,bindActionCreators
,则是一些工具方法。
下面我们就逐个来看看createStore
、combineReducers
、applyMiddleware
、compose
的源码实现。
建议打开链接:redux源码地址,参照本文的解释阅读源码。
createStore的实现
这个函数的大致结构是这样:
function createStore(reducer, preloadedState, enhancer) {
if(enhancer是有效的){ // 这个我们后面会解释,可以先忽略
return enhancer(createStore)(reducer, preloadedState)
}
let currentReducer = reducer // 当前store中的reducer
let currentState = preloadedState // 当前store中存储的状态
let currentListeners = [] // 当前store中放置的监听函数
let nextListeners = currentListeners // 下一次dispatch时的监听函数
// 注意:当我们新添加一个监听函数时,只会在下一次dispatch的时候生效。
//...
// 获取state
function getState() {
//...
}
// 添加一个监听函数,每当dispatch被调用的时候都会执行这个监听函数
function subscribe() {
//...
}
// 触发了一个action,因此我们调用reducer,得到的新的state,并且执行所有添加到store中的监听函数。
function dispatch() {
//...
}
//...
//dispatch一个用于初始化的action,相当于调用一次reducer
//然后将reducer中的子reducer的初始值也获取到
//详见下面reducer的实现。
return {
dispatch,
subscribe,
getState,
//下面两个是主要面向库开发者的方法,暂时先忽略
//replaceReducer,
//observable
}
}
可以看出,createStore方法创建了一个store,但是并没有直接将这个store的状态state返回,而是返回了一系列方法,外部可以通过这些方法(getState)获取state,或者间接地(通过调用dispatch)改变state。
至于state呢,被存在了闭包中。(不理解闭包的同学可以先去了解一下先)
我们再来详细的看看每个模块是如何实现的(为了让逻辑更清晰,省略了错误处理的代码):
getState
function getState() {
return currentState
}
简单到发指。其实这很像面向对象编程中封装只读属性的方法,只提供数据的getter方法,而不直接提供setter。(虽然这里返回的是一个state的引用,你可以直接修改state,但是一般来说,redux不建议这样做。)
subscribe
function subscribe(listener) {
// 添加到监听函数数组,
// 注意:我们添加到了下一次dispatch时才会生效的数组
nextListeners.push(listener)
let isSubscribe = true //设置一个标志,标志该监听器已经订阅了
// 返回取消订阅的函数,即从数组中删除该监听函数
return function unsubscribe() {
if(!isSubscribe) {
return // 如果已经取消订阅过了,直接返回
}
isSubscribe = false
// 从下一轮的监听函数数组(用于下一次dispatch)中删除这个监听器。
const index = nextListeners.indexOf(listener)
nextListeners.splice(index, 1)
}
}
subscribe返回的是一个取消订阅的方法。取消订阅是非常必要的,当添加的监听器没用了之后,应该从store中清理掉。不然每次dispatch都会调用这个没用的监听器。
dispatch
function dispatch(action) {
//调用reducer,得到新state
currentState = currentReducer(currentState, action);
//更新监听数组
currentListener = nextListener;
//调用监听数组中的所有监听函数
for(let i = 0; i < currentListener.length; i++) {
const listener = currentListener[i];
listener();
}
}
createStore这个方法的基本功能我们已经实现了,但是调用createStore方法需要提供reducer,让我们来思考一下reducer的作用。
combineReducers
在理解combineReducers之前,我们先来想想reducer的功能:reducer接受一个旧的状态和一个action,当这个action被触发的时候,reducer处理后返回一个新状态。
也就是说 ,reducer负责状态的管理(或者说更新)。在实际使用中,我们应用的状态是可以分成很多个模块的,比如一个典型社交网站的状态可以分为:用户个人信息,好友列表,消息列表等模块。理论上,我们可以用一个reducer去处理所有状态的维护,但是这样做的话,我们一个reducer函数的逻辑就会太多,容易产生混乱。
因此我们可以将逻辑(reducer)也按照模块划分,每个模块再细分成各个子模块,开发完每个模块的逻辑后,再将reducer合并起来,这样我们的逻辑就能很清晰的组合起来。
对于我们的这种需求,redux提供了combineReducers方法,可以把子reducer合并成一个总的reducer。
来看看redux源码中combineReducers的主要逻辑:
function combineReducers(reducers) {
//先获取传入reducers对象的所有key
const reducerKeys = Object.keys(reducers)
const finalReducers = {} // 最后真正有效的reducer存在这里
//下面从reducers中筛选出有效的reducer
for(let i = 0; i < reducerKeys.length; i++){
const key = reducerKeys[i]
if(typeof reducers[key] === 'function') {
finalReducers[key] = reducers[key]
}
}
const finalReducerKeys = Object.keys(finalReducers);
//这里assertReducerShape函数做的事情是:
// 检查finalReducer中的reducer接受一个初始action或一个未知的action时,是否依旧能够返回有效的值。
let shapeAssertionError
try {
assertReducerShape(finalReducers)
} catch (e) {
shapeAssertionError = e
}
//返回合并后的reducer
return function combination(state= {}, action){
//这里的逻辑是:
//取得每个子reducer对应的state,与action一起作为参数给每个子reducer执行。
let hasChanged = false //标志state是否有变化
let nextState = {}
for(let i = 0; i < finalReducerKeys.length; i++) {
//得到本次循环的子reducer
const key = finalReducerKeys[i]
const reducer = finalReducers[key]
//得到该子reducer对应的旧状态
const previousStateForKey = state[key]
//调用子reducer得到新状态
const nextStateForKey = reducer(previousStateForKey, action)
//存到nextState中(总的状态)
nextState[key] = nextStateForKey
//到这里时有一个问题:
//就是如果子reducer不能处理该action,那么会返回previousStateForKey
//也就是旧状态,当所有状态都没改变时,我们直接返回之前的state就可以了。
hasChanged = hasChanged || previousStateForKey !== nextStateForKey
}
return hasChanged ? nextState : state
}
}
为什么需要中间件
在redux的设计思想中,reducer应该是一个纯函数
维基百科关于纯函数的定义:
在程序设计中,若一个函数符合以下要求,则它可能被认为是纯函数:
- 此函数在相同的输入值时,需产生相同的输出。函数的输出和输入值以外的其他隐藏信息或状态无关,也和由I/O设备产生的外部输出无关。
- 该函数不能有语义上可观察的函数副作用,诸如“触发事件”,使输出设备输出,或更改输出值以外物件的内容等。
纯函数的输出可以不用和所有的输入值有关,甚至可以和所有的输入值都无关。但纯函数的输出不能和输入值以外的任何资讯有关。纯函数可以传回多个输出值,但上述的原则需针对所有输出值都要成立。若引数是传引用调用,若有对参数物件的更改,就会影响函数以外物件的内容,因此就不是纯函数。
总结一下,纯函数的重点在于:
- 相同的输入产生相同的输出(不能在内部使用
Math.random
,Date.now
这些方法影响输出) - 输出不能和输入值以外的任何东西有关(不能调用API获得其他数据)
- 函数内部不能影响函数外部的任何东西(不能直接改变传入的引用变量),即不会突变
reducer为什么要求使用纯函数,文档里也有提到,总结下来有这几点:
-
state是根据reducer创建出来的,所以reducer是和state紧密相关的,对于state,我们有时候需要有一些需求(比如打印每一次更新前后的state,或者回到某一次更新前的state)这就对reducer有一些要求。
- 纯函数更易于调试
- 比如我们调试时希望action和对应的新旧state能够被打印出来,如果新state是在旧state上修改的,即使用同一个引用,那么就不能打印出新旧两种状态了。
- 如果函数的输出具有随机性,或者依赖外部的任何东西,都会让我们调试时很难定位问题。
- 如果不使用纯函数,那么在比较新旧状态对应的两个对象时,我们就不得不深比较了,深比较是非常浪费性能的。相反的,如果对于所有可能被修改的对象(比如reducer被调用了一次,传入的state就可能被改变),我们都新建一个对象并赋值,两个对象有不同的地址。那么浅比较就可以了。
至此,我们已经知道了,reducer是一个纯函数,那么如果我们在应用中确实需要处理一些副作用(比如异步处理,调用API等操作),那么该怎么办呢?这就是中间件解决的问题。下面我们就来讲讲redux中的中间件。
中间件处理副作用的机制
中间件在redux中位于什么位置,我们可以通过这两张图来看一下。
先来看看不用中间件时的redux工作流程:
- dispatch一个action(纯对象格式)
- 这个action被reducer处理
- reducer根据action更新store(中的state)
而用了中间件之后的工作流程是这样的:
- dispatch一个“action”(不一定是标准的action)
- 这个“action”先被中间件处理(比如在这里发送一个异步请求)
- 中间件处理结束后,再发送一个”action”(有可能是原来的action,也可能是不同的action因中间件功能不同而不同)
- 中间件发出的”action”可能继续被另一个中间件处理,进行类似3的步骤。即中间件可以链式串联。
- 最后一个中间件处理完后,dispatch一个符合reducer处理标准的action(纯对象action)
- 这个标准的action被reducer处理,
- reducer根据action更新store(中的state)
那么中间件该如何融合到redux中呢?
在上面的流程中,2-4的步骤是关于中间件的,但凡我们想要添加一个中间件,我们就需要写一套2-4的逻辑。
如果我们需要多个中间件,我们就需要考虑如何让他们串联起来。如果每次串联都写一份串联逻辑的话,就不够灵活,万一需要增删改或调整中间件的顺序,都需要修改中间件串联的逻辑。
所以redux提供了一种解决方案,将中间件的串联操作进行了封装,经过封装后,上面的步骤2-5就可以成为一个整体,如下图:
我们只需要改造store自带的dispatch方法。action发生后,先给中间件处理,最后再dispatch一个action交给reducer去改变状态。
在redux中使用中间件
还记得redux 的createStore()
方法的第三个参数enhancer
吗:
function createStore(reducer, preloadedState, enhancer) {
if(enhancer是有效的){
return enhancer(createStore)(reducer, preloadedState)
}
//...
}
在这里,我们可以看到,enhancer(可以叫做强化器)是一个函数,这个函数接受一个「普通createStore函数」作为参数,返回一个「加强后的createStore函数」。
这个加强的过程中做的事情,其实就是改造dispatch,添加上中间件。
redux提供的applyMiddleware()
方法返回的就是一个enhancer。
applyMiddleware,顾名思义,「应用中间件」。输入为若干中间件,输出为enhancer。下面来看看它的源码:
function applyMiddleware(...middlewares) {
// 返回一个函数A,函数A的参数是一个createStore函数。
// 函数A的返回值是函数B,其实也就是一个加强后的createStore函数,大括号内的是函数B的函数体
return createStore => (...args) => {
//用参数传进来的createStore创建一个store
const store = createStore(...args)
//注意,我们在这里需要改造的只是store的dispatch方法
let dispatch = () => { //一个临时的dispatch
//作用是在dispatch改造完成前调用dispatch只会打印错误信息
throw new Error(`一些错误信息`)
}
//接下来我们准备将每个中间件与我们的state关联起来(通过传入getState方法),得到改造函数。
const middlewareAPI = {
getState: store.getState,
dispatch: (...args) => dispatch(...args)
}
//middlewares是一个中间件函数数组,中间件函数的返回值是一个改造dispatch的函数
//调用数组中的每个中间件函数,得到所有的改造函数
const chain = middlewares.map(middleware => middleware(middlewareAPI))
//将这些改造函数compose(翻译:构成,整理成)成一个函数
//用compose后的函数去改造store的dispatch
dispatch = compose(...chain)(store.dispatch)
// compose方法的作用是,例如这样调用:
// compose(func1,func2,func3)
// 返回一个函数: (...args) => func1( func2( func3(...args) ) )
// 即传入的dispatch被func3改造后得到一个新的dispatch,新的dispatch继续被func2改造...
// 返回store,用改造后的dispatch方法替换store中的dispatch
return {
...store,
dispatch
}
}
}
总结一下,applyMiddleware的工作方式是:
- 调用(若干个)中间件函数,获取(若干个)改造函数
- 把所有改造函数compose成一个改造函数
- 改造dispatch方法
中间件的工作方式是:
- 中间件是一个函数,不妨叫做中间件函数
- 中间件函数的输入是store的
getState
和dispatch
,输出为改造函数(改造dispatch
的函数) - 改造函数输入是一个
dispatch
,输出「改造后的dispatch
」
源码中用到了一个很有用的方法:compose()
,将多个函数组合成一个函数。理解这个函数对理解中间件很有帮助,我们来看看它的源码:
function compose(...funcs) {
// 当未传入函数时,返回一个函数:arg => arg
if(funcs.length === 0) {
return arg => arg
}
// 当只传入一个函数时,直接返回这个函数
if(funcs.length === 1) {
return funcs[0]
}
// 返回组合后的函数
return funcs.reduce((a, b) => (...args) => a(b(...args)))
//reduce是js的Array对象的内置方法
//array.reduce(callback)的作用是:给array中每一个元素应用callback函数
//callback函数:
/*
*@参数{accumulator}:callback上一次调用的返回值
*@参数{value}:当前数组元素
*@参数{index}:可选,当前元素的索引
*@参数{array}:可选,当前数组
*
*callback( accumulator, value, [index], [array])
*/
}
画一张图来理解compose的作用:
在applyMiddleware方法中,我们传入的「参数」是原始的dispatch方法,返回的「结果」是改造后的dispatch方法。通过compose,我们可以让多个改造函数抽象成一个改造函数。
中间件的实现
作者注:本来只想讲redux,但是讲着讲着却发现:理解中间件,是理解redux的中间件机制的前提。
下面我们以redux-thunk为例,看看一个中间件是如何实现的。
redux-thunk的功能
你可能没用过redux-thunk,所以在阅读这段代码前,我先简要的讲一下redux-thunk的作用:
正常的dispatch函数的参数action应该是一个纯对象。像这样:
store.dispatch({
type:'REQUEST_SOME_THING',
payload: {
from:'bob',
}
})
使用了thunk之后,我们可以dispatch一个函数:
function logStateInOneSecond(name) {
return (dispatch, getState, name) => { // 这个函数会在合适的时候dispatch一个真正的action
setTimeout({
console.log(getState())
dispatch({
type:'LOG_OK',
payload: {
name,
}
})
}, 1000)
}
}
store.dispatch(logStateInOneSecond('jay')) //dispatch的参数是一个函数
为什么需要这个功能?或者说「dispatch一个函数」能解决什么问题?
从上面的例子中你会发现,如果dispatch一个函数,我们可以在这个函数内做任何我们想要的操作(异步处理,调用接口等等),不受任何限制,为什么?
因为我们「还没有dispatch一个真正的action」,所以不会调用reducer,我们并没有将副作用放在reducer中,而是在使用reducer之前就处理了副作用。
如果你还不明白redux-thunk的功能,可以去它的github仓库查看更详细的解释。
redux-thunk的实现
如何实现redux-thunk中间件呢?
首先中间件肯定是改造dispatch方法,改造后的dispatch应该具有这样的功能:
- 如果传入的参数是函数,就执行这个函数。
- 否则,就认为传入的是一个标准的action,就调用「改造前的dispatch」方法,dispatch这个action。
现在我们来看看redux-thunk的源码(8行有效代码):
function createThunkMiddleware(extraArgument) {
return ({ dispatch, getState }) => next => action => {
if (typeof action === 'function') {
return action(dispatch, getState, extraArgument);
}
return next(action);
};
}
如果三个箭头函数让你有点头晕,我来帮你展开一下:
//createThunkMiddleware的作用是返回thunk中间件(middleware)
function createThunkMiddleware(extraArgument) {
return function({ dispatch, getState }) { // 这是「中间件函数」
return function(next) { // 这是中间件函数创建的「改造函数」
return function(action) { // 这是改造函数改造后的「dispatch方法」
if (typeof action === 'function') {
return action(dispatch, getState, extraArgument);
}
return next(action);
}
}
}
}
再加点注释?
function createThunkMiddleware(extraArgument) {
return function({ dispatch, getState }) { // 这是「中间件函数」
//参数是store中的dispatch和getState方法
return function(next) { // 这是中间件函数创建的「改造函数」
//参数next是被当前中间件改造前的dispatch
//因为在被当前中间件改造之前,可能已经被其他中间件改造过了,所以不妨叫next
return function(action) { // 这是改造函数「改造后的dispatch方法」
if (typeof action === 'function') {
//如果action是一个函数,就调用这个函数,并传入参数给函数使用
return action(dispatch, getState, extraArgument);
}
//否则调用用改造前的dispatch方法
return next(action);
}
}
}
}
讲完了。可以看出redux-thunk严格遵循了redux中间件的思想:在原始的dispatch方法触发reducer处理之前,处理副作用。
总结
至此,redux的核心源码已经讲完了,最后不得不感叹,redux写的真的美,真tm的简洁。
一句话总结redux的核心功能:「创建一个store来管理state」
关于中间件,我会尝试着写一篇《如何自己实现一个redux中间件》,更深入的理解redux中间件的意义。
关于store如何与其他框架(如react)共同工作,我会再写一篇《react-redux
源码解读》的博客探究探究这个问题。
敬请期待。
第一次更新(2018-09-12)
- 添加了对
compose()
的源码解释 - 修正了错误的描述”改变state的唯一方式是触发dispatch”;补充了关于
unSubscribe
的解释 - 添加了中间件的实现原理,以
redux-thunk
为例