redux常用的几个函数

1. createStore(reducer, [initState, enhancer])

• 作用：创建一个Redux store来存放应用中所有的state，一个应用只能有个store。函数返回store对象。
• 参数：
  • reducer(Function)：两个参数：state和action，返回一个state。 不要对参数state进行修改，需要返回一个新的对象。
  • initStatate：初始state。如果不为空，需要和reducer中处理的state结构一致
  • enhancer：一个中间件，如logger等。
    例如：

import { createStore, applyMiddleware, compose } from 'redux'
import thunk from 'redux-thunk'
import createLogger from 'redux-logger'
import api from '../middleware/api'
import rootReducer from '../reducers'
import DevTools from '../containers/DevTools'

export default function configureStore(preloadedState) {
  const store = createStore(
    rootReducer,
    preloadedState,
    compose(
      applyMiddleware(thunk, api, createLogger()),
      DevTools.instrument()
    )
  )
  return store
}

2. Store

Store是用来维持应用所有state树的一个对象。改变state的唯一方法是store dispatch一个action。
Store不是类，而只是一个有几个方法的对象，可以采用createStore进行创建。

• getState()
  返回应用当前的 state 树。它与 store 的最后一个 reducer 返回值相同。
• dispatch(action)
  分发action，这是改变state的唯一方法。
• subscribe(listener)
  添加一个变化监听器，每当 dispatch action 的时候就会执行，state 树中的一部分可能已经变化。你可以在回调函数里调用 getState() 来拿到当前 state。函数返回一个解绑的函数。可以参考counter-vanilla
• replaceReducer(nextReducer)
  替换Reducer，用处较少。

// 渲染和订阅渲染
function render() {
      valueEl.innerHTML = store.getState().toString()
}
store.subscribe(render)

3. combineReducers(reducers)

combineReducers辅助函数的作用是，把一个由多个不同 reducer 函数作为 value 的 object，合并成一个最终的 reducer 函数，然后就可以对这个 reducer 调用 createStore。
多个子reducer函数合并后，相当于整体函数会为state特定字段进行映射产生特定的reducer函数。 如页面中的例子；todos和counter只会处理对应字段过来的action。

4. applyMiddleware(...middlewares)

输入一个middlewares数组，返回一个函数，函数以createStore为参数：

export default function applyMiddleware(...middlewares) {
  return (createStore) => (reducer, preloadedState, enhancer) => {
    var store = createStore(reducer, preloadedState, enhancer)
    var dispatch = store.dispatch
    var chain = []

    var middlewareAPI = {
      getState: store.getState,
      dispatch: (action) => dispatch(action)
    }
    chain = middlewares.map(middleware => middleware(middlewareAPI))
    dispatch = compose(...chain)(store.dispatch)

    return {
      ...store,
      dispatch
    }
  }
}

使用示例：

import { createStore, applyMiddleware } from 'redux'
import todos from './reducers'

function logger({ getState }) {
  return (next) => (action) => {
    console.log('will dispatch', action)

    // 调用 middleware 链中下一个 middleware 的 dispatch。
    let returnValue = next(action)

    console.log('state after dispatch', getState())

    // 一般会是 action 本身，除非
    // 后面的 middleware 修改了它。
    return returnValue
  }
}

let createStoreWithMiddleware = applyMiddleware(logger)(createStore)
let store = createStoreWithMiddleware(todos, [ 'Use Redux' ])

每个 middleware 接受 Store
的 dispatch
和 getState
函数作为命名参数，并返回一个函数。该函数会被传入 被称为 next 的下一个 middleware 的 dispatch 方法，并返回一个接收 action 的新函数，这个函数可以直接调用next(action)，或者在其他需要的时刻调用，甚至根本不去调用它。调用链中最后一个 middleware 会接受真实的 store 的 dispatch
方法作为 next 参数，并借此结束调用链。所以，middleware 的函数签名是 ({ getState, dispatch }) => next => action。

5. bindActionCreators(actionCreators,dispatch)

经过bindActionCreators处理的actions，直接调用函数就相当于进行了dispatch，因而实现了不调用dispatch即可触发state的改变。
使用场景： 当你需要把 action creator 往下传到一个组件上，却不想让这个组件觉察到 Redux 的存在，而且不希望把 Redux store 或 dispatch
传给它。

// app.js
import { selectReddit } from '../actions'
  ...
class App extends Component {
  render() {
    const { selectedReddit, posts, isFetching, lastUpdated, dispatch } = this.props
    let boundActionCreators = bindActionCreators({selectReddit}, dispatch);

    return (
      <div>
        <Picker value={selectedReddit}
                onChange={this.handleChange}
                {...boundActionCreators}
                options={[ 'reactjs', 'frontend' ]} />
       </div>
    )
  }
}
export default connect(mapStateToProps)(App)

// picker.js
export default class Picker extends Component {
  render() {
    const { value, onChange, options, selectReddit } = this.props
    console.log(this.props)

    return (
      <span>
        <h1>{value}</h1>
        <select onChange={e => selectReddit(e.target.value)}
                value={value}>
          {options.map(option =>
            <option value={option} key={option}>
              {option}
            </option>)
          }
        </select>
      </span>
    )
  }
}

可以参考文章。

6. compose(...functions)

从右到左来组合多个函数。
这是函数式编程中的方法，为了方便，被放到了 Redux 里。 当需要把多个 store 增强器 依次执行的时候，需要用到它。compose(funcA, funcB, funcC) 形象为 compose(funcA(funcB(funcC())))
参考文章：文章

7. <Provider store>和connect([mapStateToProps], [mapDispatchToProps],[mergeProps], [options])

<Provider store>使组件层级中的 connect()方法都能够获得 Redux store。正常情况下，你的根组件应该嵌套在 <Provider>中才能使用 connect()方法。

ReactDOM.render(
  <Provider store={store}>
    <MyRootComponent />
  </Provider>,
  rootEl
);

connect： 连接 React 组件与 Redux store。

// mapStateToProps: 哪些 Redux 全局的 state 是我们组件想要通过 props 获取的？
function mapStateToProps(state) {
  return {
    todos: state.todos
  }
}

 // mapDispatchToProps: 哪些 action 创建函数是我们想要通过 props 获取的？
function mapDispatchToProps(dispatch) {
  return {
    actions: bindActionCreators(TodoActions, dispatch)
  }
}

  mergeProps和options： 再议

 

小礼物走一走，来简书关注我

作者：狐尼克朱迪
链接：https://www.jianshu.com/p/a8e8e49c82e7
来源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。