一、下载项目并且运行

RuoYi-Vue: 🎉 基于SpringBoot，Spring Security，JWT，Vue & Element 的前后端分离权限管理系统，同时提供了 Vue3 的版本 (gitee.com)

前端

其中的 ruoyi-ui是前端项目，除了 ruoyi-ui是前端项目其余的都是后端的，可单独把 ruoyi-ui剪切出来！！！！

执行：npm install --registry=https://registry.npmmirror.com 下载的速度会快一点，尽量不要用cnpm

启动：npm run dev

后端

除了 ruoyi-ui是前端项目其余的都是后端的，放到IDEA中加载依赖，正常情况就直接等加载完毕即可，不会有报错，要是出现依赖报错的情况记得切换一下网络试试。

数据库文件quartz.sql 和ry_202******.sql都要运行

• 注意

修改ruoyi-admin 下的resources中 ：application-druid.yml 里数据库的用户名和密码【数据库名字要是不一样记得修改一下】

然后既可以去运行了：运行的启动类在ruoyi-admin下的java文件里RuoYiApplication

这样就运行起来了：登录的账号密码：admin /admin123

二、所有的封装剖析

01、前端对axios的封装

ruoyi的前端对axios进行了封装，让我们发get请求或者是post请求更加方便了。

虽然axios对request已经进行过封装了，为什么还要进行再次封装？原因就是为了提供高开发效率😊

ruoyi对axios的封装在request.js文件中

主要是：请求拦截器、响应拦截器、通用下载方法三部分

1)请求拦截器

Get

request拦截器对我们发送的请求进行了封装，当我们发送Get请求，那么我们携带参数的时候应该用param[是要拼接在链接上的]。对应下面的源码。

  // get请求映射params参数if (config.method === 'get' && config.params) {let url = config.url + '?' + tansParams(config.params);url = url.slice(0, -1);config.params = {};config.url = url;}
tansParams()是参数处理的方法，有兴趣可以看一下是怎么实现url拼接的

通过此这简单的代码，可以让get请求自动变为我们熟悉的形式[http://localhost:8080/view/list?key1=value1&key2=value2]

举个例子：

// 查询在线用户列表
export function list(query) {return request({url: '/monitor/online/list',method: 'get',params: query})
}
带参数链接：  http://localhost/dev-api/monitor/online/list不带参数链接：http://localhost/dev-api/monitor/online/list?ipaddr=127.0.0.1&userName=admin

既然用到了在线用户这个例子，那么这个功能是怎么实现的呢？

ruoyi的在线用户存在redis中的，每次一个人登录，就会把他的登录信息存在redis中，当我们去查询在线用户，无非就是去redis中取一下有哪一些用户罢了！

想要在其他项目里实现这个功能的朋友可以在debug模式下使用快捷键ctrl+shift+R搜索/monitor/online 打断点看看具体实现过程。这里就不过多叙述了！

Post

Post请求带参数则使用data。

 // post请求携带data对象if (!isRepeatSubmit && (config.method === 'post' || config.method === 'put')) {const requestObj = {url: config.url,data: typeof config.data === 'object' ? JSON.stringify(config.data) : config.data,time: new Date().getTime()}const sessionObj = cache.session.getJSON('sessionObj')if (sessionObj === undefined || sessionObj === null || sessionObj === '') {cache.session.setJSON('sessionObj', requestObj)} else {const s_url = sessionObj.url;                  // 请求地址const s_data = sessionObj.data;                // 请求数据const s_time = sessionObj.time;                // 请求时间const interval = 1000;                         // 间隔时间(ms)，小于此时间视为重复提交if (s_data === requestObj.data && requestObj.time - s_time < interval && s_url === requestObj.url) {const message = '数据正在处理，请勿重复提交';console.warn(`[${s_url}]: ` + message)return Promise.reject(new Error(message))} else {cache.session.setJSON('sessionObj', requestObj)}}}

2)响应拦截器

用于每一个响应的拦截过滤处理。

对不同状态码进行判断给出处理逻辑，并不是特别重要。

3)通用下载方法

ruoyi许多地方用到下载，比如说“字典管理”，里面可以导出。

4)附：request.js的源码

import axios from 'axios'
import {Notification, MessageBox, Message, Loading} from 'element-ui'
import store from '@/store'
import {getToken} from '@/utils/auth'
import errorCode from '@/utils/errorCode'
import {tansParams, blobValidate} from "@/utils/ruoyi";
import cache from '@/plugins/cache'
import {saveAs} from 'file-saver'let downloadLoadingInstance;
// 是否显示重新登录
export let isRelogin = {show: false};axios.defaults.headers['Content-Type'] = 'application/json;charset=utf-8'
// 创建axios实例
const service = axios.create({// axios中请求配置有baseURL选项，表示请求URL公共部分baseURL: process.env.VUE_APP_BASE_API,// 超时timeout: 10000
})// request拦截器
service.interceptors.request.use(config => {// 是否需要设置 tokenconst isToken = (config.headers || {}).isToken === false// 是否需要防止数据重复提交const isRepeatSubmit = (config.headers || {}).repeatSubmit === falseif (getToken() && !isToken) {config.headers['Authorization'] = 'Bearer ' + getToken() // 让每个请求携带自定义token 请根据实际情况自行修改}// get请求映射params参数if (config.method === 'get' && config.params) {let url = config.url + '?' + tansParams(config.params);url = url.slice(0, -1);config.params = {};config.url = url;}if (!isRepeatSubmit && (config.method === 'post' || config.method === 'put')) {const requestObj = {url: config.url,data: typeof config.data === 'object' ? JSON.stringify(config.data) : config.data,time: new Date().getTime()}const sessionObj = cache.session.getJSON('sessionObj')if (sessionObj === undefined || sessionObj === null || sessionObj === '') {cache.session.setJSON('sessionObj', requestObj)} else {const s_url = sessionObj.url;                  // 请求地址const s_data = sessionObj.data;                // 请求数据const s_time = sessionObj.time;                // 请求时间const interval = 1000;                         // 间隔时间(ms)，小于此时间视为重复提交if (s_data === requestObj.data && requestObj.time - s_time < interval && s_url === requestObj.url) {const message = '数据正在处理，请勿重复提交';console.warn(`[${s_url}]: ` + message)return Promise.reject(new Error(message))} else {cache.session.setJSON('sessionObj', requestObj)}}}return config
}, error => {console.log(error)Promise.reject(error)
})// 响应拦截器
service.interceptors.response.use(res => {// 未设置状态码则默认成功状态const code = res.data.code || 200;// 获取错误信息const msg = errorCode[code] || res.data.msg || errorCode['default']// 二进制数据则直接返回if (res.request.responseType === 'blob' || res.request.responseType === 'arraybuffer') {return res.data}if (code === 401) {if (!isRelogin.show) {isRelogin.show = true;MessageBox.confirm('登录状态已过期，您可以继续留在该页面，或者重新登录', '系统提示', {confirmButtonText: '重新登录',cancelButtonText: '取消',type: 'warning'}).then(() => {isRelogin.show = false;store.dispatch('LogOut').then(() => {location.href = '/index';})}).catch(() => {isRelogin.show = false;});}return Promise.reject('无效的会话，或者会话已过期，请重新登录。')} else if (code === 500) {Message({message: msg, type: 'error'})return Promise.reject(new Error(msg))} else if (code === 601) {Message({message: msg, type: 'warning'})return Promise.reject('error')} else if (code !== 200) {Notification.error({title: msg})return Promise.reject('error')} else {return res.data}},error => {console.log('err' + error)let {message} = error;if (message == "Network Error") {message = "后端接口连接异常";} else if (message.includes("timeout")) {message = "系统接口请求超时";} else if (message.includes("Request failed with status code")) {message = "系统接口" + message.substr(message.length - 3) + "异常";}Message({message: message, type: 'error', duration: 5 * 1000})return Promise.reject(error)}
)// 通用下载方法
export function download(url, params, filename, config) {downloadLoadingInstance = Loading.service({text: "正在下载数据，请稍候",spinner: "el-icon-loading",background: "rgba(0, 0, 0, 0.7)",})return service.post(url, params, {transformRequest: [(params) => {return tansParams(params)}],headers: {'Content-Type': 'application/x-www-form-urlencoded'},responseType: 'blob',...config}).then(async (data) => {const isBlob = blobValidate(data);if (isBlob) {const blob = new Blob([data])saveAs(blob, filename)} else {const resText = await data.text();const rspObj = JSON.parse(resText);const errMsg = errorCode[rspObj.code] || rspObj.msg || errorCode['default']Message.error(errMsg);}downloadLoadingInstance.close();}).catch((r) => {console.error(r)Message.error('下载文件出现错误，请联系管理员！')downloadLoadingInstance.close();})
}export default service

持续更新中…