鸿蒙开发网络工具类展示列表

<think>我们正在讨论HarmonyOS开发中的网络请求工具类。根据引用内容，HarmonyOS是一个分布式操作系统，支持多种终端设备。在开发中，网络请求是常见的需求。HarmonyOS提供了网络管理相关的API，我们可以使用这些API来构建网络请求工具类。 在HarmonyOS中，常用的网络请求方式包括使用HttpURLConnection或者更高级的封装库。此外，HarmonyOS也提供了类似OkHttp的第三方库支持，但官方推荐使用自己的网络管理模块。 根据HarmonyOS的文档，我们可以构建一个简单的网络工具类，它可能包含以下方法： 1. 发起GET请求 2. 发起POST请求 3. 设置请求头 4. 处理响应 5. 异步请求处理 下面是一个示例的网络工具类，它使用了HarmonyOS的`HttpURLConnection`： ```java import ohos.hiviewdfx.HiLog; import ohos.hiviewdfx.HiLogLabel; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.io.OutputStream; import java.net.HttpURLConnection; import java.net.URL; public class HttpUtil { private static final HiLogLabel LABEL = new HiLogLabel(HiLog.LOG_APP, 0, "HttpUtil"); // 发起GET请求 public static String doGet(String urlStr) { HttpURLConnection connection = null; StringBuilder response = new StringBuilder(); try { URL url = new URL(urlStr); connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("GET"); connection.setConnectTimeout(8000); connection.setReadTimeout(8000); int responseCode = connection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream())); String line; while ((line = reader.readLine()) != null) { response.append(line); } reader.close(); } else { HiLog.error(LABEL, "GET request failed. Response Code: " + responseCode); } } catch (Exception e) { HiLog.error(LABEL, "GET request exception: " + e.getMessage()); } finally { if (connection != null) { connection.disconnect(); } } return response.toString(); } // 发起POST请求 public static String doPost(String urlStr, String data) { HttpURLConnection connection = null; StringBuilder response = new StringBuilder(); try { URL url = new URL(urlStr); connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("POST"); connection.setConnectTimeout(8000); connection.setReadTimeout(8000); connection.setDoOutput(true); // 发送请求数据 OutputStream outputStream = connection.getOutputStream(); outputStream.write(data.getBytes()); outputStream.flush(); outputStream.close(); int responseCode = connection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream())); String line; while ((line = reader.readLine()) != null) { response.append(line); } reader.close(); } else { HiLog.error(LABEL, "POST request failed. Response Code: " + responseCode); } } catch (Exception e) { HiLog.error(LABEL, "POST request exception: " + e.getMessage()); } finally { if (connection != null) { connection.disconnect(); } } return response.toString(); } } ``` 这个工具类提供了两个静态方法：`doGet`和`doPost`。它们分别用于发起GET和POST请求，并返回服务器响应的字符串。 **功能列表：** - `doGet(String urlStr)`: 发起GET请求，参数为请求的URL，返回响应体字符串。 - `doPost(String urlStr, String data)`: 发起POST请求，第一个参数为URL，第二个参数为要提交的数据（如JSON字符串），返回响应体字符串。 在实际开发中，我们可能还需要增加更多的功能，比如： - 支持设置请求头（如Content-Type, Authorization等） - 支持文件上传下载 - 支持HTTPS - 支持异步回调（可以使用TaskDispatcher进行异步处理） 此外，HarmonyOS还提供了更高级的网络框架，例如使用`@ohos.net.http`包中的`Http`类，它提供了更简洁的API。以下是使用`Http`类的示例： ```javascript import http from '@ohos.net.http'; // 创建http对象 let httpRequest = http.createHttp(); // 发起GET请求 httpRequest.request("https://example.com", (err, data) => { if (!err) { console.log("Result: " + data.result); } else { console.log("Error: " + JSON.stringify(err)); } }); ``` 但是，由于问题要求的是工具类及其方法列表，我们也可以基于`@ohos.net.http`封装一个工具类。 下面是一个使用`@ohos.net.http`的简单工具类示例： ```javascript import http from '@ohos.net.http'; export default class HttpUtils { static get(url, callback) { let httpRequest = http.createHttp(); httpRequest.request(url, { method: http.RequestMethod.GET, }, (err, data) => { callback(err, data); } ); } static post(url, data, callback) { let httpRequest = http.createHttp(); httpRequest.request(url, { method: http.RequestMethod.POST, header: { 'Content-Type': 'application/json' }, extraData: data }, (err, data) => { callback(err, data); } ); } } ``` **功能列表（基于@ohos.net.http）：** - `get(url, callback)`: 发起GET请求，url为请求地址，callback为回调函数（接收错误和响应数据）。 - `post(url, data, callback)`: 发起POST请求，url为请求地址，data为要提交的数据，callback为回调函数。 注意：以上代码是JavaScript的，适用于HarmonyOS的JS应用开发（如使用eTS开发UI）。如果使用Java开发，则使用第一种方式（HttpURLConnection）或者使用OkHttp等第三方库。 总结：根据开发语言和框架的不同，可以选择不同的网络请求工具类。在Java开发中，可以使用基于`HttpURLConnection`封装的工具类；在JS/eTS开发中，可以使用基于`@ohos.net.http`封装的工具类。 §§相关问题§§ 1. HarmonyOS中如何处理HTTPS请求和证书验证？ 2. 如何实现HarmonyOS网络请求的异步处理（非阻塞）？ 3. HarmonyOS中如何管理网络请求的生命周期（如页面退出时取消请求）？ 4. HarmonyOS中如何实现文件上传和下载？</think>在 HarmonyOS 开发中，网络请求通常使用官方提供的 `@ohos.net.http` 模块。以下是常用的网络工具类及其核心功能方法列表： ### 网络工具类核心方法 ```typescript import http from '@ohos.net.http'; class HttpUtils { // 1. 创建HTTP请求对象 static createRequest(): http.HttpRequest { return http.createHttp(); } // 2. 发起GET请求 static async get(url: string, headers?: Object): Promise<http.HttpResponse> { const httpRequest = http.createHttp(); return httpRequest.request(url, { method: http.RequestMethod.GET, header: headers }); } // 3. 发起POST请求（支持JSON） static async post(url: string, data: Object, headers?: Object): Promise<http.HttpResponse> { const httpRequest = http.createHttp(); return httpRequest.request(url, { method: http.RequestMethod.POST, header: { 'Content-Type': 'application/json', ...headers }, extraData: JSON.stringify(data) }); } // 4. 文件上传（支持FormData） static async upload(url: string, file: File, formData?: Object): Promise<http.HttpResponse> { const httpRequest = http.createHttp(); return httpRequest.request(url, { method: http.RequestMethod.POST, header: { 'Content-Type': 'multipart/form-data' }, extraData: { file, ...formData } }); } // 5. 设置请求超时 static setRequestTimeout(request: http.HttpRequest, timeout: number): void { request.on('timeout', () => { request.destroy(); // 终止请求 }); request.setTimeout(timeout); } // 6. 中断网络请求 static abortRequest(request: http.HttpRequest): void { request.destroy(); } // 7. 解析响应数据（自动处理JSON） static parseResponse(response: http.HttpResponse): any { if (response.responseCode === http.ResponseCode.OK) { try { return JSON.parse(response.result as string); } catch { return response.result; } } throw new Error(`HTTP ${response.responseCode}`); } } ``` ### 主要功能特性 1. **多请求方法支持** - GET/POST/PUT/DELETE 等标准 HTTP 方法 - 支持同步/异步请求模式 2. **数据传输格式** - JSON 自动序列化/反序列化（`extraData`） - 文件上传（`multipart/form-data`） - 文本/二进制流处理 3. **连接管理** - 连接超时控制（`setTimeout`） - 请求中断（`destroy()`） - 连接复用机制 4. **安全特性** - HTTPS 证书校验 - 支持 TLS 协议配置 - 网络权限声明（需在 `config.json` 配置） 5. **分布式能力集成** - 跨设备服务调用（通过分布式软总线） - 设备间数据同步（基于分布式数据管理） ### 使用示例 ```typescript // 发起GET请求 const response = await HttpUtils.get('https://api.example.com/data'); const data = HttpUtils.parseResponse(response); // 发起POST请求 await HttpUtils.post( 'https://api.example.com/login', { username: 'test', password: '123' } ); // 文件上传 const file = ... // 获取文件对象 await HttpUtils.upload('https://api.example.com/upload', file, { desc: 'HarmonyOS文件' }); ``` > **关键特性说明**： > HarmonyOS 的网络模块深度集成了分布式能力，可通过分布式软总线实现跨设备服务调用[^3]。开发者只需关注业务逻辑，系统会自动处理设备发现、认证和通信过程，真正实现“一次开发，多端部署”[^4]。