通过axios请求接口已经很简单了,但最近在做一个vue项目,想着把axios请求再封装一下,这样api就可以只在一处配置成方法,在使用的时候直接调用这个方法。
但咱们不用每个接口都定义成一个啰嗦的axios请求方法,既然是想简单点,就尽量只在一处完成简单的配置。
1、配置api接口
将同一模块的接口放在一个文件下,比如我在src的services下定义了一个global.js作为全局服务的配置,在它里面配置的api可以作为这个服务的方法。
比如:
name字段将作为之后被调用的方法名,但这个只是一个单纯的对象,现在我们定义方法将它转为方法。
2、将接口配置的数组对象转化为方法
import axios from "axios";const withAxios = apiConfig => {const serviceMap = {};apiConfig.map(({ name, url, method }) => {serviceMap[name] = async function(data = {}) {let key = "params";if (method === "post" || method === "put") {key = "data";}return axios({method,url: "/api" + url,[key]: data});};});return serviceMap; };export default withAxios;
我们在utils下定义了一个通用的方法withAxios,这个方法的作用是将api配置文件转化为包含方法的一个对象。
3、在api配置文件中使用withAxios
import withAxios from "../utils/withAxios";const apiConfig = [{name: "userLogin",url: "/login",method: "get"},{name: "getUserInfo",url: "/login/user",method: "get"},{name: "getDeptList",url: "/login/department",method: "get"} ];export default withAxios(apiConfig);
直接export出包装后的对象即可。
4、在vuex中使用
想在vuex中调用某个api,首先import刚才导出的对象
import GlobalService from "@/services/global";
在action中调用某个接口:
const { data } = await GlobalService.userLogin(payload);
这样就完事了。之后只需要配置-调用这么两步就可以完成接口调用,而且接口的语义化也更明确了。
5、axios的其他配置
我们可以在utils的withAxios中顺便对axios做一些通用的设置。
比如每次请求头中都自动带上鉴权:
axios.defaults.headers.common["Authorization"] = getCookie("jwt") || ""; // 注意:此处只会在web应用初始化时配置,在登录成功后需重新配置Authorization。
比如使用拦截器对返回对象做统一处理:
axios.interceptors.response.use(response => {const { data } = response;if (data.status === -2) {Vue.prototype.$Message.error(`无效的登录信息或登录已失效,请重新登录`);delCookie("jwt");router.push({ path: "/login" });}if (data.status === -1) {Vue.prototype.$Message.error(`发生错误[${data.message}]`);}return response; });