Аксиомы вторичной инкапсуляции Vue для использования плагинов

внешний интерфейс JavaScript Vue.js axios

Вставить как обычноaxiosизgitHubадрес

Независимо от того, какой метод используется для получения данных, для проекта код должен быть простым в обслуживании с последующим красивым написанием, поэтому необходимо добавить слой инкапсуляции.

vuejs2.0 больше не поддерживаетсяvue-resource, vuejs2.0 был использованaxios, поэтому я иду вaxiosОсновная причина, без лишних слов:

Основные требования к упаковке:

  • Единая конфигурация URL
  • единый API-запрос
  • запрос (запрос) перехватчик, например: принести токен и т.д., установить заголовок запроса
  • Перехватчики ответа (response), такие как: унифицированная обработка ошибок, перенаправление страниц и т. д.
  • Комбинируйте по мере необходимостиVuexСделайте глобальную анимацию загрузки или неправильную обработку
  • Будуaxiosупаковано вVueиспользование плагина

файловая структура

использоватьvue-cliВыполните соответствующую упаковку в папке src:

src
    |
-- папка модуля http пакета axios
      |
---- config.js конфигурация axios по умолчанию
---- аксиомы вторичной инкапсуляции api.js, перехватчики и т. д.
---- interface.js файл интерфейса запроса
---- index.js инкапсулирует axios в качестве плагина

config.js

Справочник по конфигурации по умолчаниюgitHub, это просто пример:

export default {
    method: 'post',
    // 基础url前缀
    baseURL: 'https://easy-mock.com/mock/5ad75e9f41d4d65f0e935be4/example',
    // 请求头信息
    headers: {
      'Content-Type':'application/json;charset=UTF-8'
    },
    // 参数
    data: {},
    // 设置超时时间
    timeout: 10000,
    // 携带凭证
    withCredentials: false,
    // 返回数据类型
    responseType: 'json'
}

PS:Вот рекомендацияMockинструментEasy Mock, указанный выше адрес запроса исходит от этого инструмента. Я напишу о том, как использовать этот инструмент, когда у меня будет время в будущем.

api.js

import axios from 'axios' // 注意先安装哦
import config from './config.js' // 倒入默认配置
import qs from 'qs' // 序列化请求数据,视服务端的要求

export default function $axios (options) {
    return new Promise((resolve, reject) => {
        const instance = axios.create({
            baseURL: config.baseURL,
            headers: {},
            transformResponse: [function (data) {}]
        }
    )

    // request 拦截器
    instance.interceptors.request.use(
        config => {
			// Tip: 1
			// 请求开始的时候可以结合 vuex 开启全屏的 loading 动画

			// Tip: 2 
			// 带上 token , 可以结合 vuex 或者重 localStorage
			// if (store.getters.token) {
			//     config.headers['X-Token'] = getToken() // 让每个请求携带token--['X-Token']为自定义key 请根据实际情况自行修改
			// } else {
			//     // 重定向到登录页面    
			// }

			// Tip: 3
			// 根据请求方法,序列化传来的参数,根据后端需求是否序列化
			if (config.method.toLocaleLowerCase() === 'post' 
				|| config.method.toLocaleLowerCase() === 'put' 
				|| config.method.toLocaleLowerCase() === 'delete') {

				config.data = qs.stringify(config.data)
			}
          	return config
        },
        error => {
			// 请求错误时做些事(接口错误、超时等)
			// Tip: 4
			// 关闭loadding
			console.log('request:', error) 
		
			//  1.判断请求超时
			if (error.code === 'ECONNABORTED' && error.message.indexOf('timeout') !== -1) {
				console.log('根据你设置的timeout/真的请求超时 判断请求现在超时了,你可以在这里加入超时的处理方案')
				// return service.request(originalRequest);//例如再重复请求一次
			}
			//  2.需要重定向到错误页面
			const errorInfo = error.response
			console.log(errorInfo)
			if (errorInfo) {
				// error =errorInfo.data//页面那边catch的时候就能拿到详细的错误信息,看最下边的Promise.reject
				const errorStatus = errorInfo.status; // 404 403 500 ... 等
				router.push({
					path: `/error/${errorStatus}`
				})
			}
			return Promise.reject(error) // 在调用的那边可以拿到(catch)你想返回的错误信息
        }
    )
  
    // response 拦截器
    instance.interceptors.response.use(
        response => {
			let data;
			// IE9时response.data是undefined,因此需要使用response.request.responseText(Stringify后的字符串)
			if(response.data == undefined){
				data = response.request.responseText
			} else{
				data = response.data
			}
			// 根据返回的code值来做不同的处理(和后端约定)
			switch (data.code) {
				case '':
				break;
				default:
			}
			// 若不是正确的返回code,且已经登录,就抛出错误
			// const err = new Error(data.description)

			// err.data = data
			// err.response = response

			// throw err
          	return data
        },
        err => {
			if (err && err.response) {
				switch (err.response.status) {
					case 400:
					err.message = '请求错误'
					break
			
					case 401:
					err.message = '未授权,请登录'
					break
			
					case 403:
					err.message = '拒绝访问'
					break
			
					case 404:
					err.message = `请求地址出错: ${err.response.config.url}`
					break
			
					case 408:
					err.message = '请求超时'
					break
			
					case 500:
					err.message = '服务器内部错误'
					break
			
					case 501:
					err.message = '服务未实现'
					break
			
					case 502:
					err.message = '网关错误'
					break
			
					case 503:
					err.message = '服务不可用'
					break
			
					case 504:
					err.message = '网关超时'
					break
			
					case 505:
					err.message = 'HTTP版本不受支持'
					break
			
					default:
				}
			}
			console.error(err)
            // 此处我使用的是 element UI 的提示组件
			// Message.error(`ERROR: ${err}`);
			return Promise.reject(err) // 返回接口返回的错误信息
        }
    )
  
    //请求处理
    instance(options)
        .then((res) => {
			resolve(res)
			return false
        })
        .catch((error) => {
            reject(error)
        })
    })
}

interface.js

import axios from './api' // 倒入 api

/* 将所有接口统一起来便于维护
 * 如果项目很大可以将 url 独立成文件,接口分成不同的模块
 * 此处的数据依然来自 Easy Mock
 */

// 单独倒出
export const query = params => {
    return axios({
        url: '/query',
        method: 'get',
        params
    })
}
  
export const mock = params => {
    return axios({
        url: '/mock',
        method: 'get',
        params
    })
}

export const upload = data => {
    return axios({
        url: '/upload',
        method: 'post',
        data
    })
}

// 默认全部倒出
// 根绝需要进行  
export default {
    query,
    mock,
    upload
}

index.js

упаковано вVueВставьте, затем (поднимите) в (высокий) сделайте (B) используйте (сетку)

// 倒入所有接口
import apiList from './interface'

const install = Vue => {
    if (install.installed) 
        return;
    install.installed = true;

    Object.defineProperties(Vue.prototype, {
        // 注意哦,此处挂载在 Vue 原型的 $api 对象上
        $api: {
            get() {
                return apiList
            }
        }
    })
}

export default install

использовать

До сих пор все готово и отправлено, а вmian.jsСделайте следующее в:

// 倒入 http 文件夹下的 index.js
import api from './http/index'
Vue.use(api)

// 此时可以直接在 Vue 原型上调用 $api 了

Суммировать

  • Вышеупомянутая вторичная упаковка является относительно комплексной, в основном удовлетворяя наши предыдущие потребности.
  • При обработке ошибок также необходимо согласовать возвращаемое значение с серверной частью и заключить конкретные соглашения.
  • Есть много обратных вызовов инкапсуляции, и вам нужно добавить их, когда вы их используете.then()обработать результат,async & awaitУзнайте об этом, конечно, хорошие вещи должны быть скрыты, поэтому я не буду ими делиться...

PS:IE9 не поддерживает Promise О, вам нужно установить егоpolyfill

import 'babel-polyfill'