axios는 XMLHttpRequest
서비스를 기반으로 HTTP 요청을 수행하고, Promise를 지원하며, 브라우저 측과 Node.js 측을 지원합니다. Vue2.0부터 Youda는 vue-resource
의 공식 추천을 취소하고 대신 axios를 추천하겠다고 발표했습니다. 이제 Axios는 대부분의 Vue 개발자에게 첫 번째 선택이 되었습니다. (Axios에 익숙하지 않은 경우 여기에서 해당 API를 확인할 수 있습니다.) [관련 권장사항: vue.js 영상 튜토리얼】XMLHttpRequest
服务来执行 HTTP 请求,支持丰富的配置,支持 Promise,支持浏览器端和 Node.js 端。自Vue2.0起,尤大大宣布取消对vue-resource
的官方推荐,转而推荐 axios。现在 axios 已经成为大部分 Vue 开发者的首选。( 如果你还不熟悉 axios,可以在这里查看它的API。)【相关推荐:vue.js视频教程】
封装前,先来看下,不封装的情况下,一个实际项目中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 封装到一个独立的文件
cd src mkdir utils touch http.js
// 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
方法里,创建新的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
아마 다음과 같을 것입니다:
🎜// src/api/home.js import axios from '@/utils/http'; export const fetchData = options => axios.request({ ...options, url: '/data', }); export default {};
axios
가 해야 할 일은 axios의 모든 HTTP 요청에 공통적인 구성을 미리 구성하고 필요한 매개변수와 인터페이스를 예약한 다음 이를 새로운 axios로 반환하는 것입니다. 🎜🎜🎜디렉토리 구조는 다음과 같습니다(Vue-cli 3.0에서 생성됨): 🎜🎜🎜|--public/🎜|--mock/🎜| |--db.json # 내 새 인터페이스 시뮬레이션 데이터 🎜 |--src/🎜| |--컴포넌트/🎜| |--store/🎜| |--Home.Vue🎜| |- -App.vue🎜| |--main.js🎜|--theme.styl🎜|--package.json🎜|...🎜🎜🎜2. 홈 페이지에서 axios 요청을 수행하는 것은 몇 가지 매개변수만으로 메소드를 호출하는 것만큼 간단하므로 비즈니스 코드에 집중할 수 있습니다. 🎜🎜🎜1. axios를 별도의 파일로 캡슐화🎜🎜
// src/api/index.js export * from './home';
// 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>
baseURL
을 구성합니다. 🎜rrreeetimeout
속성을 구성합니다. 저는 보통 10초로 설정합니다. 🎜rrreeewidthCredentials
속성이 true
🎜rrreeerequest
메서드에서 새 axios 인스턴스를 생성하고 요청 구성 매개변수를 수신하고 매개변수를 처리하고 구성을 추가합니다. axios 인스턴스 결과(Promise 객체)에 대한 요청을 반환합니다. 🎜🎜기본으로 내보낸 axios 인스턴스를 생성하지 않고 직접 사용한 다음 모든 구성을 넣을 수도 있지만 이렇게 하면 전체 프로젝트가 하나의 axios 인스턴스를 공유하게 됩니다. 대부분의 프로젝트에서는 이것으로 충분하지만, 일부 프로젝트에서는 서로 다른 서비스 주소의 요청 및 응답 구조가 완전히 다를 수 있습니다. 이 경우 하나의 인스턴스를 공유하면 이를 지원할 수 없습니다. 따라서 캡슐화를 더욱 다양하고 유연하게 만들기 위해 axios
의 create
메서드를 사용하여 각 요청이 새로운 axios 인스턴스가 되도록 하겠습니다. 🎜rrreee🎜인셉터 구성 내용이 상대적으로 크기 때문에 내부 기능으로 캡슐화됩니다. 🎜토큰
을 구성하겠습니다. 🎜rrreeethen
또는 catch</ 전에 응답 데이터 사전 처리 라운드를 수행합니다. 코드> 처리 거래. 예를 들어, 응답 데이터 필터링, 그리고 더 중요한 것은 다양한 응답 오류 코드에 대한 통합 오류 처리, 네트워크 연결 끊김 처리 등이 있습니다. 🎜🎜여기서 403과 단절을 판단하겠습니다. 🎜rrreee🎜🎜또한 인터셉터에는 로딩과 같은 버퍼링 효과를 배치하는 것도 적합합니다. 🎜요청 인터셉터에 로딩을 표시하고 응답 인터셉터에서 로딩을 제거합니다. 이러한 방식으로 모든 요청은 통합된 <code>로드
효과를 갖습니다. 🎜axios
캡슐화가 80% 완료되었습니다. . 처음에 설정한 캡슐화 목표를 달성하려면 Axios를 인터페이스와 결합하고 한 계층 더 캡슐화해야 합니다. 🎜🎜🎜3. 새로운 axios 패키지 API를 사용하세요🎜🎜home.js
。我们需要把接口根据一定规则分好类,一类接口对应一个js文件。这个分类可以是按页面来划分,或者按模块等等。为了演示更直观,我这里就按页面来划分了。实际根据自己的需求来定。// 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의 캡슐화 요청을 구문 분석합니다(단계 코드 사용).의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!