React应用框架DvaJs入门

我不是女神ヾ 2021-09-24 08:44 292阅读 0赞

## 1 什么是Dva? ##

dva 首先是一个基于 [redux][] 和 [redux-saga][] 的数据流方案，然后为了简化开发体验，dva 还额外内置了 [react-router][] 和 [fetch][]，所以也可以理解为一个轻量级的应用框架。

## 2 特性 ##

*  **易学易用**，仅有 6 个 api，对 redux 用户尤其友好，[配合 umi 使用][umi]后更是降低为 0 API
 *  **elm 概念**，通过 reducers, effects 和 subscriptions 组织 model
 *  **插件机制**，比如 [dva-loading][] 可以自动处理 loading 状态，不用一遍遍地写 showLoading 和 hideLoading
 *  **支持 HMR**，基于 [babel-plugin-dva-hmr][] 实现 components、routes 和 models 的 HMR

## 3 Dva中常见的概念 ##

## 4 数据流向 ##

数据的改变发生通常是通过用户交互行为或者浏览器行为（如路由跳转等）触发的，当此类行为会改变数据的时候可以通过 `dispatch` 发起一个 action，如果是同步行为会直接通过 `Reducers` 改变 `State` ，如果是异步行为（副作用）会先触发 `Effects` 然后流向 `Reducers` 最终改变 `State`，所以在 dva 中，数据流向非常清晰简明，并且思路基本跟开源社区保持一致（也是来自于开源社区）。

![format_png][]

## 5 Models ##

### State ###

`type State = any`

State 表示 Model 的状态数据，通常表现为一个 javascript 对象（当然它可以是任何值）；操作的时候每次都要当作不可变数据（immutable data）来对待，保证每次都是全新对象，没有引用关系，这样才能保证 State 的独立性，便于测试和追踪变化。

在 dva 中你可以通过 dva 的实例属性 `_store` 看到顶部的 state 数据，但是通常你很少会用到:

const app = dva();
    console.log(app._store); // 顶部的 state 数据

### Action ###

`type AsyncAction = any`

Action 是一个普通 javascript 对象，它是改变 State 的唯一途径。无论是从 UI 事件、网络回调，还是 WebSocket 等数据源所获得的数据，最终都会通过 dispatch 函数调用一个 action，从而改变对应的数据。action 必须带有 `type` 属性指明具体的行为，其它字段可以自定义，如果要发起一个 action 需要使用 `dispatch` 函数；需要注意的是 `dispatch` 是在组件 connect Models以后，通过 props 传入的。

dispatch({
      type: 'add',
    });

### dispatch 函数 ###

`type dispatch = (a: Action) => Action`

dispatching function 是一个用于触发 action 的函数，action 是改变 State 的唯一途径，但是它只描述了一个行为，而 dipatch 可以看作是触发这个行为的方式，而 Reducer 则是描述如何改变数据的。

在 dva 中，connect Model 的组件通过 props 可以访问到 dispatch，可以调用 Model 中的 Reducer 或者 Effects，常见的形式如：

dispatch({
      type: 'user/add', // 如果在 model 外调用，需要添加 namespace
      payload: {}, // 需要传递的信息
    });

### Reducer ###

`type Reducer<S, A> = (state: S, action: A) => S`

Reducer（也称为 reducing function）函数接受两个参数：之前已经累积运算的结果和当前要被累积的值，返回的是一个新的累积结果。该函数把一个集合归并成一个单值。

Reducer 的概念来自于是函数式编程，很多语言中都有 reduce API。如在 javascript 中：

[{x:1},{y:2},{z:3}].reduce(function(prev, next){
        return Object.assign(prev, next);
    })
    //return {x:1, y:2, z:3}

在 dva 中，reducers 聚合积累的结果是当前 model 的 state 对象。通过 actions 中传入的值，与当前 reducers 中的值进行运算获得新的值（也就是新的 state）。需要注意的是 Reducer 必须是[纯函数][Link 1]，所以同样的输入必然得到同样的输出，它们不应该产生任何副作用。并且，每一次的计算都应该使用[immutable data][]，这种特性简单理解就是每次操作都是返回一个全新的数据（独立，纯净），所以热重载和时间旅行这些功能才能够使用。

### Effect ###

Effect 被称为副作用，在我们的应用中，最常见的就是异步操作。它来自于函数编程的概念，之所以叫副作用是因为它使得我们的函数变得不纯，同样的输入不一定获得同样的输出。

dva 为了控制副作用的操作，底层引入了[redux-sagas][]做异步流程控制，由于采用了[generator的相关概念][generator]，所以将异步转成同步写法，从而将effects转为纯函数。至于为什么我们这么纠结于 **纯函数**，如果你想了解更多可以阅读[Mostly adequate guide to FP][]，或者它的中文译本[JS函数式编程指南][JS]。

### Subscription ###

Subscriptions 是一种从 **源** 获取数据的方法，它来自于 elm。

Subscription 语义是订阅，用于订阅一个数据源，然后根据条件 dispatch 需要的 action。数据源可以是当前的时间、服务器的 websocket 连接、keyboard 输入、geolocation 变化、history 路由变化等等。

import key from 'keymaster';
    ...
    app.model({
      namespace: 'count',
      subscriptions: {
        keyEvent({dispatch}) {
          key('⌘+up, ctrl+up', () => { dispatch({type:'add'}) });
        },
      }
    });

## 6 Router ##

这里的路由通常指的是前端路由，由于我们的应用现在通常是单页应用，所以需要前端代码来控制路由逻辑，通过浏览器提供的 [History API][] 可以监听浏览器url的变化，从而控制路由相关操作。

dva 实例提供了 router 方法来控制路由，使用的是[react-router][react-router 1]。

import { Router, Route } from 'dva/router';
    app.router(({history}) =>
      <Router history={history}>
        <Route path="/" component={HomePage} />
      </Router>
    );

## 7 Route Components ##

在[组件设计方法][Link 2]中，我们提到过 Container Components，在 dva 中我们通常将其约束为 Route Components，因为在 dva 中我们通常以页面维度来设计 Container Components。

所以在 dva 中，通常需要 connect Model的组件都是 Route Components，组织在`/routes/`目录下，而`/components/`目录下则是纯组件（Presentational Components）。

# 8 入门课 #

## React 没有解决的问题 ##

React 本身只是一个 DOM 的抽象层，使用组件构建虚拟 DOM。

如果开发大应用，还需要解决一个问题。

*  通信：组件之间如何通信？
 *  数据流：数据如何和视图串联起来？路由和数据如何绑定？如何编写异步逻辑？等等

## 通信问题 ##

组件会发生三种通信。

*  向子组件发消息
 *  向父组件发消息
 *  向其他组件发消息

React 只提供了一种通信手段：传参。对于大应用，很不方便。

## 组件通信的例子 ##

### 步骤1 ###

class Son extends React.Component {
      render() {
        return <input/>;
      }
    }
    
    class Father extends React.Component {
      render() {
        return <div>
          <Son/>
          <p>这里显示 Son 组件的内容</p>
        </div>;
      }
    }
    
    ReactDOM.render(<Father/>, mountNode);

看这个例子，想一想父组件如何拿到子组件的值。

### 步骤2 ###

class Son extends React.Component {
      render() {
        return <input onChange={this.props.onChange}/>;
      }
    }
    
    class Father extends React.Component {
      constructor() {
        super();
        this.state = {
          son: ""
        }
      }
      changeHandler(e) {
        this.setState({
          son: e.target.value
        });
      }
      render() {
        return <div>
          <Son onChange={this.changeHandler.bind(this)}/>
          <p>这里显示 Son 组件的内容：{this.state.son}</p>
        </div>;
      }
    }
    
    ReactDOM.render(<Father/>, mountNode);

看下这个例子，看懂源码，理解子组件如何通过父组件传入的函数，将自己的值再传回父组件。

## 数据流问题 ##

目前流行的数据流方案有：

*  Flux，单向数据流方案，以 [Redux][] 为代表
 *  Reactive，响应式数据流方案，以 [Mobx][] 为代表
 *  其他，比如 rxjs 等

到底哪一种架构最合适 React ？

## 目前最流行的数据流方案 ##

截止 2017.1，最流行的社区 React 应用架构方案如下。

*  路由： [React-Router][]
 *  架构： [Redux][]
 *  异步操作： [Redux-saga][]

缺点：要引入多个库，项目结构复杂。

## dva 是什么 ##

dva 是体验技术部开发的 React 应用框架，将上面三个 React 工具库包装在一起，简化了 API，让开发 React 应用更加方便和快捷。

dva = React-Router + Redux + Redux-saga

## dva 应用的最简结构 ##

import dva from 'dva';
    const App = () => <div>Hello dva</div>;
    
    // 创建应用
    const app = dva();
    // 注册视图
    app.router(() => <App />);
    // 启动应用
    app.start('#root');

## 数据流图 ##

![format_png 1][]

## 核心概念 ##

*  State：一个对象，保存整个应用状态
 *  View：React 组件构成的视图层
 *  Action：一个对象，描述事件
 *  connect 方法：一个函数，绑定 State 到 View
 *  dispatch 方法：一个函数，发送 Action 到 State

## State 和 View ##

State 是储存数据的地方，收到 Action 以后，会更新数据。

View 就是 React 组件构成的 UI 层，从 State 取数据后，渲染成 HTML 代码。只要 State 有变化，View 就会自动更新。

## Action ##

Action 是用来描述 UI 层事件的一个对象。

{
      type: 'click-submit-button',
      payload: this.form.data
    }

## connect 方法 ##

connect 是一个函数，绑定 State 到 View。

import { connect } from 'dva';
    
    function mapStateToProps(state) {
      return { todos: state.todos };
    }
    connect(mapStateToProps)(App);

connect 方法返回的也是一个 React 组件，通常称为容器组件。因为它是原始 UI 组件的容器，即在外面包了一层 State。

connect 方法传入的第一个参数是 mapStateToProps 函数，mapStateToProps 函数会返回一个对象，用于建立 State 到 Props 的映射关系。

## dispatch 方法 ##

dispatch 是一个函数方法，用来将 Action 发送给 State。

dispatch({
      type: 'click-submit-button',
      payload: this.form.data
    })

dispatch 方法从哪里来？被 connect 的 Component 会自动在 props 中拥有 dispatch 方法。

> connect 的数据从哪里来?

## dva 应用的最简结构（带 model) ##

// 创建应用
    const app = dva();
    
    // 注册 Model
    app.model({
      namespace: 'count',
      state: 0,
      reducers: {
        add(state) { return state + 1 },
      },
      effects: {
        *addAfter1Second(action, { call, put }) {
          yield call(delay, 1000);
          yield put({ type: 'add' });
        },
      },
    });
    
    // 注册视图
    app.router(() => <ConnectedApp />);
    
    // 启动应用
    app.start('#root');

## 数据流图 1 ##

![format_png 2][]

## 数据流图 2 ##

![format_png 3][]

## app.model ##

dva 提供 app.model 这个对象，所有的应用逻辑都定义在它上面。

const app = dva();
    
    // 新增这一行
    app.model({ /**/ });
    
    app.router(() => <App />);
    app.start('#root');

## Model 对象的例子 ##

{
      namespace: 'count',
      state: 0,
      reducers: {
        add(state) { return state + 1 },
      },
      effects: {
        *addAfter1Second(action, { call, put }) {
          yield call(delay, 1000);
          yield put({ type: 'add' });
        },
      },
    }

## Model 对象的属性 ##

*  namespace: 当前 Model 的名称。整个应用的 State，由多个小的 Model 的 State 以 namespace 为 key 合成
 *  state: 该 Model 当前的状态。数据保存在这里，直接决定了视图层的输出
 *  reducers: Action 处理器，处理同步动作，用来算出最新的 State
 *  effects：Action 处理器，处理异步动作

## Reducer ##

Reducer 是 Action 处理器，用来处理同步操作，可以看做是 state 的计算器。它的作用是根据 Action，从上一个 State 算出当前 State。

一些例子：

// count +1
    function add(state) { return state + 1; }
    
    // 往 [] 里添加一个新 todo
    function addTodo(state, action) { return [...state, action.payload]; }
    
    // 往 { todos: [], loading: true } 里添加一个新 todo，并标记 loading 为 false
    function addTodo(state, action) {
      return {
        ...state,
        todos: state.todos.concat(action.payload),
        loading: false
      };
    }

## Effect ##

Action 处理器，处理异步动作，基于 Redux-saga 实现。Effect 指的是副作用。根据函数式编程，计算以外的操作都属于 Effect，典型的就是 I/O 操作、数据库读写。

function *addAfter1Second(action, { put, call }) {
      yield call(delay, 1000);
      yield put({ type: 'add' });
    }

## Generator 函数 ##

Effect 是一个 Generator 函数，内部使用 yield 关键字，标识每一步的操作（不管是异步或同步）。

## call 和 put ##

dva 提供多个 effect 函数内部的处理函数，比较常用的是 `call` 和 `put`。

*  call：执行异步函数
 *  put：发出一个 Action，类似于 dispatch

原文链接-DvaJs官网：[https://dvajs.com/guide/][https_dvajs.com_guide]

写博客是为了记住自己容易忘记的东西，另外也是对自己工作的总结，希望尽自己的努力，做到更好，大家一起努力进步！  
  
如果有什么问题，欢迎大家评论，一起探讨，代码如有问题，欢迎各位大神指正！  
  
给自己的梦想添加一双翅膀，让它可以在天空中自由自在的飞翔！

[redux]: https://github.com/reduxjs/redux
[redux-saga]: https://github.com/redux-saga/redux-saga
[react-router]: https://github.com/ReactTraining/react-router
[fetch]: https://github.com/github/fetch
[umi]: https://umijs.org/guide/with-dva.html
[dva-loading]: https://github.com/dvajs/dva/tree/master/packages/dva-loading
[babel-plugin-dva-hmr]: https://github.com/dvajs/babel-plugin-dva-hmr
[format_png]: /images/20210923/6b8a6d40f71b45bd9f8fa286dc16ad37.png
[Link 1]: https://github.com/MostlyAdequate/mostly-adequate-guide/blob/master/ch3.md
[immutable data]: https://github.com/MostlyAdequate/mostly-adequate-guide/blob/master/ch3.md#reasonable
[redux-sagas]: http://superraytin.github.io/redux-saga-in-chinese
[generator]: http://www.ruanyifeng.com/blog/2015/04/generator.html
[Mostly adequate guide to FP]: https://github.com/MostlyAdequate/mostly-adequate-guide
[JS]: https://www.gitbook.com/book/llh911001/mostly-adequate-guide-chinese/details
[History API]: http://mdn.beonex.com/en/DOM/window.history.html
[react-router 1]: https://github.com/reactjs/react-router
[Link 2]: https://github.com/dvajs/dva-docs/blob/master/v1/zh-cn/tutorial/04-%E7%BB%84%E4%BB%B6%E8%AE%BE%E8%AE%A1%E6%96%B9%E6%B3%95.md
[Redux]: https://github.com/reactjs/redux
[Mobx]: https://github.com/mobxjs/mobx
[React-Router]: https://github.com/ReactTraining/react-router/tree/v2.8.1
[Redux-saga]: https://github.com/yelouafi/redux-saga
[format_png 1]: /images/20210923/1ba2263fa1884d19bfd4e4921a6132d0.png
[format_png 2]: /images/20210923/b65602b0aeec47b0a5eb4cbc8ab320c8.png
[format_png 3]: /images/20210923/2cf84846b23a4a44aba85b2427efcabc.png
[https_dvajs.com_guide]: https://dvajs.com/guide/