1.使用Typescript重构axios(一)——写在最前面
2.使用Typescript重构axios(二)——项目起手,跑通流程
3.使用Typescript重构axios(三)——实现基础功能:处理get请求url参数
4.使用Typescript重构axios(四)——实现基础功能:处理post请求参数
5.使用Typescript重构axios(五)——实现基础功能:处理请求的header
6.使用Typescript重构axios(六)——实现基础功能:获取响应数据
7.使用Typescript重构axios(七)——实现基础功能:处理响应header
8.使用Typescript重构axios(八)——实现基础功能:处理响应data
9.使用Typescript重构axios(九)——异常处理:基础版
10.使用Typescript重构axios(十)——异常处理:增强版
11.使用Typescript重构axios(十一)——接口扩展
12.使用Typescript重构axios(十二)——增加参数
13.使用Typescript重构axios(十三)——让响应数据支持泛型
14.使用Typescript重构axios(十四)——实现拦截器
15.使用Typescript重构axios(十五)——默认配置
16.使用Typescript重构axios(十六)——请求和响应数据配置化
17.使用Typescript重构axios(十七)——增加axios.create
18.使用Typescript重构axios(十八)——请求取消功能:总体思路
19.使用Typescript重构axios(十九)——请求取消功能:实现第二种使用方式
20.使用Typescript重构axios(二十)——请求取消功能:实现第一种使用方式
21.使用Typescript重构axios(二十一)——请求取消功能:添加axios.isCancel接口
22.使用Typescript重构axios(二十二)——请求取消功能:收尾
23.使用Typescript重构axios(二十三)——添加withCredentials属性
24.使用Typescript重构axios(二十四)——防御XSRF攻击
25.使用Typescript重构axios(二十五)——文件上传下载进度监控
26.使用Typescript重构axios(二十六)——添加HTTP授权auth属性
27.使用Typescript重构axios(二十七)——添加请求状态码合法性校验
28.使用Typescript重构axios(二十八)——自定义序列化请求参数
29.使用Typescript重构axios(二十九)——添加baseURL
30.使用Typescript重构axios(三十)——添加axios.getUri方法
31.使用Typescript重构axios(三十一)——添加axios.all和axios.spread方法
32.使用Typescript重构axios(三十二)——写在最后面(总结)
项目源码请猛戳这里!!!
1. 前言
在之前的文章中,我们一直都是使用 axios(config) 来创建一个 axios 实例对象,然后发送请求。这样做表面上看起来似乎没什么问题,但是别忘了,我们在各个地方使用的 axios 其实是同一个实例对象,这样就有一个问题,如果我修改了这个实例对象的默认配置,那么所有的 axios 实例都会受到影响,进而影响到所有的请求。这不是我们想要的,我们想要的是能够创建出多个 axios 实例对象来,例如:我们可以创建出一个 axiosLogInstance 实例对象,该实例对象专门用来做跟日志相关操作的请求,并且给它配一些跟日志请求相关的默认配置;我们还可以再创建出一个 axiosUserInstance 实例对象,该实例对象专门用来做跟用户相关的请求,并且给它配一些跟用户请求相关的默认配置。这两个实例对象互不影响,这才是我们想要的结果。好在官方 axios 为我们提供了 axios.create() 静态接口,我们通过调用该接口可以创建出一个崭新的实例对象,该对象接收一个 AxiosRequestConfig 类型的参数作为该实例的默认配置对象,也不可以不传参数表示没有默认配置,它返回一个实例对象,我们可以像之前使用 axios 对象那样使用返回的这个实例对象,并且会它做一些自定义配置。说了这么多,不如看代码一目了然,伪代码如下:
const axiosLogInstance = axios.create({ baseURL: '', timeout: 0, headers: { 'Content-Type': 'application/x-www-form-urlencoded' } }) axiosLogInstance({ url: '/log', method: 'post', data: { a: 1 } })
OK,了解了作用以后,我们就来给我们的 axios 混合对象上增加 create 静态接口。
2. 定义接口类型
由于 我们要给 axios 混合对象上 扩展一个静态接口,因此我们先来修改之前的定义的 AxiosInstance 接口类型。之前 axios 混合对象上的 request 、 get 、 post ...等这些实例方法,这些方法的接口类型都定义在了 AxiosInstance 里面,为了区别于这些方法,我们新创建一个接口类型 AxiosStatic ,并将其继承自 AxiosInstance ,该类型用于定义 create 和后面讲到的 all 、 spread 等静态接口,它的定义如下:
export interface AxiosStatic extends AxiosInstance{ create(config?:AxiosRequestConfig):AxiosInstance }
create 函数可以接受一个 AxiosRequestConfig 类型的配置,作为默认配置的扩展,也可以接受不传参数。
OK,接口类型定义好之后,我们就来实现 create 接口。
3. 实现create接口
实现起来也很容易,该接口支持接收一个 AxiosRequestConfig 类型的配置对象,把该配置对象和全局的默认配置对象进行合并,作为将来返回的新 axios 实例对象的默认配置,最后使用 getAxios 创建出一个新的实例对象返回即可。我们把实现逻辑写在 src/axios.ts 内,如下:
import { AxiosRequestConfig, AxiosStatic } from "./types"; import Axios from "./core/Axios"; import { extend } from "./helpers/util"; import defaults from "./defaultes"; import mergeConfig from "./core/mergeConfig"; function getAxios(config: AxiosRequestConfig): AxiosStatic { const context = new Axios(config); const axios = Axios.prototype.request.bind(context); extend(axios, context); return axios as AxiosStatic; } const axios = getAxios(defaults); axios.create = function(config: AxiosRequestConfig) { return getAxios(mergeConfig(defaults, config)); }; export default axios;
OK,接口的逻辑就实现好了,接下来我们就编写 demo 来测试效果如何。
4. demo编写
在 examples 目录下创建 expandCreateInterface 目录,在 expandCreateInterface 目录下创建 index.html :
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8" /> <title>expandCreateInterface demo</title> </head> <body> <script src="/__build__/expandCreateInterface.js"></script> </body> </html>
接着再创建 app.ts 作为入口文件:
import axios from "src/axios"; import qs from "qs"; const instance1 = axios.create({ headers: { NLRX: "Hello NLRX" } }); instance1({ url: "/api/expandCreateInterface", method: "post", data: qs.stringify({ a: 1 }) }).then(res => { console.log(res.data); }); const instance2 = axios.create({ headers: { test: "123" } }); instance2({ url: "/api/expandCreateInterface", method: "post", data: qs.stringify({ a:1 }) }).then(res => { console.log(res.data); });
在该 demo 中,我们使用 axios.create 创建了两个实例 instance1 和 instance2 ,在这两个实例中,我们在创建的时候给它们的 headers 里面设置了不同的内容,其余均相同,然后用这两个实例分别发出请求,如果在结果中这两个请求的 headers 确实不同,表明这两个实例互相独立,互不影响。
接着在 server/server.js 添加新的接口路由:
// 添加create接口 router.post("/api/expandCreateInterface", function(req, res) { res.json(req.body); });
最后在根目录下的 index.html 中加上启动该 demo 的入口:
<li><a href="examples/expandCreateInterface">expandCreateInterface</a></li>
OK,我们在命令行中执行:
# 同时开启客户端和服务端 npm run server | npm start
接着我们打开 chrome 浏览器,访问 http://localhost:8000/ 即可访问我们的 demo 了,我们点击 expandCreateInterface ,通过 F12 的 network 部分我们可以看到请求已正常发出,并且请求的 headers 如下:
从上图的结果中看,两个请求的 headers 确实不同,验证了这两个实例发出的请求互相独立,互不相同,OK, create 接口就增加完毕了。
(完)
查看更多关于使用Typescript重构axios(十七)——增加axios.create接口的详细内容...