http://www.ruanyifeng.com/blog/2016/09/redux_tutorial_part_one_basic_usages.html

名称解释—Store [stɔ:(r)] 仓库

Store 就是保存数据的地方,你可以把它看成一个容器。整个应用只能有一个 Store。
Redux 提供createStore这个函数,用来生成 Store。

名称解释—State [steɪt] 状态

对象包含所有数据。如果想得到某个时点的数据,就要对 Store 生成快照。这种时点的数据集合,就叫做 State。 当前时刻的 State,可以通过store.getState()拿到

名称解释—Action [ˈækʃən] 活动

State 的变化,会导致 View 的变化。但是,用户接触不到 State,只能接触到 View。所以,State 的变化必须是 View 导致的。Action 就是 View 发出的通知,表示 State 应该要发生变化了。 Action 是一个对象。其中的type属性是必须的,表示 Action 的名称。其他属性可以自由设置,社区有一个规范可以参考。

  1. const action = {
  2. type: 'ADD_TODO',
  3. payload: 'Learn Redux'
  4. };
  5. // 表示一个ADD_TODO类型的action,他的传入值是Learn Redux

View 要发送多少种消息,就会有多少种 Action。如果都手写,会很麻烦。可以定义一个函数来生成 Action,这个函数就叫 Action Creator。

名称解释—Reducer[rɪ’dju:sə] 状态处理机

Store 收到 Action 以后,必须给出一个新的 State,这样 View 才会发生变化。这种 State 的计算过程就叫做 Reducer。 Reducer 是一个函数,它接受 Action 和当前 State 作为参数,返回一个新的 State

  1. const createStore = window.Redux.createStore;
  2. const combineReducers = window.Redux.combineReducers;
  3. const defaultState = 0;
  4. const reducer = (state = defaultState, action) => {
  5. switch (action.type) {
  6. case 'ADD':
  7. return state + action.payload;
  8. default:
  9. return state;
  10. }
  11. };
  12. const store = createStore(reducer);
  13. const state = store.getState();
  14. console.log(state);
  15. const actions = [
  16. { type: 'ADD', payload: 0 },
  17. { type: 'ADD', payload: 1 },
  18. { type: 'ADD', payload: 2 }
  19. ];
  20. const total = actions.reduce(reducer, 0); // 数组累加器 3

Reducer 函数最重要的特征是,它是一个纯函数。也就是说,只要是同样的输入,必定得到同样的输出。
纯函数是函数式编程的概念,必须遵守以下一些约束。
不得改写参数
不能调用系统 I/O 的API
不能调用Date.now()或者Math.random()等不纯的方法,因为每次会得到不一样的结果
由于 Reducer 是纯函数,就可以保证同样的State,必定得到同样的 View。但也正因为这一点,Reducer 函数里面不能改变 State,必须返回一个全新的对象,请参考下面的写法。

  1. // State 是一个对象
  2. function reducer(state, action) {
  3. return Object.assign({}, state, { thingToChange });
  4. // 或者
  5. return { ...state, ...newState };
  6. }
  7. // State 是一个数组
  8. function reducer(state, action) {
  9. return [...state, newItem];
  10. }

最好把 State 对象设成只读。你没法改变它,要得到新的 State,唯一办法就是生成一个新对象。这样的好处是,任何时候,与某个 View 对应的 State 总是一个不变的对象。

store.dispatch()是 View 发出 Action 的唯一方法,此方法返回当前 action。

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="UTF-8">
  5. <title></title>
  6. <script src="https://cdn.bootcss.com/react/15.4.2/react.min.js"></script>
  7. <script src="https://cdn.bootcss.com/react/15.4.2/react-dom.min.js"></script>
  8. <script src="https://cdn.bootcss.com/babel-standalone/6.22.1/babel.min.js"></script>
  9. <script src="https://unpkg.com/react-router-dom/umd/react-router-dom.min.js"></script>
  10. <script type="text/javascript" src="../js/react-redux.js" ></script>
  11. <script type="text/javascript" src="../js/redux.js" ></script>
  12. </head>
  13. <body>
  14. <div id="root"></div>
  15. </body>
  16. <script type="text/babel">
  17. /*
  18. react-redux version 4.4.9 window.ReactRedux
  19. redux version 4.0.0
  20. * */
  21. console.log(window.ReactRedux);
  22. console.log(window.Redux);
  23. const createStore = window.Redux.createStore;
  24. const combineReducers = window.Redux.combineReducers;
  25. const store = createStore(function(){});
  26. const ADD_TODO = '添加 TODO';
  27. function addTodo(text) {
  28. return {
  29. type: ADD_TODO,
  30. text
  31. }
  32. }
  33. const action = addTodo('Learn Redux');
  34. // store.dispatch()是 View 发出 Action 的唯一方法。
  35. let state = store.dispatch({
  36. type: 'ADD_TODO',
  37. payload: 'Learn Redux'
  38. });
  39. console.log(state) // {type: "ADD_TODO", payload: "Learn Redux"}
  40. state = store.dispatch({
  41. type: 'ADD_TODO2',
  42. payload: 'Learn Redux2'
  43. });
  44. console.log(state) // {type: "ADD_TODO2", payload: "Learn Redux2"}
  45. state = store.dispatch(addTodo('xxxxx'));
  46. console.log(state) // {type: "添加 TODO", text: "xxxxx"}
  47. state = store.getState();
  48. console.log(state); // undefined
  49. </script>
  50. </html>

store.getState() 获取store的所有状态

当设置了监听器的时候,调用此方法返回所有状态,当未设置监听器时返回undefined

store.subscribe 美 [səbˈskraɪb] 监听器

Store 允许使用store.subscribe方法设置监听函数,一旦 State 发生变化,就自动执行这个函数。

显然,只要把 View 的更新函数(对于 React 项目,就是组件的render方法或setState方法)放入listen,就会实现 View 的自动渲染。 store.subscribe方法返回一个函数,调用这个函数就可以解除监听。

  1. const createStore = window.Redux.createStore;
  2. const combineReducers = window.Redux.combineReducers;
  3. const defaultState = 0;
  4. const reducer = (state = defaultState, action) => {
  5. switch (action.type) {
  6. case 'ADD':
  7. return state + action.payload;
  8. default:
  9. return state;
  10. }
  11. };
  12. const store = createStore(reducer);
  13. const state = store.getState();
  14. console.log(state); // 返回0
  15. let unsubscribe = store.subscribe(() =>
  16. console.log(store.getState())
  17. );
  18. // unsubscribe(); 取消监听器
  19. store.dispatch({
  20. type: 'ADD',
  21. payload: 1
  22. });
  23. console.log('console:', store.getState()); // console: 1
  24. store.dispatch({
  25. type: 'ADD',
  26. payload: 2
  27. });
  28. // subscribe 返回 1
  29. // subscribe 返回 3

基础例子一

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="UTF-8">
  5. <title></title>
  6. <script src="https://cdn.bootcss.com/react/15.4.2/react.min.js"></script>
  7. <script src="https://cdn.bootcss.com/react/15.4.2/react-dom.min.js"></script>
  8. <script src="https://cdn.bootcss.com/babel-standalone/6.22.1/babel.min.js"></script>
  9. <script src="https://unpkg.com/react-router-dom/umd/react-router-dom.min.js"></script>
  10. <script type="text/javascript" src="../js/react-redux.js" ></script>
  11. <script type="text/javascript" src="../js/redux.js" ></script>
  12. </head>
  13. <body>
  14. <div id="root"></div>
  15. </body>
  16. <script type="text/babel">
  17. /*
  18. react-redux version 4.4.9 window.ReactRedux
  19. redux version 4.0.0
  20. **/
  21. const createStore = window.Redux.createStore;
  22. const Num = (value, action) => {
  23. switch (action.type) {
  24. case 'INCREMENT': return value + 1;
  25. case 'DECREMENT': return value - 1;
  26. default: return value;
  27. }
  28. }
  29. const Num2 = (value, action) => {
  30. switch (action.type) {
  31. case 'INCREMENT2': return value + 1;
  32. case 'DECREMENT2': return value - 1;
  33. default: return value;
  34. }
  35. }
  36. function reducer(state = { Num : 0, Num2: 0 }, action) {
  37. return {
  38. Num: Num(state.Num, action),
  39. Num2: Num2(state.Num2, action),
  40. }
  41. }
  42. const store = createStore(reducer);
  43. let next = store.dispatch;
  44. store.dispatch = function dispatchAndLog(action) {
  45. console.log('dispatching', action);
  46. next(action);
  47. console.log('next state', store.getState());
  48. }
  49. const Counter = ({ value, onIncrement, onDecrement }) => (
  50. <div>
  51. <h1>{value}</h1>
  52. <button onClick={onIncrement}>+</button>
  53. <button onClick={onDecrement}>-</button>
  54. </div>
  55. );
  56. const Div = () => {
  57. return (
  58. <div>
  59. <Counter
  60. value={store.getState().Num}
  61. onIncrement={() => store.dispatch({type: 'INCREMENT'})}
  62. onDecrement={() => store.dispatch({type: 'DECREMENT'})}
  63. />
  64. <Counter
  65. value={store.getState().Num2}
  66. onIncrement={() => store.dispatch({type: 'INCREMENT2'})}
  67. onDecrement={() => store.dispatch({type: 'DECREMENT2'})}
  68. />
  69. </div>)
  70. }
  71. const render = () => {
  72. ReactDOM.render(
  73. <Div/>,
  74. document.getElementById('root')
  75. );
  76. };
  77. render();
  78. store.subscribe(render);
  79. </script>
  80. </html>

Redux 原理与实现

CreateStore的实现

  1. import { createStore } from 'redux';
  2. const createStore = (reducer) => {
  3. let state;
  4. let listeners = [];
  5. const getState = () => state;
  6. const dispatch = (action) => {
  7. state = reducer(state, action);
  8. listeners.forEach(listener => listener());
  9. };
  10. const subscribe = (listener) => {
  11. listeners.push(listener);
  12. return () => {
  13. listeners = listeners.filter(l => l !== listener);
  14. }
  15. };
  16. dispatch({});
  17. return { getState, dispatch, subscribe };
  18. };
  19. let { subscribe, dispatch, getState } = createStore(reducer);
  • store.getState()
  • store.dispatch()
  • store.subscribe()

Reducer的拆分

Reducer 函数负责生成 State。由于整个应用只有一个 State 对象,包含所有数据,对于大型应用来说,这个 State 必然十分庞大,导致 Reducer 函数也十分庞大。

  1. const chatReducer = (state = defaultState, action = {}) => {
  2. const { type, payload } = action;
  3. switch (type) {
  4. case ADD_CHAT:
  5. return Object.assign({}, state, {
  6. chatLog: state.chatLog.concat(payload)
  7. });
  8. case CHANGE_STATUS:
  9. return Object.assign({}, state, {
  10. statusMessage: payload
  11. });
  12. case CHANGE_USERNAME:
  13. return Object.assign({}, state, {
  14. userName: payload
  15. });
  16. default: return state;
  17. }
  18. };
  1. const chatReducer = (state = defaultState, action = {}) => {
  2. return {
  3. chatLog: chatLog(state.chatLog, action),
  4. statusMessage: statusMessage(state.statusMessage, action),
  5. userName: userName(state.userName, action)
  6. }
  7. };

Redux 提供了一个combineReducers方法,用于 Reducer 的拆分。你只要定义各个子 Reducer 函数,然后用这个方法,将它们合成一个大的 Reducer。

  1. import { combineReducers } from 'redux';
  2. const chatReducer = combineReducers({
  3. chatLog,
  4. statusMessage,
  5. userName
  6. })
  7. export default todoApp;
  8. const reducer = combineReducers({
  9. a: doSomethingWithA,
  10. b: processB,
  11. c: c
  12. })
  13. // 等同于
  14. function reducer(state = {}, action) {
  15. return {
  16. a: doSomethingWithA(state.a, action),
  17. b: processB(state.b, action),
  18. c: c(state.c, action)
  19. }
  20. }

总之,combineReducers()做的就是产生一个整体的 Reducer 函数。该函数根据 State 的 key 去执行相应的子 Reducer,并将返回结果合并成一个大的 State 对象。
下面是combineReducer的简单实现。

  1. const combineReducers = reducers => {
  2. return (state = {}, action) => {
  3. return Object.keys(reducers).reduce(
  4. (nextState, key) => {
  5. nextState[key] = reducers[key](state[key], action);
  6. return nextState;
  7. },
  8. {}
  9. );
  10. };
  11. };

你可以把所有子 Reducer 放在一个文件里面,然后统一引入。

  1. import { combineReducers } from 'redux'
  2. import * as reducers from './reducers'
  3. const reducer = combineReducers(reducers)

异步的问题,与Redux中间件

一个关键问题没有解决:异步操作怎么办?Action 发出以后,Reducer 立即算出 State,这叫做同步;Action 发出以后,过一段时间再执行 Reducer,这就是异步。
怎么才能 Reducer 在异步操作结束后自动执行呢?这就要用到新的工具:中间件(middleware)。

为了理解中间件,让我们站在框架作者的角度思考问题:如果要添加功能,你会在哪个环节添加?
(1)Reducer:纯函数,只承担计算 State 的功能,不合适承担其他功能,也承担不了,因为理论上,纯函数不能进行读写操作。
(2)View:与 State 一一对应,可以看作 State 的视觉层,也不合适承担其他功能。
(3)Action:存放数据的对象,即消息的载体,只能被别人操作,自己不能进行任何操作。
想来想去,只有发送 Action 的这个步骤,即store.dispatch()方法,可以添加功能。举例来说,要添加日志功能,把 Action 和 State 打印出来,可以对store.dispatch进行如下改造。

  1. let next = store.dispatch;
  2. store.dispatch = function dispatchAndLog(action) {
  3. console.log('dispatching', action);
  4. next(action);
  5. console.log('next state', store.getState());
  6. }

redux-logger 日志中间件

  1. import { applyMiddleware, createStore } from 'redux';
  2. import createLogger from 'redux-logger';
  3. const logger = createLogger();
  4. const store = createStore(
  5. reducer,
  6. applyMiddleware(logger)
  7. );

redux-logger提供一个生成器createLogger,可以生成日志中间件logger。然后,将它放在applyMiddleware方法之中,传入createStore方法,就完成了store.dispatch()的功能增强。

createStore方法可以接受整个应用的初始状态作为参数,那样的话,applyMiddleware就是第三个参数了。

  1. const store = createStore(
  2. reducer,
  3. initial_state,
  4. applyMiddleware(logger)
  5. );

中间件的次序有讲究。

  1. const store = createStore(
  2. reducer,
  3. applyMiddleware(thunk, promise, logger)
  4. );

上面代码中,applyMiddleware方法的三个参数,就是三个中间件。有的中间件有次序要求,使用前要查一下文档。比如,logger就一定要放在最后,否则输出结果会不正确。

applyMiddlewares()

看到这里,你可能会问,applyMiddlewares这个方法到底是干什么的?
它是 Redux 的原生方法,作用是将所有中间件组成一个数组,依次执行。下面是它的源码。

  1. export default function applyMiddleware(...middlewares) {
  2. return (createStore) => (reducer, preloadedState, enhancer) => {
  3. var store = createStore(reducer, preloadedState, enhancer);
  4. var dispatch = store.dispatch;
  5. var chain = [];
  6. var middlewareAPI = {
  7. getState: store.getState,
  8. dispatch: (action) => dispatch(action)
  9. };
  10. chain = middlewares.map(middleware => middleware(middlewareAPI));
  11. dispatch = compose(...chain)(store.dispatch);
  12. return {...store, dispatch}
  13. }
  14. }
  15. // 使用
  16. function bFn(b1, b2, b3) {
  17. return {
  18. b1,
  19. b2,
  20. b3,
  21. }
  22. }
  23. function aFn(...a) {
  24. return (bFn) => (b1, b2, b3) => {
  25. var store = bFn(b1, b2, b3);
  26. console.log(a);
  27. return { ...store }
  28. }
  29. }
  30. var fn1 = aFn(1, 2, 3);
  31. var fn2 = fn1(bFn);
  32. var result = fn2(4,5,6);
  33. console.log(result);

上面代码中,所有中间件被放进了一个数组chain,然后嵌套执行,最后执行store.dispatch。可以看到,中间件内部(middlewareAPI)可以拿到getState和dispatch这两个方法。

redux异步操作的基本思路

理解了中间件以后,就可以处理异步操作了。
同步操作只要发出一种 Action 即可,异步操作的差别是它要发出三种 Action。
操作发起时的 Action
操作成功时的 Action
操作失败时的 Action
以向服务器取出数据为例,三种 Action 可以有两种不同的写法。

  1. // 写法一:名称相同,参数不同
  2. { type: 'FETCH_POSTS' }
  3. { type: 'FETCH_POSTS', status: 'error', error: 'Oops' }
  4. { type: 'FETCH_POSTS', status: 'success', response: { ... } }
  5. // 写法二:名称不同
  6. { type: 'FETCH_POSTS_REQUEST' }
  7. { type: 'FETCH_POSTS_FAILURE', error: 'Oops' }
  8. { type: 'FETCH_POSTS_SUCCESS', response: { ... } }

除了 Action 种类不同,异步操作的 State 也要进行改造,反映不同的操作状态。下面是 State 的一个例子。

  1. let state = {
  2. // ...
  3. isFetching: true,
  4. didInvalidate: true,
  5. lastUpdated: 'xxxxxxx'
  6. };

上面代码中,State 的属性isFetching表示是否在抓取数据。didInvalidate表示数据是否过时,lastUpdated表示上一次更新时间。
现在,整个异步操作的思路就很清楚了。

  • 操作开始时,送出一个 Action,触发 State 更新为”正在操作”状态,View 重新渲染
  • 操作结束后,再送出一个 Action,触发 State 更新为”操作结束”状态,View 再一次重新渲染

redux-thunk 中间件,美[θʌŋk],让dispatch支持function的传参

异步操作至少要送出两个 Action:用户触发第一个 Action,这个跟同步操作一样,没有问题;如何才能在操作结束时,系统自动送出第二个 Action 呢?
奥妙就在 Action Creator 之中。

  1. class AsyncApp extends Component {
  2. componentDidMount() {
  3. const { dispatch, selectedPost } = this.props
  4. dispatch(fetchPosts(selectedPost))
  5. }
  6. // ...

上面代码是一个异步组件的例子。加载成功后(componentDidMount方法),它送出了(dispatch方法)一个 Action,向服务器要求数据 fetchPosts(selectedSubreddit)。这里的fetchPosts就是 Action Creator。
下面就是fetchPosts的代码,关键之处就在里面。

  1. const fetchPosts = postTitle => (dispatch, getState) => {
  2. dispatch(requestPosts(postTitle));
  3. return fetch(`/some/API/${postTitle}.json`)
  4. .then(response => response.json())
  5. .then(json => dispatch(receivePosts(postTitle, json)));
  6. };
  7. };
  8. // 使用方法一
  9. store.dispatch(fetchPosts('reactjs'));
  10. // 使用方法二
  11. store.dispatch(fetchPosts('reactjs')).then(() =>
  12. console.log(store.getState())
  13. );

上面代码中,fetchPosts是一个Action Creator(动作生成器),返回一个函数。这个函数执行后,先发出一个Action(requestPosts(postTitle)),然后进行异步操作。拿到结果后,先将结果转成 JSON 格式,然后再发出一个 Action( receivePosts(postTitle, json))。
上面代码中,有几个地方需要注意。

(1)fetchPosts返回了一个函数,而普通的 Action Creator 默认返回一个对象。
(2)返回的函数的参数是dispatch和getState这两个 Redux 方法,普通的 Action Creator 的参数是 Action 的内容。
(3)在返回的函数之中,先发出一个 Action(requestPosts(postTitle)),表示操作开始。
(4)异步操作结束之后,再发出一个 Action(receivePosts(postTitle, json)),表示操作结束。

这样的处理,就解决了自动发送第二个 Action 的问题。但是,又带来了一个新的问题,Action 是由store.dispatch方法发送的。而store.dispatch方法正常情况下,参数只能是对象,不能是函数。
这时,就要使用中间件redux-thunk

  1. import { createStore, applyMiddleware } from 'redux';
  2. import thunk from 'redux-thunk';
  3. import reducer from './reducers';
  4. // Note: this API requires redux@>=3.1.0
  5. const store = createStore(
  6. reducer,
  7. applyMiddleware(thunk)
  8. );

上面代码使用redux-thunk中间件,改造store.dispatch,使得后者可以接受函数作为参数。
因此,异步操作的第一种解决方案就是,写出一个返回函数的 Action Creator,然后使用redux-thunk中间件改造store.dispatch。

redux-promise 中间件

既然 Action Creator 可以返回函数,当然也可以返回其他值。另一种异步操作的解决方案,就是让 Action Creator 返回一个 Promise 对象。
这就需要使用redux-promise中间件。

  1. import { createStore, applyMiddleware } from 'redux';
  2. import promiseMiddleware from 'redux-promise';
  3. import reducer from './reducers';
  4. const store = createStore(
  5. reducer,
  6. applyMiddleware(promiseMiddleware)
  7. );

这个中间件使得store.dispatch方法可以接受 Promise 对象作为参数。这时,Action Creator 有两种写法。写法一,返回值是一个 Promise 对象。

  1. const fetchPosts =
  2. (dispatch, postTitle) => new Promise(function (resolve, reject) {
  3. dispatch(requestPosts(postTitle));
  4. return fetch(`/some/API/${postTitle}.json`)
  5. .then(response => {
  6. type: 'FETCH_POSTS',
  7. payload: response.json()
  8. });
  9. });

写法二,Action 对象的payload属性是一个 Promise 对象。这需要从redux-actions模块引入createAction方法,并且写法也要变成下面这样。

  1. import { createAction } from 'redux-actions';
  2. class AsyncApp extends Component {
  3. componentDidMount() {
  4. const { dispatch, selectedPost } = this.props
  5. // 发出同步 Action
  6. dispatch(requestPosts(selectedPost));
  7. // 发出异步 Action
  8. dispatch(createAction(
  9. 'FETCH_POSTS',
  10. fetch(`/some/API/${postTitle}.json`)
  11. .then(response => response.json())
  12. ));
  13. }

上面代码中,第二个dispatch方法发出的是异步 Action,只有等到操作结束,这个 Action 才会实际发出。注意,createAction的第二个参数必须是一个 Promise 对象。
看一下redux-promise的源码,就会明白它内部是怎么操作的。

  1. export default function promiseMiddleware({ dispatch }) {
  2. return next => action => {
  3. if (!isFSA(action)) {
  4. return isPromise(action)
  5. ? action.then(dispatch)
  6. : next(action);
  7. }
  8. return isPromise(action.payload)
  9. ? action.payload.then(
  10. result => dispatch({ ...action, payload: result }),
  11. error => {
  12. dispatch({ ...action, payload: error, error: true });
  13. return Promise.reject(error);
  14. }
  15. )
  16. : next(action);
  17. };
  18. }

从上面代码可以看出,如果 Action 本身是一个 Promise,它 resolve 以后的值应该是一个 Action 对象,会被dispatch方法送出(action.then(dispatch)),但 reject 以后不会有任何动作;如果 Action 对象的payload属性是一个 Promise 对象,那么无论 resolve 和 reject,dispatch方法都会发出 Action。

React-redux

为了方便使用,Redux 的作者封装了一个 React 专用的库 React-Redux,本文主要介绍它。
这个库是可以选用的。实际项目中,你应该权衡一下,是直接使用 Redux,还是使用 React-Redux。后者虽然提供了便利,但是需要掌握额外的 API,并且要遵守它的组件拆分规范。

React-Redux 将所有组件分成两大类:UI 组件(presentational component)和容器组件(container component)。

一、UI 组件有以下几个特征。

  • 只负责 UI 的呈现,不带有任何业务逻辑
  • 没有状态(即不使用this.state这个变量)
  • 所有数据都由参数(this.props)提供
  • 不使用任何 Redux 的 API

下面就是一个 UI 组件的例子。

  1. const Title =
  2. value => <h1>{value}</h1>;

因为不含有状态,UI 组件又称为”纯组件”,即它纯函数一样,纯粹由参数决定它的值。

二、容器组件

容器组件的特征恰恰相反。

  • 负责管理数据和业务逻辑,不负责 UI 的呈现
  • 带有内部状态
  • 使用 Redux 的 API

总之,只要记住一句话就可以了:UI 组件负责 UI 的呈现,容器组件负责管理数据和逻辑。
你可能会问,如果一个组件既有 UI 又有业务逻辑,那怎么办?回答是,将它拆分成下面的结构:外面是一个容器组件,里面包了一个UI 组件。前者负责与外部的通信,将数据传给后者,由后者渲染出视图。
React-Redux 规定,所有的 UI 组件都由用户提供,容器组件则是由 React-Redux 自动生成。也就是说,用户负责视觉层,状态管理则是全部交给它。

三、connect()

React-Redux 提供connect方法,用于从 UI 组件生成容器组件。connect的意思,就是将这两种组件连起来。

  1. import { connect } from 'react-redux'
  2. const VisibleTodoList = connect()(TodoList);

上面代码中,TodoList是 UI 组件,VisibleTodoList就是由 React-Redux 通过connect方法自动生成的容器组件。
但是,因为没有定义业务逻辑,上面这个容器组件毫无意义,只是 UI 组件的一个单纯的包装层。为了定义业务逻辑,需要给出下面两方面的信息。

(1)输入逻辑:外部的数据(即state对象)如何转换为 UI 组件的参数 (2)输出逻辑:用户发出的动作如何变为 Action 对象,从 UI 组件传出去。

因此,connect方法的完整 API 如下。

  1. import { connect } from 'react-redux'
  2. const VisibleTodoList = connect(
  3. mapStateToProps,
  4. mapDispatchToProps
  5. )(TodoList)

上面代码中,connect方法接受两个参数:mapStateToProps和mapDispatchToProps。它们定义了 UI 组件的业务逻辑。前者负责输入逻辑,即将state映射到 UI 组件的参数(props),后者负责输出逻辑,即将用户对 UI 组件的操作映射成 Action。

四、mapStateToProps()

mapStateToProps是一个函数。它的作用就是像它的名字那样,建立一个从(外部的)state对象到(UI 组件的)props对象的映射关系。
作为函数,mapStateToProps执行后应该返回一个对象,里面的每一个键值对就是一个映射。请看下面的例子。

  1. const mapStateToProps = (state) => {
  2. return {
  3. todos: getVisibleTodos(state.todos, state.visibilityFilter)
  4. }
  5. }

上面代码中,mapStateToProps是一个函数,它接受state作为参数,返回一个对象。这个对象有一个todos属性,代表 UI 组件的同名参数,后面的getVisibleTodos也是一个函数,可以从state算出 todos 的值。
下面就是getVisibleTodos的一个例子,用来算出todos。

  1. const getVisibleTodos = (todos, filter) => {
  2. switch (filter) {
  3. case 'SHOW_ALL':
  4. return todos
  5. case 'SHOW_COMPLETED':
  6. return todos.filter(t => t.completed)
  7. case 'SHOW_ACTIVE':
  8. return todos.filter(t => !t.completed)
  9. default:
  10. throw new Error('Unknown filter: ' + filter)
  11. }
  12. }

mapStateToProps会订阅 Store,每当state更新的时候,就会自动执行,重新计算 UI 组件的参数,从而触发 UI 组件的重新渲染。
mapStateToProps的第一个参数总是state对象,还可以使用第二个参数,代表容器组件的props对象。

  1. // 容器组件的代码
  2. // <FilterLink filter="SHOW_ALL">
  3. // All
  4. // </FilterLink>
  5. const mapStateToProps = (state, ownProps) => {
  6. return {
  7. active: ownProps.filter === state.visibilityFilter
  8. }
  9. }

使用ownProps作为参数后,如果容器组件的参数发生变化,也会引发 UI 组件重新渲染。
connect方法可以省略mapStateToProps参数,那样的话,UI 组件就不会订阅Store,就是说 Store 的更新不会引起 UI 组件的更新。

五、mapDispatchToProps()

mapDispatchToProps是connect函数的第二个参数,用来建立 UI 组件的参数到store.dispatch方法的映射。也就是说,它定义了哪些用户的操作应该当作 Action,传给 Store。它可以是一个函数,也可以是一个对象。
如果mapDispatchToProps是一个函数,会得到dispatch和ownProps(容器组件的props对象)两个参数。

  1. const mapDispatchToProps = (
  2. dispatch,
  3. ownProps
  4. ) => {
  5. return {
  6. onClick: () => {
  7. dispatch({
  8. type: 'SET_VISIBILITY_FILTER',
  9. filter: ownProps.filter
  10. });
  11. }
  12. };
  13. }

从上面代码可以看到,mapDispatchToProps作为函数,应该返回一个对象,该对象的每个键值对都是一个映射,定义了 UI 组件的参数怎样发出 Action。
如果mapDispatchToProps是一个对象,它的每个键名也是对应 UI 组件的同名参数,键值应该是一个函数,会被当作 Action creator ,返回的 Action 会由 Redux 自动发出。举例来说,上面的mapDispatchToProps写成对象就是下面这样。

  1. const mapDispatchToProps = {
  2. onClick: (filter) => {
  3. type: 'SET_VISIBILITY_FILTER',
  4. filter: filter
  5. };
  6. }

六、实例

  1. // src/redux/index.jsx
  2. import { connect } from 'react-redux';
  3. import { bindActionCreators } from 'redux';
  4. import actions from './actions';
  5. export function mapStateToProps(state) {
  6. return state;
  7. }
  8. export function mapDispatchToProps(dispatch) {
  9. return {
  10. ...bindActionCreators(actions, dispatch),
  11. };
  12. }
  13. export function connectAll(Component) {
  14. return connect(mapStateToProps, mapDispatchToProps)(Component);
  15. }
  16. // src/redux/actions.jsx
  17. import { combineReducers } from 'redux';
  18. const chatLog = (state = '1', action) => {
  19. console.log(state, action);
  20. switch(action.type) {
  21. case 'ADD_CHAT':
  22. return action.chatLog
  23. default:
  24. return state;
  25. }
  26. }
  27. const userName = (state = '1', action) => {
  28. console.log(state, action);
  29. switch(action.type) {
  30. case 'CHANGE_USERNAME':
  31. return action.userName
  32. default:
  33. return state;
  34. }
  35. }
  36. const statusMessage = (state = '1', action) => {
  37. console.log(state, action);
  38. switch(action.type) {
  39. case 'CHANGE_STATUS':
  40. return action.statusMessage
  41. default:
  42. return state;
  43. }
  44. }
  45. export const reducer = combineReducers({
  46. chatLog,
  47. statusMessage,
  48. userName
  49. })
  50. export const actions = {
  51. setAddChat: value => ({
  52. type: 'ADD_CHAT',
  53. chatLog: value
  54. }),
  55. setStatusMessage: value => ({
  56. type: 'CHANGE_STATUS',
  57. statusMessage: value
  58. }),
  59. setUserName: value => ({
  60. type: 'CHANGE_USERNAME',
  61. userName: value
  62. })
  63. }
  64. // src/component/App.jsx
  65. import React from "react";
  66. import { connectAll } from '../Redux'
  67. class Mod extends React.Component {
  68. constructor(props) {
  69. super(props);
  70. this.state = {};
  71. }
  72. setUserName = () => {
  73. this.props.setUserName('xxx');
  74. }
  75. render() {
  76. console.log('777');
  77. console.log(this.props);
  78. return (<div>
  79. <div>{this.props.chatLog}</div>
  80. <div>{this.props.statusMessage}</div>
  81. <div>{this.props.userName}</div>
  82. <button onClick={this.setUserName}>改变UserName</button>
  83. </div>)
  84. }
  85. }
  86. export default connectAll(Mod);

七、 组件

connect方法生成容器组件以后,需要让容器组件拿到state对象,才能生成 UI 组件的参数。
一种解决方法是将state对象作为参数,传入容器组件。但是,这样做比较麻烦,尤其是容器组件可能在很深的层级,一级级将state传下去就很麻烦。
React-Redux 提供Provider组件,可以让容器组件拿到state。

  1. import { Provider } from 'react-redux'
  2. import { createStore } from 'redux'
  3. import todoApp from './reducers'
  4. import App from './components/App'
  5. let store = createStore(todoApp);
  6. render(
  7. <Provider store={store}>
  8. <App />
  9. </Provider>,
  10. document.getElementById('root')
  11. )

上面代码中,Provider在根组件外面包了一层,这样一来,App的所有子组件就默认都可以拿到state了。
它的原理是React组件的context属性,请看源码。

  1. class Provider extends Component {
  2. getChildContext() {
  3. return {
  4. store: this.props.store
  5. };
  6. }
  7. render() {
  8. return this.props.children;
  9. }
  10. }
  11. Provider.childContextTypes = {
  12. store: React.PropTypes.object
  13. }

上面代码中,store放在了上下文对象context上面。然后,子组件就可以从context拿到store,代码大致如下。

  1. class VisibleTodoList extends Component {
  2. componentDidMount() {
  3. const { store } = this.context;
  4. this.unsubscribe = store.subscribe(() =>
  5. this.forceUpdate()
  6. );
  7. }
  8. render() {
  9. const props = this.props;
  10. const { store } = this.context;
  11. const state = store.getState();
  12. // ...
  13. }
  14. }
  15. VisibleTodoList.contextTypes = {
  16. store: React.PropTypes.object
  17. }

React-Redux自动生成的容器组件的代码,就类似上面这样,从而拿到store。

八、实例:计数器

我们来看一个实例。下面是一个计数器组件,它是一个纯的 UI 组件。

  1. class Counter extends Component {
  2. render() {
  3. const { value, onIncreaseClick } = this.props
  4. return (
  5. <div>
  6. <span>{value}</span>
  7. <button onClick={onIncreaseClick}>Increase</button>
  8. </div>
  9. )
  10. }
  11. }

上面代码中,这个 UI 组件有两个参数:value和onIncreaseClick。前者需要从state计算得到,后者需要向外发出 Action。
接着,定义value到state的映射,以及onIncreaseClick到dispatch的映射。

  1. function mapStateToProps(state) {
  2. return {
  3. value: state.count
  4. }
  5. }
  6. function mapDispatchToProps(dispatch) {
  7. return {
  8. onIncreaseClick: () => dispatch(increaseAction)
  9. }
  10. }
  11. // Action Creator
  12. const increaseAction = { type: 'increase' }

然后,使用connect方法生成容器组件。

  1. const App = connect(
  2. mapStateToProps,
  3. mapDispatchToProps
  4. )(Counter)

然后,定义这个组件的 Reducer。

  1. // Reducer
  2. function counter(state = { count: 0 }, action) {
  3. const count = state.count
  4. switch (action.type) {
  5. case 'increase':
  6. return { count: count + 1 }
  7. default:
  8. return state
  9. }
  10. }

最后,生成store对象,并使用Provider在根组件外面包一层。

  1. import { loadState, saveState } from './localStorage';
  2. const persistedState = loadState();
  3. const store = createStore(
  4. todoApp,
  5. persistedState
  6. );
  7. store.subscribe(throttle(() => {
  8. saveState({
  9. todos: store.getState().todos,
  10. })
  11. }, 1000))
  12. ReactDOM.render(
  13. <Provider store={store}>
  14. <App />
  15. </Provider>,
  16. document.getElementById('root')
  17. );

完整的代码看这里

九、React-Router 路由库

使用React-Router的项目,与其他项目没有不同之处,也是使用Provider在Router外面包一层,毕竟Provider的唯一功能就是传入store对象。

  1. const Root = ({ store }) => (
  2. <Provider store={store}>
  3. <Router>
  4. <Route path="/" component={App} />
  5. </Router>
  6. </Provider>
  7. );