Skip to content

基本介绍

什么是 awe-axios?

awe-axios 是在 axios 基础上进行扩展的增强型 HTTP 请求工具库。它通过装饰器模式、配置扩展等方式,为 axios 提供了更丰富的功能和更灵活的使用方式,同时保持了与 axios 生态的兼容性。

核心特性包括:

  • 注解驱动:awe-axios 基于装饰器来定义 API 接口,被装饰的方法会自动被代理为API接口,简化请求方式
  • 封装核心业务场景功能:awe-axios内部封装了请求重传(Retry)、防抖(Debounce)、节流(Throttle)等常用功能,开发者无需重复造轮子
  • 无侵入:awe-axios 不会修改 axios 的原有 API,保持与 axios 原有 API 的兼容性
  • 集成 mock 功能:awe-axios借助msw实现了mock功能,并真实从网络层面拦截请求
  • 接口二义性:awe-axios中的接口,即是真实接口也是mock接口,开发者无需单独再定义mock接口
  • 面向切面:awe-axios在前端实现了aop面向切面的功能,让请求和响应拦截更加精细化
  • 依赖注入:awe-axios支持依赖注入,并提供了工厂函数来管理实例

使用场景

awe-axios 适用于需要处理各类 HTTP 请求的前端应用场景,尤其适合:

  1. 企业级应用开发:通过装饰器集中管理 API 配置,提高代码可维护性
  2. 高频请求场景:利用防抖、节流功能优化请求性能,减少不必要的网络请求
  3. 不稳定网络环境:通过请求重传机制提升请求成功率
  4. 多环境适配:支持自定义 axios 实例,可同时适配不同域名、认证方式的后端服务
  5. 前后端并行开发:内置 mock 功能,无需等待后端接口就绪即可进行开发
  6. 需要数据转换的场景:提供便捷的请求/响应数据转换能力,处理数据格式转换、加密解密等需求

无论是 Vue、React 等框架应用,还是原生 JavaScript 项目,都可以通过 awe-axios 简化 HTTP 请求的处理逻辑。