React + Dva + Antd + Umi 快速入门

最近一个项目用了React + Dva + Antd + Umi技术栈，现处于慢慢摸索过程中，分享出来与大家共同学习进步。

基础框架概念先知道

React
前端三大框架之一。
Dva
由阿里架构师 sorrycc 带领 team 完成的一套前端框架，在作者的 github 里是这么描述它的：”dva 是 react 和 redux 的最佳实践”。
Antd
是阿里的一套开箱即用的中台前端/设计解决方案，UI框架。
Umi
一套可插拔的企业级 react 应用框架，同样由dva作者 sorrycc 完成。他在Umi中引入了 UI 工具 antd，打包工具 roadhog，路由 react-router和状态管理器 dva，做到了可插拔机制。

Dva 初实践

一般来说，可以分为主要的三个部分，models、services 和 views。其中，views负责页面上的展示，这个不做赘述；services里面主要写一些请求后台接口的方法；models是其中最重要的概念，这里存放了各种数据，并对数据进行相应的交互。

view层

import React, { Component } from 'react';
import { Form, Input } from 'antd';
import { connect } from 'dva/index';

@Form.create()
class View extends Component {
  render() {
    return(
      <div>
        <Form>
          <FormItem label="commitMessage" {...formItemLayout}>
            {getFieldDecorator('commitMessage', {
              rules: [{ type: 'string' }]
            })(<Input />)}
          </FormItem>
        </Form>
      </div>
        );
    }
}

const mapStateToProps = state => {
  const { 
    checkBranches
  } = state.projects;
  return {
    checkBranches
  };
};
export default connect(mapStateToProps)(View);

View层负责页面的展示问题，如React写法一致，最后通过connect方法应用model层的数据。

Service层

import request from '@src/utils/request';

export function checkBranches({ id }) {
  return request(`/projects/${id}/branches`, {
    method: 'GET',
    headers: {
      'Content-type': 'application/json'
    }
  });
}

Service层主要负责存放请求后台接口的方法。这里的request封装了fetch函数，返回的是一个promise对象。request中传入两个参数，第一个是url是请求地址，第二个options是请求的参数，看情况传入，比如说这里传入了method和headers。

Model层

import * as services from '@services/index';

export default {
  namespace: '',
  state: {},
  reducers: {},
  effects: {}.
  subscriptions: {}

model里面包括以下五部分：namespace、state、reducers、effects、subscriptions，缺一不可。注意，这里也需要从service层导入相应的方法。

namespace 命名空间

namespace: 'projects'

state 相当于原生React中的state状态，用于存放数据的初始值。

state: {
    projectsData: []
}

reducers 用于存放能够改变view的action，这里按照官方说明，不应该做数据的处理，只是用来return state，从而改变view层的展示。

reducers: {
    getProjectAllData(state, action) {
        return { ...state, ...action.payload };
    },
}

effects 用于和后台交互，是处理异步数据逻辑的地方。

effects: {
    *getAllProjects({ payload = {} }, { call, put }) {
        try {
            const res = yield call(projectsService.checkBranches, payload);
            yield put({
                type: 'getProjectData',
                payload: {
                    projectsData: res.data
                }
            });
        } catch (e) {
            message.warning(e.message);
        }
    },
}

subscriptions 订阅监听，比如监听路由，进入页面如何如何，就可以在这里处理。相当于原生React中的componentWillMount方法。就比如上述代码，监听/project路由，进入该路由页面后，将发起getAllProjects aciton，获取页面数据。

subscriptions: {
    setup({ dispatch, history }) {
        return history.listen(({ pathname }) => {
            if (pathname === '/projects') {
                dispatch({
                    type: 'getAllProjects'
                });
            }
        });
    }
}

Dva 数据流向

总的来说如下：View层操作 –> 触发models层effect中方法 –> 触发service层请求，获取后台数据 –> 触发model层处理相应数据的方法，存储至reducer中 –> 更新model层中state –> 触发view层的render方法进行重新渲染 –> 页面更新

如图所示

Dva数据流

参考资源

入门攻略就这么多啦，希望对你有所帮助。也欢迎一起探讨，共同进步。