一步一步分析Redux源码
前言
最近做项目遇到了一些复杂数据处理,侧面体会到一个良好的数据层设计对一个项目的稳定性和可维护性是多么的重要。于是想以源码分析的方式总结一下当前的数据管理方式,首选redux。 我们可以通过Redux 的官方文档来了解其设计思想。 cn.redux.js.org/.
本文保存在我的github上 欢迎fork or star github.com/yangfan0095…
Redux 源码入口 index.js
我们可以看到 Redux 对外导出了以下5个模块。分别对应5个js文件。
import createStore from './createStore'
import combineReducers from './combineReducers'
import bindActionCreators from './bindActionCreators'
import applyMiddleware from './applyMiddleware'
import compose from './compose'
...
export {
createStore,
combineReducers,
bindActionCreators,
applyMiddleware,
compose
}
复制代码
-
createStore 作用: 创建store
-
combineReducers 作用: 合并reducer
-
bindActionCreators 作用: 把一个 value 为不同 action creator 的对象,转成拥有同名 key 的对象
-
applyMiddleware 作用:通过自定义中间件拓展Redux 介绍
-
compose 作用: 从右到左来组合多个函数
其中最主要的文件就是 createStore 。
createStore
createStore
该方法的主要作用是创建一个带有初始化状态树的store。并且该状态树状态只能够通过 createStore
提供的dispatch
api 来触发reducer
修改。
源码如下:
import isPlainObject from 'lodash/isPlainObject'
import $$observable from 'symbol-observable'
export default function createStore(reducer, preloadedState, enhancer) {
if (typeof preloadedState === 'function' && typeof enhancer === 'undefined') {
enhancer = preloadedState
preloadedState = undefined
}
if (typeof enhancer !== 'undefined') {
if (typeof enhancer !== 'function') {
throw new Error('Expected the enhancer to be a function.')
}
return enhancer(createStore)(reducer, preloadedState)
}
if (typeof reducer !== 'function') {
throw new Error('Expected the reducer to be a function.')
}
...
return {
dispatch,
subscribe,
getState,
replaceReducer,
[$$observable]: observable
}
复制代码
方法有三个参数 reducer ,preloadedState ,enhancer。其中reducer是生成store时通过combineReducers合成以后返回的一个方法combination
这个方法 输入 state 和 action ,返回最新的状态树,用来更新state。 preloadedState 是初始化state数据 ,enhancer
是一个高阶函数用于拓展store的功能 , 如redux 自带的模块applyMiddleware
就是一个enhancer
函数。
看源码,首先js 函数传递的是形参。源码判断第二个参数的类型,如果是function 那么就说明传入的参数不是initState. 所以就把第二个参数替换成enhancer 。这样提高了我们的开发体验。
if (typeof preloadedState === 'function' && typeof enhancer === 'undefined') {
enhancer = preloadedState
preloadedState = undefined
}
复制代码
关于对于enhancer的操作,如果enhancer 存在 执行则下面这段语句。
if (typeof enhancer !== 'undefined') {
if (typeof enhancer !== 'function') {
throw new Error('Expected the enhancer to be a function.')
}
return enhancer(createStore)(reducer, preloadedState)
}
复制代码
我在网上找了一个例子来了解。 首先enhancer 是一个类似于下面结构的函数。 函数返回一个匿名函数。由于js是传值调用,所以这个enhancer 在 createStore 中执行的时候 已经变成了createStore => (reducer, initialState, enhancer) => { ... })
然后直接执行这个方法。
export default function autoLogger() {
return createStore => (reducer, initialState, enhancer) => {
const store = createStore(reducer, initialState, enhancer)
function dispatch(action) {
console.log(`dispatch an action: ${JSON.stringify(action)}`);
const result = store.dispatch(action);
const newState = store.getState();
console.log(`current state: ${JSON.stringify(newState)}`);
return result;
}
return {...store, dispatch}
}
}
复制代码
这里总结一下,通过这个enhancer我们可以改变dispatch 的行为。 其实这个例子是通过在enhancer 方法中定义新的dispatch覆盖store中的dispatch来使用户访问到我们通过enhancer新定义的dispatch。除此之外还可以看applyMiddleware
这个方法,这个我们后面再讲。
接下来我们看到这里,配置了一些变量 ,初始化时 将初始化数据preloadedState 赋值给currentState
。这些变量实际上是一个闭包,保存一些全局数据。
let currentReducer = reducer
let currentState = preloadedState
let currentListeners = []
let nextListeners = currentListeners
let isDispatching = false
...
复制代码
subscribe 方法
function subscribe(listener) {
if (typeof listener !== 'function') {
throw new Error('Expected listener to be a function.')
}
let isSubscribed = true
ensureCanMutateNextListeners()
nextListeners.push(listener)
return function unsubscribe() {
if (!isSubscribed) {
return
}
isSubscribed = false
ensureCanMutateNextListeners()
const index = nextListeners.indexOf(listener)
nextListeners.splice(index, 1)
}
}
复制代码
subscribe 方法实现的是一个订阅监听器,参数listener是一个回调函数,在每次执行dispatch后会被调用,如下面代码:
function dispatch(action){
for (let i = 0; i < listeners.length; i++) {
const listener = listeners[i]
listener()
}
...
复制代码
订阅函数返回一个解除订阅函数unsubscribe
,传入的监听函数listener首先会被放入当前订阅者回调函数列表nextListeners中 ,在action 触发 dispatch 时,首先combination 及 我们的当前传入的renducer会更新最新的状态树,然后listener被调用用于更新调用方的数据 在React 中 这个调用一般是用来更新当前组件state。React 中我们使用react-redux 来与redux做连接。想了解更多可以查看源码 github.com/reactjs/rea… 。
源码做了高度封装,这里找了一个大致的例子来观察react-redux 中高阶组件 Connect 如何订阅redux 以及更新组件状态。
static contextTypes = {
store: PropTypes.object
}
constructor () {
super()
this.state = { themeColor: '' }
}
// 组件挂载前添加订阅
componentWillMount () {
this._updateThemeColor()
store.subscribe(() => this._updateThemeColor())
}
_updateThemeColor () {
const { store } = this.context
const state = store.getState()
this.setState({ themeColor: state.themeColor })
}
复制代码
我们调用store.subscribe(() => this._updateThemeColor())
来订阅store () => this._updateThemeColor()
这个传入的回调就是 listener。当我们dispatch时 我们执行listener实际 上是在执行this.setState({ themeColor: state.themeColor })
从而更新当前组件的对应状态树的state。
订阅器在每次dispatch之前会将listener 保存到nextListeners 中,相当于是一份快照。如果当你正在执行listener函数时,如果此时又收到订阅或者接触订阅指令 ,后者不会立即生效 ,而是在下一次调用dispatch
会使用最新的订阅者列表即nextListeners
。 当调用dispatch时 将最新的订阅者快照nextListeners
赋给 currentListeners
。 这里有篇博客文章专门讨论了这个话题
const listeners = currentListeners = nextListeners
for (let i = 0; i < listeners.length; i++) {
const listener = listeners[i]
listener()
}
复制代码
ensureCanMutateNextListeners 函数
关于ensureCanMutateNextListeners
函数的作用,我看了很多资料,但是都没有找到很好的解释。大抵上的作用是某些场景可能会导重复的listener被添加,从而导致当前订阅者列表中存在两个相同的处理函数。ensureCanMutateNextListeners
的作用是为了规避这种现象发生。
function ensureCanMutateNextListeners() {
if (nextListeners === currentListeners) {
nextListeners = currentListeners.slice()
}
}
复制代码
当我们以如下方式追加订阅 ,执行dispatch时就会造成重复订阅。 具体的例子可以看这个链接: React Redux source function ensureCanMutateNextListeners?
const store = createStore(someReducer);
function doSubscribe() {
store.subscribe(doSubscribe);
}
doSubscribe();
复制代码
dispatch方法
我们来看dispatch函数,dispatch 用来分发一个action,触发reducer改变当前状态树然后执行listener 更新组件state。这里是内部的dispatch 方法, 传入的action 是朴素的action 对象。 包含一个state 和 type 属性。 如果需要action 支持更多功能可以使用enhancer增强。如支持promise ,可以使用 redux-promise 它的本质是一个中间件。 在其内部对action做处理,并最终传递一个朴素的action 对象到dispatch方法中。我们在下面介绍 applyMiddleware 中还会讨论这个话题。
function dispatch(action) {
if (!isPlainObject(action)) {
throw new Error(
'Actions must be plain objects. ' +
'Use custom middleware for async actions.'
)
}
if (typeof action.type === 'undefined') {
throw new Error(
'Actions may not have an undefined "type" property. ' +
'Have you misspelled a constant?'
)
}
if (isDispatching) {
throw new Error('Reducers may not dispatch actions.')
}
try {
isDispatching = true
currentState = currentReducer(currentState, action)
} finally {
isDispatching = false
}
const listeners = currentListeners = nextListeners
for (let i = 0; i < listeners.length; i++) {
const listener = listeners[i]
listener()
}
return action
}
复制代码
首先 dispatch 通过第三方引入的方法判断isPlainObject
先判断 action 类型是否合法 。然后将当前的state 和action 传入 currentReducer
函数中 ,currentReducer
处理得到最新的state 赋值给currentState。然后触发所有已更新的 listener 来更新state
try {
isDispatching = true
currentState = currentReducer(currentState, action)
} finally {
isDispatching = false
}
const listeners = currentListeners = nextListeners
for (let i = 0; i < listeners.length; i++) {
const listener = listeners[i]
listener()
}
复制代码
replaceReducer 方法
replaceReducer 方法用于动态更新当前currentReducer
。 通过对外暴露replaceReducer API, 外部可以直接调用这个方法来替换当前currentReducer
。然后执行dispatch({ type: ActionTypes.INIT })
其实相当于一个初始化的createStore操作。dispatch({ type: ActionTypes.INIT })
的作用是当store被创建时,一个初始化的action { type: ActionTypes.INIT }
被分发当前所有的reducer ,reducer返回它们的初始值,这样就生成了一个初始化的状态树。
function replaceReducer(nextReducer) {
if (typeof nextReducer !== 'function') {
throw new Error('Expected the nextReducer to be a function.')
}
currentReducer = nextReducer
dispatch({ type: ActionTypes.INIT })
}
复制代码
getState 方法
返回当前状态树
function getState() {
return currentState
}
复制代码
observable方法
observable 是通过私有属性被暴露出去的 ,只供内部使用。 该函数对外返回一个subscribe
方法,该方法可以用来观察最小单位的state 状态的改变。 这个方法的参数 observer 是一个具有next (类型为Function) 属性的对象。
如下源码所示: 函数首先将createStore 下的subscribe
方法赋值给outerSubscribe
,在起返回的方法中 首先定义函数observeState ,然后将其传入outeSubscribe
。实际上是封装了一个linster 引用subscribe
来做订阅。当消息被分发时,就出发了这个 linster ,然后next方法下调用observer.next(getState())
就获取到了当前的state
function observeState() {
if (observer.next) {
observer.next(getState())
}
}
observeState()
const unsubscribe = outerSubscribe(observeState)
复制代码
要获取更多关于observable 的信息可以查看github.com/tc39/propos…
function observable() {
const outerSubscribe = subscribe
return {
subscribe(observer) {
if (typeof observer !== 'object') {
thr[$$observable]: observableow new TypeError('Expected the observer to be an object.')
}
function observeState() {
if (observer.next) {
observer.next(getState())
}
}
//获取观察着的状态 并返回一个取消订阅的方法。
observeState()
const unsubscribe = outerSubscribe(observeState)
return { unsubscribe }
},
[$$observable]() {
return this
}
}
}
复制代码
createStore 到这里就讲完了,它是redux里面最核心的一个方法。里面提供了完整的观察订阅方法API 给第三方。
bindActionCreators
export default function bindActionCreators(actionCreators, dispatch) {
if (typeof actionCreators === 'function') {
return bindActionCreator(actionCreators, dispatch)
}
if (typeof actionCreators !== 'object' || actionCreators === null) {
throw new Error(
`bindActionCreators expected an object or a function, instead received ${actionCreators === null ? 'null' : typeof actionCreators}. ` +
`Did you write "import ActionCreators from" instead of "import * as ActionCreators from"?`
)
}
const keys = Object.keys(actionCreators)
const boundActionCreators = {}
for (let i = 0; i < keys.length; i++) {
const key = keys[i]
const actionCreator = actionCreators[key]
if (typeof actionCreator === 'function') {
boundActionCreators[key] = bindActionCreator(actionCreator, dispatch)
}
}
return boundActionCreators
}
function bindActionCreator(actionCreator, dispatch) {
return (...args) => dispatch(actionCreator(...args))
}
复制代码
我们可以重点来看 bindActionCreator
方法,这个方法很简单 直接传入一个原始action 对象 ,和 dispatch方法。返回一个分发action 的方法(...args) => dispatch(actionCreator(...args))
。 我们一个原始的action 对象如下
export function addTodo(text) {
return {
type: 'ADD_TODO',
text
}
}
复制代码
例如react 中我们获取到了更新的状态值 要手动通过dispatch 去执行对应的reducer (listener )函数来更新状态数state
dispatch(addTodo)
复制代码
这里相当于是直接将我们手动dispatch的方法封装起来。action 实际变成了 (...args) => dispatch(actionCreator(...args))
我们执行的时候 自动完成了dispatch操作。 bindActionCreators
方法对我们的 对应文件导出的action方法 进行遍历 分别执行bindActionCreator
最后返回一个更新后的action集合boundActionCreators
。
combineReducers
作用是将多个reducer 合并成一个reducer ,返回一个combination
方法。 combination
也就是createStore
操作传入的reducer 。这个方法接受一个state 一个action返回一个最新的状态数
例如我们在执行dispatch时会调用currentState = currentReducer(currentState, action)
这行代码来更新当前的状态树, 然后执行 订阅者回调函数listener 更新订阅者 (如react 组件)的state 。
export default function combineReducers(reducers) {
const reducerKeys = Object.keys(reducers)
// 校验合法性 然后获取当前所有 reducer 对象
const finalReducers = {}
for (let i = 0; i < reducerKeys.length; i++) {
const key = reducerKeys[i]
if (process.env.NODE_ENV !== 'production') {
if (typeof reducers[key] === 'undefined') {
warning(`No reducer provided for key "${key}"`)
}
}
if (typeof reducers[key] === 'function') {
finalReducers[key] = reducers[key]
}
}
const finalReducerKeys = Object.keys(finalReducers)
let unexpectedKeyCache
if (process.env.NODE_ENV !== 'production') {
unexpectedKeyCache = {}
}
// 调用 assertReducerShape 判断单个reducer函数合法性
let shapeAssertionError
try {
assertReducerShape(finalReducers)
} catch (e) {
shapeAssertionError = e
}
// 返回一个combination方法 这个方法传入state 和action 返回一个新的状态树
return function combination(state = {}, action) {
if (shapeAssertionError) {
throw shapeAssertionError
}
if (process.env.NODE_ENV !== 'production') {
const warningMessage = getUnexpectedStateShapeWarningMessage(state, finalReducers, action, unexpectedKeyCache)
if (warningMessage) {
warning(warningMessage)
}
}
let hasChanged = false
const nextState = {}
for (let i = 0; i < finalReducerKeys.length; i++) {
const key = finalReducerKeys[i]
const reducer = finalReducers[key]
const previousStateForKey = state[key]
const nextStateForKey = reducer(previousStateForKey, action)
if (typeof nextStateForKey === 'undefined') {
const errorMessage = getUndefinedStateErrorMessage(key, action)
throw new Error(errorMessage)
}
nextState[key] = nextStateForKey
hasChanged = hasChanged || nextStateForKey !== previousStateForKey
}
return hasChanged ? nextState : state
}
}
复制代码
compose函数 & applyMiddleware 函数
compose 源码如下:
export default function compose(...funcs) {
if (funcs.length === 0) {
return arg => arg
}
if (funcs.length === 1) {
return funcs[0]
}
return funcs.reduce((a, b) => (...args) => a(b(...args)))
}
复制代码
关键看着一行 funcs.reduce((a, b) => (...args) => a(b(...args)))
compose 函数的作用是从右到左去组合中间件函数。 我们看一下常用的中间件范例 redux-thunk
let logger = ({ dispatch, getState }) => next => action => {
console.log('next:之前state', getState())
let result = next(action)
console.log('next:之前state', getState())
return result
}
let thunk = ({ dispatch, getState }) => next => action => {
if (typeof action === 'function') {
return action(dispatch, getState)
}
return next(action)
}
复制代码
中间件的格式是输入dispatch, getState
输出 next
let middleware = ({ dispatch, getState }) => next => action => {
...//操作
return next(action)
}
复制代码
这里的compose函数输入一个包含多个中间件函数的数组,然后通过reduce 迭代成 middleware1(middleware2(middleware3(...args)))
这种形式。 这里由于js 传值调用 ,每个中间件在传入第二个中间件时 实际上已经被执行过一次。 所以第二个中间件传入的args 是第一个中间件return的 next方法。所以 compose返回的函数可以简化为 function returnComposeFunc = middleware(next)
,现在我们来看applyMiddleware
export default function applyMiddleware(...middlewares) {
return (createStore) => (reducer, preloadedState, enhancer) => {
const store = createStore(reducer, preloadedState, enhancer)
let dispatch = store.dispatch
let chain = []
const middlewareAPI = {
getState: store.getState,
dispatch: (action) => dispatch(action)
}
chain = middlewares.map(middleware => middleware(middlewareAPI))
dispatch = compose(...chain)(store.dispatch)
return {
...store,
dispatch
}
}
}
复制代码
这里的applyMiddleware 是一个enhancer 方法用来增强store的dispatch 功能,这里用来合并中间件。首先利用闭包给每个中间件传递它们需要的getState和dispatch。
const middlewareAPI = {
getState: store.getState,
dispatch: (action) => dispatch(action)
}
chain = middlewares.map(middleware => middleware(middlewareAPI))
复制代码
然后将所有中间件push 到一个数组chain中。 然后执行compose函数。执行compose函数compose(...chain)(store.dispatch)
compose返回一个returnComposeFunc
我们传入一个store.dispatch
,然后会返回一个 方法 。 而这个方法就是我们新的dispatch方法。
action => {
if (typeof action === 'function') {
return action(dispatch, getState)
}
return next(action)
}
复制代码
看到这里不得不说这里的代码只有寥寥几行 ,却是如此值得推敲,写得非常之精妙!
写到这里 redux的源码已经看完了,在react中需要我们手动添加订阅,我们使用react-redux 来为每个组件添加订阅。react-redux 里面要讲的也有很多,后面会写一篇专门分析。
最后欢迎拍砖
参考资料