Vue接口封装的完整步骤记录

以下是Vue接口封装的完整步骤记录的攻略：

1. 确定接口需求

在进行接口封装之前，首先需要明确接口的需求，包括但不限于接口的用途、参数、API文档等。这可以帮助我们更好地理解业务需求，从而设计出更好的API接口。

具体来说，需要确定以下几点：

1. 接口的用途：明确该接口的作用，它是提供了什么功能？这对我们后续的接口设计有很大的帮助。
2. 接口的参数：需要确定接口所需要的参数，包括是GET请求还是POST请求、请求参数的格式、接口的地址等，这对于我们后续的接口设计也非常重要。
3. 接口的API文档：接口的API文档可以帮助我们更好地理解接口的用法、参数及其可能的返回值。

2. 设计接口参数

确定了接口需求之后，接下来就需要对接口的参数进行设计。

在设计接口参数时，需要考虑以下几个方面：

1. 参数类型：需要确定每个参数的数据类型，比如 String、Number、Object 等。为了更好地维护代码，建议为参数类型定义一个枚举对象。
2. 参数校验：需要对每个参数进行合法性校验，包括参数是否存在、参数格式是否正确等。可以使用一些第三方库，如 validator.js、Joi，或者自己实现一套参数校验机制。
3. 参数默认值：为了提高代码的灵活性，可以为每个参数设置默认值。如果在接口调用时未传入该参数，则会使用默认值。
4. 参数说明：为每个参数提供详细的说明。可以使用注释或者在文档中进行文档说明。

3. 编写Vue接口封装

在确定了接口需求和参数设计之后，接下来就是编写Vue接口封装的代码了。我们可以使用 axios 来进行网络请求，axios 是一个基于 promise 的 HTTP 库，可以用在浏览器和 node.js 中。

具体流程如下：

1. 引入 axios 库

import axios from 'axios'

1. 创建 axios 实例

const service = axios.create({
  baseURL: 'http://localhost:8080', // 如果有统一的接口前缀，可以在这里设置
  timeout: 10000 // 超时时间
})

1. 封装请求方法

export const request = (url, method = 'get', data = {}) => {
  return new Promise((resolve, reject) => {
    service({
      url,
      method,
      data
    })
      .then(response => {
        // 请求成功处理
        if (response.status === 200) {
          resolve(response.data)
        } else {
          reject(response)
        }
      })
      .catch(error => {
        // 请求失败处理
        reject(error)
      })
  })
}

1. 编写具体接口封装

// 登录接口
export const login = (params = {}) => {
  const url = '/api/login'
  const { username, password } = params
  const data = {
    username,
    password
  }
  return request(url, 'post', data)
}

// 获取用户信息接口
export const getUserInfo = (params = {}) => {
  const url = '/api/getUserInfo'
  return request(url, 'get', params)
}

4. 使用接口封装

接口封装完成后，我们就可以在 Vue 组件中使用它了。以获取用户信息为例，可以这样使用：

import { getUserInfo } from 'api/user'

export default {
  methods: {
    async getUserInfo () {
      try {
        const result = await getUserInfo()
        // 处理获取用户信息成功的逻辑
      } catch (error) {
        // 处理获取用户信息失败的逻辑
      }
    }
  }
}

以上是使用 Vue 形式的接口封装的完整攻略，附上一个获取Github API的示例：

1. 确定接口需求

获取 Github 用户信息 API

1. 设计接口参数

无需参数

1. 编写 Vue 接口封装

import axios from 'axios'

export const requestGithub = (url, method = 'get') => {
  return new Promise((resolve, reject) => {
    const instance = axios.create({
      baseURL: 'https://api.github.com/users/',
      timeout: 10000
    })
    instance({
      url,
      method
    })
      .then(response => {
        if (response.status === 200) {
          resolve(response.data)
        } else {
          reject(response)
        }
      })
      .catch(error => {
        reject(error)
      })
  })
}

1. 使用接口封装

import { requestGithub } from 'api/github'

export default {
  methods: {
    async getUserInfo () {
      try {
        const result = await requestGithub('astrobids')
        // 处理获取 Github 用户信息成功的逻辑
      } catch (error) {
        // 处理获取 Github 用户信息失败的逻辑
      }
    }
  }
}

以上是完整的 Vue 接口封装攻略，希望对你有所帮助！