React Redux: 从文档看源码 - Connect工具类篇(2)

前端之家收集整理的这篇文章主要介绍了React Redux: 从文档看源码 - Connect工具类篇(2)前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

注:这篇文章只是讲解React Redux这一层,并不包含Redux部分。Redux有计划去学习,等以后学习了Redux源码以后再做分析
注:代码基于现在(2016.12.29)React Redux的最新版本(5.0.1)

Connect工具类篇(1)

Connect工具类篇(2)

verifySubselectors.js

这里有四个参数:

  1. mapStateToProps,mapDispatchToProps,mergeProps都是经过mapDispatchToProps,mapStateToProps,mergeProps封装过的

  2. displayName是option里面传入的
    主要做的是检查传入的mapStateToProps,mergeProps是否存在,由于这里的对象是经过几个map方法封装过的,所以不存在就说明开发传入的值是错误。同时检查是否有dependsOnOwnProps这个属性,如果没有给一个warning.

import warning from '../utils/warning'

function verify(selector,methodName,displayName) {
  if (!selector) {
    throw new Error(`Unexpected value for ${methodName} in ${displayName}.`)

  } else if (methodName === 'mapStateToProps' || methodName === 'mapDispatchToProps') { //只检查mapStateToProps和mapDispatchToProps,因为mergeProps方法不需要
    if (!selector.hasOwnProperty('dependsOnOwnProps')) {
      warning(
        `The selector for ${methodName} of ${displayName} did not specify a value for dependsOnOwnProps.`
      )
    }
  }
}

export default function verifySubselectors(mapStateToProps,mergeProps,displayName) {
  verify(mapStateToProps,'mapStateToProps',displayName)
  verify(mapDispatchToProps,'mapDispatchToProps',displayName)
  verify(mergeProps,'mergeProps',displayName)
}

selectorFactory.js

这里主要负责获取处理过的mapStateToProps,mergeProps和传入的options,来进行props的合并,最后返回合并后的结果。其中,当pure为true的时候,会对props进行存储,便于下一次比较,如果通过比较两个相同,那么就不改变props对象,减少不必要的re-render。

在connectAdvanced.js里面看到这么一段注释:

selectoryFactory方法返回的是一个function,这个function的作用是根据Redux Store state,props和dispatch计算新的props. 在connectAdvanced中会提供dispatch给selectorFactory,以便selectorFactory可以对actionCreator进行绑定。connectAdvanced获取的option配置会直接被传给selectorFactory,其中就包含了displayName和wrappedComponent(其实还有一些对比的方法在里面)。

selectorFactory负责记录所有的状态(props,store state,dispatch,mergedProps),以便在部分状态发生改变,而不影响组件渲染的时候,可以避免不必要的渲染。

finalPropsSelectorFactory

export default function finalPropsSelectorFactory(dispatch,{
  initMapStateToProps,initMapDispatchToProps,initMergeProps,...options
}) {
  const mapStateToProps = initMapStateToProps(dispatch,options)
  const mapDispatchToProps = initMapDispatchToProps(dispatch,options)
  const mergeProps = initMergeProps(dispatch,options)

  if (process.env.NODE_ENV !== 'production') {
    verifySubselectors(mapStateToProps,options.displayName)
  }

  const selectorFactory = options.pure
    ? pureFinalPropsSelectorFactory
    : impureFinalPropsSelectorFactory

  return selectorFactory(
    mapStateToProps,options
  )
}

这里只是给mapStateToProps,mergeProps传入dispatch和options对象,然后根据pure的值传给不同的方法进行处理。

如果pure是true,那么selectorFactory返回的selector会负责存储最后结果。如果结果没有发生改变,那么connectAdvanced的shouldComponentUpdate就会返回false。

如果pure是false,那么selector永远会返回一个新的对象,同时shouldComponentUpdate永远都返回true

这个factory方法会返回一个function,接收Redux Store和ownProps作为参数。作用是,每次store或ownProps发生改变以后,调用这个返回的function,获取更新后的最终props。

impureFinalPropsSelectorFactory

export function impureFinalPropsSelectorFactory(
  mapStateToProps,dispatch
) {
  return function impureFinalPropsSelector(state,ownProps) {
    return mergeProps(
      mapStateToProps(state,ownProps),mapDispatchToProps(dispatch,ownProps
    )
  }
}

根据pure等于false的情况,这里会永远返回一个新的对象。存粹的、不加任何判断的调用mergeProps对几个props的结构进行合并。

这里返回的值的格式是:(state,ownProps)=>final props

pureFinalPropsSelectorFactory

export function pureFinalPropsSelectorFactory(
  mapStateToProps,{ areStatesEqual,areOwnPropsEqual,areStatePropsEqual }
) {
  let hasRunAtLeastOnce = false // 是否是第一次调用,第一次调用不需要做是否改变的检查
  let state // 记忆上一次的state
  let ownProps // 记忆上一次的ownProps
  let stateProps // 记忆mapStateToProps返回的props
  let dispatchProps // 记忆mapDispatchToProps返回的props
  let mergedProps // 记忆最后合并后的结果

  // 第一次调用的时候,纯粹记住所有的结果
  function handleFirstCall(firstState,firstOwnProps) {
    state = firstState
    ownProps = firstOwnProps
    stateProps = mapStateToProps(state,ownProps)
    dispatchProps = mapDispatchToProps(dispatch,ownProps)
    mergedProps = mergeProps(stateProps,dispatchProps,ownProps)
    hasRunAtLeastOnce = true
    return mergedProps
  }

  // 当两个都发生改变。。。
  function handleNewPropsAndNewState() {
    stateProps = mapStateToProps(state,ownProps) // ownProps发生了改变,肯定需要调用获取新的props

    if (mapDispatchToProps.dependsOnOwnProps)
      dispatchProps = mapDispatchToProps(dispatch,ownProps)

    mergedProps = mergeProps(stateProps,ownProps)
    return mergedProps
  }

  // 如果只有父组件传入的props发生了改变,那么需要根据dependsOnOwnProps来进行更新
  function handleNewProps() {
    if (mapStateToProps.dependsOnOwnProps)
      stateProps = mapStateToProps(state,ownProps)

    if (mapDispatchToProps.dependsOnOwnProps)
      dispatchProps = mapDispatchToProps(dispatch,ownProps)

    // 由于ownProps发生了改变,所以不需要进行检查,直接调用mergeProps方法
    mergedProps = mergeProps(stateProps,ownProps)
    return mergedProps
  }

  // 如果只有Redux store state发生了改变,那么只用更新mapStateToProps的返回值,因为dispatchProps和Redux State无关
  function handleNewState() {
    const nextStateProps = mapStateToProps(state,ownProps)
    const statePropsChanged = !areStatePropsEqual(nextStateProps,stateProps)
    stateProps = nextStateProps
    
    if (statePropsChanged)
      mergedProps = mergeProps(stateProps,ownProps)

    return mergedProps
  }

  // 除第一次调用外,每次都需要对各种结果进行检查,然后记录必要的结果
  function handleSubsequentCalls(nextState,nextOwnProps) {
    const propsChanged = !areOwnPropsEqual(nextOwnProps,ownProps) // 检查ownProps是否发生改变
    const stateChanged = !areStatesEqual(nextState,state) // 检查Redux store state是否发生改变
    state = nextState
    ownProps = nextOwnProps

    // 根据改变的不同,调用不同的方法。减少不必要的运算
    if (propsChanged && stateChanged) return handleNewPropsAndNewState()
    if (propsChanged) return handleNewProps()
    if (stateChanged) return handleNewState()
    return mergedProps
  }

  return function pureFinalPropsSelector(nextState,nextOwnProps) {
    return hasRunAtLeastOnce
      ? handleSubsequentCalls(nextState,nextOwnProps)
      : handleFirstCall(nextState,nextOwnProps)
  }
}

当pure等于true的时候,需要做出各种检查来判定是否需要调用方法,来获取新的props.

  1. 当Redux state发生改变,ownProps没变的时候
    1) 由于mapDispatchToProps并没有基于Redux State,所以dispatchProps是需要进行更新的。2) 而mapStateToProps是基于Redux State的,所以需要调用mapStateToProps方法或许"新的"stateProps。由于State发生改变,并不一定会造成返回结果的改变,所以需要根据检查后的结果来判定是否调用mergeProps方法

  2. 当OwnProps发生改变,Redux State没有改变的时候
    1) 由于mapDispatchToProps和mapStateToProps都可能基于ownProps,所以需要根据dependsOnOwnProps属性来检查,判断是否需要调用方法进行更新。2) ownProps作为mergeProps的一个必要参数,所以不需要做任何判断,mergePorps必须被调用

  3. 当Redux Store,OwnProps都发生了改变
    综合之前的两点,mapStateToProps必须调用,mapDispatchToProps根据dependsOnOwnProps属性调用,mergeProps必须调用

一点总结:

  1. 在connect定义的时候,一般尽量使用pure:true的情况(默认值),因为在这种情况下,会对props进行差别检查。如果没有改变,就不会去调用connectAdvanced组件去更新。如果内部组件同时根据 父组件传入的propsRedux store的其他状态进行更新渲染,那么pure必须是false。

  2. option中的areStatesEqual(默认值为===),areOwnPropsEqual(默认值为shallowEqual),areStatePropsEqual(默认值为shallowEqual),areMergedPropsEqual(默认值为shallowEqual),可以根据需要来修改这几个参数,当pure为true的时候,检查更多不必要的re-render

猜你在找的React相关文章