Vue+axios统一接口管理

通过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;
});