鸿蒙应用 HTTP 请求工具封装指南

在鸿蒙应用开发中，实现 HTTP 请求功能有两种主要途径：

1. 使用系统内置模块： 直接调用 @ohos.net.http 提供的原生能力。
2. 封装第三方库 (推荐)： 采用前端广泛使用的 axios 库进行封装，提升开发效率和一致性。

本文重点介绍基于 axios 的封装方案：

1. 安装依赖

在项目的 Terminal 中执行以下命令安装 axios 鸿蒙适配版：

bash ohpm install @ohos/axios

2. 配置网络权限

鸿蒙应用访问网络必须声明权限。在工程目录 entry/src/main/module.json5 文件中添加 ohos.permission.INTERNET 权限声明：

json "requestPermissions": [ { "name": "ohos.permission.INTERNET" } ]

3. 封装步骤

*   **创建 Axios 实例：**
    初始化一个 `axios` 实例，配置全局默认参数，例如：
    *   `baseURL`: API 基础地址
    *   `timeout`: 请求超时时间（毫秒）
    *   `headers`: 公共请求头 (如 `Content-Type`)

*   **添加请求拦截器：**
    利用 `interceptors.request.use` 方法注册请求拦截器。在请求发出前执行统一操作，例如：
    *   注入身份认证 Token
    *   动态设置特定请求头
    *   对请求数据进行预处理

*   **添加响应拦截器：**
    利用 `interceptors.response.use` 方法注册响应拦截器。用于统一处理响应数据，例如：
    *   解析后端返回的数据结构
    *   根据 HTTP 状态码或自定义业务码进行全局错误处理（如 Token 失效跳转登录）
    *   统一转换响应数据格式

*   **封装具体请求方法：**
    基于配置好的 `axios` 实例，封装常用的 HTTP 方法（如 `get`, `post`, `put`, `delete`）。这些方法应：
    *   接收明确的参数：`url`, `params` (查询参数), `data` (请求体数据), `config` (自定义配置) 等。
    *   返回结构化的 `Promise` 对象，通常包含处理后的核心数据 (`data`)、状态码 (`status`) 以及可能的错误信息。
    *   暴露清晰的 API 供业务模块调用。

4. 导出与使用

将封装好的请求方法（如 httpGet, httpPost）或整个配置实例导出。业务层代码只需导入并使用这些封装方法，无需关心底层网络细节和通用处理逻辑。

封装优势：

• 统一管理： 集中配置基础 URL、超时、请求头等，避免重复代码。
• 增强复用性： 封装后的方法可在应用各处复用。
• 提升可维护性： 拦截器集中处理通用逻辑（认证、错误处理、数据转换），修改点单一。
• 灵活扩展： 拦截器机制提供了强大的扩展点，满足多样化的业务需求（如日志、重试、缓存）。
• 开发效率： 符合前端开发者习惯的 axios API 设计，降低学习成本。

通过以上步骤，开发者可以高效地在鸿蒙应用中构建一个健壮、易用且易于维护的 HTTP 请求工具层。