功能21:使用axios发送请求
text
功能20:使用分页插件
功能19:集成MyBatis-Plus
功能18:创建后端工程
功能17:菜单管理
功能16:角色管理
功能15:用户管理
功能14:使用本地SVG图标库
功能13:侧边栏加入Logo
功能12:折叠/展开侧边栏
功能11:实现面包屑功能
功能10:添加首页菜单项
功能9:退出登录功能
功能8:页面权限控制
功能7:路由全局前置守卫
功能6:动态添加路由记录
功能5:侧边栏菜单动态显示
功能4:首页使用Layout布局
功能3:点击登录按钮实现页面跳转
功能2:静态登录界面
功能1:创建前端项目
前言
Axios 是一个基于 Promise 的现代化 HTTP 客户端库,广泛应用于浏览器和 Node.js 环境。它简化了前端与后端的数据交互,具备拦截器、自动 JSON 转换、请求取消等强大功能,成为替代原生 fetch 的热门选择。
一.操作步骤
1.安装
bash
pnpm add axios
2.axios自定义实例
新建文件:src\utils\request.js
js
import axios from 'axios'
// 创建axios实例
const service = axios.create({
// axios中请求配置有baseURL选项,表示请求URL公共部分
baseURL: import.meta.env.VITE_APP_BASE_API,
// 超时
timeout: 10000,
headers: {
'Content-Type': 'application/json;charset=utf-8'
}
})
// 响应拦截器
service.interceptors.response.use(res => {
return Promise.resolve(res.data)
},
error => {
return Promise.reject(error)
}
)
export default service
3.修改user.js
将原来模拟的数据,替换成使用axios发送GET请求。
js
import request from '@/utils/request'
// 查询用户列表
export function listUser(query) {
return request({
url: '/system/user/list',
method: 'get',
params: query
})
}
4.修改工具类ruoyi.js
增加一个工具函数。
js
/**
* 将日期范围添加到查询参数对象中,支持自定义属性名前缀
* @function addDateRange
* @param {Object} queryParams - 原始查询参数对象
* @param {Array} dateRange - 日期范围数组,包含起始和结束时间
* @param {string} [propName] - 自定义日期范围的属性名前缀(可选)
* @returns {Object} 处理后的查询参数对象,包含添加的日期范围参数
* @example
* // 基本用法:添加beginTime和endTime
* const params = { params: {} };
* addDateRange(params, ['2023-01-01', '2023-01-31']);
* // 返回: { params: { beginTime: '2023-01-01', endTime: '2023-01-31' } }
*
* @example
* // 带前缀用法:添加beginOrder和endOrder
* const params = { params: { page: 1 } };
* addDateRange(params, ['2023-01-01', '2023-01-31'], 'Order');
* // 返回: { params: { page:1, beginOrder: '2023-01-01', endOrder: '2023-01-31' } }
*/
export function addDateRange(queryParams, dateRange, propName) {
let search = queryParams;
search.params = typeof (search.params) === 'object' && search.params !== null && !Array.isArray(search.params) ? search.params : {};
dateRange = Array.isArray(dateRange) ? dateRange : [];
if (typeof (propName) === 'undefined') {
search.params['beginTime'] = dateRange[0];
search.params['endTime'] = dateRange[1];
} else {
search.params['begin' + propName] = dateRange[0];
search.params['end' + propName] = dateRange[1];
}
return search;
}
5.修改用户管理模板
查询时带上分页信息。
bash
import { parseTime, addDateRange } from '@/utils/ruoyi'
/** 查询用户列表 */
function getList() {
loading.value = true;
listUser(addDateRange(queryParams.value, dateRange.value)).then(res => {
loading.value = false;
userList.value = res.rows;
total.value = res.total;
});
};
6.vite.config.js
配置代理proxy
作用
:配置反向代理,解决跨域问题或转发 API 请求。
详解
:将特定请求转发到后端服务器,避免浏览器直接请求不同源的 API。
代理配置项:/dev-api
target: 'http://localhost:8080'
目标服务器地址,所有匹配的请求会被转发到此 URL。
此处后端服务运行在本地 8080 端口。
changeOrigin: true
修改请求头中的 Origin 为目标 URL 的域名。
绕过某些后端服务器的同源策略检查,避免被拒绝。
示例:前端请求 Origin: http://localhost:80 → 代理后变为 Origin: http://localhost:8080。
rewrite: § => p.replace(/^/dev-api/, '')
重写请求路径,移除 /dev-api 前缀。
示例:/dev-api/user → /user。
目的:前端代码统一使用 /dev-api 前缀发起请求,代理转发时去掉该前缀,适配后端实际路径。
bash
// vite 相关配置
server: {
host: true,
open: true,
proxy: {
'/dev-api': {
target: 'http://localhost:8080',
changeOrigin: true,
rewrite: (p) => p.replace(/^\/dev-api/, '')
}
}
},
二.功能验证
运行项目,浏览器访问http://localhost:5173/system/user
列表显示的数据跟数据库一致。