文档章节

【转】基于 (react+dva+antd)完成用户管理的 CURD 应用,升级版antd-admin

wlc534
 wlc534
发布于 2017/09/12 10:36
字数 1777
阅读 184
收藏 2

本文会一步步引导大家如何创建一个 CURD 应用,包含查询、编辑、删除、创建,以及分页处理,数据 mock,自动处理 loading 状态等,基于 react, dva 和 antd 。

最终效果:

开始之前:

  • 确保 node 版本是 6.5 +
  • 用 cnpm 或 yarn 能节约你安装依赖的时间

Step 1. 安装 dva-cli 并创建应用

先安装 dva-cli,并确保版本是 0.7 或以上。

Shell

 

1

2

3

$ npm i dva-cli -g

$ dva -v

0.7.0

然后创建应用:

Shell

 

1

2

$ dva new user-dashboard

$ cd user-dashboard

 

Step 2. 配置 antd 和 babel-plugin-import

babel-plugin-import 用于按需引入 antd 的 JavaScript 和 CSS,这样打包出来的文件不至于太大。

Shell

 

1

2

$ npm i antd --save

$ npm i babel-plugin-import --save-dev

修改 .roadhogrc,在 "extraBabelPlugins" 里加上:

JavaScript

 

1

["import", { "libraryName": "antd", "style": "css" }]

 

Step 3. 配置代理,能通过 RESTFul 的方式访问http://localhost:8000/api/users

修改 .roadhogrc,加上 "proxy" 配置:

JavaScript

 

1

2

3

4

5

6

7

"proxy": {

  "/api": {

    "target": "http://jsonplaceholder.typicode.com/",

    "changeOrigin": true,

    "pathRewrite": { "^/api" : "" }

  }

},

然后启动应用:(这个命令一直开着,后面不需要重启)

Shell

 

1

$ npm start

浏览器会自动开启,并打开 http://localhost:8000 。

访问 http://localhost:8000/api/users ,就能访问到 http://jsonplaceholder.typicode.com/users 的数据。(由于 typicode.com 服务的稳定性,偶尔可能会失败。不过没关系,正好便于我们之后对于出错的处理)

68747470733a2f2f7a6f732e616c697061796f626a656374732e636f6d2f726d73706f7274616c2f6f4641504a6b78634959655a466a59415475554c2e706e67

Step 4. 生成 users 路由

用 dva-cli 生成路由:

Shell

 

1

$ dva g route users

然后访问 http://localhost:8000/#/users 。

Step 5. 构造 users model 和 service

用 dva-cli 生成 Model :

Shell

 

1

$ dva g model users

修改 src/models/users.js :

JavaScript

 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

import * as usersService from '../services/users';

 

export default {

  namespace: 'users',

  state: {

    list: [],

    total: null,

  },

  reducers: {

    save(state, { payload: { data: list, total } }) {

      return { ...state, list, total };

    },

  },

  effects: {

    *fetch({ payload: { page } }, { call, put }) {

      const { data, headers } = yield call(usersService.fetch, { page });

      yield put({ type: 'save', payload: { data, total: headers['x-total-count'] } });

    },

  },

  subscriptions: {

    setup({ dispatch, history }) {

      return history.listen(({ pathname, query }) => {

        if (pathname === '/users') {

          dispatch({ type: 'fetch', payload: query });

        }

      });

    },

  },

};

新增 src/services/users.js

JavaScript

 

1

2

3

4

5

import request from '../utils/request';

 

export function fetch({ page = 1 }) {

  return request(`/api/users?_page=${page}&_limit=5`);

}

由于我们需要从 response headers 中获取 total users 数量,所以需要改造下 src/utils/request.js

JavaScript

 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

import fetch from 'dva/fetch';

 

function checkStatus(response) {

  if (response.status >= 200 && response.status < 300) {

    return response;

  }

 

  const error = new Error(response.statusText);

  error.response = response;

  throw error;

}

 

/**

* Requests a URL, returning a promise.

*

* @param  {string} url       The URL we want to request

* @param  {object} [options] The options we want to pass to "fetch"

* @return {object}           An object containing either "data" or "err"

*/

export default async function request(url, options) {

  const response = await fetch(url, options);

 

  checkStatus(response);

 

  const data = await response.json();

 

  const ret = {

    data,

    headers: {},

  };

 

  if (response.headers.get('x-total-count')) {

    ret.headers['x-total-count'] = response.headers.get('x-total-count');

  }

 

  return ret;

}

切换到浏览器(会自动刷新),应该没任何变化,因为数据虽然好了,但并没有视图与之关联。但是打开 Redux 开发者工具,应该可以看到 users/fetch 和 users/save 的 action 以及相关的 state 。

68747470733a2f2f7a6f732e616c697061796f626a656374732e636f6d2f726d73706f7274616c2f44744e6f586a5141644d534a717a4f53455a416f2e706e67

Step 6. 添加界面,让用户列表展现出来

用 dva-cli 生成 component:

Shell

 

1

$ dva g component Users/Users

然后修改生成出来的 src/components/Users/Users.js 和 src/components/Users/Users.css,并在src/routes/Users.js 中引用他。具体参考这个 Commit

需留意两件事:

  1. 对 model 进行了微调,加入了 page 表示当前页
  2. 由于 components 和 services 中都用到了 pageSize,所以提取到 src/constants.js

改完后,切换到浏览器,应该能看到带分页的用户列表。

68747470733a2f2f7a6f732e616c697061796f626a656374732e636f6d2f726d73706f7274616c2f6763456c70527054446b7055456d72585247486e2e706e67

Step 7. 添加 layout

添加 layout 布局,使得我们可以在首页和用户列表页之间来回切换。

  1. 添加布局,src/components/MainLayout/MainLayout.js 和 CSS 文件
  2. 在 src/routes 文件夹下的文件中引用这个布局

参考这个 Commit

注意:

  1. 页头的菜单会随着页面切换变化,高亮显示当前页所在的菜单项

Step 8. 通过 dva-loading 处理 loading 状态

dva 有一个管理 effects 执行的 hook,并基于此封装了 dva-loading 插件。通过这个插件,我们可以不必一遍遍地写 showLoading 和 hideLoading,当发起请求时,插件会自动设置数据里的 loading 状态为 true 或 false 。然后我们在渲染 components 时绑定并根据这个数据进行渲染。

先安装 dva-loading :

Shell

 

1

$ npm i dva-loading --save

修改 src/index.js 加载插件,在合适的地方加入下面两句:

JavaScript

 

1

2

+ import createLoading from 'dva-loading';

+ app.use(createLoading());

然后在 src/components/Users/Users.js 里绑定 loading 数据:

JavaScript

 

1

+ loading: state.loading.models.users,

具体参考这个 Commit 。

切换到浏览器,你的用户列表有 loading 了没?

Step 9. 处理分页

只改一个文件 src/components/Users/Users.js 就好。

处理分页有两个思路:

  1. 发 action,请求新的分页数据,保存到 model,然后自动更新页面
  2. 切换路由 (由于之前监听了路由变化,所以后续的事情会自动处理)

我们用的是思路 2 的方式,好处是用户可以直接访问到 page 2 或其他页面。

参考这个 Commit 。

Step 10. 处理用户删除

经过前面的 9 步,应用的整体脉络已经清晰,相信大家已经对整体流程也有了一定了解。

后面的功能调整基本都可以按照以下三步进行:

  1. service
  2. model
  3. component

我们现在开始增加用户删除功能。

  1. service, 修改 src/services/users.js

    JavaScript

     

    1

    2

    3

    4

    5

    export function remove(id) {

      return request(`/api/users/${id}`, {

        method: 'DELETE',

      });

    }

  1. model, 修改 src/models/users.js

    JavaScript

     

    1

    2

    3

    4

    5

    *remove({ payload: id }, { call, put, select }) {

      yield call(usersService.remove, id);

      const page = yield select(state => state.users.page);

      yield put({ type: 'fetch', payload: { page } });

    },

  1. component, 修改 src/components/Users/Users.js,替换 deleteHandler 内容:

    JavaScript

     

    1

    2

    3

    4

    dispatch({

      type: 'users/remove',

      payload: id,

    });

切换到浏览器,删除功能应该已经生效。

Step 11. 处理用户编辑

处理用户编辑和前面的一样,遵循三步走:

  1. service
  2. model
  3. component

先是 service,修改 src/services/users.js

JavaScript

 

1

2

3

4

5

6

export function patch(id, values) {

  return request(`/api/users/${id}`, {

    method: 'PATCH',

    body: JSON.stringify(values),

  });

}

再是 model,修改 src/models/users.js

JavaScript

 

1

2

3

4

5

*patch({ payload: { id, values } }, { call, put, select }) {

  yield call(usersService.patch, id, values);

  const page = yield select(state => state.users.page);

  yield put({ type: 'fetch', payload: { page } });

},

最后是 component,详见 Commit

需要注意的一点是,我们在这里如何处理 Model 的 visible 状态,有几种选择:

  1. 存 dva 的 model state 里
  2. 存 component state 里

另外,怎么存也是个问题,可以:

  1. 只有一个 visible,然后根据用户点选的 user 填不同的表单数据
  2. 几个 user 几个 visible

此教程选的方案是 2-2,即存 component state,并且 visible 按 user 存。另外为了使用的简便,封装了一个UserModal 的组件。

完成后,切换到浏览器,应该就能对用户进行编辑了。

Step 12. 处理用户创建

相比用户编辑,用户创建更简单些,因为可以共用 UserModal 组件。和 Step 11 比较类似,就不累述了,详见 Commit 。

到这里,我们已经完成了一个完整的 CURD 应用。但仅仅是完成,并不完善,比如:

  • 如何处理错误,比如请求等
  • 如何处理请求超时
  • 如何根据路由动态加载 JS 和 CSS

请期待下一篇。

(完)

本文转载自:

共有 人打赏支持
wlc534
粉丝 4
博文 40
码字总数 37684
作品 0
DvaJS的学习之路1 —— dva+umi官网例子学习

前置知识 dva roadhog umi dva知识地图 使用 umi 改进 dva 项目开发 umi + dva,完成用户管理的 CURD 应用 本文主要是在 dva 作者 @sorrycc 的例子 umi + dva,完成用户管理的 CURD 应用 基础...

清秋
08/07
0
0
IDEMaker/IDEMaker-php开源订餐系统

IDEMaker开源订餐系统 IDEMaker开源订餐系统是-B2B2C商业化的开源项目平台 MVC设计架构模式,基于php+mysql的外卖订餐网站,包括前端,后台,商家后台。 源码演示地址:http://dingfan.fmlyne...

IDEMaker
2017/12/12
0
0
喜大普奔,Ant Design of Vue 1.0版本发布🎉🎉🎉

vue-antd-ui是一个站在巨人(antd)肩膀上的UI组件库,有着其它组件库没有的优势,几乎继承了antd所有的功能特点,自带antd各种buff。 vue-antd-ui诞生于17年9月份,18年3月份正式开源,800多次...

zeka
07/24
0
0
理解 Role, Policy 以及 Role-Based Access Control

本文主要讲解 Keystone 的两类基本服务,如下图蓝色部分: Assignment:包括 role 和 role assignment,用于描述某个 identity 对某个 resource 下的资源拥有的访问权限。 Policy:定义 Open...

koala bear
2014/02/10
0
0
智能 DNS 系统 wdDNS_v3 版本正式发布

wdDNS是由wdlinux团队于2011年推出的智能DNS解析系统,基于开源软件bind开发的高效,稳定的智能DNS系统支持WEB在线管理和操作设置,支持各大运营商线路解析,分省地区路智能解析等,支持一键...

wdlinuxcn
2017/06/26
1K
7

没有更多内容

加载失败,请刷新页面

加载更多

下一页

异步化,高并发大杀器

今天来聊聊如何让项目异步化的一些事。 在进入正文之前,顺便给大家推荐一个Java架构方面的交流学习群:698581634,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分...

Java大蜗牛
9分钟前
0
0
织梦dedecms安全设置

网站本身做好防范: 1、修改默认后台名。 打开网站根目录,找到[dede],这个文件夹就是后台的路径,可以随意修改,比如修改为[adminbuy],此时后台登陆的路径为:http://www.*****.com/admi...

雨季2014
10分钟前
0
0
完美Python入门基础知识点总结,看完你的Python就完全入门了!

Python标识符 在 Python 里,标识符有字母、数字、下划线组成。 在 Python 中,所有标识符可以包括英文、数字以及下划线(_),但不能以数字开头。 Python 中的标识符是区分大小写的。 以下划线...

糖宝lsh
16分钟前
0
0
Java关于前后台传输中文乱码以及Excel下载乱码解决

针对乱码,一般情况是前后台以及中间件编码格式不同导致.故需要保证编码格式相同即可. 1.前台页面格式指定,这里用的是jsp,故需要将pageEncoding指定为"UTF-8" 2.指定服务器编码格式,比如用的t...

勤奋的蚂蚁
18分钟前
0
0
Flutter组件 - Flexible

Flexible是一个控制Row、Column、Flex等子组件如何布局的组件。 Flexible组件可以使Row、Column、Flex等子组件在主轴方向有填充可用空间的能力(例如,Row在水平方向,Column在垂直方向),但是...

一箭落旄头
21分钟前
1
0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部