vue項目中axios的封裝請求
一、簡介
axios 是一個輕量的HTTP客戶端,它基於 XMLHttpRequest
服務來執行 HTTP 請求,支持豐富的配置,支持 Promise,支持瀏覽器端和 Node.js 端。自Vue2.0起,尤大大宣佈取消對vue-resource
的官方推薦,轉而推薦 axios。現在 axios 已經成為大部分 Vue 開發者的首選。( 如果你還不熟悉 axios,可以在這裡查看它的API。)
封裝前,先來看下,不封裝的情況下,一個實際項目中axios請求的樣子。
大概是長這樣:
axios('http://localhost:3000/data', { method: 'GET', timeout: 1000, withCredentials: true, headers: { 'Content-Type': 'application/json', Authorization: 'xxx', }, transformRequest: [function (data, headers) { return data; }], // 其他請求配置... }) .then((data) => { // todo: 真正業務邏輯代碼 console.log(data); }, (err) => { if (err.response.status === 401) { // handle authorization error } if (err.response.status === 403) { // handle server forbidden error } // 其他錯誤處理..... console.log(err); });
可以看到在這段代碼中,頁面代碼邏輯隻在第15行處,上方的一大塊請求配置代碼和下方一大塊響應錯誤處理代碼,幾乎跟頁面功能沒有關系,而且每個請求中這些內容都差不多,甚至有的部分完全一樣。
二、封裝後
1.封裝步驟
封裝的本質就是在待封裝的內容外面添加各種東西,然後把它們作為一個新的整體呈現給使用者,以達到擴展和易用的目的。
封裝 axios
要做的事情,就是把所有HTTP請求共用的配置,事先都在axios上配置好,預留好必要的參數和接口,然後把它作為新的axios返回。
目錄結構如下(由Vue-cli 3.0 生成):
|–public/
|–mock/
| |–db.json # 我新建的接口模擬數據
|–src/
| |–assets/
| |–components/
| |–router/
| |–store/
| |–views/
| |–Home.Vue
| |–App.vue
| |–main.js
| |–theme.styl
|–package.json
|…
2.封裝目標
在 Home 頁,發起 axios 請求時就像調用一個隻有少量參數的方法一樣簡單,這樣我就可以專註業務代碼瞭。
1. 將 axios 封裝到一個獨立的文件
- 在src下創建 utils/http.js 文件
cd src mkdir utils touch http.js
- 引入 axios
// src/utils/http.js import axios from 'axios';
- 創建一個類
//src/utils/http.js //... class NewAxios { }
- 給不同環境配置不同請求地址
根據process.env.NODE_ENV
配置不同的 baseURL
,使項目隻需執行相應打包命令,就可以在不同環境中自動切換請求主機地址。
// src/utils/http.js //... const getBaseUrl = (env) => { let base = { production: '/', development: 'http://localhost:3000', test: 'http://localhost:3001', }[env]; if (!base) { base = '/'; } return base; }; class NewAxios { constructor() { this.baseURL = getBaseUrl(process.env.NODE_ENV); } }
- 配置超時時間
timeout
屬性,我一般設置10秒。
// src/utils/http.js //... class NewAxios { constructor() { //... this.timeout = 10000; } }
- 配置允許攜帶憑證
widthCredentials
屬性設為true
// src/utils/http.js //... class NewAxios { constructor() { //... this.withCredentials = true; } }
- 給這個類創建實例上的方法request
在 request
方法裡,創建新的axios實例,接收請求配置參數,處理參數,添加配置,返回axios實例的請求結果(一個promise對象)。
你也可以不創建,直接使用默認導出的axios實例,然後把所有配置都放到它上面,不過這樣一來整個項目就會共用一個axios實例。雖然大部分項目下這樣夠用沒問題,但是有的項目中不同服務地址的請求和響應結構可能完全不同,這個時候共用一個實例就沒辦法支持瞭。所以為瞭封裝可以更通用,更具靈活性,我會使用axios
的create
方法,使每次發請求都是新的axios實例。
// src/utils/http.js //... class NewAxios { //... request(options) { // 每次請求都會創建新的axios實例。 const instance = axios.create(); const config = { // 將用戶傳過來的參數與公共配置合並。 ...options, baseURL: this.baseURL, timeout: this.timeout, withCredentials: this.withCredentials, }; // 配置攔截器,支持根據不同url配置不同的攔截器。 this.setInterceptors(instance, options.url); return instance(config); // 返回axios實例的執行結果 } }
因為攔截器配置內容比較多,所以封裝成一個內部函數瞭。
- 配置請求攔截器
在發送請求前對請求參數做的所有修改都在這裡統一配置。比如統一添加token憑證、統一設置語言、統一設置內容類型、指定數據格式等等。做完後記得返回這個配置,否則整個請求不會進行。
我這裡就配置一個token
。
// src/utils/http.js //... class NewAxios { //... // 這裡的url可供你針對需要特殊處理的接口路徑設置不同攔截器。 setInterceptors = (instance, url) => { instance.interceptors.request.use((config) => { // 請求攔截器 // 配置token config.headers.AuthorizationToken = localStorage.getItem('AuthorizationToken') || ''; return config; }, err => Promise.reject(err)); } //... }
- 配置響應攔截器
在請求的then
或catch
處理前對響應數據進行一輪預先處理。比如過濾響應數據,更多的,是在這裡對各種響應錯誤碼進行統一錯誤處理,還有斷網處理等等。
我這裡就判斷一下403和斷網。
// src/utils/http.js //... class NewAxios { //... setInterceptors = (instance, url) => { //... instance.interceptors.response.use((response) => { // 響應攔截器 // todo: 想根據業務需要,對響應結果預先處理的,都放在這裡 console.log(); return response; }, (err) => { if (err.response) { // 響應錯誤碼處理 switch (err.response.status) { case '403': // todo: handler server forbidden error break; // todo: handler other status code default: break; } return Promise.reject(err.response); } if (!window.navigator.online) { // 斷網處理 // todo: jump to offline page return -1; } return Promise.reject(err); }); } //... }
另外,在攔截器裡,還適合放置loading等緩沖效果:在請求攔截器裡顯示loading,在響應攔截器裡移除loading。這樣所有請求就都有瞭一個統一的loading
效果。
- 默認導出新的實例
// src/utils/http.js //... export default new NewAxios();
最後完整的代碼如下:
// src/utils/http.js import axios from 'axios'; const getBaseUrl = (env) => { let base = { production: '/', development: 'http://localhost:3000', test: 'http://localhost:3001', }[env]; if (!base) { base = '/'; } return base; }; class NewAxios { constructor() { this.baseURL = getBaseUrl(process.env.NODE_ENV); this.timeout = 10000; this.withCredentials = true; } // 這裡的url可供你針對需要特殊處理的接口路徑設置不同攔截器。 setInterceptors = (instance, url) => { instance.interceptors.request.use((config) => { // 在這裡添加loading // 配置token config.headers.AuthorizationToken = localStorage.getItem('AuthorizationToken') || ''; return config; }, err => Promise.reject(err)); instance.interceptors.response.use((response) => { // 在這裡移除loading // todo: 想根據業務需要,對響應結果預先處理的,都放在這裡 return response; }, (err) => { if (err.response) { // 響應錯誤碼處理 switch (err.response.status) { case '403': // todo: handler server forbidden error break; // todo: handler other status code default: break; } return Promise.reject(err.response); } if (!window.navigator.online) { // 斷網處理 // todo: jump to offline page return -1; } return Promise.reject(err); }); } request(options) { // 每次請求都會創建新的axios實例。 const instance = axios.create(); const config = { // 將用戶傳過來的參數與公共配置合並。 ...options, baseURL: this.baseURL, timeout: this.timeout, withCredentials: this.withCredentials, }; // 配置攔截器,支持根據不同url配置不同的攔截器。 this.setInterceptors(instance, options.url); return instance(config); // 返回axios實例的執行結果 } } export default new NewAxios();
現在 axios
封裝算是完成瞭80%。我們還需要再進一步把axios和接口結合再封裝一層,才能達到我在一開始定的封裝目標。
3. 使用新的 axios 封裝API
- 在 src 目錄下新建 api 文件夾。把所有涉及HTTP請求的接口統一集中到這個目錄來管理。
- 新建
home.js
。我們需要把接口根據一定規則分好類,一類接口對應一個js文件。這個分類可以是按頁面來劃分,或者按模塊等等。為瞭演示更直觀,我這裡就按頁面來劃分瞭。實際根據自己的需求來定。 - 使用新的 axios 封裝API(固定url的值,合並用戶傳過來的參數),然後命名導出這些函數。
// src/api/home.js import axios from '@/utils/http'; export const fetchData = options => axios.request({ ...options, url: '/data', }); export default {};
在 api 目錄下新建 index.js,把其他文件的接口都在這個文件裡匯總導出。
// src/api/index.js export * from './home';
這層封裝將我們的新的axios封裝到瞭更簡潔更語義化的接口方法中。
現在我們的目錄結構長這樣:
|–public/
|–mock/
| |–db.json # 接口模擬數據
|–src/
| |–api/ # 所有的接口都集中在這個目錄下
| |–home.js # Home頁面裡涉及到的接口封裝在這裡
| |–index.js # 項目中所有接口調用的入口
| |–assets/
| |–components/
| |–router/
| |–store/
| |–utils/
| |–http.js # axios封裝在這裡
| |–views/
| |–Home.Vue
| |–App.vue
| |–main.js
| |–theme.styl
|–package.json
|…
4.使用封裝後的axios
現在我們要發HTTP請求時,隻需引入 api 下的 index.js 文件就可以調用任何接口瞭,並且用的是封裝後的 axios。
// src/views/Home.vue <template> <div class="home"> <h1>This is home page</h1> </div> </template> <script> // @ is an alias to /src import { fetchData } from '@/api/index'; export default { name: 'home', mounted() { fetchData() // axios請求在這裡 .then((data) => { console.log(data); }) .catch((err) => { console.log(err); }); }, }; </script>
axios請求被封裝在fetchData函數裡,頁面請求壓根不需要出現任何axios API,悄無聲息地發起請求獲取響應,就像在調用一個簡單的 Promise 函數一樣輕松。並且在頁面中隻需專註處理業務功能,不用被其他事物幹擾。
到此這篇關於vue項目中axios的封裝請求的文章就介紹到這瞭,更多相關vue中axios封裝內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!
推薦閱讀:
- 如何使用TS對axios的進行簡單封裝
- vue3+vite+axios 配置連接後端調用接口的實現方法
- Vue項目的網絡請求代理到封裝步驟詳解
- vue網絡請求方案原生網絡請求和js網絡請求庫
- 十分鐘封裝一個好用的axios步驟示例