(轉(zhuǎn))vue中Axios的封裝和API接口的管理(更新)

我們所要的說的axios的封裝和api接口的統(tǒng)一管理箭阶,其實(shí)主要目的就是在幫助我們簡化代碼和利于后期的更新維護(hù)府树。

一、axios的封裝

在vue項(xiàng)目中澜倦,和后臺交互獲取數(shù)據(jù)這塊聚蝶,我們通常使用的是axios庫,它是基于promise的http庫藻治,可運(yùn)行在瀏覽器端和node.js中碘勉。他有很多優(yōu)秀的特性,例如攔截請求和響應(yīng)桩卵、取消請求验靡、轉(zhuǎn)換json、客戶端防御XSRF等雏节。所以我們的尤大大也是果斷放棄了對其官方庫vue-resource的維護(hù)胜嗓,直接推薦我們使用axios庫。如果還對axios不了解的钩乍,可以移步axios文檔辞州。

安裝

npm install axios; // 安裝axios復(fù)制代碼

引入

一般我會在項(xiàng)目的src目錄中,新建一個request文件夾寥粹,然后在里面新建一個http.js和一個api.js文件变过。http.js文件用來封裝我們的axios,api.js用來統(tǒng)一管理我們的接口涝涤。

// 在http.js中引入axios
import axios from 'axios'; // 引入axios
import QS from 'qs'; // 引入qs模塊媚狰,用來序列化post類型的數(shù)據(jù),后面會提到
// vant的toast提示框組件阔拳,大家可根據(jù)自己的ui組件更改崭孤。
import { Toast } from 'vant'; 
復(fù)制代碼

環(huán)境的切換

我們的項(xiàng)目環(huán)境可能有開發(fā)環(huán)境、測試環(huán)境和生產(chǎn)環(huán)境糊肠。我們通過node的環(huán)境變量來匹配我們的默認(rèn)的接口url前綴裳瘪。axios.defaults.baseURL可以設(shè)置axios的默認(rèn)請求地址就不多說了。

// 環(huán)境的切換
if (process.env.NODE_ENV == 'development') {    
    axios.defaults.baseURL = 'https://www.baidu.com';} 
else if (process.env.NODE_ENV == 'debug') {    
    axios.defaults.baseURL = 'https://www.ceshi.com';
} 
else if (process.env.NODE_ENV == 'production') {    
    axios.defaults.baseURL = 'https://www.production.com';
}復(fù)制代碼

設(shè)置請求超時

通過axios.defaults.timeout設(shè)置默認(rèn)的請求超時時間罪针。例如超過了10s彭羹,就會告知用戶當(dāng)前請求超時,請刷新等泪酱。

axios.defaults.timeout = 10000;復(fù)制代碼

post請求頭的設(shè)置

post請求的時候派殷,我們需要加上一個請求頭,所以可以在這里進(jìn)行一個默認(rèn)的設(shè)置墓阀,即設(shè)置post的請求頭為application/x-www-form-urlencoded;charset=UTF-8

axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded;charset=UTF-8';復(fù)制代碼
  • 請求攔截

我們在發(fā)送請求前可以進(jìn)行一個請求的攔截毡惜,為什么要攔截呢,我們攔截請求是用來做什么的呢斯撮?比如经伙,有些請求是需要用戶登錄之后才能訪問的,或者post請求的時候,我們需要序列化我們提交的數(shù)據(jù)帕膜。這時候枣氧,我們可以在請求被發(fā)送之前進(jìn)行一個攔截,從而進(jìn)行我們想要的操作垮刹。

請求攔截

// 先導(dǎo)入vuex,因?yàn)槲覀円褂玫嚼锩娴臓顟B(tài)對象
// vuex的路徑根據(jù)自己的路徑去寫
import store from '@/store/index';

// 請求攔截器axios.interceptors.request.use(    
    config => {        
        // 每次發(fā)送請求之前判斷vuex中是否存在token        
        // 如果存在达吞,則統(tǒng)一在http請求的header都加上token,這樣后臺根據(jù)token判斷你的登錄情況
        // 即使本地存在token荒典,也有可能token是過期的酪劫,所以在響應(yīng)攔截器中要對返回狀態(tài)進(jìn)行判斷 
        const token = store.state.token;        
        token && (config.headers.Authorization = token);        
        return config;    
    },    
    error => {        
        return Promise.error(error);    
})
復(fù)制代碼

這里說一下token,一般是在登錄完成之后寺董,將用戶的token通過localStorage或者cookie存在本地覆糟,然后用戶每次在進(jìn)入頁面的時候(即在main.js中),會首先從本地存儲中讀取token遮咖,如果token存在說明用戶已經(jīng)登陸過滩字,則更新vuex中的token狀態(tài)。然后盯滚,在每次請求接口的時候踢械,都會在請求的header中攜帶token,后臺人員就可以根據(jù)你攜帶的token來判斷你的登錄是否過期魄藕,如果沒有攜帶内列,則說明沒有登錄過。這時候或許有些小伙伴會有疑問了背率,就是每個請求都攜帶token话瞧,那么要是一個頁面不需要用戶登錄就可以訪問的怎么辦呢?其實(shí)寝姿,你前端的請求可以攜帶token留特,但是后臺可以選擇不接收扒菥妗俏拱!

響應(yīng)的攔截

// 響應(yīng)攔截器
axios.interceptors.response.use(    
    response => {   
        // 如果返回的狀態(tài)碼為200雷恃,說明接口請求成功,可以正常拿到數(shù)據(jù)     
        // 否則的話拋出錯誤
        if (response.status === 200) {            
            return Promise.resolve(response);        
        } else {            
            return Promise.reject(response);        
        }    
    },    
    // 服務(wù)器狀態(tài)碼不是2開頭的的情況
    // 這里可以跟你們的后臺開發(fā)人員協(xié)商好統(tǒng)一的錯誤狀態(tài)碼    
    // 然后根據(jù)返回的狀態(tài)碼進(jìn)行一些操作根资,例如登錄過期提示架专,錯誤提示等等
    // 下面列舉幾個常見的操作,其他需求可自行擴(kuò)展
    error => {            
        if (error.response.status) {            
            switch (error.response.status) {                
                // 401: 未登錄
                // 未登錄則跳轉(zhuǎn)登錄頁面玄帕,并攜帶當(dāng)前頁面的路徑
                // 在登錄成功后返回當(dāng)前頁面部脚,這一步需要在登錄頁操作。                
                case 401:                    
                    router.replace({                        
                        path: '/login',                        
                        query: { 
                            redirect: router.currentRoute.fullPath 
                        }
                    });
                    break;

                // 403 token過期
                // 登錄過期對用戶進(jìn)行提示
                // 清除本地token和清空vuex中token對象
                // 跳轉(zhuǎn)登錄頁面                
                case 403:
                     Toast({
                        message: '登錄過期裤纹,請重新登錄',
                        duration: 1000,
                        forbidClick: true
                    });
                    // 清除token
                    localStorage.removeItem('token');
                    store.commit('loginSuccess', null);
                    // 跳轉(zhuǎn)登錄頁面委刘,并將要瀏覽的頁面fullPath傳過去,登錄成功后跳轉(zhuǎn)需要訪問的頁面 
                    setTimeout(() => {                        
                        router.replace({                            
                            path: '/login',                            
                            query: { 
                                redirect: router.currentRoute.fullPath 
                            }                        
                        });                    
                    }, 1000);                    
                    break; 

                // 404請求不存在
                case 404:
                    Toast({
                        message: '網(wǎng)絡(luò)請求不存在',
                        duration: 1500,
                        forbidClick: true
                    });
                    break;
                // 其他錯誤,直接拋出錯誤提示
                default:
                    Toast({
                        message: error.response.data.message,
                        duration: 1500,
                        forbidClick: true
                    });
            }
            return Promise.reject(error.response);
        }
    }    
});復(fù)制代碼

響應(yīng)攔截器很好理解锡移,就是服務(wù)器返回給我們的數(shù)據(jù)呕童,我們在拿到之前可以對他進(jìn)行一些處理。例如上面的思想:如果后臺返回的狀態(tài)碼是200罩抗,則正常返回數(shù)據(jù)拉庵,否則的根據(jù)錯誤的狀態(tài)碼類型進(jìn)行一些我們需要的錯誤灿椅,其實(shí)這里主要就是進(jìn)行了錯誤的統(tǒng)一處理和沒登錄或登錄過期后調(diào)整登錄頁的一個操作套蒂。

要注意的是,上面的Toast()方法茫蛹,是我引入的vant庫中的toast輕提示組件操刀,你根據(jù)你的ui庫,對應(yīng)使用你的一個提示組件婴洼。

封裝get方法和post方法

我們常用的ajax請求方法有g(shù)et骨坑、post、put等方法柬采,相信小伙伴都不會陌生欢唾。axios對應(yīng)的也有很多類似的方法,不清楚的可以看下文檔粉捻。但是為了簡化我們的代碼礁遣,我們還是要對其進(jìn)行一個簡單的封裝。下面我們主要封裝兩個方法:get和post肩刃。

get方法:我們通過定義一個get函數(shù)祟霍,get函數(shù)有兩個參數(shù),第一個參數(shù)表示我們要請求的url地址盈包,第二個參數(shù)是我們要攜帶的請求參數(shù)沸呐。get函數(shù)返回一個promise對象,當(dāng)axios其請求成功時resolve服務(wù)器返回 值呢燥,請求失敗時reject錯誤值崭添。最后通過export拋出get函數(shù)。

/**
 * get方法叛氨,對應(yīng)get請求
 * @param {String} url [請求的url地址]
 * @param {Object} params [請求時攜帶的參數(shù)]
 */
export function get(url, params){    
    return new Promise((resolve, reject) =>{        
        axios.get(url, {            
            params: params        
        }).then(res => {
            resolve(res.data);
        }).catch(err =>{
            reject(err.data)        
    })    
});}復(fù)制代碼

post方法:原理同get基本一樣呼渣,但是要注意的是,post方法必須要使用對提交從參數(shù)對象進(jìn)行序列化的操作力试,所以這里我們通過node的qs模塊來序列化我們的參數(shù)徙邻。這個很重要,如果沒有序列化操作畸裳,后臺是拿不到你提交的數(shù)據(jù)的缰犁。這就是文章開頭我們import QS from 'qs';的原因。如果不明白序列化是什么意思的,就百度一下吧帅容,答案一大堆颇象。

/** 
 * post方法,對應(yīng)post請求 
 * @param {String} url [請求的url地址] 
 * @param {Object} params [請求時攜帶的參數(shù)] 
 */
export function post(url, params) {
    return new Promise((resolve, reject) => {
         axios.post(url, QS.stringify(params))
        .then(res => {
            resolve(res.data);
        })
        .catch(err =>{
            reject(err.data)
        })
    });
}復(fù)制代碼

這里有個小細(xì)節(jié)說下并徘,axios.get()方法和axios.post()在提交數(shù)據(jù)時參數(shù)的書寫方式還是有區(qū)別的遣钳。區(qū)別就是,get的第二個參數(shù)是一個{}麦乞,然后這個對象的params屬性值是一個參數(shù)對象的蕴茴。而post的第二個參數(shù)就是一個參數(shù)對象。兩者略微的區(qū)別要留意哦姐直!

[圖片上傳失敗...(image-901e8a-1535623727506)]

axios的封裝基本就完成了倦淀,下面再簡單說下api的統(tǒng)一管理。

整齊的api就像電路板一樣声畏,即使再復(fù)雜也能很清晰整個線路撞叽。上面說了,我們會新建一個api.js,然后在這個文件中存放我們所有的api接口插龄。

  • 首先我們在api.js中引入我們封裝的get和post方法
/**   
 * api接口統(tǒng)一管理
 */
import { get, post } from './http'復(fù)制代碼

現(xiàn)在愿棋,例如我們有這樣一個接口,是一個post請求:

http://www.baiodu.com/api/v1/users/my_address/address_edit_before復(fù)制代碼

我們可以在api.js中這樣封裝:

export const apiAddress = p => post('api/v1/users/my_address/address_edit_before', p);復(fù)制代碼

我們定義了一個apiAddress方法均牢,這個方法有一個參數(shù)p糠雨,p是我們請求接口時攜帶的參數(shù)對象。而后調(diào)用了我們封裝的post方法膨处,post方法的第一個參數(shù)是我們的接口地址见秤,第二個參數(shù)是apiAddress的p參數(shù),即請求接口時攜帶的參數(shù)對象真椿。最后通過export導(dǎo)出apiAddress鹃答。

然后在我們的頁面中可以這樣調(diào)用我們的api接口:

import { apiAddress } from '@/request/api';// 導(dǎo)入我們的api接口
export default {        
    name: 'Address',    
    created () {
        this.onLoad();
    },
    methods: {            
        // 獲取數(shù)據(jù)            
        onLoad() {
            // 調(diào)用api接口,并且提供了兩個參數(shù)                
            apiAddress({                    
                type: 0,                    
                sort: 1                
            }).then(res => {
                // 獲取數(shù)據(jù)成功后的其他操作
                ………………                
            })            
        }        
    }
}復(fù)制代碼

其他的api接口突硝,就在pai.js中繼續(xù)往下面擴(kuò)展就可以了测摔。友情提示,為每個接口寫好注釋哦=馇 7姘恕!

api接口管理的一個好處就是护盈,我們把a(bǔ)pi統(tǒng)一集中起來挟纱,如果后期需要修改接口,我們就直接在api.js中找到對應(yīng)的修改就好了腐宋,而不用去每一個頁面查找我們的接口然后再修改會很麻煩紊服。關(guān)鍵是檀轨,萬一修改的量比較大,就規(guī)格gg了欺嗤。還有就是如果直接在我們的業(yè)務(wù)代碼修改接口参萄,一不小心還容易動到我們的業(yè)務(wù)代碼造成不必要的麻煩。

好了煎饼,最后把完成的axios封裝代碼奉上讹挎。

/**axios封裝
 * 請求攔截、相應(yīng)攔截吆玖、錯誤統(tǒng)一處理
 */
import axios from 'axios';import QS from 'qs';
import { Toast } from 'vant';
import store from '../store/index'

// 環(huán)境的切換
if (process.env.NODE_ENV == 'development') {    
    axios.defaults.baseURL = '/api';
} else if (process.env.NODE_ENV == 'debug') {    
    axios.defaults.baseURL = '';
} else if (process.env.NODE_ENV == 'production') {    
    axios.defaults.baseURL = 'http://api.123dailu.com/';
}

// 請求超時時間
axios.defaults.timeout = 10000;

// post請求頭
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded;charset=UTF-8';

// 請求攔截器
axios.interceptors.request.use(    
    config => {
        // 每次發(fā)送請求之前判斷是否存在token筒溃,如果存在,則統(tǒng)一在http請求的header都加上token衰伯,不用每次請求都手動添加了
        // 即使本地存在token铡羡,也有可能token是過期的积蔚,所以在響應(yīng)攔截器中要對返回狀態(tài)進(jìn)行判斷
        const token = store.state.token;        
        token && (config.headers.Authorization = token);        
        return config;    
    },    
    error => {        
        return Promise.error(error);    
    })

// 響應(yīng)攔截器
axios.interceptors.response.use(    
    response => {        
        if (response.status === 200) {            
            return Promise.resolve(response);        
        } else {            
            return Promise.reject(response);        
        }    
    },
    // 服務(wù)器狀態(tài)碼不是200的情況    
    error => {        
        if (error.response.status) {            
            switch (error.response.status) {                
                // 401: 未登錄                
                // 未登錄則跳轉(zhuǎn)登錄頁面意鲸,并攜帶當(dāng)前頁面的路徑                
                // 在登錄成功后返回當(dāng)前頁面,這一步需要在登錄頁操作尽爆。                
                case 401:                    
                    router.replace({                        
                        path: '/login',                        
                        query: { redirect: router.currentRoute.fullPath } 
                    });
                    break;
                // 403 token過期                
                // 登錄過期對用戶進(jìn)行提示                
                // 清除本地token和清空vuex中token對象                
                // 跳轉(zhuǎn)登錄頁面                
                case 403:                     
                    Toast({                        
                        message: '登錄過期怎顾,請重新登錄',                        
                        duration: 1000,                        
                        forbidClick: true                    
                    });                    
                    // 清除token                    
                    localStorage.removeItem('token');                    
                    store.commit('loginSuccess', null);                    
                    // 跳轉(zhuǎn)登錄頁面,并將要瀏覽的頁面fullPath傳過去漱贱,登錄成功后跳轉(zhuǎn)需要訪問的頁面
                    setTimeout(() => {                        
                        router.replace({                            
                            path: '/login',                            
                            query: { 
                                redirect: router.currentRoute.fullPath 
                            }                        
                        });                    
                    }, 1000);                    
                    break; 
                // 404請求不存在                
                case 404:                    
                    Toast({                        
                        message: '網(wǎng)絡(luò)請求不存在',                        
                        duration: 1500,                        
                        forbidClick: true                    
                    });                    
                break;                
                // 其他錯誤槐雾,直接拋出錯誤提示                
                default:                    
                    Toast({                        
                        message: error.response.data.message,                        
                        duration: 1500,                        
                        forbidClick: true                    
                    });            
            }            
            return Promise.reject(error.response);        
        }       
    }
);
/** 
 * get方法,對應(yīng)get請求 
 * @param {String} url [請求的url地址] 
 * @param {Object} params [請求時攜帶的參數(shù)] 
 */
export function get(url, params){    
    return new Promise((resolve, reject) =>{        
        axios.get(url, {            
            params: params        
        })        
        .then(res => {            
            resolve(res.data);        
        })        
        .catch(err => {            
            reject(err.data)        
        })    
    });
}
/** 
 * post方法幅狮,對應(yīng)post請求 
 * @param {String} url [請求的url地址] 
 * @param {Object} params [請求時攜帶的參數(shù)] 
 */
export function post(url, params) {    
    return new Promise((resolve, reject) => {         
        axios.post(url, QS.stringify(params))        
        .then(res => {            
            resolve(res.data);        
        })        
        .catch(err => {            
            reject(err.data)        
        })    
    });
}
復(fù)制代碼

如果喜歡募强,就給個??吧()

*********華麗麗的分割線******************華麗麗的分割線******************華麗麗的分割線******************華麗麗的分割線******************華麗麗的分割線*********

2018.8.14更新

axios的封裝根據(jù)需求的不同而不同。這里非常感謝評論里一些很中肯的建議崇摄,我也對此進(jìn)行了思考和針對不同需求的改善擎值。主要有以下改變:

1.優(yōu)化axios封裝,去掉之前的get和post

2.斷網(wǎng)情況處理

3.更加模塊化的api管理

4.接口域名有多個的情況

5.api掛載到vue.prototype上省去引入的步驟

http.js中axios封裝的優(yōu)化逐抑,先直接貼代碼:

/**
 * axios封裝
 * 請求攔截鸠儿、響應(yīng)攔截、錯誤統(tǒng)一處理
 */
import axios from 'axios';
import router from '../router';
import store from '../store/index';
import { Toast } from 'vant';

/** 
 * 提示函數(shù) 
 * 禁止點(diǎn)擊蒙層厕氨、顯示一秒后關(guān)閉
 */
const tip = msg => {    
    Toast({        
        message: msg,        
        duration: 1000,        
        forbidClick: true    
    });
}

/** 
 * 跳轉(zhuǎn)登錄頁
 * 攜帶當(dāng)前頁面路由进每,以期在登錄頁面完成登錄后返回當(dāng)前頁面
 */
const toLogin = () => {
    router.replace({
        path: '/login',        
        query: {
            redirect: router.currentRoute.fullPath
        }
    });
}

/** 
 * 請求失敗后的錯誤統(tǒng)一處理 
 * @param {Number} status 請求失敗的狀態(tài)碼
 */
const errorHandle = (status, other) => {
    // 狀態(tài)碼判斷
    switch (status) {
        // 401: 未登錄狀態(tài),跳轉(zhuǎn)登錄頁
        case 401:
            toLogin();
            break;
        // 403 token過期
        // 清除token并跳轉(zhuǎn)登錄頁
        case 403:
            tip('登錄過期命斧,請重新登錄');
            localStorage.removeItem('token');
            store.commit('loginSuccess', null);
            setTimeout(() => {
                toLogin();
            }, 1000);
            break;
        // 404請求不存在
        case 404:
            tip('請求的資源不存在'); 
            break;
        default:
            console.log(other);   
        }}

// 創(chuàng)建axios實(shí)例
var instance = axios.create({    timeout: 1000 * 12});
// 設(shè)置post請求頭
instance.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';
/** 
 * 請求攔截器 
 * 每次請求前田晚,如果存在token則在請求頭中攜帶token 
 */ 
instance.interceptors.request.use(    
    config => {        
        // 登錄流程控制中,根據(jù)本地是否存在token判斷用戶的登錄情況        
        // 但是即使token存在国葬,也有可能token是過期的贤徒,所以在每次的請求頭中攜帶token        
        // 后臺根據(jù)攜帶的token判斷用戶的登錄情況遭京,并返回給我們對應(yīng)的狀態(tài)碼        
        // 而后我們可以在響應(yīng)攔截器中,根據(jù)狀態(tài)碼進(jìn)行一些統(tǒng)一的操作泞莉。        
        const token = store.state.token;        
        token && (config.headers.Authorization = token);        
        return config;    
    },    
    error => Promise.error(error))

// 響應(yīng)攔截器
instance.interceptors.response.use(    
    // 請求成功
    res => res.status === 200 ? Promise.resolve(res) : Promise.reject(res),    
    // 請求失敗
    error => {
        const { response } = error;
        if (response) {
            // 請求已發(fā)出哪雕,但是不在2xx的范圍 
            errorHandle(response.status, response.data.message);
            return Promise.reject(response);
        } else {
            // 處理斷網(wǎng)的情況
            // eg:請求超時或斷網(wǎng)時,更新state的network狀態(tài)
            // network狀態(tài)在app.vue中控制著一個全局的斷網(wǎng)提示組件的顯示隱藏
            // 關(guān)于斷網(wǎng)組件中的刷新重新獲取數(shù)據(jù)鲫趁,會在斷網(wǎng)組件中說明
            store.commit('changeNetwork', false);
        }
    });

export default instance;復(fù)制代碼

這個axios和之前的大同小異斯嚎,做了如下幾點(diǎn)改變:

1.去掉了之前get和post方法的封裝,通過創(chuàng)建一個axios實(shí)例然后export default方法導(dǎo)出挨厚,這樣使用起來更靈活一些堡僻。

2.去掉了通過環(huán)境變量控制baseUrl的值∫咛辏考慮到接口會有多個不同域名的情況钉疫,所以準(zhǔn)備通過js變量來控制接口域名。這點(diǎn)具體在api里會介紹巢价。

3.增加了請求超時牲阁,即斷網(wǎng)狀態(tài)的處理。說下思路壤躲,當(dāng)斷網(wǎng)時城菊,通過更新vuex中network的狀態(tài)來控制斷網(wǎng)提示組件的顯示隱藏。斷網(wǎng)提示一般會有重新加載數(shù)據(jù)的操作碉克,這步會在后面對應(yīng)的地方介紹凌唬。

4.公用函數(shù)進(jìn)行抽出,簡化代碼漏麦,盡量保證單一職責(zé)原則客税。

下面說下api這塊,考慮到一下需求:

1.更加模塊化

2.更方便多人開發(fā)撕贞,有效減少解決命名沖突

3.處理接口域名有多個情況

這里這里呢新建了一個api文件夾更耻,里面有一個index.js和一個base.js,以及多個根據(jù)模塊劃分的接口js文件麻掸。index.js是一個api的出口酥夭,base.js管理接口域名,其他js則用來管理各個模塊的接口脊奋。

先放index.js代碼:

/** 
 * api接口的統(tǒng)一出口
 */
// 文章模塊接口
import article from '@/api/article';
// 其他模塊的接口……

// 導(dǎo)出接口
export default {    
    article,
    // ……
}復(fù)制代碼

index.js是一個api接口的出口熬北,這樣就可以把a(bǔ)pi接口根據(jù)功能劃分為多個模塊,利于多人協(xié)作開發(fā)诚隙,比如一個人只負(fù)責(zé)一個模塊的開發(fā)等讶隐,還能方便每個模塊中接口的命名哦。

base.js:

/**
 * 接口域名的管理
 */
const base = {    
    sq: 'https://xxxx111111.com/api/v1',    
    bd: 'http://xxxxx22222.com/api'
}

export default base;復(fù)制代碼

通過base.js來管理我們的接口域名久又,不管有多少個都可以通過這里進(jìn)行接口的定義巫延。即使修改起來效五,也是很方便的。

最后就是接口模塊的說明炉峰,例如上面的article.js:

/**
 * article模塊接口列表
 */

import base from './base'; // 導(dǎo)入接口域名列表
import axios from '@/utils/http'; // 導(dǎo)入http中創(chuàng)建的axios實(shí)例
import qs from 'qs'; // 根據(jù)需求是否導(dǎo)入qs模塊

const article = {    
    // 新聞列表    
    articleList () {        
        return axios.get(`${base.sq}/topics`);    
    },    
    // 新聞詳情,演示    
    articleDetail (id, params) {        
        return axios.get(`${base.sq}/topic/${id}`, {            
            params: params        
        });    
    },
    // post提交    
    login (params) {        
        return axios.post(`${base.sq}/accesstoken`, qs.stringify(params));    
    }
    // 其他接口…………
}

export default article;復(fù)制代碼

1.通過直接引入我們封裝好的axios實(shí)例畏妖,然后定義接口、調(diào)用axios實(shí)例并返回疼阔,可以更靈活的使用axios戒劫,比如你可以對post請求時提交的數(shù)據(jù)進(jìn)行一個qs序列化的處理等。

2.請求的配置更靈活婆廊,你可以針對某個需求進(jìn)行一個不同的配置迅细。關(guān)于配置的優(yōu)先級,axios文檔說的很清楚淘邻,這個順序是:在 lib/defaults.js 找到的庫的默認(rèn)值茵典,然后是實(shí)例的 defaults 屬性,最后是請求的 config 參數(shù)宾舅。后者將優(yōu)先于前者统阿。

3.restful風(fēng)格的接口,也可以通過這種方式靈活的設(shè)置api接口地址贴浙。

最后砂吞,為了方便api的調(diào)用,我們需要將其掛載到vue的原型上崎溃。在main.js中:

import Vue from 'vue'
import App from './App'
import router from './router' // 導(dǎo)入路由文件
import store from './store' // 導(dǎo)入vuex文件
import api from './api' // 導(dǎo)入api接口

Vue.prototype.$api = api; // 將api掛載到vue的原型上復(fù)制代碼

然后我們可以在頁面中這樣調(diào)用接口,eg:

methods: {    
    onLoad(id) {      
        this.$api.article.articleDetail(id, {        
            api: 123      
        }).then(res=> {
            // 執(zhí)行某些操作      
        })    
    }  
}復(fù)制代碼

再提一下斷網(wǎng)的處理盯质,這里只做一個簡單的示例:

<template>  
    <div id="app">    
        <div v-if="!network">      
            <h3>我沒網(wǎng)了</h3>      
            <div @click="onRefresh">刷新</div>      
        </div>    
        <router-view/>      
    </div>
</template>

<script>
    import { mapState } from 'vuex';
    export default {  
        name: 'App',  
        computed: {    
            ...mapState(['network'])  
        },  
        methods: {    
            // 通過跳轉(zhuǎn)一個空頁面再返回的方式來實(shí)現(xiàn)刷新當(dāng)前頁面數(shù)據(jù)的目的
            onRefresh () {      
                this.$router.replace('/refresh')    
            }  
        }
    }
</script>復(fù)制代碼

這是app.vue袁串,這里簡單演示一下斷網(wǎng)。在http.js中介紹了呼巷,我們會在斷網(wǎng)的時候囱修,來更新vue中network的狀態(tài),那么這里我們根據(jù)network的狀態(tài)來判斷是否需要加載這個斷網(wǎng)組件王悍。斷網(wǎng)情況下破镰,加載斷網(wǎng)組件,不加載對應(yīng)頁面的組件压储。當(dāng)點(diǎn)擊刷新的時候鲜漩,我們通過跳轉(zhuǎn)refesh頁面然后立即返回的方式來實(shí)現(xiàn)重新獲取數(shù)據(jù)的操作。因此我們需要新建一個refresh.vue頁面集惋,并在其beforeRouteEnter鉤子中再返回當(dāng)前頁面孕似。

// refresh.vue
beforeRouteEnter (to, from, next) {
    next(vm => {            
        vm.$router.replace(from.fullPath)        
    })    
}復(fù)制代碼

這是一種全局通用的斷網(wǎng)提示,當(dāng)然了刮刑,也可以根據(jù)自己的項(xiàng)目需求操作喉祭。具體操作就仁者見仁智者見智了养渴。

如果更多的需求,或者說是不一樣的需求泛烙,可以根據(jù)自己的需求進(jìn)行一個改進(jìn)理卑。
轉(zhuǎn)自:https://juejin.im/post/5b55c118f265da0f6f1aa354

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市蔽氨,隨后出現(xiàn)的幾起案子傻工,更是在濱河造成了極大的恐慌,老刑警劉巖孵滞,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件中捆,死亡現(xiàn)場離奇詭異,居然都是意外死亡坊饶,警方通過查閱死者的電腦和手機(jī)泄伪,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來匿级,“玉大人蟋滴,你說我怎么就攤上這事《灰铮” “怎么了津函?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長孤页。 經(jīng)常有香客問我尔苦,道長,這世上最難降的妖魔是什么行施? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任允坚,我火速辦了婚禮,結(jié)果婚禮上蛾号,老公的妹妹穿的比我還像新娘稠项。我一直安慰自己,他們只是感情好鲜结,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布展运。 她就那樣靜靜地躺著,像睡著了一般精刷。 火紅的嫁衣襯著肌膚如雪拗胜。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天贬养,我揣著相機(jī)與錄音挤土,去河邊找鬼。 笑死误算,一個胖子當(dāng)著我的面吹牛仰美,可吹牛的內(nèi)容都是我干的迷殿。 我是一名探鬼主播,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼咖杂,長吁一口氣:“原來是場噩夢啊……” “哼庆寺!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起诉字,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤懦尝,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后壤圃,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體陵霉,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年伍绳,在試婚紗的時候發(fā)現(xiàn)自己被綠了踊挠。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡冲杀,死狀恐怖效床,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情权谁,我是刑警寧澤剩檀,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布,位于F島的核電站旺芽,受9級特大地震影響沪猴,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜甥绿,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一字币、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧共缕,春花似錦、人聲如沸士复。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽阱洪。三九已至便贵,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間冗荸,已是汗流浹背承璃。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留蚌本,地道東北人盔粹。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓隘梨,卻偏偏與公主長得像,于是被迫代替她去往敵國和親舷嗡。 傳聞我的和親對象是個殘疾皇子轴猎,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內(nèi)容