以前寫了一篇經過一個demo瞭解Redux,但對於redux的核心方法沒有進行深刻剖析,在此從新總結學習,完整的代碼看這裏。(參考了React 技術棧系列教程)html
什麼狀況須要用redux?react
簡單說,若是你的UI層很是簡單,沒有不少互動,Redux 就是沒必要要的,用了反而增長複雜性。多交互、多數據源場景就比較適合使用Redux。git
設計思想:github
Redux工做流程:json
首先,用戶發出 Action。redux
store.dispatch(action);
而後,Store 自動調用 Reducer,而且傳入兩個參數:當前 State 和收到的 Action。 Reducer 會返回新的 State 。promise
let nextState = todoApp(previousState, action);
State 一旦有變化,Store 就會調用監聽函數。服務器
// 設置監聽函數 store.subscribe(listener);
listener
能夠經過store.getState()
獲得當前狀態。若是使用的是 React,這時能夠觸發從新渲染 View。app
function listerner() { let newState = store.getState(); component.setState(newState); }
若是如今沒理解以上流程,不要急,看完如下API就差很少能懂得Redux的核心機制了。框架
Store
Store 就是保存數據的地方,你能夠把它當作一個容器。整個應用只能有一個 Store。
Redux 提供createStore
這個函數,用來生成 Store。
下面代碼中,createStore
函數接受另外一個函數做爲參數,返回新生成的 Store 對象。
import { createStore } from 'redux';
const store = createStore(fn);
State
Store
對象包含全部數據。若是想獲得某個時點的數據,就要對 Store 生成快照。這種時點的數據集合,就叫作 State。
當前時刻的 State,能夠經過store.getState()
拿到。
import { createStore } from 'redux'; const store = createStore(fn); const state = store.getState();
Redux 規定, 一個 State 對應一個 View。只要 State 相同,View 就相同。你知道 State,就知道 View 是什麼樣,反之亦然。
Action
State 的變化,會致使 View 的變化。可是,用戶接觸不到 State,只能接觸到 View。因此,State 的變化必須是 View 致使的。Action 就是 View 發出的通知,表示 State 應該要發生變化了。
Action 是一個對象。其中的type
屬性是必須的,表示 Action 的名稱。其餘屬性能夠自由設置,社區有一個規範能夠參考。
const action = { type: 'ADD_TODO', payload: 'Learn Redux' };
上面代碼中,Action 的名稱是ADD_TODO
,它攜帶的信息是字符串Learn Redux
。
能夠這樣理解,Action 描述當前發生的事情。改變 State 的惟一辦法,就是使用 Action。它會運送數據到 Store。
Action Creator
View 要發送多少種消息,就會有多少種 Action。若是都手寫,會很麻煩。能夠定義一個函數來生成 Action,這個函數就叫 Action Creator。
const ADD_TODO = '添加 TODO'; function addTodo(text) { return { type: ADD_TODO, text } } const action = addTodo('Learn Redux');
store.dispatch()
store.dispatch()
是 View 發出 Action 的惟一方法。
import { createStore } from 'redux'; const store = createStore(fn); store.dispatch({ type: 'ADD_TODO', payload: 'Learn Redux' });
上面代碼中,store.dispatch
接受一個 Action 對象做爲參數,將它發送出去。
結合 Action Creator,這段代碼能夠改寫以下。
store.dispatch(addTodo('Learn Redux'));
Reducer
Store 收到 Action 之後,必須給出一個新的 State,這樣 View 纔會發生變化。這種 State 的計算過程就叫作 Reducer。
Reducer 是一個函數,它接受 Action 和當前 State 做爲參數,返回一個新的 State。下面是一個實際的例子
const defaultState = 0; const reducer = (state = defaultState, action) => { switch (action.type) { case 'ADD': return state + action.payload; default: return state; } }; const state = reducer(1, { type: 'ADD', payload: 2 });
上面代碼中,reducer
函數收到名爲ADD
的 Action 之後,就返回一個新的 State,做爲加法的計算結果。其餘運算的邏輯(好比減法),也能夠根據 Action 的不一樣來實現。
實際應用中,Reducer 函數不用像上面這樣手動調用,store.dispatch
方法會觸發 Reducer 的自動執行。爲此,Store 須要知道 Reducer 函數,作法就是在生成 Store 的時候,將 Reducer 傳入createStore
方法。
import { createStore } from 'redux';
const store = createStore(reducer);
上面代碼中,createStore
接受 Reducer 做爲參數,生成一個新的 Store。之後每當store.dispatch
發送過來一個新的 Action,就會自動調用 Reducer,獲得新的 State。
store.subscribe()
Store 容許使用store.subscribe
方法設置監聽函數,一旦 State 發生變化,就自動執行這個函數。
import { createStore } from 'redux'; const store = createStore(reducer); store.subscribe(listener);
顯然,只要把 View 的更新函數(對於 React 項目,就是組件的render
方法或setState
方法)放入listen
,就會實現 View 的自動渲染。
store.subscribe
方法返回一個函數,調用這個函數就能夠解除監聽。
let unsubscribe = store.subscribe(() =>
console.log(store.getState())
);
unsubscribe();
一個關鍵問題沒有解決:異步操做怎麼辦?Action 發出之後,Reducer 當即算出 State,這叫作同步;Action 發出之後,過一段時間再執行 Reducer,這就是異步。
怎麼才能 Reducer 在異步操做結束後自動執行呢?這就要用到新的工具:中間件(middleware)。
爲了理解中間件,讓咱們站在框架做者的角度思考問題:若是要添加功能,你會在哪一個環節添加?
(1)Reducer:純函數,只承擔計算 State 的功能,不合適承擔其餘功能,也承擔不了,由於理論上,純函數不能進行讀寫操做。
(2)View:與 State 一一對應,能夠看做 State 的視覺層,也不合適承擔其餘功能。
(3)Action:存放數據的對象,即消息的載體,只能被別人操做,本身不能進行任何操做。
想來想去,只有發送 Action 的這個步驟,即store.dispatch()
方法,能夠添加功能。
本文不涉及如何編寫中間件,由於經常使用的中間件都有現成的,只要引用別人寫好的模塊便可。好比,上一節的日誌中間件,就有現成的redux-logger模塊。這裏只介紹怎麼使用中間件。
import { applyMiddleware, createStore } from 'redux'; import createLogger from 'redux-logger'; const logger = createLogger(); const store = createStore( reducer, applyMiddleware(logger) );
上面代碼中,redux-logger
提供一個生成器createLogger
,能夠生成日誌中間件logger
。而後,將它放在applyMiddleware
方法之中,傳入createStore
方法,就完成了store.dispatch()
的功能加強。
這裏有兩點須要注意:
(1)createStore
方法能夠接受整個應用的初始狀態做爲參數,那樣的話,applyMiddleware
就是第三個參數了。
const store = createStore(
reducer,
initial_state,
applyMiddleware(logger)
);
(2)中間件的次序有講究。
const store = createStore(
reducer,
applyMiddleware(thunk, promise, logger)
);
上面代碼中,applyMiddleware
方法的三個參數,就是三個中間件。有的中間件有次序要求,使用前要查一下文檔。好比,logger
就必定要放在最後,不然輸出結果會不正確。
理解了中間件之後,就能夠處理異步操做了。
同步操做只要發出一種 Action 便可,異步操做的差異是它要發出三種 Action。
以向服務器取出數據爲例,三種 Action 能夠有兩種不一樣的寫法。
// 寫法一:名稱相同,參數不一樣 { type: 'FETCH_POSTS' } { type: 'FETCH_POSTS', status: 'error', error: 'Oops' } { type: 'FETCH_POSTS', status: 'success', response: { ... } } // 寫法二:名稱不一樣 { type: 'FETCH_POSTS_REQUEST' } { type: 'FETCH_POSTS_FAILURE', error: 'Oops' } { type: 'FETCH_POSTS_SUCCESS', response: { ... } }
除了 Action 種類不一樣,異步操做的 State 也要進行改造,反映不一樣的操做狀態。下面是 State 的一個例子。
let state = { // ... isFetching: true, didInvalidate: true, lastUpdated: 'xxxxxxx' };
上面代碼中,State 的屬性isFetching
表示是否在抓取數據。didInvalidate
表示數據是否過期,lastUpdated
表示上一次更新時間。
如今,整個異步操做的思路就很清楚了。
異步操做至少要送出兩個 Action:用戶觸發第一個 Action,這個跟同步操做同樣,沒有問題;如何才能在操做結束時,系統自動送出第二個 Action 呢?
奧妙就在 Action Creator 之中。
class AsyncApp extends Component { componentDidMount() { const { dispatch, selectedPost } = this.props dispatch(fetchPosts(selectedPost)) } // ...
上面代碼是一個異步組件的例子。加載成功後(componentDidMount
方法),它送出了(dispatch
方法)一個 Action,向服務器要求數據 fetchPosts(selectedSubreddit)
。這裏的fetchPosts
就是 Action Creator。
下面就是fetchPosts
的代碼,關鍵之處就在裏面。
const fetchPosts = postTitle => (dispatch, getState) => { dispatch(requestPosts(postTitle)); return fetch(`/some/API/${postTitle}.json`) .then(response => response.json()) .then(json => dispatch(receivePosts(postTitle, json))); }; }; // 使用方法一 store.dispatch(fetchPosts('reactjs')); // 使用方法二 store.dispatch(fetchPosts('reactjs')).then(() => console.log(store.getState()) );
上面代碼中,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
。
import { createStore, applyMiddleware } from 'redux'; import thunk from 'redux-thunk'; import reducer from './reducers'; // Note: this API requires redux@>=3.1.0 const store = createStore( reducer, applyMiddleware(thunk) );
上面代碼使用redux-thunk
中間件,改造store.dispatch
,使得後者能夠接受函數做爲參數。
所以,異步操做的第一種解決方案就是,寫出一個返回函數的 Action Creator,而後使用redux-thunk
中間件改造store.dispatch
。
爲了方便使用,Redux 的做者封裝了一個 React 專用的庫 React-Redux,本文主要介紹它。
這個庫是能夠選用的。實際項目中,你應該權衡一下,是直接使用 Redux,仍是使用 React-Redux。後者雖然提供了便利,可是須要掌握額外的 API,而且要遵照它的組件拆分規範。
React-Redux 將全部組件分紅兩大類:UI 組件(presentational component)和容器組件(container component)。
UI 組件有如下幾個特徵。
this.state
這個變量)this.props
)提供下面就是一個 UI 組件的例子。
const Title =
value => <h1>{value}</h1>;
由於不含有狀態,UI 組件又稱爲"純組件",即它純函數同樣,純粹由參數決定它的值。
容器組件的特徵偏偏相反。
總之,只要記住一句話就能夠了:UI 組件負責 UI 的呈現,容器組件負責管理數據和邏輯。
你可能會問,若是一個組件既有 UI 又有業務邏輯,那怎麼辦?回答是,將它拆分紅下面的結構:外面是一個容器組件,裏面包了一個UI 組件。前者負責與外部的通訊,將數據傳給後者,由後者渲染出視圖。
React-Redux 規定,全部的 UI 組件都由用戶提供,容器組件則是由 React-Redux 自動生成。也就是說,用戶負責視覺層,狀態管理則是所有交給它。
connect()
React-Redux 提供connect
方法,用於從 UI 組件生成容器組件。connect
的意思,就是將這兩種組件連起來。
connect
方法的完整 API 以下。
import { connect } from 'react-redux' const VisibleTodoList = connect( mapStateToProps, mapDispatchToProps )(TodoList)
上面代碼中,TodoList
是 UI 組件,VisibleTodoList
就是由 React-Redux 經過connect
方法自動生成的容器組件。connect
方法接受兩個參數:mapStateToProps
和mapDispatchToProps
。它們定義了 UI 組件的業務邏輯。前者負責輸入邏輯,即將state
映射到 UI 組件的參數(props
),後者負責輸出邏輯,即將用戶對 UI 組件的操做映射成 Action。
mapStateToProps
mapStateToProps
是一個函數。它的做用就是像它的名字那樣,創建一個從(外部的)state
對象到(UI 組件的)props
對象的映射關係。
做爲函數,mapStateToProps
執行後應該返回一個對象,裏面的每個鍵值對就是一個映射。請看下面的例子。
const mapStateToProps = (state) => { return { todos: getVisibleTodos(state.todos, state.visibilityFilter) } }
上面代碼中,mapStateToProps
是一個函數,它接受state
做爲參數,返回一個對象。這個對象有一個todos
屬性,表明 UI 組件的同名參數,後面的getVisibleTodos
也是一個函數,能夠從state
算出 todos
的值。
下面就是getVisibleTodos
的一個例子,用來算出todos
。
const getVisibleTodos = (todos, filter) => { switch (filter) { case 'SHOW_ALL': return todos case 'SHOW_COMPLETED': return todos.filter(t => t.completed) case 'SHOW_ACTIVE': return todos.filter(t => !t.completed) default: throw new Error('Unknown filter: ' + filter) } }
mapStateToProps
會訂閱 Store,每當state
更新的時候,就會自動執行,從新計算 UI 組件的參數,從而觸發 UI 組件的從新渲染。
mapStateToProps
的第一個參數老是state
對象,還可使用第二個參數,表明容器組件的props
對象。
// 容器組件的代碼 // <FilterLink filter="SHOW_ALL"> // All // </FilterLink> const mapStateToProps = (state, ownProps) => { return { active: ownProps.filter === state.visibilityFilter } }
使用ownProps
做爲參數後,若是容器組件的參數發生變化,也會引起 UI 組件從新渲染。
connect
方法能夠省略mapStateToProps
參數,那樣的話,UI 組件就不會訂閱Store,就是說 Store 的更新不會引發 UI 組件的更新。
mapDispatchToProps()
mapDispatchToProps
是connect
函數的第二個參數,用來創建 UI 組件的參數到store.dispatch
方法的映射。也就是說,它定義了哪些用戶的操做應該看成 Action,傳給 Store。它能夠是一個函數,也能夠是一個對象。
若是mapDispatchToProps
是一個函數,會獲得dispatch
和ownProps
(容器組件的props
對象)兩個參數。
const mapDispatchToProps = ( dispatch, ownProps ) => { return { onClick: () => { dispatch({ type: 'SET_VISIBILITY_FILTER', filter: ownProps.filter }); } }; }
從上面代碼能夠看到,mapDispatchToProps
做爲函數,應該返回一個對象,該對象的每一個鍵值對都是一個映射,定義了 UI 組件的參數怎樣發出 Action。
若是mapDispatchToProps
是一個對象,它的每一個鍵名也是對應 UI 組件的同名參數,鍵值應該是一個函數,會被看成 Action creator ,返回的 Action 會由 Redux 自動發出。舉例來講,上面的mapDispatchToProps
寫成對象就是下面這樣。
const mapDispatchToProps = { onClick: (filter) => { type: 'SET_VISIBILITY_FILTER', filter: filter }; }
<Provider>組件
connect
方法生成容器組件之後,須要讓容器組件拿到state
對象,才能生成 UI 組件的參數。React-Redux 提供Provider
組件,可讓容器組件拿到state
。
import { Provider } from 'react-redux' import { createStore } from 'redux' import todoApp from './reducers' import App from './components/App' let store = createStore(todoApp); render( <Provider store={store}> <App /> </Provider>, document.getElementById('root') )
上面代碼中,Provider
在根組件外面包了一層,這樣一來,App
的全部子組件就默認均可以拿到state
了。
使用React-Router
的項目,與其餘項目沒有不一樣之處,也是使用Provider
在Router
外面包一層,畢竟Provider
的惟一功能就是傳入store
對象。
const Root = ({ store }) => (
<Provider store={store}>
<Router>
<Route path="/" component={App} />
</Router>
</Provider>
);