前言
本文档介绍了如何通过二次封装 Flutter Dio 组件来简化网络请求的过程。通过封装，我们可以提高代码复用性，简化调用方式，并添加一些常用的功能，使网络请求更加易于管理和维护。
一、添加依赖
首先，确保你的 Flutter 项目已经添加了 Dio 的依赖。在项目的 pubspec.yaml 文件中，添加以下依赖：
dependencies: dio: ^4.0.0然后运行 flutter pub get 来获取最新的依赖包。
二、创建封装类
创建一个新的 Dart 类来封装 Dio 组件的功能。例如，我们可以创建一个名为 ApiService 的类。
import 'package:dio/dio.dart';class ApiService { final Dio _dio; ApiService() : _dio = Dio() { // 在这里可以添加一些公共配置，如请求超时时间、拦截器等 _dio.options.baseUrl = 'https://api.example.com'; _dio.options.connectTimeout = 5000; // 设置请求超时时间为5秒 } // 在这里添加封装后的网络请求方法 Future fetchData(String path, {Map? params}) async { try { final response = await _dio.get(path, queryParameters: params); return response; } catch (e) { throw Exception('网络请求失败'); } }} 在上面的示例代码中，我们创建了一个名为 ApiService 的类，它内部包含一个 _dio 实例来处理网络请求。在构造函数中，我们可以进行一些公共配置，例如设置基本 URL、请求超时时间等。
接下来，在 ApiService 类中，我们添加了一个 fetchData 方法来发送 GET 请求。该方法接受一个路径参数和一个可选的参数 Map，用于传递查询参数。在方法内部，我们使用 Dio 组件的 get 方法发送请求，并返回响应结果。
你可以根据实际需求，继续添加其他类型的请求方法（如 POST、PUT、DELETE 等）或其他功能。
三、使用封装类
在你的 Flutter 项目中，你可以通过实例化 ApiService 类来使用封装后的网络请求方法。以下是一个简单的示例：
final apiService = ApiService();void fetchData() async { try { final response = await apiService.fetchData('/data', params: {'id': 1}); // 处理响应结果 print(response.data); } catch (e) { // 处理异常 print(e.toString()); }}在上面的示例中，我们首先创建了一个 ApiService 实例 apiService，然后使用它来调用封装的 fetchData 方法进行网络请求。在 catch 块中，我们处理了可能出现的异常情况，并打印出错误信息。
根据实际需要，你可以进一步完善和扩展封装类的功能，以满足项目的具体要求。
四、拦截器
Dio 组件支持拦截器，你可以在请求发送前或响应返回后对其进行处理。这为添加公共参数、鉴权等功能提供了便利。
以下是一个示例，演示如何使用拦截器在请求头中添加 Token。
class ApiService { final Dio _dio; ApiService() : _dio = Dio() { // 在这里可以添加一些公共配置，如请求超时时间、拦截器等 _dio.options.baseUrl = 'https://api.example.com'; _dio.options.connectTimeout = 5000; // 设置请求超时时间为5秒 // 添加拦截器 _dio.interceptors.add( InterceptorsWrapper( onRequest: (options, handler) { // 在请求头中添加 Token final token = getToken(); // 获取 Token 的方法，根据实际情况替换 options.headers['Authorization'] = 'Bearer $token'; return handler.next(options); }, ), ); } // ...}在上面的示例中，我们通过创建 InterceptorsWrapper 实例并添加到 _dio 的拦截器列表中来实现拦截器功能。在 onRequest 回调中，我们可以对请求进行修改或添加处理逻辑。在这个示例中，我们在请求头中添加了一个名为 “Authorization” 的字段，并设置其值为 Token。
你可以根据实际需求，添加其他拦截器来实现各种功能，例如日志记录、缓存等。
五、错误处理
在网络请求中，错误处理是非常重要的。你可以通过 Dio 组件的错误类型来捕获和处理不同的错误情况。
以下是一个示例，演示如何处理网络请求异常：
class ApiService { // ... Future fetchData(String path, {Map? params}) async { try { final response = await _dio.get(path, queryParameters: params); return response; } catch (e) { if (e is DioError) { // DioError 是 Dio 组件的异常类型，可以根据不同的错误类型进行处理 if (e.type == DioErrorType.connectTimeout) { throw Exception('连接超时，请检查网络连接'); } else if (e.type == DioErrorType.response) { // 如果服务器返回了错误响应，可以通过 e.response 来获取响应信息 final statusCode = e.response?.statusCode; final errorMessage = e.response?.statusMessage; throw Exception('请求失败：$statusCode $errorMessage'); } else { throw Exception('请求失败，请稍后重试'); } } else { throw Exception('网络请求失败'); } } } // ...} 在上面的示例中，我们首先捕获 Dio 组件的异常类型 DioError。然后根据不同的错误类型，我们可以自定义异常信息并抛出异常。
这只是一个简单的示例，你可以根据项目需求，进一步完善错误处理逻辑，并定义更多的异常类型。
总结
通过对 Flutter Dio 组件进行二次封装，我们可以提高代码的复用性和可维护性，简化网络请求的调用过程。在封装过程中，我们可以添加拦截器、处理错误等功能，使网络请求更加灵活和可靠。
希望本文档能够帮助你了解如何二次封装 Flutter Dio 组件，并在实际项目中应用。如果你对 Dio 组件有更深入的需求，建议参考 Dio 官方文档以获取更多详细信息。
祝你在 Flutter 开发中取得成功！如有任何疑问，请随时提问。
来源地址：https://blog.csdn.net/u010755471/article/details/131409862
