从零开始：用 Dart 和 Flutter 打造你的专属 HTTP 请求工具

在 Flutter 应用开发中，与后端服务器进行数据交互是至关重要的。虽然市面上有诸多优秀的第三方 HTTP 库，如 Dio、http 等，但理解其底层原理并亲手打造一个属于自己的 HTTP 请求工具，不仅能加深对网络请求的理解，还能根据自身需求进行高度定制。

本文将带你从零开始，基于 Dart 语言，不依赖任何第三方框架，开发一个用于发送 RESTful 风格请求的 HTTP 类。

一、核心类设计

首先，我们需要定义一个HttpUtil类，它将包含我们实现 HTTP 请求所需的核心方法：

class HttpUtil {

// TODO: 实现相关方法

}

二、实现 GET 请求

我们从最简单的 GET 请求开始：

Future<String> get(String url, {Map<String, String>? headers}) async {

final httpClient = HttpClient();

final request = await httpClient.getUrl(Uri.parse(url));

// 设置请求头

headers?.forEach((key, value) {

  request.headers.set(key, value);

});

final response = await request.close();

final responseBody = await response.transform(utf8.decoder).join();

httpClient.close();

return responseBody;

}

代码解析：

创建 HttpClient 实例：HttpClient是 Dart 提供的用于发送 HTTP 请求的核心类。

构建 GET 请求：使用httpClient.getUrl(Uri.parse(url))创建一个 GET 请求对象。

设置请求头：遍历传入的 headers 参数，将其添加到请求头中。

发送请求并获取响应：调用request.close()发送请求，并使用response.transform(utf8.decoder).join()将响应体转换为字符串。

关闭 HttpClient：释放资源，避免内存泄漏。

三、实现 POST 请求

接下来，我们实现 POST 请求，用于向服务器提交数据：

Future<String> post(String url, {Map<String, String>? headers, Object? body}) async {

final httpClient = HttpClient();

final request = await httpClient.postUrl(Uri.parse(url));

// 设置请求头

headers?.forEach((key, value) {

  request.headers.set(key, value);

});

// 设置请求体

if (body != null) {

  request.write(jsonEncode(body));

}

final response = await request.close();

final responseBody = await response.transform(utf8.decoder).join();

httpClient.close();

return responseBody;

}

代码解析：

创建 POST 请求：使用httpClient.postUrl(Uri.parse(url))创建一个 POST 请求对象。

设置请求体：将传入的 body 参数（通常为 Map 或 List）使用jsonEncode转换为 JSON 字符串，并写入请求体。

四、实现 PUT、DELETE 请求

PUT 和 DELETE 请求的实现与 POST 请求类似，只需将postUrl替换为putUrl和deleteUrl即可：

Future<String> put(String url, {Map<String, String>? headers, Object? body}) async {

// 与 POST 请求类似，使用 httpClient.putUrl

}

Future<String> delete(String url, {Map<String, String>? headers}) async {

// 与 GET 请求类似，使用 httpClient.deleteUrl

}

五、处理异常和错误

在实际应用中，网络请求可能会遇到各种异常情况，例如网络连接失败、服务器返回错误状态码等。我们需要对这些情况进行处理：

Future<String> get(String url, {Map<String, String>? headers}) async {

try {

  final httpClient = HttpClient();

  final request = await httpClient.getUrl(Uri.parse(url));

  headers?.forEach((key, value) {

    request.headers.set(key, value);

  });

  final response = await request.close();

  if (response.statusCode == HttpStatus.ok) {

    final responseBody = await response.transform(utf8.decoder).join();

    return responseBody;

  } else {

    throw Exception('请求失败，状态码：${response.statusCode}');

  }

} catch (e) {

  throw Exception('网络请求异常：$e');

} finally {

  httpClient.close();

}

}

代码解析：

使用 try-catch 捕获异常：将网络请求代码包裹在try-catch块中，捕获可能发生的异常。

检查响应状态码：使用response.statusCode判断请求是否成功，如果状态码不是 200，则抛出异常。

finally 块释放资源：无论请求成功与否，都需要在finally块中关闭HttpClient，释放资源。

六、扩展功能

除了基本的 CRUD 操作，你还可以根据需求扩展HttpUtil类的功能，例如：

文件上传下载：使用HttpClientRequest和HttpClientResponse的相关方法实现文件的上传和下载。

请求拦截器：在发送请求前或接收响应后，对请求和响应进行统一处理，例如添加公共参数、打印日志等。

超时设置：使用HttpClient.connectionTimeout设置请求超时时间。

Cookie 管理：使用HttpClient的cookieJar属性管理 Cookie。

七、总结

通过以上步骤，我们实现了一个基于 Dart 和 Flutter 的简易 HTTP 请求工具。虽然功能上不如第三方库强大，但它帮助我们理解了 HTTP 请求的底层原理，并可以根据自身需求进行灵活定制。

在实际项目中，建议根据项目规模和复杂度选择合适的 HTTP 库。对于小型项目或学习 purposes，可以使用本文实现的简易工具；对于大型项目，建议使用功能更强大、社区更活跃的第三方库，例如 Dio 等。

希望本文能帮助你更好地理解 Flutter 中的网络请求，并激发你探索更多 Flutter 开发的乐趣！