照例先貼上 axios 的 gitHub 地址
不管用什么方式獲取數(shù)據(jù),對于一個項(xiàng)目來說,代碼一定要利于維護(hù)其次是一定要寫的優(yōu)美,因此加上一層封裝是必要的
vuejs2.0 已經(jīng)不再維護(hù) vue-resource,vuejs2.0 已經(jīng)使用了 axios,這也是為什么我會轉(zhuǎn)到 axios 的主要原因,廢話不多說:
基本的封裝要求:
文件結(jié)構(gòu)
使用 vue-cli 進(jìn)行相關(guān)的封裝,在 src 文件夾下:
src |-- http 封裝axios模塊文件夾 |---- config.js axios的默認(rèn)配置---- api.js 二次封裝axios,攔截器等---- interface.js 請求接口文件---- index.js 將axios封裝成插件
config.js
默認(rèn)配置參照 gitHub,以下只做示例:
export default { method: 'post', // 基礎(chǔ)url前綴 baseURL: 'https://easy-mock.com/mock/5ad75e9f41d4d65f0e935be4/example', // 請求頭信息 headers: { 'Content-Type':'application/json;charset=UTF-8' }, // 參數(shù) data: {}, // 設(shè)置超時時間 timeout: 10000, // 攜帶憑證 withCredentials: false, // 返回?cái)?shù)據(jù)類型 responseType: 'json'}PS: 這里推薦一下一款 Mock 工具Easy Mock,以上請求地址來自該工具。以后有空會單獨(dú)寫一下怎么使用該工具。
api.js
import axios from 'axios' // 注意先安裝哦import config from './config.js' // 倒入默認(rèn)配置import qs from 'qs' // 序列化請求數(shù)據(jù),視服務(wù)端的要求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 // 請求開始的時候可以結(jié)合 vuex 開啟全屏的 loading 動畫 // Tip: 2 // 帶上 token , 可以結(jié)合 vuex 或者重 localStorage // if (store.getters.token) { // config.headers['X-Token'] = getToken() // 讓每個請求攜帶token--['X-Token']為自定義key 請根據(jù)實(shí)際情況自行修改 // } else { // // 重定向到登錄頁面 // } // Tip: 3 // 根據(jù)請求方法,序列化傳來的參數(shù),根據(jù)后端需求是否序列化 if (config.method.toLocaleLowerCase() === 'post' || config.method.toLocaleLowerCase() === 'put' || config.method.toLocaleLowerCase() === 'delete') { config.data = qs.stringify(config.data) } return config }, error => { // 請求錯誤時做些事(接口錯誤、超時等) // Tip: 4 // 關(guān)閉loadding console.log('request:', error) // 1.判斷請求超時 if (error.code === 'ECONNABORTED' && error.message.indexOf('timeout') !== -1) { console.log('根據(jù)你設(shè)置的timeout/真的請求超時 判斷請求現(xiàn)在超時了,你可以在這里加入超時的處理方案') // return service.request(originalRequest);//例如再重復(fù)請求一次 } // 2.需要重定向到錯誤頁面 const errorInfo = error.response console.log(errorInfo) if (errorInfo) { // error =errorInfo.data//頁面那邊catch的時候就能拿到詳細(xì)的錯誤信息,看最下邊的Promise.reject const errorStatus = errorInfo.status; // 404 403 500 ... 等 router.push({ path: `/error/${errorStatus}` }) } return Promise.reject(error) // 在調(diào)用的那邊可以拿到(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 } // 根據(jù)返回的code值來做不同的處理(和后端約定) switch (data.code) { case '': break; default: } // 若不是正確的返回code,且已經(jīng)登錄,就拋出錯誤 // 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 = '未授權(quán),請登錄' break case 403: err.message = '拒絕訪問' break case 404: err.message = `請求地址出錯: ${err.response.config.url}` break case 408: err.message = '請求超時' break case 500: err.message = '服務(wù)器內(nèi)部錯誤' break case 501: err.message = '服務(wù)未實(shí)現(xiàn)' break case 502: err.message = '網(wǎng)關(guān)錯誤' break case 503: err.message = '服務(wù)不可用' break case 504: err.message = '網(wǎng)關(guān)超時' 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/* 將所有接口統(tǒng)一起來便于維護(hù) * 如果項(xiàng)目很大可以將 url 獨(dú)立成文件,接口分成不同的模塊 * 此處的數(shù)據(jù)依然來自 Easy Mock */// 單獨(dú)倒出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 })}// 默認(rèn)全部倒出// 根絕需要進(jìn)行 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.jsimport api from './http/index'Vue.use(api)// 此時可以直接在 Vue 原型上調(diào)用 $api 了
總結(jié)
PS: IE9 不支持 Promise 哦,需要安裝一個 polyfill
import 'babel-polyfill'
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持武林網(wǎng)。
新聞熱點(diǎn)
疑難解答