0%

一. 前言

本篇基于有来商城youlai-mall 微服务项目搭建的后台前端管理平台,技术选型Vue+element-ui实现前后端分离,解决方案选型vue-element-admin。希望通过本篇你可以改造vue-element-admin工程接入微服务接口实现前后端分离。

二. vue-element-admin下载启动

1. 下载

下载 vue-element-admin的i18n分支支持中文,下载地址https://github.com/PanJiaChen/vue-element-admin/tree/i18n

2. 启动

导入vue-element-admin至IDEA,执行npm install,如果安装慢或网络差的情况下请参考安装cnpm设置npm淘宝镜像源这篇文章安装cnpm,然后执行cnpm install安装依赖包。

依赖包安装完成之后,执行npm run dev本地启动项目,默认自动打开浏览器或者在浏览器打开地址栏输入http://localhost:9527
在这里插入图片描述

三. vue-element-admin后台接入

vue-element-admin项目默认走的是本地mock接口数据,那怎么接入到自己平台的后台接口呢?

1. mock接口信息

先看下vue-element-admin登录进入平台所需要的接口信息,如下图所示,是有两个关键接口
在这里插入图片描述

接口一:/user/login 登录认证获取token

接口二:/user/info?token=admin-token 根据token获取用户信息

2. 后台接口信息

按照上面的mock接口的数据格式编写对应的后台接口返回对应的数据格式

接口一: 登录认证获取token

youlai-mall整合SpringCloud Gateway+Spring Security OAuth2+JWT技术实现的登录认证接口,调用信息如下:

http://localhost:9999/youlai-auth/oauth/token

在这里插入图片描述

接口二: 获取用户信息

http://localhost:9999/youlai-admin/users/current

以上就是按照mock数据制作的后台接口。

3. 移除mock

1. vue.config.js

在这里插入图片描述

http://localhost:9999为后台地址

为什么添加配置devServer.proxy进行代理转发?

因为前后端分离,就算是本地开发,也会因为端口不同而满足 跨域请求条件的。

一般跨域是浏览器禁止的,服务器端之间并不禁止跨域(可以配置禁止)。

配置好代理之后,在项目启动时本地会启动一个node服务,浏览器先将请求发送到本地node服务,然后经由node服务将请求代理转发到后台,这样就可以避开浏览器跨域的问题。

具体原理详情可参照:node中跨域代理 proxyTable的原理是什么?

2. src/main.js
在这里插入图片描述

4. 替换mock为后台接口请求

1. src/api/user.js

接口URL替换: 修改登录认证和获取用户信息两个接口的后台请求路径,替换后如下图:

2. src/store/modules/user.js

认证接口参数: 首先看下登录入口: src/views/login/index.vue的handleLogin方法
在这里插入图片描述

this.$store.dispatch是Vuex状态管理中调用方式,具体操作是分发actions->调用mutations->改变state,其中action包含了异步操做,这是action与mutation的区别,也是dispatch和commit的区别。

明白this.$store.dispatch是做actions的分发,分发路径是/user/login,找到user模块文件src/store/modules/user.js,在文件中actions找到login方法,详情如下图:

在这里插入图片描述

OAuth2认证认证接口还需补上3个参数:

参数值

参数名

参数描述

grant_type

password

OAuth2授权方式:密码式

client_id

client

客户端ID

client_secret

123456

客户端密钥

补全参数后如下:

3.src/utils/request.js

修改数据上传默认为JSON格式


修改请求头
在这里插入图片描述
修改成功响应状态码
在这里插入图片描述

5. 接入后台登录测试

在这里插入图片描述
在这里插入图片描述

到这里就完成了vue-element-admin移除mock接入到后台的功能

四. 搭建管理前端

通过上面步骤,我们已成功改造vue-element-admin接入到后台接口,接下来我们以管理平台的用户管理功能为例讲述如何使用vue-element-admin搭建我们自己的管理平台。

1. 删除多余文件

删除mock文件夹

删除views下除了dashboard、error-page、login、profile、redirect之外的文件夹

2. 引入用户管理

新增user.js接口、user/index.vue用户页面,完整代码文章结尾获取,结构如下图所示:

在这里插入图片描述

3. 路由配置

修改路由配置文件 src/router/index.js,其中有静态路由constantRoutes和权限路由asyncRoutes需要修改。

静态路由删减保留如下:

权限路由删减,并新增用户管理路由如下:

4. 验证用户管理

执行npm run dev再次打开系统,登录后界面如下:

可以看到,管理平台中的用户管理已成功集成到我们改造后的vue-element-admin工程,其他功能搭建按照同样方法即可。

五. 结语

本篇就如何改造vue-element-admin接入到后台实现youlai-mall后台前端管理平台的搭建。其中涉及的前后端分离解决浏览器跨域问题的解决原理,vuex、vue-router的应用,觉得很有意义去亲手实践一下。最后附上完整代码下载地址,出现问题可比对改造完成的项目:

youlai-mall

youlai-mall-admin

__EOF__