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
来源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

猜你喜欢

转载自blog.csdn.net/hsany330/article/details/89457134