前言
封装包含,请求错误提示,配置token,对数据进行统一预处理,不同请求方式传参方式的配置等一、vue2.X 中axios的简单封装
简单封装说明了封装思路,适合小白但想尝试封装的人。你可以在此基础上进行追加改造.
1.引入库
代码如下(示例):
npm install axios
npm install element-ui -S
// 或者
yarn add axios
yarn add element-ui
2.创建封装文件 request.js
代码如下(示例):
/**
* 全站http配置
*/
import axios from 'axios';
import { Message } from 'element-ui';
//默认超时时间
axios.defaults.timeout = 10000;
//返回其他状态码
axios.defaults.validateStatus = function (status) {
return status >= 200 && status <= 500;
};
//跨域请求,允许保存cookie
axios.defaults.withCredentials = true;
//http request拦截 ,此处用到es6 Promise
axios.interceptors.request.use(config => {
// 你可以通过config来配置请求头...
const meta = (config.meta || {});
//headers中配置text请求
if (config.text === true) {
config.headers["Content-Type"] = "text/plain";
}
//headers中配置serialize为true开启序列化
if (config.method === 'post' && meta.isSerialize === true) {
config.data = serialize(config.data);
}
return config
}, error => {
return Promise.reject(error)
});
//http response 拦截,此处用到es6 Promise
axios.interceptors.response.use(res => {
//获取状态码
const status = res.data.code || res.status;
const message = res.data.msg || res.data.error_description || '未知错误';
//如果是401则跳转到登录页面
if (status === 401) {
//router.push({ path: '/login' }))
};
// 如果请求为非200否者默认统一处理
if (status !== 200) {
Message({
message: message,
type: 'error'
});
return Promise.reject(new Error(message))
}
return res;
}, error => {
return Promise.reject(new Error(error));
});
export default axios;
3.使用方式
在vue项目的根目录下的main.js 正常引用就好啦
import request from './api/request/request.js'
Vue.prototype.request = request;
接下来去页面中调用。这里唯一可能会犯错的地方
1. url路径的开头忘记加 / 了! hhh
2. /api 不明白是干什么的。其实这里是 devServer.proxy 的key
let _self = this;
let id = '123';
let name = 'abner';
let url = '/api/blade-performance-mgt/hzy/performance/record/planSubmit'; // 请求地址
// post 请求
_self.request
.post(url, {
id: id,
name: name ,
})
.then((res) => {
// res
});
// git 请求
let url = '/api/blade-performance-mgt/hzy/performance/record/list; // 请求地址
_self.request.get(url)
.then((res) => {
// res
});
也发下vue.config.js的配置吧!
这里只需要看下devServer中的配置就行
module.exports = {
//路径前缀
publicPath: "/",
lintOnSave: true,
productionSourceMap: false,
chainWebpack: (config) => {
//忽略的打包文件
config.externals({
'vue': 'Vue',
'vue-router': 'VueRouter',
'vuex': 'Vuex',
'axios': 'axios',
'element-ui': 'ELEMENT',
});
const entry = config.entry('app');
entry.add('babel-polyfill').end();
entry.add('classlist-polyfill').end();
entry.add('@/mock').end();
},
css: {
extract: { ignoreOrder: true }
},
//开发模式反向代理配置,生产模式请使用Nginx部署并配置反向代理
devServer: {
port: 1888,
proxy: {
'/api': {
//本地服务接口地址
// target: 'http://localhost',
//远程演示服务地址,可用于直接启动项目
target: 'http://10.1.100.248:8000/api',
// target: 'http://10.1.6.67:8033',
ws: true,
pathRewrite: {
'^/api': '/'
}
}
}
}
};
二、 多功能封装
这种为了更好的分离代码,需要创建两个文件interceptor.js和request.js
1.创建request文件夹,我的项目目录如下
interceptor.js 代码如下
/**
* Author:abner ,修改于5月28
* 生成基础axios对象,并对请求和响应做处理
* 前后端约定接口返回解构规范
* {
* code:200,
* data:"成功",
* msg: "操作成功"
* success: true
* }
*/
import axios from 'axios'
import { Message } from 'element-ui'
import { getToken } from '@/util/auth'; // 获取token值的方法,如何没有用token验证删掉即可
// 创建一个独立的axios实例
const service = axios.create({
// 设置baseUr地址,如果通过proxy跨域可直接填写base地址
baseURL: '/api',
// 定义统一的请求头部
headers: {
// 'Authorization': ``, // 此处对应后台AOP验证,
'Content-Type': 'application/json' //默认方式提交数据
// 'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8' //表单方式提交数据
},
// 配置请求超时时间
timeout: 10000,
// 如果用的JSONP,可以配置此参数带上cookie凭证,如果是代理和CORS不用设置
withCredentials: true
});
// 请求拦截
service.interceptors.request.use(config => {
// 在header中自定义token参数名:tokenHeader,可添加项目token
config.headers[tokenHeader] = getToken()
return config;
});
// 返回拦截
service.interceptors.response.use((response) => {
// 获取接口返回结果
const res = response.data;
// code为200,直接把结果返回回去,这样前端代码就不用在获取一次data.
if (res.code === 200) {
return res;
} else if (res.code === 10000) {
// 10000假设是未登录状态码
Message.warning(res.msg);
// 也可使用router进行跳转
window.location.href = '/#/login';
return res;
} else {
// 错误显示可在service中控制,因为某些场景我们不想要展示错误
// Message.error(res.message);
return res;
}
}, () => {
Message.error('网络请求异常,请稍后重试!');
});
export default service;
request.js中你需要知道的
这里需要说明的是请求方式那里的判断,我们需要知道axios不同请求方式默认传参的方式是不同的,比如:
1.post请求我们一般都用data:{} 这中方式传参
2.get请求我们一般都用params:{} 这中方式传参
又比如
//如果服务端将参数作为对象来封装接受
axios.delete('demo/url', {
data: {
id: 123,
name: 'Henry',
},
timeout: 1000,
...//其他相关配置
})
//如果服务端将参数作为url参数来接受,则请求的url为:www.demo/url?a=1&b=2形式
axios.delete('demo/url', {
params: {
id: 123,
name: 'Henry',
},
timeout: 1000,
...//其他相关配置
})
我们需要对不同的请求,不同的情况进行判断处理
request.js 代码如下
/**
* request.js
* 通过promise对axios做二次封装,针对用户端参数,做灵活配置
* Author:abner ,修改于5月28
*/
import { Message, Loading } from 'element-ui';
import instance from './interceptor'
/**
* 核心函数,可通过它处理一切请求数据,并做横向扩展
* @param {url} 请求地址
* @param {params} 请求参数
* @param {options} 请求配置,针对当前本次请求;
* @param loading 是否显示loading
* @param mock 本次是否请求mock而非线上
* @param error 本次是否显示错误
*/
function request(url, params, options = { loading: true, mock: false, error: true }, method) {
// let loadingInstance = '';
// 请求前loading
// if (options.loading) loadingInstance = Loading.service({background:'transparent'});
return new Promise((resolve, reject) => {
let data = {}
// get请求使用params字段
if (method == 'get') data = { params }
// post请求使用data字段
if (method == 'post') data = { data: params }
// delete请求使用params字段
if (method == 'delete') data = { params }
// 通过mock平台可对局部接口进行mock设置
if (options.mock) url = 'http://www.mock.com/mock/xxxx/api';
instance({
url,
method,
...data
}).then((res) => {
// 此处作用很大,可以扩展很多功能。对返回的数据进行统一处理
if (res && res.code === 200) {
resolve(res.data);
} else {
// 通过配置可关闭错误提示
if (res && options.error) Message.error(res.msg);
reject(res);
}
}).catch((error) => {
Message.error(error.message)
}).finally(() => {
// loadingInstance.close();
})
})
}
// 封装GET请求
function get(url, params, options) {
return request(url, params, options, 'get')
}
// 封装POST请求
function post(url, params, options) {
return request(url, params, options, 'post')
}
// 封装DELETE请求
function Delete(url, params, options) {
return request(url, params, options, 'delete')
}
export default {
get, post, Delete
}
使用步骤
1.在main.js中添加
import request from './api/request/request'
Vue.prototype.request = request;
2.在方法中直接使用
methods: {
getUnitTabledata() {
let _self = this;
_self.request
.get("/lnjzxh-awards-mgt/lnjzxh/award/serial/unit/list/page", {
awardName: _self.searchName,
status: _self.statusValue,
account: _self.account,
createDate: _self.pickerValue,
current: _self.page.currentPage - 1,
size: _self.page.pageSize,
})
.then((res) => {
_self.page.total = res.total;
_self.tableData = res.records;
});
},
}