前提须知

axios  是一个基于 promise 网络请求库,作用于node.js 和浏览器中,专门用于项目中发送请求获取数据。

axios 请求方式有:

  1. axios.get('url', { params: { /*参数*/ } }).then(callback)
  2. axios.post('url', { /*参数*/ }).then(callback)
  3.  axios({
         method: '请求类型',
         url: '请求的URL地址',
         data: { /* POST数据 */ },
         params: { /* GET参数 */ }
         // data和params二选一 
     }) .then(callback)

axios 二次封装

正常我们发送axios请求都需要写完整的请求地址url,例如:

// 立即执行函数 async+await异步发起请求
(async() => {
    const res1 = await axios.get('http://xxx.com/yyy/get', {
        params: {
            name: 'xxx',
            age: 18
        }
    })
    const res2 = await axios.post('http://xxx.com/yyy/post', {
        name: 'xxx',
        age: 18
    })
})()

为了请求方便,我们可以配置请求地址的基地址http://xxx.com

// 使用axios.create进行配置
const ggbone = axios.create({
    // 指定基地址
    // baseURL: 'http://xxx.com',
    // 为了更加方便基地址还可以设置成这样
    baseURL: 'http://xxx.com/yyy',
    // 指定请求超时时间
    timeout: 5000
}) 

这样我们就完成了基地址的配置,同时这个操作就是我们所说的axios的二次封装,然后我们就可以使用封装的这个axios发送请求,例如:

(async() => {
    const res1 = await ggbone.get('/get', {
        params: {
            name: 'xxx',
            age: 18
        }
    })
    const res2 = await ggbone.post('/post', {
        name: 'xxx',
        age: 18
    })
})()

这样就完成了axios简单的二次封装


请求、响应拦截器

在实际开发项目中,我们会在二次封装的时候通过请求拦截器和响应拦截器对请求之前和响应时对请求进行拦截并做一些处理,例如:请求拦截器中将 token 携带给服务器,响应拦截器中对不同响应结果进行提示,例如:

// 对axios进行二次封装 目的使用请求与响应拦截器
import axios from 'axios'
// 引入element-plus中的消息提示的组件ElMessage
import { ElMessage } from 'element-plus'

// 第一步:利用axios对象的create方法创建axios实例(配置其他的配置:基础路径、超时的时间等)
const request = axios.create({
  // 利用axios自定义配置
  baseURL: http://ggbone,
  timeout: 5000, // 超时时间为5s
})
// 第二步:request实例添加请求与响应拦截器-interceptors拦截器
request.interceptors.request.use((config) => {
  ...

  // 如果有 token 则将 token 放到请求头中
  config.headers.token = userStore.token
  // config配置对象中的headers属性请求头:经常用于给服务器端携带公共参数

  return config // 返回配置对象
})
// 第三步:响应拦截器
request.interceptors.response.use(
  (response) => {
    return response.data // 简化数据 只拿响应对象中的data数据,不用拿到所有数据组成的对象
  },
  (error) => {
    // 处理http网络错误
    // 定义一个变量:存储网络错误信息
    let message = '' // 起始值为空,根据响应失败对象身上的状态码去处理http网络错误
    // http状态码
    const status = error.response.status
    switch (status) {
      case 401:
        message = 'Token过期'
        break
      case 403:
        message = '无权访问'
        break
      case 404:
        message = '请求地址错误'
        break
      case 500:
        message = '服务器出现问题'
        break
      default:
        message = '无网络'
    }
    // 提示错误信息
    ElMessage({
      type: 'error',
      message: message,
    })
    // 返回失败的promise 去终结Promise
    return Promise.reject(error)
  },
)
export default request

这样就完成了 axios 完整的二次封装


Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐