我们需要进行前后端分离开发,那么前后端的跨域问题就是无可避免的问题,前后端的请求也是无可避免的,Vue开发可以使用一个请求组件,做到跨域请求,这个组件就是axios,我们可以对axios进行封装作为我们请求的工具组件
npm install axios; // 安装axios
npm install qs; // 安装qs,序列化数据
// 在http.js中引入axios
import axios from 'axios'; // 引入axios
import QS from 'qs'; // 引入qs模块,用来序列化post类型的数据,后面会提到
一般我会在项目的src目录中,新建一个utils文件夹,然后在里面新建一个request.js文件作为封装的工具类,新建一个api文件夹,在里面建一个api.js文件用来统一管理我们的接口。
import axios from 'axios'; // 引入axios
const instance = axios.create({
baseURL: 'http//:localhost:8090/api',
timeout: 6000
})
export default instance
我们的项目环境可能有开发环境【dev】、测试环境【】和生产环境【prod】。我们通过node的环境变量来匹配我们的默认的接口url前缀。axios.defaults.baseURL可以设置axios的默认请求地址
// 环境的切换
if (process.env.NODE_ENV == 'development') {
axios.defaults.baseURL = 'http//:localhost:8090/api';}
else if (process.env.NODE_ENV == 'debug') {
axios.defaults.baseURL = 'http//:localhost:8090/api';
}
else if (process.env.NODE_ENV == 'production') {
axios.defaults.baseURL = 'http//:localhost:8090/api';
}
axios.defaults.timeout=6000 //设置请求超时时间,单位为毫秒
设置默认的post请求头,当需要使用其他请求头的时候,可以直接在请求方法之中写,
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded;charset=UTF-8'
请求拦截是作为我们在发送请求的时候作为一个拦截校验
最常见的就是校验是否登录
可以搭配vuex进行全局变量使用
// vuex的路径根据自己的路径去写
import store from '@/store/index';
// 请求拦截器
axios.interceptors.request.use(
config => {
// 每次发送请求之前判断vuex中是否存在token
// 如果存在,则统一在http请求的header都加上token,这样后台根据token判断你的登录情况
// 即使本地存在token,也有可能token是过期的,所以在响应拦截器中要对返回状态进行判断
const token = store.state.token;
token && (config.headers.Authorization = token);
return config;
},
error => {
return Promise.error(error);
})
如果我们的所有请求响应格式是一致的,那么我们可以根据响应的状态码进行响应拦截,最常见的响应拦截就是进行了错误的统一处理和没登录或登录过期后跳转登录页的一个操作。
// 响应拦截器
axios.interceptors.response.use(
response => {
// 如果返回的状态码为200,说明接口请求成功,可以正常拿到数据
// 否则的话抛出错误
if (response.status === 200) {
return Promise.resolve(response);
} else {
return Promise.reject(response);
}
},
// 服务器状态码不是2开头的的情况
// 这里可以跟你们的后台开发人员协商好统一的错误状态码
// 然后根据返回的状态码进行一些操作,例如登录过期提示,错误提示等等
// 下面列举几个常见的操作,其他需求可自行扩展
error => {
if (error.response.status) {
switch (error.response.status) {
// 401: 未登录
// 未登录则跳转登录页面,并携带当前页面的路径
// 在登录成功后返回当前页面,这一步需要在登录页操作。
case 401:
router.replace({
path: '/login',
query: {
redirect: router.currentRoute.fullPath
}
});
break;
// 403 token过期
// 登录过期对用户进行提示
// 清除本地token和清空vuex中token对象
// 跳转登录页面
case 403:
Toast({
message: '登录过期,请重新登录',
duration: 1000,
forbidClick: true
});
// 清除token
localStorage.removeItem('token');
store.commit('loginSuccess', null);
// 跳转登录页面,并将要浏览的页面fullPath传过去,登录成功后跳转需要访问的页面
setTimeout(() => {
router.replace({
path: '/login',
query: {
redirect: router.currentRoute.fullPath
}
});
}, 1000);
break;
// 404请求不存在
case 404:
Toast({
message: '网络请求不存在',
duration: 1500,
forbidClick: true
});
break;
// 其他错误,直接抛出错误提示
default:
//根据你自己的ui组件格式进行抛出
Toast({
message: error.response.data.message,
duration: 1500,
forbidClick: true
});
}
return Promise.reject(error.response);
}
}
});
export default instence
import request from '@/utils/request'
// 登录方法【post请求】
export function login(username, password, code, uuid) {
const data = {
username,
password,
code,
uuid
}
return request({
url: '/login',
method: 'post',
data: data
})
}
// 获取用户详细信息【get 请求】
export function getInfo() {
return request({
url: '/getInfo',
method: 'get'
})
}
在具体的页面之中进行导入api.js文件的方法进行使用即可
这就是vue中对于axios的初步封装使用,后续会持续更新