axios 封装 http 请求详解

最新推荐文章于 2024-09-29 10:05:19 发布
最新推荐文章于 2024-09-29 10:05:19 发布
阅读量1.9k 收藏 28
点赞数 12
分类专栏： Vue 文章标签： axios http封装 vue
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_42966167/article/details/137269220
版权

前言

Axios 是一个基于 Promise 的 HTTP 库，它的概念及使用方法本文不过多赘述，请参考：axios传送门
本文重点讲述下在项目中是如何利用 axios 封装 http 请求。

一、预设全局变量

在 /const/preset.js 中配置预先设置一些全局变量

window.$env = process.env.NODE_ENV === 'development' ? 'DEV' : 'PROD'

// 默认开发环境
let config = {
  baseURL: location.origin,
  httpBaseURL: location.origin + '/api',
  webBaseURL: location.origin + location.pathname,
  vipAddress: '/necp/mapp/sc', // 后端微服务的统一入口
}

// 生产环境
if (window.$env !== 'DEV') {
  if (location.href.indexOf('/ecs/') > -1) {
    config.baseURL = location.href.replace(/\/ecs.+/, '')
    config.httpBaseURL = config.baseURL
  }
}

// 文件资源请求路径
config.fileUrl = config.httpBaseURL + config.vipAddress + 'file/download'

window.$globals = config

在 main.js 中引入

import Vue from 'vue'
import './const/preset'
// ...
// 把 vue 示例挂载到 window 下
window.$vm = new Vue({
  render: h => h(App),
  router
}).$mount('#app')

因为生产环境部署的差异，http 请求的 baseURL 并非都是统一的，所以不单独配置默认的 axios.defaults.baseURL，而是通过此文件预设的变量进行设置。

全局预设变量中的 config.httpBaseURL 将添加到请求的 URL 中，对于代码中的 location.href.indexOf(‘/ecs/’) > -1 判断只是举例，可根据实际需求决定是否需要。

二、http 请求封装

1.配置全局 axios 默认值

axios.defaults.headers.post['Content-Type'] = 'application/json;charset=UTF-8'
axios.defaults.timeout = 60000
axios.defaults.crossDomain = true

此三条配置分别对应以下作用：

  • 发送POST请求时，设置请求头的 Content-Type 字段为 ‘application/json;charset=UTF-8’ ，以便服务器正确解析请求的数据。
  • 发送请求默认的超时时间为 60s。
  • 允许跨域请求。

提示：覆盖默认超时时间，可在 axios 发送请求的参数 config 对象中设置 timeout 属性即可

2.配置请求拦截器

请求拦截器是在发送请求前执行的函数，它可以用于修改请求的配置或者在请求发送前进行一些操作。最常用的功能就是使用请求拦截器实现身份验证。

一个常见的实现是用户登录之后，服务端会响应用户的登录信息，并且把用户的身份认证 token 存储到 cookie 中，然后在请求拦截器中将 cookie 中获取到的 token 设置到请求头中，每次发送请求都会携带上此 token 发送到服务端，服务端再获取请求头的 token 来判断用户是否登录状态或者登录已过期，作出不同的响应。

axios.interceptors.request.use(
  config => {
    const token = cookie.get(TOKEN_COOKIE_KEY)
    if (token) {
      config.headers[TOKEN_REQ_KEY] = token
    }
    return config
  },
  error => {
    return Promise.reject(error)
  }
)

3.配置响应拦截器

响应拦截器是在接收到响应后执行的函数，它可以用于修改响应的数据或者在接收到响应后进行一些操作。
响应拦截器主要作用包括修改响应数据、错误处理、统一处理响应等功能，因把响应数据及错误的处理都放在了发送请求的回调中，所以只定义了最简单的响应拦截器。

axios.interceptors.response.use(response => {
  return response
}, error => {
  return Promise.reject(error)
})

4.发送请求的 request 函数

此函数接收四个参数：请求方法，请求的 api 接口，请求参数，请求的 config 配置项，返回一个 Promise 的实例。此函数完成了正常响应处理、异常处理、重复请求取消等功能。

4.1 拼接完整的请求 url

const apiInterceptor = api => {
  if (api.startsWith('http')) { // 自定义请求路径
    return api.slice(4)
  }
  if (api.startsWith('_SC_')) { // 项目统一的api前缀
    api = $globals.vipAddress + api.slice(4)
  }
  return $globals.httpBaseURL + api
}

const request = async (method = 'post', api, params = {}, config = {}) => {
  // 省略...
  let url = apiInterceptor(api)
  let opts = {
    method,
    url,
    headers: config.headers || {},
    withCredentials: config.withCredentials || true // 跨域请求时是否需要使用凭证
  }
  // 省略...
}

调用 apiInterceptor 函数来拼接完整的请求 url，如果 api 是以 http 开头，则表示自定义 api 的请求路径，否则请求路径使用 preset.js 中预设的全局变量来拼接完整的 url。

4.2 参数处理

const jsonObj2FormData = jsonObj => {
  let formData = new FormData()
  Object.keys(jsonObj).forEach(key => {
    if (jsonObj[key] instanceof Array) {
      formData.append(key, JSON.stringify(jsonObj[key]))
    } else {
      formData.append(key, jsonObj[key])
    }
  })
  return formData
}
// 省略...

if (config.formDataFormat) {
  opts.headers['Content-Type'] = 'application/x-www-form-urlencoded;charset=UTF-8'
  params = jsonObj2FormData(params)
}
if (method == 'post') {
  opts.data = params
} else {
  opts.params = params
}
  • 服务端有部分接口接收的参数要求 FormData 格式，这时候需要将参数序列化，并且修改请求头的 Content-Type。
  • 发送 get/post 请求时，接收参数的对象的 key 不一样。

4.3 正常响应处理

使用 axios(opts) 发起请求，得到的是一个 Promise，在 then 的第一个参数中传入一个正常的响应处理函数，这个函数接收响应拦截器中返回的 response 作为参数。

return new Promise((resolve, reject) => {
  axios(opts).then(response => {
     let res = response.data
     if (config.customHandler) { // 自定义响应处理
       if (config.responseAll) return resolve(response)
       return resolve(res)
     }
     if (res) {
       if (res.code === 000) { // 登录超时
          $vm.$toast.error(res.message)
          $vm.$store.dispatch('REMOVE_USER') // 移除 cookie、session、storage 存储的信息
          reject(res.message)
          if (window.self === window.top) {
            $vm.$router.push('/login') // 跳转登录页
          }
        } else if (res.code === 200) {
          resolve(res.data)
        } else {
          $vm.$toast.error(res.message || '接口异常, 请稍后重试')
          reject(res)
        }
     } else {
        $vm.$toast.error('接口无返回内容')
     }
   })
})

提示：$vm 指向全局的 Vue 实例，$toast 则是将 element 的 Message 组件实例挂载到了 Vue 的原型上

  • 如果调用 request 函数传入了 config.customHandler = true，表示自定义响应处理，并且 config.responseAll = true 时，会把响应拦截器中得到的 response 直接返回，这个参数主要用于调用服务端响应字节流的接口时使用。
  • 后端响应的数据结构如下图，并且登录过期接口的 http 响应状态码是 200，但是响应的数据格式中的 code 值为特定值，所以要特殊处理此类情况，清空存储在客户端的客户信息，跳转到登录页。
  • 当响应的数据中与服务端约定响应正常的 code 为 200，此时把 data 作为 Promise.resolve 的值
    response响应结构

4.4 异常处理

异常处理在 axios(opts).then() 的第二个参数中传入处理函数，这个函数接收响应拦截器中返回的 Promise.reject(error) 作为参数。

异常处理主要针对 http 响应状态码不等于 200 的情况，包括常见的请求超时，404请求资源不存在，50X 服务器异常等情况。

axios(opts).then(response => {
  // 省略...
}, error => {
      // 如果自定义处理
      if (config.customHandler) {
        reject(error)
        return
      }
      // 请求超时
      if (error.code == 'ECONNABORTED' && error.message.indexOf('timeout') > -1) {
        $vm.$toast.error(`请求超时,接口地址：${url}`)
        reject(error)
        return
      }
      if (error.response) {
        // 401未登录或登录失效
        if (error.response.status === 401) {
          reject(error)
          if (window.self === window.top) {
            $vm.$router.push('/login')
          }
          return
        }
        switch (error.response.status) {
          case 404:
            $vm.$toast.error(`请求的资源不存在,异常服务接口地址：${url}`)
            break
          case 408:
            $vm.$toast.error('请求超时')
            break
          case 500:
            $vm.$toast.error('服务异常')
            break
          case 502:
            $vm.$toast.error(error.message || '服务未响应')
            break
          case 503:
            $vm.$toast.error(error.message || '服务暂不可访问')
            break
          default:
            $vm.$toast.error(error.response.statusText || '服务异常, 请稍后重试')
        }
      } else {
        $vm.$toast.error(error.response.statusText || '未知错误, 请稍后重试')
      }
      reject(error)
    })

4.5 取消请求

在一些特定情况下，比如用户快速点击提交表单，短时间内同时触发同一个请求多次，我们可以借助 axios.cancelToken 来取消前几次请求，只保留最后一次请求。

主要实现的原理如下：

  1. 每次调用 request 函数时，根据传入的 method + api + JSON.stringify(config) 作为当前请求的标识 key，如果配置了 config.cancelTokenWidthParams = true，时，在 key 后面拼接 JSON.stringify(params) 作为 key。
  2. HTTP_CANCEL_MAP 每一项的 key 为每个请求的 ‘唯一标识 + _ + 时间戳’，每一项 value 设置为 axios.CancelToken 构造函数传入的 executor 函数的参数，也就是 cancel 函数，调用 checkHttpCancel 函数传入 key 判断是否为重复请求，是重复请求则调用 cancel() 取消请求。
  3. 调用 request 函数时，配置 opts.cancelToken，使用 new 调用 CancelToken 的构造函数来创建 cancel token
  4. 请求响应成功和失败时都需要从 HTTP_CANCEL_MAP 中删除 reqUniqueKey 对应的 cancelToken
const CANCEL_TOKEN = axios.CancelToken
const HTTP_CANCEL_MAP = $globals.httpCancelMap = new Map()
const IS_CANCELED_MSG = 'canceled'

const checkHttpCancel = reqKey => {
  HTTP_CANCEL_MAP.forEach((v, k) => {
    if (k.slice(0, -14) === reqKey) {
      v()
      HTTP_CANCEL_MAP.delete(k)
    }
  })
}

const request = async (method = 'post', api, params = {}, config = {}) => {
  let reqKey = method + api + JSON.stringify(config)
  if (config.cancelTokenWidthParams) reqKey += JSON.stringify(params)
  let reqUniqueKey = reqKey + '_' + new Date().getTime()
  checkHttpCancel(reqKey)
  // 省略...
  opts.cancelToken = new CANCEL_TOKEN(c => HTTP_CANCEL_MAP.set(reqUniqueKey, c))
  // ...
  axios(opts).then(response => {
    HTTP_CANCEL_MAP.delete(reqUniqueKey)
    // ...
  }, error => {
    HTTP_CANCEL_MAP.delete(reqUniqueKey)
    if (axios.isCancel(error)) {
      reject(new Error(IS_CANCELED_MSG))
      return
    }
    // ...
  })
})

注意

  1. 此项目使用的 axios 版本为 0.21.1，从 v0.22.0 开始，Axios 支持以 fetch API 方式—— AbortController 取消请求，CancelToken API被弃用
  2. 可以使用同一个 cancel token 取消多个请求

三、完整的 http.js

import axios from 'axios'
import { TOKEN_REQ_KEY, TOKEN_COOKIE_KEY } from '@/const/common'
import { session, cookie, jsonObj2FormData } from '@/util/common'

axios.defaults.headers.post['Content-Type'] = 'application/json;charset=UTF-8'
axios.defaults.timeout = 120000
axios.defaults.crossDomain = true

axios.interceptors.request.use(
  config => {
    const token = cookie.get(TOKEN_COOKIE_KEY)
    if (token) {
      config.headers[TOKEN_REQ_KEY] = token
    }
    return config
  },
  error => {
    return Promise.reject(error)
  }
)

axios.interceptors.response.use(response => {
  return response
}, error => {
  return Promise.reject(error)
})

const CANCEL_TOKEN = axios.CancelToken
const HTTP_CANCEL_MAP = $globals.httpCancelMap = new Map()
const IS_CANCELED_MSG = 'canceled'

const checkHttpCancel = reqKey => {
  HTTP_CANCEL_MAP.forEach((v, k) => {
    if (k.slice(0, -14) === reqKey) {
      v()
      HTTP_CANCEL_MAP.delete(k)
    }
  })
}

const apiInterceptor = api => {
  if (api.startsWith('http')) { // 自定义请求路径
    return api.slice(4)
  }
  if (api.startsWith('_SC_')) { // 项目统一的api前缀
    api = $globals.vipAddress + api.slice(4)
  }
  return $globals.httpBaseURL + api
}

const request = async (method = 'post', api, params = {}, config = {}) => {
  let reqKey = method + api + JSON.stringify(config)
  if (config.cancelTokenWidthParams) reqKey += JSON.stringify(params)
  let reqUniqueKey = reqKey + '_' + new Date().getTime()
  checkHttpCancel(reqKey)

  return new Promise((resolve, reject) => {
    if (config.loading) $vm.$loading.show()
    let url = apiInterceptor(api)
    let opts = {
      method,
      url,
      headers: config.headers || {},
      withCredentials: config.withCredentials || true // 跨域请求时是否需要使用凭证
    }
    if (config.formDataFormat) {
      opts.headers['Content-Type'] = 'application/x-www-form-urlencoded;charset=UTF-8'
      params = jsonObj2FormData(params)
    }
    if (config.timeout) opts.timeout = config.timeout
    if (config.extends) opts = Object.assign(opts, config.extends) // 如果有并列层级的参数扩展
    if (method == 'post') {
      opts.data = params
    } else {
      opts.params = params
    }
    opts.cancelToken = new CANCEL_TOKEN(c => HTTP_CANCEL_MAP.set(reqUniqueKey, c))
    if (config.responseType) opts.responseType = config.responseType
    
    // 发起 axios 请求
    axios(opts).then(response => {
      HTTP_CANCEL_MAP.delete(reqUniqueKey)
      if (config.loading) $vm.$loading.close()
      let res = response.data
      if (config.customHandler) { // 自定义响应处理
        if (config.responseAll) return resolve(response)
        return resolve(res)
      }
      if (res) {
        if (res.code === 000) { // 登录超时
          $vm.$toast.error(res.message)
          $vm.$store.dispatch('REMOVE_USER') // 移除 cookie、session、storage 存储的信息
          reject(res.message)
          if (window.self === window.top) {
            $vm.$router.push('/login') // 跳转登录页
          }
        } else if (res.code === 200) {
          resolve(res.data)
        } else {
          $vm.$toast.error(res.message || '接口异常, 请稍后重试')
          reject(res)
        }
      } else {
        $vm.$toast.error('接口无返回内容')
      }
    }, error => {
      HTTP_CANCEL_MAP.delete(reqUniqueKey)
      if (axios.isCancel(error)) {
        reject(new Error(IS_CANCELED_MSG))
        return
      }
      if (config.loading) $vm.$loading.close()
      // 如果自定义处理
      if (config.customHandler) {
        reject(error)
        return
      }
      // 请求超时
      if (error.code == 'ECONNABORTED' && error.message.indexOf('timeout') > -1) {
        $vm.$toast.error(`请求超时,接口地址：${url}`)
        reject(error)
        return
      }
      if (error.response) {
        // 401未登录或登录失效
        if (error.response.status === 401) {
          reject(error)
          if (window.self === window.top) {
            $vm.$router.push('/login')
          }
          return
        }
        switch (error.response.status) {
          case 404:
            $vm.$toast.error(`请求的资源不存在,异常服务接口地址：${url}`)
            break
          case 408:
            $vm.$toast.error('请求超时')
            break
          case 413:
            $vm.$toast.error('请求实体大小超过服务器最大限制')
            break
          case 500:
            $vm.$toast.error('服务异常')
            break
          case 502:
            $vm.$toast.error(error.message || '服务未响应')
            break
          case 503:
            $vm.$toast.error(error.message || '服务暂不可访问')
            break
          default:
            $vm.$toast.error(error.response.statusText || '服务异常, 请稍后重试')
        }
      } else {
        $vm.$toast.error(error.response.statusText || '未知错误, 请稍后重试')
      }
      reject(error)
    })
  })
}

export default {
  get: (api, params = {}, config = {}) => {
    return request('get', api, params, config)
  },
  post: (api, params = {}, config = {}) => {
    return request('post', api, params, config)
  },
  image: id => {
    return `${$globals.fileUrl}?fileId=${id}`
  },
  isCanceled: error => {
    if (error && error.message === IS_CANCELED_MSG) return true
    return false
  }
}
  1. http.image 方法仅用于返回文件的请求完整 url，使用场景为比如 <img> 标签中的 src 的值
  2. http.isCanceled 方法用于判断当前请求是否取消，如果有请求未取消并且出现全局 loading 加载未关闭的情况，可根据此标志来判断是否关闭

四、封装成插件并挂载到原型

/plugins/http/install.js

import httpService from '@/service/http'

export default {
  install: Vue => {
    Vue.prototype.$http = httpService
  }
}

五、管理 api

例如，根据业务可划分为文档，评论等模块，在 service 目录下分别创建对应的模块存放 api 的 js 文件，对 api 进行统一管理。

强烈建议给每个 api 备注功能，提高可维护性

service模块划分
/service/comment.js

/**
 * @name 获取评论列表
 * @param {Object} params 请求参数对象
 */
export const getCommentListPromise = params => {
  params = Object.assign({
    page: 0, // 页码
    pageSize: 5, // 每页数量
  }, params)
  return $vm.$http.get('_SC_/comment/findCommentList', params)
}

在 Comment.vue 页面中使用

import { getCommentListPromise } from '@/service/comment'
async findCommentList() {
  const data = await getCommentListPromise()
  console.log(data)
}

总结

本文主要讲述了如何使用 axios 进行 http 封装的详细过程，及在项目中如何使用封装的 http 请求，请求拦截器和响应拦截器都是比较简单，没有处理很多的逻辑，逻辑处理基本是集中在 request 函数中。

axios请求封装
m0_61255374的博客
01-04 1739
一般我们会在项目根目录的src文件夹下新建一个utils文件夹, 在文件夹下放http.js文件,在http.js中首先导入axios， 然后设置属性，比如baseURL（公共地址）和 timeOut (超时时间） 还可以设置响应拦截和请求拦截，在请求拦截中可以设置loading动画的开启和配置请求头的token 在响应拦截中可以关闭loading和根据后端返回的状态码检测token是否有效 最后把server导出 import axios from 'axios' let server = axio.
vue中axios封装请求
weixin_48115183的博客
05-11 6939
执行 GET 请求 // 向具有指定ID的用户发出请求 axios.get('/user?ID=12345') .then(function (res) { console.log(res); }) .catch(function (error) { console.log(error); }); // 也可以通过 params 对象传递参数 axios.get('/user', { params: { ID: 12345 } }) .then(fun
axios请求的封装
12-15
axios请求的封装，在工程的src目录下面，新建一个文件夹lib，将该文件复制到lib文件夹下，并在main.js中设置为全局引用，例：在main.js中添加：import Extend from './lib/http'，Extend(Vue.prototype)，另外http.js中添加overall.$axios = axios，即可。
vue + axios---封装一个http请求
weixin_34272308的博客
12-12 210
在使用vue开发时，官方推荐使用axios来请求接口 // axios官方地址 https://github.com/axios/axios 但是axios并不像 vue-resource 一样拥有install，即不能直接 Vue.use(axios) 来使用，所以需要我们自己根据axios来写一个具有install方法的Http...
封装axios请求
最新发布
活宝小娜的博客
09-29 381
封装axios，对错误信息进行统一处理
服务器网络请求返回状态码集合
qq_41241504的博客
11-25 584
在开发过程中报错是最令人头疼的，接下来我们就来谈谈那些状态码都是什么 200: '服务器成功返回请求的数据。', 201: '新建或修改数据成功。', 202: '一个请求已经进入后台排队（异步任务）。', 204: '删除数据成功。', 400: '发出的请求有错误，服务器没有进行新建或修改数据的操作。', 401: '用户没有权限（令牌、用户名、密码错误）。', ...
Vue项目中如何使用Axios封装http请求详解
10-16
### Vue项目中Axios封装http请求的详细步骤与知识点 #### 1. 前言 在现代的前端开发中，使用Vue框架时经常需要处理网络请求。Axios作为一个基于Promise的HTTP客户端，广泛用于浏览器和node.js环境中，因其简洁的...
vue 项目封装 axios 的 HTTP 请求
盛夏温暖流年
01-19 995
在介绍如何封装 axios 的 http 请求之前，我们先来了解下什么是 axios。 axios 是通过 promise 实现对 ajax 技术 的一种封装，就像 jQuery 实现 ajax 封装一样。 简单来说，ajax 技术实现了网页的局部数据刷新，axios 实现了对 ajax 的封装。 平时开发 vue 项目时，不同模块都会使用 axios 请求后台的接口，代码如下： this.$axios({ method: "POST", url: "接口地址", params: { 参
Vue Promise的axios请求封装详解
10-18
Vue Promise的axios请求封装详解旨在介绍如何利用JavaScript中的Promise对象和axios库来实现优雅和高效的请求封装。本文将详细探讨Promise的使用方法、axios请求封装技巧，以及如何在不同环境下区分请求链接。 首先...
axios 封装请求
goodtimedd的博客
04-06 319
axios 封装请求 用于统一管理 接口请求 如果需要在此文件中用于其他方法的文件可以： // import { getIMEI } from './utils' // getIMEI() 来进行使用 const baseURL = '你请求的接口地址'; let Token:string = ''; let RefreshToken:string = ''; let UserId:string = ''; let UserPhone:string = ''; let openid:string =
axios 封装的http请求
big_borther6的博客
01-20 297
使用可配置的ip /** * 请求工具封装 */ import axios from 'axios' import qs from 'qs' import { Message,Loading } from 'element-ui'; let loadinginstace; //load加载 //let apiBaseUrl = process.env.BASE_API; // var s...
axios 是如何封装 HTTP 请求的
热门推荐
深夜代码酒神
11-28 5万+
概述 前端开发中，经常会遇到发送异步请求的场景。一个功能齐全的 HTTP 请求库可以大大降低我们的开发成本，提高开发效率。 axios 就是这样一个 HTTP 请求库，近年来非常热门。目前，它在 GitHub 上拥有超过 40,000 的 Star，许多权威人士都推荐使用它。 因此，我们有必要了解下 axios 是如何设计，以及如何实现 HTTP 请求库封装的。撰写本文时，axios 当前版本为 ...
http请求axios封装
xye1230的博客
05-18 361
来抄作业 import axios,{AxiosError,AxiosRequestConfig,AxiosResponse,Canceler,CancelTokenSource} from 'axios' export interface AjaxResponse{ request:()=>Promise<AxiosResponse> //Axios异步函数 cancel:Canceler //关联的cancel方法 } const baseConfig={ validateS
axios设置fomrData请求
qq_31620497的博客
10-31 1355
设置form-data请求格式   import axios from "axios" //引入 //设置axios为form-data axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded'; axios.defaults.headers.get['Content-Type'] ...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值