easy-axios: 优化 axios 封装，提升开发效率

easy-axios 是一个基于流行的 HTTP 客户端库 axios 进行二次封装的库，旨在简化开发者的前端 HTTP 请求代码。本文档将详细介绍 easy-axios 的功能特点及使用方式。 ### 核心功能： 1. **取消重复请求**：在快速连续操作时，如用户连续点击按钮，easy-axios 能够自动取消重复的请求，避免多余的网络请求和不必要的服务器负载。开发者可以选择关闭这一功能，以满足特定场景需求。 2. **请求数据缓存**：easy-axios 支持缓存请求数据，类似于浏览器缓存，可以减少服务器的请求次数，并加快页面响应速度。同样，这一功能也提供了关闭选项，以便在需要获取最新数据的场景中使用。 3. **自动重发请求**：在网络不稳定导致请求失败时，easy-axios 能够自动重新发起请求，直到成功或者达到最大尝试次数。这对于提高用户体验是非常有用的，尤其是在移动网络条件下。此自动重试机制也是可配置的。 4. **统一的请求调用方法**：easy-axios 封装了统一的 REQUEST/GET/POST/PUT/DELETE/FORMDATA 方法，其中 REQUEST 方法作为通用请求方法，其他方法都是对 REQUEST 的简单封装。这样的设计使得 API 使用起来更为统一和直观。 5. **自定义状态码处理**：easy-axios 允许开发者自定义状态码及其对应的方法，这意味着可以针对不同的业务场景和响应状态码进行定制化的错误处理或业务逻辑。 6. **请求前后的钩子**：提供了 beforeRequestHook 和 afterResponseHook 两个钩子方法。beforeRequestHook 允许开发者在请求发起之前进行预处理，而 afterResponseHook 允许开发者在响应返回之后根据不同的结果执行不同的操作，例如区分响应的成功与失败。afterResponseHook 的第二个参数正是用来区分响应成功和失败的，方便开发者做出逻辑判断。 7. **获取响应状态码、信息及数据的方法**：easy-axios 提供了几个辅助方法，包括 getStatusFormResult、getMassageFormResult 和 getDataFormResult，它们用于获取 response.data 中的状态码、信息以及数据。这些方法默认识别的状态码字段是 status，信息字段是 msg，数据字段是 dat，但这些都是可以修改的，以适应不同的数据格式。 ### 适用场景： - **单页应用（SPA）**：在单页应用中，由于页面不重新加载，大量的数据交互需要通过 AJAX 完成，easy-axios 可以简化 AJAX 的使用，提高开发效率。 - **移动应用开发**：移动网络环境较差，经常会出现请求失败的情况，easy-axios 的自动重发请求功能可以有效提升应用的稳定性和用户体验。 - **后端 API 接口封装**：在后端 API 开发中，使用 easy-axios 可以快速统一前端调用接口的方式，同时提供了丰富的配置选项和钩子函数，方便在不同业务场景下进行定制化处理。 ### 总结： easy-axios 通过在 axios 的基础上进行封装，不仅提供了常用 HTTP 请求方法的简化调用，还增加了请求重复控制、数据缓存、请求失败自动重试等实用功能。此外，它还提供了请求前后钩子，以及获取响应状态的辅助方法，使得开发者可以根据具体的业务需求灵活地处理网络请求和响应。easy-axios 的这些特点，使得它在提升前端开发效率、增强应用稳定性和改善用户体验方面具有明显优势。