本文主要讲述,在微信小程序中如何使用redux
- 如何在小程序中引入redux状态管理库,及它相关的插件?
- 微信小程序没有清晰的异步api,便于thunkMiddleware处理异步请求(异步操作),如何解决?
- 如何正确使用store的三大核心方法(
getStore
dispatch
subscribe
)?
redux并不是react专属,所以他可以在任何地方使用,小程序也不例外。解决上面三个问题就可以了。
- 使用
npm
在临时目录里安装redux
和其他你需要用到的包,如:logger
thunkMiddleware
。这里以redux示例。 - 进入
node_module
中,拷贝如下文件:\redux\dist\redux.js
或者\redux\dist\redux.min.js
- 根据1/2中的步骤。把
redux.js
logger.js
thunkMiddleware
都拷贝到小程序项目文件夹\module
目录下,没有请新建。
前面有文章已经写过,如何将微信异步api转换为Promise,便于异步编程:把微信小程序异步API转为Promise,简化异步编程
读完会,把to-promise
库和redux
一样放在\module
文件夹下
这也是最关键的
- 在
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)
}
})
如下图: