在微信小程序中使用redux

本文主要講述，在微信小程序中如何使用redux

DEMO

須要解決的問題

1. 如何在小程序中引入redux狀態管理庫，及它相關的插件？
2. 微信小程序沒有清晰的異步api，便於thunkMiddleware處理異步請求（異步操做），如何解決？
3. 如何正確使用store的三大核心方法（getStore dispatch subscribe）？

redux並非react專屬，因此他能夠在任何地方使用，小程序也不例外。解決上面三個問題就能夠了。

問題一： 如何在小程序中引入redux狀態管理庫，及它相關的插件？

1. 使用npm在臨時目錄裏安裝redux和其餘你須要用到的包，如：logger thunkMiddleware。這裏以redux示例。
2. 進入node_module中，拷貝以下文件：\redux\dist\redux.js或者\redux\dist\redux.min.js
3. 根據1/2中的步驟。把redux.js logger.js thunkMiddleware都拷貝到小程序項目文件夾\module目錄下，沒有請新建。

問題二： 微信小程序沒有清晰的異步api，便於thunkMiddleware處理異步請求（異步操做），如何解決？

前面有文章已經寫過，如何將微信異步api轉換爲Promise，便於異步編程:把微信小程序異步API轉爲Promise，簡化異步編程

讀完會，把to-promise庫和redux同樣放在\module文件夾下

問題三：如何正確使用store的三大方法（getStore dispatch subscribe）？

這也是最關鍵的

在app.js中建立store

//app.js
import reducer from './reducer/index'
import { createStore, applyMiddleware } from './module/redux'
import logger from './module/redux-logger'
import thunkMiddleware from './module/redux-thunk'

//建立redux store
export const store = createStore(
  reducer,
  applyMiddleware(
    logger,//用於控制檯state調試
    thunkMiddleware//用於處理異步action
  )
)

App({
    //...
})

編寫action

// 項目根目錄/action/http3Steps.js

export const REQUSET_BEGIN = 'REQUEST_BEGIN'
export const RECEIVED = 'RECEIVED'
export const REQUEST_FAILED = 'REQUEST_FAILED'

//建立三個請求http事務時的狀態action，用於處理通用http請求
//1 請求開始；2 收到請求；3 請求失敗
export const requestBegin = (requestName) => ({
  type: REQUSET_BEGIN + requestName
})

export const received = (requestName, res) => ({
  type: RECEIVED + requestName,
  res
})

export const requestFailed = (requestName, err) => ({
  type: REQUEST_FAILED + requestName,
  err
})

編寫索引action:

// 項目根目錄/action/index.js

import { requestBegin, received, requestFailed } from './http3Steps'
import toPromise from '../module/to-promise'

//微信小程序沒有提供Promise版本的異步api
//我封裝了一個庫，把微信小程序異步api轉化爲Promise，用於處理redux中的異步action
//項目地址：https://github.com/tornoda/to-promise
//使用方法見blog：https://www.cnblogs.com/looyulong/p/9471424.html
const toPromiseWx = toPromise(wx)
const request = toPromiseWx('request')

//這是一個同步的action
export const INCREASE = 'INCREASE'

export const increase = {
  type: INCREASE
}

//這是一個異步action
//網絡請求action
//根據redux官網的介紹，它應該是一個Promise，可是微信小程序沒有提供Promise版本的異步api，須要使用上面提到的工具庫
export const GAME_LIST = '_GAME_LIST'

export const fetch = (requestName, option) => {
  return (dispatch) => {
    dispatch(requestBegin(requestName))//請求開始，更新state狀態
    return request(option)
      .then(
        (res) => { dispatch(received(requestName, res)); return res },//請求成功，把返回的信息在state中更新
        (err) => { dispatch(requestFailed(requestName, err)) }//請求失敗，把失敗的信息在state中更新
      )
  }
}

編寫處理action的reducer

// 項目根目錄/reducer/index.js

import { INCREASE } from '../actions/index'
import { GAME_LIST } from '../actions/index'
import { REQUSET_BEGIN, RECEIVED, REQUEST_END } from '../actions/http3Steps'
import { combineReducers } from "../module/redux";

//這是處理本例子中同步action的reducer
export const disposeIncrease = (state = 0, action) => {
  switch (action.type) {
    case INCREASE:
      console.log('redux is worked')
      return state + 1
    default:
      return state
  }
}

//這是處理本例中異步的reducer
const preState = {}

export const disposeFetch = (state = preState, action) => {
  switch (action.type) {
    case REQUSET_BEGIN + GAME_LIST:
      return {
        ...state,
        status: 'REQUEST_BEGIN',
      }
    case RECEIVED + GAME_LIST:
      return {
        ...state,
        status: 'RECEIVED',
        res: action.res
      }
    case REQUEST_END + GAME_LIST:
      return {
        ...state,
        status: 'REQUEST_END',
        err: action.err
      }
    default:
      return state
  }
}

//按照state的結構組合起來
export default combineReducers({
  theIncreasingNo: disposeIncrease,
  asyncData: disposeFetch
})

讓state變化時自動更新ui視圖

方法很簡單，在page的index.js中的onLoad函數裏面調用store.subscribe()方法監聽局部data.

onLoad: function () {
    const _this = this
    //在onLoad函數中訂閱state的更新
    //若是state變化，對應ui就會更新
    subscribe(() => {
      const { asyncData: { status }, theIncreasingNo } = getState()
      _this.setData({
        syncData: `
          請求狀態：${status}, 
          返回的數據請查看控制檯
        `,
        number: theIncreasingNo
      })
    })
  }

觸發動做，發出action，改變state

//index.js
import { store } from '../../app'
import { increase, fetch, GAME_LIST } from '../../actions/index'

const { dispatch, subscribe, getState } = store

Page({
  data: {
    syncData: 'Hello World',
    number: '0',
  },
  onLoad: function () {
    const _this = this
    //發出一個異步action
    dispatch(fetch(GAME_LIST, {
      url: 'http://open.douyucdn.cn/api/RoomApi/game'
    })).then((data) => { console.log(data) })
    //在onLoad函數中訂閱state的更新
    //若是state變化，對應ui就會更新
    subscribe(() => {
      const { asyncData: { status }, theIncreasingNo } = getState()
      _this.setData({
        syncData: `
          請求狀態：${status}, 
          返回的數據請查看控制檯
        `,
        number: theIncreasingNo
      })
    })
  },
  testSyncAction: function () {
    //發出一個同步action
    dispatch(increase)
  }
})

以下圖：

源文件

DEMO地址

實戰項目

稍後上傳，敬請期待。