亲测！Flutter Dio网络请求库封装指南

2023-12-27 04:14:16

使用 Dio 封装 Flutter 网络请求：提升代码可维护性和可扩展性

简介

在 Flutter 开发中，网络请求是不可或缺的一部分。Dio 作为 Flutter 中一个流行的 HTTP 网络请求库，以其易用性和灵活性著称。通过封装 Dio，开发者可以进一步提升代码的可维护性和可扩展性。

一、请求参数的封装

Dio 通常将请求参数以 Map<String, dynamic> 的形式传递。为了封装请求参数，可以创建一个专门的类或函数来处理参数的收集和组织。

class RequestParameters {
  final String username;
  final String password;

  RequestParameters(this.username, this.password);

  Map<String, dynamic> toMap() {
    return {'username': username, 'password': password};
  }
}

二、响应结果的解析

Dio 将响应结果以 Response 对象的形式返回。为了解析响应结果，可以编写一个通用的解析方法，将 Response 对象转换为应用程序中定义的数据结构。

T parseResponse<T>(Response response) {
  if (response.statusCode == 200) {
    return jsonDecode(response.data) as T;
  } else {
    throw DioError(
      requestOptions: response.requestOptions,
      response: response,
      error: 'Error parsing response: ${response.statusCode}',
    );
  }
}

三、错误的处理

Dio 将错误以 DioError 对象的形式抛出。为了统一处理错误，可以创建一个自定义错误处理函数，根据 DioError 对象提供更友好的错误信息。

String handleError(DioError error) {
  switch (error.type) {
    case DioErrorType.connectTimeout:
      return 'Connection timed out. Please check your internet connection.';
    case DioErrorType.receiveTimeout:
      return 'Server did not respond in time. Please try again later.';
    case DioErrorType.other:
      return 'An unknown error occurred. Please contact support.';
    default:
      return error.message;
  }
}