Vue.cli项目封装全局axios，封装请求，封装公共的api和调用请求的全过程

2021-11-27 532

前言

在做vue中大型项目的时候，官方推荐使用axios，但是原生的axios可能对项目的适配不友好，所以，在工程开始的来时候来封装一下axios，保持全项目数据处理的统一性。此文主要讲在vue-cli项目中如何封装axios，封装请求，封装公共的api，页面如何调用请求。

正式配置路线：
1. 拿到项目及后台接口，首先做的是配置全局代理及第二点。
2. 全局封装axios及第三点request.js。
3. 过滤axios请求方式，控制路径及参数的格式及第四点http.js。
4. 正式封装api及第五点api.js。
5. 页面调用。
复制代码

正文

一、VUE项目的前期配置

新建vue项目，下载axios，并在main.js中导入axios。

npm i axios -S
复制代码

// main.js
import axios from "axios"
复制代码

二、配置config文件中的代理地址

在项目config目录下的index.js文件，这里是主要书写配置多个后台接口。

vue cil2 旧版本的代理配置--confin/index.js

 dev: {
    // Paths
    assetsSubDirectory: 'static',
    assetsPublicPath: '/',
    // 后端请求地址代理，配置后testIp再之后的页面调用时就直接指代 http://197.82.15.15:8088
    proxyTable: {
      '/testIp': {
        target: 'http://197.82.15.15:8088',
        changeOrigin: true,
        pathRewrite: { 
          '^/testIp': ''
        }
      },
      '/elseIp': {
        target: 'http://182.83.19.15:8080',
        changeOrigin: true,
        pathRewrite: { 
          '^/esleIp': ''
        }
      },
    },

    // Various Dev Server settings
    host: 'localhost', // can be overwritten by process.env.HOST
    port: 8080, // can be overwritten by process.env.PORT, if port is in use, a free one will be determined
    autoOpenBrowser: false,
    errorOverlay: true,
    notifyOnErrors: true,
    poll: false, // https://webpack.js.org/configuration/dev-server/#devserver-watchoptions-


    /**
     * Source Maps
     */

    // https://webpack.js.org/configuration/devtool/#development
    devtool: 'cheap-module-eval-source-map',

    // 如果您在调试devtools中的vue文件时遇到问题,
    // 将此设置为false ，他可能有所帮助
    // https://vue-loader.vuejs.org/en/options.html#cachebusting
    cacheBusting: true,

    cssSourceMap: true
  },


复制代码

vue cil 3+ 新版本的代理配置 vue.config.js 文件

关于多代理配置：

		 devServer: {
            overlay: { // 让浏览器 overlay 同时显示警告和错误
              warnings: true,
              errors: true
            },
            host: "localhost",
            port: 8080, // 端口号
            https: false, // https:{type:Boolean}
            open: false, //配置后自动启动浏览器
            hotOnly: true, // 热更新
            // proxy: 'http://localhost:8080'   // 配置跨域处理,只有一个代理
            proxy: { //配置多个代理
                "/testIp": {
                    target: "http://197.0.0.1:8088",
                    changeOrigin: true,
                    ws: true,//websocket支持
                    secure: false,
                    pathRewrite: {
                        "^/testIp": "/"
                    }
                },
                "/elseIp": {
                    target: "http://197.0.0.2:8088",
                    changeOrigin: true,
                    //ws: true,//websocket支持
                    secure: false,
                    pathRewrite: {
                        "^/elseIp": "/"
                    }
                },
            }
        }

复制代码

三、封装axios实例--request.js

在项目src目录下新建utils文件夹，然后再其中新建request.js，这个文件时主要书写axios的封装过程。

/****   request.js   ****/
// 导入axios
import axios from 'axios'
// 使用element-ui Message做消息提醒
import { Message} from 'element-ui';
//1. 创建新的axios实例，
const service = axios.create({
  // 公共接口--这里注意后面会讲
  baseURL: process.env.BASE_API,
  // 超时时间 单位是ms，这里设置了3s的超时时间
  timeout: 3 * 1000
})
// 2.请求拦截器
service.interceptors.request.use(config => {
  //发请求前做的一些处理，数据转化，配置请求头，设置token,设置loading等，根据需求去添加
   config.data = JSON.stringify(config.data); //数据转化,也可以使用qs转换
   config.headers = {
     'Content-Type':'application/x-www-form-urlencoded' //配置请求头
   }
   //注意使用token的时候需要引入cookie方法或者用本地localStorage等方法，推荐js-cookie
   const token = getCookie('名称');//这里取token之前，你肯定需要先拿到token,存一下
   if(token){
      config.params = {'token':token} //如果要求携带在参数中
      config.headers.token= token; //如果要求携带在请求头中
    }
  return config
}, error => {
  Promise.reject(error)
})

// 3.响应拦截器
service.interceptors.response.use(response => {
  //接收到响应数据并成功后的一些共有的处理，关闭loading等
  
  return response
}, error => {
   /***** 接收到异常响应的处理开始 *****/
  if (error && error.response) {
    // 1.公共错误处理
    // 2.根据响应码具体处理
    switch (error.response.status) {
      case 400:
        error.message = '错误请求'
        break;
      case 401:
        error.message = '未授权，请重新登录'
        break;
      case 403:
        error.message = '拒绝访问'
        break;
      case 404:
        error.message = '请求错误,未找到该资源'
        window.location.href = "/NotFound"
        break;
      case 405:
        error.message = '请求方法未允许'
        break;
      case 408:
        error.message = '请求超时'
        break;
      case 500:
        error.message = '服务器端出错'
        break;
      case 501:
        error.message = '网络未实现'
        break;
      case 502:
        error.message = '网络错误'
        break;
      case 503:
        error.message = '服务不可用'
        break;
      case 504:
        error.message = '网络超时'
        break;
      case 505:
        error.message = 'http版本不支持该请求'
        break;
      default:
        error.message = `连接错误${error.response.status}`
    }
  } else {
    // 超时处理
    if (JSON.stringify(error).includes('timeout')) {
      Message.error('服务器响应超时，请刷新当前页')
    }
    error.message = '连接服务器失败'
  }

  Message.error(error.message)
  /***** 处理结束 *****/
  //如果不需要错误处理，以上的处理过程都可省略
  return Promise.resolve(error.response)
})
//4.导入文件
export default service

复制代码

特殊说明：

关于数据转换这块的问题，在这特别说明一下

config.data = JSON.stringify(config.data);
config.headers = { 'Content-Type':'application/x-www-form-urlencoded'  }
const token = getCookie('名称')
if(token){ 
  config.params = {'token':token} ; 
  config.headers.token= token; 
}

复制代码

上述的代码都是请求的配置项，非必须，也是分情况的，data/headers/params这种本身的参数都有多种，和后台沟通，需要什么就配什么！
config.data = JSON.stringify(config.data) 为什么不用qs.stringify,因为我的后台想要的只是json类型的传参，而qs转换会转换成键值对拼接字符串形式。当然你们后台需要传递字符串类型参数，那就转换成qs或者其他方式。
const token = getCookie(名称)这是token的取值，在取之前你肯定需要发请求拿到token，然后sheCookie存起来，而名称就是你存的token的名称，每个人的都不一样。
config.headers = {'Content-Type':'application/x-www-form-urlendoded'}请求头内容的配置，也是不同的，application/x-www-form-urlendoded:form表单数据被编码为key/value格式发送到服务器（表单默认的提交数据的格式），你可以根据实际情况去配置自己需要的。
如果最终配完成后，报错连接服务器失败，那是正常的，因为示例配置的服务器地址是假地址，需要替换成你自己的服务器。

关于响应拦截器错误码返回处理的更改：

被大佬指正的优化内容......

// 响应拦截器
service.interceptors.response.use(
    (response) => {
        const res = response.data
        if (response.config.responseType !== 'blob') {
            if (res.code !== 0) {
                Message({
                    message: res.msg || 'Error',
                    type: 'error',
                    duration: 3 * 1000,
                })
                return Promise.reject(new Error(res.msg || 'Error'))
            } else {
                return res
            }
        }
        return res
    },
    (error) => {
        let res = error.response
        if (error.response) {
            if (res.status == 401) {
                Vue.prototype.parentFns.portal_logout()
            }
        }
        return Promise.reject(error)
    }
)
复制代码

四、封装请求 -- http.js

在项目src目录下的 utils 文件夹中新建 http.js文件，这个文件是主要书写几种请求的封装过程。

/****   http.js   ****/
// 导入封装好的axios实例
import request from './request'

const http ={
    /**
     * methods: 请求方式
     * url 请求地址 
     * params 请求参数
     */
    get(url,params){
        const config = {
            method: 'get',
            url:url
        }
        if(params) config.params = params
        return request(config)
    },
    post(url,params){
        const config = {
            method: 'post',
            url:url
        }
        if(params) config.data = params
        return request(config)
    },
    put(url,params){
        const config = {
            method: 'put',
            url:url
        }
        if(params) config.params = params
        return request(config)
    },
    delete(url,params){
        const config = {
            method: 'delete',
            url:url
        }
        if(params) config.params = params
        return request(config)
    }
}
//导出
export default http

复制代码

五、正式封装API，用于发送请求 -- api.js

在项目src目录下新建api文件夹，然后再其中新建api.js文件，这个文件是书写API的封装过程。

写法一，适合分类导出：

import http from '../utils/http'
// 
/**
 *   resquest 请求地址 例如：http://197.82.15.15:8088/request/...
 *   '/testIp'代表vue-cil中config，index.js中配置的代理
 */
let resquest = "/testIp/request/"

// get请求
export function getListAPI(params){
    return http.get(`${resquest}/getList.json`,params)
}
// post请求
export function postFormAPI(params){
    return http.post(`${resquest}/postForm.json`,params)
}
// put 请求
export function putSomeAPI(params){
    return http.put(`${resquest}/putSome.json`,params)
}
// delete 请求
export function deleteListAPI(params){
    return http.delete(`${resquest}/deleteList.json`,params)
}


复制代码

写法二，适合全部导出：

import http from '../utils/http'
// 
/**
 *   resquest 请求地址 例如：http://197.82.15.15:8088/request/...
 *   '/testIp'代表vue-cil中config，index.js中配置的代理
 */
let resquest = "/testIp/request/"

// get请求
export default{
 	getListAPI(params){
    	return http.get(`${resquest}/getList.json`,params)
	},
	 postFormAPI(params){
    	return http.post(`${resquest}/postForm.json`,params)
	}
}

复制代码

注意：一个项目中如果后台请求的不是同一个ip，而是多个ip的时候，可以再api文件夹下建立多个js，用来调用请求。

我们看一下之前遗留的一个问题：

// 创建新的axios实例
const service = axios.create({
    baseURL:process.nev.BASE_API,
    timeout:3 * 1000
})
复制代码

在之前封装公共接口的baseUrl的时候，用了 webpack 中的全局变量 process.env.BASE_API ,而不是直接写死ip，也是为了适应多个后台或开发的时候的api地址和发布的时候的api地址不一样这种情况。

以上关于配置环境和接口基本搭建完毕，下面看一下调用

六、如何在vue文件中调用

方法一：

用到哪个api就调用哪个接口 -- 适用于上文接口分类导出。

 import {getListAPI,postFormAPI, putSomeAPI, deleteListAPI} from '@/api/api'

  methods: {
      //   promise调用，链式调用， getList()括号内只接受参数；
      //   get不传参
      getList() {
        getListAPI().then(res => console.log(res)).catch(err => console.log(err))
      },
        //post传参
      postForm(formData) {
        let data = formData
        postFormAPI(data).then(res => console.log(res)).catch(err => console.log(err))
      },

      //async await同步调用
      async postForm(formData) {
        const postRes = await postFormAPI(formData)
        const putRes = await putSomeAPI({data: 'putTest'})
        const deleteRes = await deleteListAPI(formData.name)
        // 数据处理
        console.log(postRes);
        console.log(putRes);
        console.log(deleteRes);
      },
   }

复制代码

方法二：

把api全部导入，然后用哪个调用哪个api -- 适用于全部导出

   import api from '@/api/api'
   methods: {
     getList() {
        api.getListAPI(data).then(res => {
          //数据处理
        }).catch(err => console.log(err))
      }
    }  

复制代码

结语

以上就是详细介绍了，在vue-cil项目中如何封装axios，封装请求，封装公共api，配置多个接口，页面如何调用请求等问题，都是亲测有用的~，但是这种封装方法更适合中大型项目，配置比较合理，如果是自己的小项目，就直接用axios就可以了。

最后

如果你觉得此文对你有一丁点帮助，点个赞。或者可以加入我的开发交流群：1025263163相互学习，我们会有专业的技术答疑解惑

如果你觉得这篇文章对你有点用的话，麻烦请给我们的开源项目点点star:http://github.crmeb.net/u/defu不胜感激！

微信关注我们

原文链接：https://my.oschina.net/u/5079097/blog/5329272

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

Paddle.js & PaddleClas 实战 ——『寻物大作战』AI 小游戏

1. 前言 AI 自诞生以来就应用在各个科技前沿领域，随着发展进程加快，在娱乐方面也有越来越多的趣味性游戏开始将AI融入其中。『寻物大作战』正是一款基于 AI 能力打造的趣味性小游戏，目的就是让玩家通过游戏的方式感受 AI 的魅力。『寻物大作战』项目的背后所依赖的正是目前 AI 领域最热门的深度学习技术，通过一套端到端的图像分类模型来实现物体识别的效果。虽然受限于数据，它目前还是一款初级阶段的游戏，不过麻雀虽小，五脏俱全，整体开发过程囊括了数据处理、模型设计、模型训练、上线部署，四位一体的全部流程！所依赖的技术主要包含两大部分：百度飞桨图像分类套件PaddleClas和基于 JavaScript 的前端深度学习推理引擎Paddle.js。接下来将对这两部分进行详细说明。构建神经网络/深度学习模型的基本步骤 2.PaddleClas PaddleClas作为“开箱即用”的图像分类套件，拥有180+预训练模型，都只需经过简单配置，即可完成从训练到部署的全流程工作。近年来，深度学习技术越发的火热，计算机视觉在生活中得到了越来越多的应用，但受制于深度学习技术对庞大算力的需求，其在手机...

2021-11-26

684

Nacos是目前比较流行的一款集服务发现和配置管理的中间件，同时支持CP和AP两种模式。Nacos是久经考验的稳定、高性能的服务发现、配置管理的服务。我们在使用一个开源工具时，除了它的外在特性外，往往都想了解它的内在。否则万一出了什么问题，岂是不一脸懵，如果我们对它的代码都非常熟悉，就算出了问题，也是一点不慌。所以，解读开源代码是一项非常重要的技能！那么如何解读开源代码呢？先说下本人的做法：望其名，识其义，也就是盲猜一波。需要注意的是，走读代码时，要关注最主要的分支逻辑，不要被一些不重要的分支吸引浪费大量精力。比如说，怎么快速定位到Nacos服务端的服务注册的逻辑代码呢，先看下Nacas的几个模块的名称，然后根据名字猜测下。首先，address应该是地址相关的，应该是被其他模块引用的工具类的实现； api模块更是好猜了，属于api的声明模块了； auth、client、cmdb、common更不用说，肯定不是服务注册的核心代码所在； consistency：一致性，这个含义猜测应该是和Raft共识算法有关系，所以也不是这个模块； config：配置，这个很明显，应该是配置管理的...

2021-11-28

539

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。