详解Flutter中网络框架dio的二次封装

Vevina ·

更新时间:2024-11-01

· 157 次阅读

其实dio框架已经封装的很好了，但是在实战项目中，为了项目可以统一管理，还是需要对dio框架进行二次封装。

整体思路：一般情况下，后台返回的数据我们可以分为两部分

1.状态数据

2.渲染数据

状态数据就是接口有没有正常返回数据相关的数据，这部分数据跟业务无关，我们可以封装起来统一管理，渲染数据就是我们渲染页面所需要的数据，这块的数据需要我们自己处理。

接下来我们就主要处理渲染数据这块的内容，我定义了两个函数，渲染数据可能为一个对象或者一个数组，我做了分别处理，定义两个函数来接受渲染数据。

// 定义两个函数
typedef Success<T> = Function(T data);  请求数据data为obj对象
typedef SuccessList<T> = Function(List<T> data); // 请求数据data为[]数组

首先我们需要定义两种数据接口的bean对象，返回对象示例：

/// 响应数据头数据统一管理
class BaseRes<T> {
  int? code;// 状态码
  String? message; // 状态码说明
  T? data; // 渲染数据
  BaseRes({this.code, this.message, this.data});
  factory BaseRes.fromJson(json) {
    // json 渲染json数据
    try {
      if (json["code"] != null) {
        try {
         code = json["code"];
        } catch (e) {
          code = -1;
        }
      } else {
        return BaseRes(code: -1, message: "服务器开小差了~", data: null);
      }
      return BaseRes(
          code: json["code"] ?? -1,
          message: json["message"],
          data: BeanFactory.generateOBJ<T>(json["data"]));
    } catch (e) {
      return BaseRes(code: -1, message: "服务器开小差了~", data: null);
    }
  }
}

返回数组示例省略... 只把 T?data 改为 List<T?> data 即可，大同小异。

渲染实体类转化:

/// 实体bean转化工厂类
class BeanFactory {
  static T? generateOBJ<T>(json) {
    //T.toString() 类名
    try {
      switch (T.toString()) {
        case "int":
          return json;
        case "bool":
          return json;
        case "String":
          return json;
        default:
          // 实体类序列化
          return TestBean.formJson(json) as T;
      }
    } catch (e) {
      return null;
    }
  }
}

实体类：

/// 测试bean
class TestBean {
  String? msg;
  bool? isSelector;
  TestBean(this.msg,this.isSelector);
  TestBean.fromJson(dynamic json) {
    msg = json["msg"];
    isSelector = json["isSelector"];
  }
  Map<String, dynamic> toJson() {
    var map = <String, dynamic>{};
    map["msg"] = msg;
    map["isSelector"] = isSelector;
    return map;
  }
}

实际项目中用的JsonToDart插件一键生成即可。（这个插件唯一不好的地方，不能在已生成的文件里序列化，其他都很好）。

接下来就需要进行对dio请求进行二次封装，dio库核心请求方法是request方法，dio的get、post方法都是基于request方法，所以我们要自己再次对request方法进行封装成我们所需要的。

/// dio配置类
class DioManager {
  static const baseUrl = "https://xxx"; // 正式环境
  static DioManager instance = DioManager._internal();
  Dio? _dio;
  final Map<String, dynamic> _headers = {};
  // 单例 私有化构造初始化dio
  DioManager._internal() {
    if (_dio == null) {
      BaseOptions options = BaseOptions(
          baseUrl: baseUrl,
          contentType: Headers.jsonContentType,
          responseType: ResponseType.json,
          receiveDataWhenStatusError: false,
          connectTimeout: _connectTimeout,
          receiveTimeout: _receiveTimeout,
          headers: _headers);
      _dio = Dio(options);
/// 正式环境拦截日志打印
if (!const bool.fromEnvironment("dart.vm.product")) {
  _dio?.interceptors
      .add(LogInterceptor(requestBody: true, responseBody: true));
}
Future<Uint8List> imageToBytes(String imageUrl) async {
  var response = await _dio?.get(imageUrl,
      options: Options(responseType: ResponseType.bytes));
  return Uint8List.fromList(response?.data);
}
get header => _headers;
/// 更新header
updateHeader() {
  _dio?.options.headers = _headers;
}

/// 请求，返回的渲染数据 T
/// method：请求方法，NWMethod.GET等
/// path：请求地址
/// params：请求参数
/// success：请求成功回调
/// error：请求失败回调
Future request<T>(Method method, String path,
    {String? baseUrl,
      Map<String, dynamic>? params,
      data,
      ProgressCallback? onSendProgress, // 上传数据进度
      ProgressCallback? onReceiveProgress, // 接受数据进度
      Success<T>? success,
      Function(ErrorRes)? error}) async {
  try {
    var connectivityResult = await (Connectivity().checkConnectivity());
    if (connectivityResult == ConnectivityResult.none) {
      if (error != null) {
        error(ErrorRes(code: -9, message: "网络异常~,请检查您的网络状态!"));
      }
      return;
    }
    _setBaseUrl(baseUrl); // 动态设置baseUrl 
    Response? response = await _dio?.request(
      path,
      queryParameters: params,
      data: data,
      onSendProgress: onSendProgress,
      onReceiveProgress: onReceiveProgress,
      options: Options(method: methodValues[method]),
    );
    if (response != null) {
      BaseRes entity = BaseRes<T>.fromJson(response.data);
      // 对象数据结构
      if (entity.code == 200 && entity.data != null) {
        if (success != null) success(entity.data);
      } else {
        if (error != null) {
          error(ErrorRes(code: entity.code, message: entity.message));
        }
      }
    } else {
      if (error != null) error(ErrorRes(code: -1, message: "未知错误"));
    }
  } on DioError catch (e) {
    if (error != null) error(createErrorEntity(e));
  }
}

Http最终调用类：

typedef Success<T> = Function(T data); // 定义一个函数 请求成功回调
typedef Error = Function(ErrorRes errorRes); // 请求失败统一回调
typedef SuccessList<T> = Function(List<T> data); // 请求数据data为[]集合
/// 通用调用接口类
class Http {
  // 私有构造
  Http._internal();
  static Http instance = Http._internal();
  /// get请求
  /// baseUrl 切换baseUrl
  /// params 参数
  /// success 请求对象成功回调
  /// successList 请求列表成功回调
  /// error 错误回调
  /// [isList] 请求的数据是否为List列表 默认对象
  /// [isList]=true 请求data数据为[]list列表
  void get<T>(String url,
      {String? baseUrl,
        Map<String, dynamic>? params,
        Success<T>? success,
        SuccessList<T>? successList,
        Error? error,
        bool isList = false}) {
    if (isList) {
      _requestList<T>(Method.get, url,
          baseUrl: baseUrl, params: params, success: successList, error: error);
    } else {
      _request<T>(Method.get, url,
          baseUrl: baseUrl, params: params, success: success, error: error);
    }
  }
/// post请求
/// baseUrl 切换baseUrl
/// params 参数
/// data 上传表单数据 formData
/// success 请求对象成功回调
/// successList 请求列表成功回调
/// error 错误回调
/// [isList] 请求的数据是否为List列表 默认对象
/// [isList]=true 请求data数据为[]list列表
void post<T>(String url,
    {String? baseUrl,
      Map<String, dynamic>? params,
      required data,
      Success<T>? success,
      SuccessList<T>? successList,
      Error? error,
      bool isList = false}) {
  if (isList) {
    _requestList<T>(Method.post, url,
        data: data,
        baseUrl: baseUrl,
        params: params,
        success: successList,
        error: error);
  } else {
    _request<T>(Method.post, url,
        data: data,
        baseUrl: baseUrl,
        params: params,
        success: success,
        error: error);
  }
}

实战应用调用：

我这边对对业务模块加了一层model处理，页面只需要混入我们的model层调用具体的方法即可。

mixin LoginModel {
// get请求
loadCode(
  String value, {
  required Success<String> success,
  required Error error,
}) {
  Http.instance.get(Api.loadxxx,
      params: {"key": value}, success: success, error: error);
}
}

可以看到，我们在页面中只需要关注具体的业务请求就可以了。

以上就是详解Flutter中网络框架dio的二次封装的详细内容，更多关于Flutter dio二次封装的资料请关注软件开发网其它相关文章！

封装 flutter

1024 个赞