如何自定义alova的请求适配器

alova是一个轻量级的请求策略库,旨在简化接口的管理和使用。你可以通过简单配置参数,即可实现复杂请求如请求共享、分页请求、表单提交、断点续传等,无需编写大量代码,提高开发效率,应用性能,减轻服务端压力。

在使用 alova 发送网络请求时,我们常常需要在请求头中添加一些信息,比如身份认证的 token、公共参数等。alova 提供了在全局和单个请求两种粒度配置请求头的方式。添加请求头的方法和axios非常类似。

认识请求适配器

还记得如何创建一个 Alova 实例吗?

javascript 复制代码
const alovaInstance = createAlova({
  // ...
  requestAdapter: GlobalFetch()
});

是的,requestAdapter就是请求适配器,内部的请求发送和接收都将依赖请求适配器,GlobalFetch就是通过 fetch api 的方式来管理请求的,在大多数情况下我们可以使用它,但是,当alova运行在 fetch api 不可用的环境时(如 app、小程序),就需要更换一个支持当前环境的请求适配器。

编写一个自己的请求适配器

那应该如何自定义一个请求适配器呢?很简单,它其实是一个函数,在每次发起请求时都会调用此函数,并返回一个对象,这个对象内包含如urlmethoddataheaderstimeout等请求相关的数据集合,虽然字段较多,但我们只需访问我们需要的数据即可。

请求适配器结构

请求适配器将接收到请求相关的参数,以及当前正在请求的 method 实例,并返回一个响应相关的函数集合。

javascript 复制代码
function CustomRequestAdapter(requestElements, methodInstance) {
  // 发送请求...
  return {
    async response() {
      // ...返回响应数据
    },
    async headers() {
      // 返回响应头的异步函数
    },
    abort() {
      // 中断请求,当外部调用abort时将触发此函数
    },
    onDownload(updateDownloadProgress) {
      // 下载进度信息,内部持续调用updateDownloadProgress来更新下载进度
    },
    onUpload(updateUploadProgress) {
      // 上传进度信息,内部持续调用updateUploadProgress来更新上传进度
    }
  };
}

请求参数详细

requestElements

发送请求的相关元素,包含以下数据。

typescript 复制代码
interface RequestElements {
  // 请求url,get参数已包含其中
  readonly url: string;

  // 请求类型,如GET、POST、PUT等
  readonly type: MethodType;

  // 请求头信息,对象
  readonly headers: Arg;

  // 请求体信息
  readonly data?: RequestBody;
}

methodInstance

当前请求的 method 实例

返回参数详细

response(必填)

一个异步函数,函数返回响应值,它将会传递给全局的响应拦截器(responded);

headers(必填)

一个异步函数,函数返回的响应头对象将传递给 Method 实例的 transformData 转换钩子函数;

abort(必填)

一个普通函数,它用于中断请求,在 手动中断请求 章节中调用abort函数时,实际上触发中断请求的函数就是这个中断函数;

onDownload(可选)

一个普通函数,它接收一个更新下载进度的回调函数,在此函数内自定义进度更新的频率,在此示例中模拟每隔 100 毫秒更新一次。updateDownloadProgress回调函数接收两个参数,第一个参数是总大小,第二个参数是已下载大小;

onUpload(可选)

一个普通函数,它接收一个更新上传进度的回调函数,在此函数内自定义进度更新的频率,在此示例中模拟每隔 100 毫秒更新一次。updateUploadProgress回调函数接收两个参数,第一个参数是总大小,第二个参数是已上传大小;

(案例)XMLHttpRequest 请求适配器

以下是一个通过 XMLHttpRequest 发送请求的适配器的示例,主要用于演示适配器的写法,代码不完整,不可运行。

javascript 复制代码
function XMLHttpRequestAdapter(requestElements, methodInstance) {
  // 解构出需要用到的数据
  const { url, type, data, headers } = config;

  // 发送请求
  const xhr = new XMLHttpRequest();
  xhr.open(type, url);
  for (const key in headers) {
    xhr.setRequestHeader(key, headers[key]);
  }
  const responsePromise = new Promise((resolve, reject) => {
    xhr.addEventListener('load', event => {
      // 处理响应数据
      resolve(/* ... */);
    });
    xhr.addEventListener('error', event => {
      // 处理请求错误
      reject(/* ... */);
    });
  });

  xhr.send(JSON.stringify(data));

  return {
    // 返回响应数据的异步函数
    response: () => responsePromise,

    // 返回响应头的异步函数
    headers: () => responsePromise.then(() => xhr.getAllResponseHeaders()),
    abort: () => {
      xhr.abort();
    },

    // 下载进度信息,内部持续调用updateDownloadProgress来更新下载进度
    onDownload: updateDownloadProgress => {
      xhr.addEventListener('progress', event => {
        // 数据接收进度
        updateDownloadProgress(event.total, event.loaded);
      });
    },

    // 上传进度信息,内部持续调用updateUploadProgress来更新上传进度
    onUpload: updateUploadProgress => {
      xhr.upload.onprogress = event => {
        updateUploadProgress(event.total, event.loaded);
      };
    }
  };
}

完整的XMLHttpRequest请求适配器代码点此查阅源码

结尾

以上就是 alova 的自定义请求适配器写法了,可以很灵活地处理不同的请求头设置需求。

有任何使用问题,你可以加入以下群聊咨询,也可以在github 仓库中发布 Discussions,如果遇到问题,也请在github 的 issues中提交,我们会在最快的时间解决。

同时也欢迎贡献你的一份力量,请移步贡献指南

以下为部分章节的教程,想学习更多 alovajs 的用法,欢迎来alova 官网学习。

相关推荐
前端工作日常2 小时前
我学习到的Vue2.6的prop修饰符
vue.js
小菜全2 小时前
基于若依框架Vue+TS导出PDF文件的方法
javascript·vue.js·前端框架·json
wow_DG2 小时前
【Vue2 ✨】Vue2 入门之旅 · 进阶篇(一):响应式原理
前端·javascript·vue.js
weixin_456904272 小时前
UserManagement.vue和Profile.vue详细解释
前端·javascript·vue.js
资深前端之路3 小时前
react 面试题 react 有什么特点?
前端·react.js·面试·前端框架
秋秋小事3 小时前
React Hooks useContext
前端·javascript·react.js
ST.J3 小时前
前端笔记2025
前端·javascript·css·vue.js·笔记
还有多远.5 小时前
jsBridge接入流程
前端·javascript·vue.js·react.js
hj5914_前端新手6 小时前
React 基础 - useState、useContext/createContext
前端·react.js
半花6 小时前
【Vue】defineProps、defineEmits 和 defineExpose
前端·vue.js