在vue项目中,和后台进行数据交互使用axios。要想统一处理所有的http请求和响应,就需要使用axios的拦截器。通过配置http response inteceptor 统一拦截后台的接口数据,针对异常的情况可以做统一拦截处理。
项目背景:vue+vuex+elementUI进行开发
axios详细说明手册:https://www.kancloud.cn/yunye/axios/234845
1、安装axios
npm install --save axios
2、在src/utils目录下,新建一个fetch.js文件,用于专门写axios的统一拦截操作。(具体路径存放已经文件名自定义)
在fetch.js文件中,引入axios、element-ui的部分元素、引入vuex中的store、另外在引入其他相关的方法,例如获取token的方法
import axios from 'axios';
import { Message, MessageBox } from 'element-ui';
import store from '../store';
import { getToken } from 'utils/auth';
// 创建axios实例
const service = axios.create({
// baseURL: process.env.BASE_API, // api的base_url
timeout: 60000 // 请求超时时间,1分钟
});
// request拦截器
service.interceptors.request.use(config => {
// Do something before request is sent
if (store.getters.token) {
config.headers['Authorization'] = getToken(); // 让每个请求携带token--['X-Token']为自定义key 请根据实际情况自行修改
}
return config;
}, error => {
Promise.reject(error);
})
// respone拦截器
service.interceptors.response.use(
response => {
/**
* 下面的注释为通过response自定义code来标示请求状态,当code返回如下情况为权限有问题,登出并返回到登录页
* 如通过xmlhttprequest 状态码标识 逻辑可写在下面error中
*/
const res = response.data;
if (response.status === 401 || res.status === 40101) {
MessageBox.confirm('你已被登出,可以取消继续留在该页面,或者重新登录', '确定登出', { confirmButtonText: '重新登录', cancelButtonText: '取消', cancelButtonClass: 'calBtnClass', type: 'warning' }).then(() => {
store.dispatch('FedLogOut').then(() => {
location.reload(); // 为了重新实例化vue-router对象 避免bug
});
})
return Promise.reject('error');
}
if (res.status === 40001) {
Message({ message: '账户或密码错误!', type: 'warning' });
return Promise.reject('error');
}
if (response.status !== 200 && res.status !== 200) { //此处并不能拦截全部异常情况,因为res是后台接口返回的数据,有一些由于不规范,没有带status属性,导致没有被拦截
Message({ message: res.message, type: 'error', duration: 6 * 1000 });
} else {
//只有成功后,才可以进行操作
return response.data;
}
},
error => {
Message({
message: error.message,
type: 'error',
duration: 6 * 1000
});
return Promise.reject(error);
}
);
export default service;
以上代码,是一个完整的axios统一拦截配置处理。
额外话:
在学习axios的时候,对于defaults是很迷惑,有一些写法是axios.defaults.XXX。在了解以后,才知道axios的执行顺序是:默认值,实例默认值,参数设置值
//设置默认值,设置默认超时时间为6000ms axios.defaults.timeout="6000" //创建实例,设置默认超时时间为8000ms const instance = axios.create(); instance.defaults.timeout= 8000 //请求,设置具体请求超时时间 instance.get('/url',{ timeout:1000*10 })
3、fetch.js配置完成以后,在调用请求的文件引入该文件即可
例如:本人习惯的写法是把所有的请求方法写到一个js文件中,页面需要调用的时候,在import该文件。
例如,在src/login.js文件中,存放和登录有关的全部请求方法,并在改文件中引入fetch.js
import fetch from 'utils/fetch'; //修改密码 export function editPwsFun(obj,timeout) { return fetch({ url: '/api/admin/user/current/updatePassword', method: 'post', data: obj,
timeout }) } //查询当前登录用户信息 export function getCurUserInfo() { return fetch({ url: '/api/admin/user/current/user', method: 'get', }); } //修改当前用户信息 export function editCurUInfo(obj) { return fetch({ url: '/api/admin/user/current/updateUser', method: 'post', data: obj }) } // 执行登录 export function loginByEmail(username, password) { const data = { username, password}; return fetch({ url: '/api/auth/jwt/token', method: 'post', data }); } // logout注销 export function logout(token) { return fetch({ url: '/api/auth/jwt/invalid', method: 'post', params: { token } }); } // 获取用户信息 export function getInfo(token) { return fetch({ url: '/api/admin/user/front/info', method: 'get', params: { token } }); }
4、接口文件完成以后,在vue文件中直接引入,并调用该方法即可。
<script> import {editPwsFun, editCurUInfo, getCurUserInfo } from '../../api/login'; export default { methods: { updateUserInfo() { getCurUserInfo().then(resopnse=> { if (resopnse.status==200) { this.formUInfo=resopnse.data; this.dialogUInfoVisible = true; } else { this.dialogUInfoVisible=false; } }) } } } </script>