Flutter Dio二次封裝

DioManager：Dio輔助類
NWMethod：請求方法，get、post等
NWApi：大家都知道
EntityFactory：json轉換輔助工廠，把json轉爲T
BaseEntity< T >：數據基類，返回的參數爲 {“code”: 0, “message”: “”, “data”: {}}
BaseListEntity< T >：數據基類2，返回的參數爲 {“code”: 0, “message”: “”, “data”: []}
ErrorEntity：請求報錯基類，{“code”: 0, “message”: “”}

EntityFactory：

class EntityFactory {
  static T generateOBJ<T>(json) {
    if (json == null) {
      return null;
    }
	//可以在這裏加入任何需要並且可以轉換的類型，例如下面
//    else if (T.toString() == "LoginEntity") {
//      return LoginEntity.fromJson(json) as T;
//    } 
    else {
      return json as T;
    }
  }
}

BaseEntity< T >：

class BaseEntity<T> {
  int code;
  String message;
  T data;

  BaseEntity({this.code, this.message, this.data});

  factory BaseEntity.fromJson(json) {
    return BaseEntity(
      code: json["code"],
      message: json["msg"],
      // data值需要經過工廠轉換爲我們傳進來的類型
      data: EntityFactory.generateOBJ<T>(json["data"]),
    );
  }
}

BaseListEntity< T >：

class BaseListEntity<T> {
  int code;
  String message;
  List<T> data;

  BaseListEntity({this.code, this.message, this.data});

  factory BaseListEntity.fromJson(json) {
    List<T> mData = new List<T>();
    if (json['data'] != null) {
      //遍歷data並轉換爲我們傳進來的類型
      (json['data'] as List).forEach((v) {
        mData.add(EntityFactory.generateOBJ<T>(v));
      });
    }
    return BaseListEntity(
      code: json["code"],
      message: json["msg"],
      data: mData,
    );
  }
}

ErrorEntity：

class ErrorEntity {
  int code;
  String message;

  ErrorEntity({this.code, this.message});
}

NWApi：

class NWApi {
  static final baseApi = "https://easy-mock.bookset.io/mock/5dfae67d4946c20a50841fa7/example/";
  static final loginPath = "user/login";//接口返回：{"code": int, "message": "String", "data": {"account": "String", "password": "String"}}
  static final queryListPath = "/query/list";//接口返回：{"code": ing, "message": "String", "data": [int, int, String, int, String, int]}
  static final queryListJsonPath = "/query/listjson";//接口返回：{"code": int, "message": "String", "data": [{"account": "String", "password": "String"}， {"account": "String", "password": "String"}]}
}

NWMethod：

enum NWMethod {
  GET,
  POST,
  DELETE,
  PUT
}
//使用：NWMethodValues[NWMethod.POST]
const NWMethodValues = {
  NWMethod.GET: "get",
  NWMethod.POST: "post",
  NWMethod.DELETE: "delete",
  NWMethod.PUT: "put"
};

下面就可以進行正式的封裝了：

第一步是創建Dio的單例輔助類，並初始化Dio和對Dio進行一些全局的參數設置：

import 'package:dio/dio.dart';
import 'package:flutter_app/network/NWApi.dart';
import 'package:flutter_app/utils/PrintUtil.dart';

class DioManager {
  static final DioManager _shared = DioManager._internal();
  factory DioManager() => _shared;

  Dio dio;

  DioManager._internal() {
    if (dio == null) {
      BaseOptions options = BaseOptions(
        baseUrl: NWApi.baseApi,
        contentType: Headers.jsonContentType,
        responseType: ResponseType.json,
        receiveDataWhenStatusError: false,
        connectTimeout: 30000,
        receiveTimeout: 3000,
      );
      dio = Dio(options);
    }
  }

}

第二步對請求進行封裝，在我的想法中 {“code”: 0, “message”: “”, “data”: {}} 和 {“code”: 0, “message”: “”, “data”: []} 這兩種數據是要分開兩個請求方法的：

  // 請求，返回參數爲 T
  // method：請求方法，NWMethod.POST等
  // path：請求地址
  // params：請求參數
  // success：請求成功回調
  // error：請求失敗回調
  Future request<T>(NWMethod method, String path, {Map<String, dynamic> params, Function(T) success, Function(ErrorEntity) error}) async {
    try {
      Response response = await dio.request(path, queryParameters: params, options: Options(method: NWMethodValues[method]));
      if (response != null) {
        BaseEntity entity = BaseEntity<T>.fromJson(response.data);
        if (entity.code == 0) {
          success(entity.data);
        } else {
          error(ErrorEntity(code: entity.code, message: entity.message));
        }
      } else {
        error(ErrorEntity(code: -1, message: "未知錯誤"));
      }
    } on DioError catch(e) {
      error(createErrorEntity(e));
    }
  }

  // 請求，返回參數爲 List<T>
  // method：請求方法，NWMethod.POST等
  // path：請求地址
  // params：請求參數
  // success：請求成功回調
  // error：請求失敗回調
  Future requestList<T>(NWMethod method, String path, {Map<String, dynamic> params, Function(List<T>) success, Function(ErrorEntity) error}) async {
    try {
      Response response = await dio.request(path, queryParameters: params, options: Options(method: NWMethodValues[method]));
      if (response != null) {
        BaseListEntity entity = BaseListEntity<T>.fromJson(response.data);
        if (entity.code == 0) {
          success(entity.data);
        } else {
          error(ErrorEntity(code: entity.code, message: entity.message));
        }
      } else {
        error(ErrorEntity(code: -1, message: "未知錯誤"));
      }
    } on DioError catch(e) {
      error(createErrorEntity(e));
    }
  }

提取請求錯誤處理方法createErrorEntity：

  // 錯誤信息
  ErrorEntity createErrorEntity(DioError error) {
    switch (error.type) {
      case DioErrorType.CANCEL:{
        return ErrorEntity(code: -1, message: "請求取消");
      }
      break;
      case DioErrorType.CONNECT_TIMEOUT:{
        return ErrorEntity(code: -1, message: "連接超時");
      }
      break;
      case DioErrorType.SEND_TIMEOUT:{
        return ErrorEntity(code: -1, message: "請求超時");
      }
      break;
      case DioErrorType.RECEIVE_TIMEOUT:{
        return ErrorEntity(code: -1, message: "響應超時");
      }
      break;
      case DioErrorType.RESPONSE:{
        try {
          int errCode = error.response.statusCode;
          String errMsg = error.response.statusMessage;
          return ErrorEntity(code: errCode, message: errMsg);
//          switch (errCode) {
//            case 400: {
//              return ErrorEntity(code: errCode, message: "請求語法錯誤");
//            }
//            break;
//            case 403: {
//              return ErrorEntity(code: errCode, message: "服務器拒絕執行");
//            }
//            break;
//            case 404: {
//              return ErrorEntity(code: errCode, message: "無法連接服務器");
//            }
//            break;
//            case 405: {
//              return ErrorEntity(code: errCode, message: "請求方法被禁止");
//            }
//            break;
//            case 500: {
//              return ErrorEntity(code: errCode, message: "服務器內部錯誤");
//            }
//            break;
//            case 502: {
//              return ErrorEntity(code: errCode, message: "無效的請求");
//            }
//            break;
//            case 503: {
//              return ErrorEntity(code: errCode, message: "服務器掛了");
//            }
//            break;
//            case 505: {
//              return ErrorEntity(code: errCode, message: "不支持HTTP協議請求");
//            }
//            break;
//            default: {
//              return ErrorEntity(code: errCode, message: "未知錯誤");
//            }
//          }
        } on Exception catch(_) {
          return ErrorEntity(code: -1, message: "未知錯誤");
        }
      }
      break;
      default: {
        return ErrorEntity(code: -1, message: error.message);
      }
    }
  }

完整的 DioManager 類代碼：

import 'package:dio/dio.dart';
import 'package:flutter_app/network/entity/BaseEntity.dart';
import 'package:flutter_app/network/entity/BaseListEntity.dart';
import 'package:flutter_app/network/entity/EntityFactory.dart';
import 'package:flutter_app/network/entity/ErrorEntity.dart';
import 'package:flutter_app/network/NWApi.dart';
import 'package:flutter_app/network/NWMethod.dart';

class DioManager {
  static final DioManager _shared = DioManager._internal();
  factory DioManager() => _shared;

  Dio dio;

  DioManager._internal() {
    if (dio == null) {
      BaseOptions options = BaseOptions(
        baseUrl: NWApi.baseApi,
        contentType: Headers.jsonContentType,
        responseType: ResponseType.json,
        receiveDataWhenStatusError: false,
        connectTimeout: 30000,
        receiveTimeout: 3000,
      );
      dio = Dio(options);
    }
  }

  // 請求，返回參數爲 T
  // method：請求方法，NWMethod.POST等
  // path：請求地址
  // params：請求參數
  // success：請求成功回調
  // error：請求失敗回調
  Future request<T>(NWMethod method, String path, {Map<String, dynamic> params, Function(T) success, Function(ErrorEntity) error}) async {
    try {
      Response response = await dio.request(path, queryParameters: params, options: Options(method: NWMethodValues[method]));
      if (response != null) {
        BaseEntity entity = BaseEntity<T>.fromJson(response.data);
        if (entity.code == 0) {
          success(entity.data);
        } else {
          error(ErrorEntity(code: entity.code, message: entity.message));
        }
      } else {
        error(ErrorEntity(code: -1, message: "未知錯誤"));
      }
    } on DioError catch(e) {
      error(createErrorEntity(e));
    }
  }

  // 請求，返回參數爲 List<T>
  // method：請求方法，NWMethod.POST等
  // path：請求地址
  // params：請求參數
  // success：請求成功回調
  // error：請求失敗回調
  Future requestList<T>(NWMethod method, String path, {Map<String, dynamic> params, Function(List<T>) success, Function(ErrorEntity) error}) async {
    try {
      Response response = await dio.request(path, queryParameters: params, options: Options(method: NWMethodValues[method]));
      if (response != null) {
        BaseListEntity entity = BaseListEntity<T>.fromJson(response.data);
        if (entity.code == 0) {
          success(entity.data);
        } else {
          error(ErrorEntity(code: entity.code, message: entity.message));
        }
      } else {
        error(ErrorEntity(code: -1, message: "未知錯誤"));
      }
    } on DioError catch(e) {
      error(createErrorEntity(e));
    }
  }

  // 錯誤信息
  ErrorEntity createErrorEntity(DioError error) {
    switch (error.type) {
      case DioErrorType.CANCEL:{
        return ErrorEntity(code: -1, message: "請求取消");
      }
      break;
      case DioErrorType.CONNECT_TIMEOUT:{
        return ErrorEntity(code: -1, message: "連接超時");
      }
      break;
      case DioErrorType.SEND_TIMEOUT:{
        return ErrorEntity(code: -1, message: "請求超時");
      }
      break;
      case DioErrorType.RECEIVE_TIMEOUT:{
        return ErrorEntity(code: -1, message: "響應超時");
      }
      break;
      case DioErrorType.RESPONSE:{
        try {
          int errCode = error.response.statusCode;
          String errMsg = error.response.statusMessage;
          return ErrorEntity(code: "$errCode", message: errMsg);
//          switch (errCode) {
//            case 400: {
//              return ErrorEntity(code: errCode, message: "請求語法錯誤");
//            }
//            break;
//            case 403: {
//              return ErrorEntity(code: errCode, message: "服務器拒絕執行");
//            }
//            break;
//            case 404: {
//              return ErrorEntity(code: errCode, message: "無法連接服務器");
//            }
//            break;
//            case 405: {
//              return ErrorEntity(code: errCode, message: "請求方法被禁止");
//            }
//            break;
//            case 500: {
//              return ErrorEntity(code: errCode, message: "服務器內部錯誤");
//            }
//            break;
//            case 502: {
//              return ErrorEntity(code: errCode, message: "無效的請求");
//            }
//            break;
//            case 503: {
//              return ErrorEntity(code: errCode, message: "服務器掛了");
//            }
//            break;
//            case 505: {
//              return ErrorEntity(code: errCode, message: "不支持HTTP協議請求");
//            }
//            break;
//            default: {
//              return ErrorEntity(code: errCode, message: "未知錯誤");
//            }
//          }
        } on Exception catch(_) {
          return ErrorEntity(code: -1, message: "未知錯誤");
        }
      }
      break;
      default: {
        return ErrorEntity(code: -1, message: error.message);
      }
    }
  }

}

使用：

// 返回 LoginEntity
DioManager().request<LoginEntity>(
  NWMethod.POST, 
  NWApi.loginPath,
  params: {"account": "[email protected]", "password": "123456"},
  success: (data) {
	print("success data = $data"});
  }, error: (error) {
	print("error code = ${error.code}, massage = ${error.message}");
  }
);

// 返回 List<LoginEntity>
DioManager().requestList<LoginEntity>(
  NWMethod.POST, 
  NWApi.queryListJsonPath,
  params: {"account": "[email protected]", "password": "123456"},
  success: (data) {
	print("success data = $data"});
  }, error: (error) {
	print("error code = ${error.code}, massage = ${error.message}");
  }
);

頭髮還沒禿a

發佈了29 篇原創文章 · 獲贊 26 · 訪問量 2萬+

私信關注

Flutter Dio二次封裝

目錄：

EntityFactory：

BaseEntity< T >：

BaseListEntity< T >：

ErrorEntity：

NWApi：

NWMethod：

下面就可以進行正式的封裝了：

使用：

IOS 解決無法訪問http鏈接的問題的方法

自己製作的 macOS Mojave 10.14.6 iso 文件，親測可用（附 VMware15 安裝 macOS Catalina 圖文教程與 macO Catalina.iso 鏡像下載地址）

flutter 改變 TabBar 背景顏色的方法

flutter 解決 iPhone X 等劉海屏手機導航欄/底部黑線遮擋佈局的方法

Sourcetree從URL克隆一個倉庫賬號密碼輸入錯誤時一直顯示“這是一個無效的源路徑”的問題的解決辦法

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結