1. Dio

dio是一個強大的Dart Http請求庫，支持Restful API、FormData、攔截器、請求取消、Cookie管理、文件上傳/下載、超時、自定義適配器等...

1.1 Dio 引入

Dio 引入

dependencies:
  dio: ^x.x.x #請使用pub上的最新版本

執(zhí)行 flutter pub get命令，即可導入dio三方庫

導入并創(chuàng)建dio實例：

import 'package:dio/dio.dart';
Dio dio =  Dio();

注意，一個dio實例可以發(fā)起多個http請求，一般來說，APP只有一個http數(shù)據(jù)源時，dio應該使用單例模式。

1.2 基本使用

Get

  final dio = Dio();
  dio.get("https://httpbin.org/get").then((res) {
    print(res);
  });

  final dio = Dio();
  var res = await dio.get("https://httpbin.org/get");
  print(res);

Post

  final dio = Dio();
  dio.post("https://httpbin.org/post").then((res) {
    print(res);
  });

  final dio = Dio();
  var res = await dio.post("https://httpbin.org/post");
  print(res);

發(fā)起多個并發(fā)請求:

  final dio = Dio();
  var res = await Future.wait([
    dio.post("https://httpbin.org/post"),
    dio.get("https://httpbin.org/get")
  ]);
  print(res);

下載文件

response=await dio.download("https://www.google.com/",_savePath);

發(fā)送 FormData:

FormData formData = FormData.from({
   "name": "wendux",
   "age": 25,
});
response = await dio.post("/info", data: formData)

如果發(fā)送的數(shù)據(jù)是FormData，則dio會將請求header的contentType設為“multipart/form-data”。

通過FormData上傳多個文件:

var formData = FormData.fromMap({
  'name': 'wendux',
  'age': 25,
  'file': await MultipartFile.fromFile('./text.txt', filename: 'upload.txt'),
  'files': [
    await MultipartFile.fromFile('./text1.txt', filename: 'text1.txt'),
    await MultipartFile.fromFile('./text2.txt', filename: 'text2.txt'),
  ]
});
var response = await dio.post('/info', data: formData);

監(jiān)聽上傳進度

response = await dio.post(
  'http://www.dtworkroom.com/doris/1/2.0.0/test',
  data: {'aa': 'bb' * 22},
  onSendProgress: (int sent, int total) {
    print('$sent $total');
  },
);

設置代理、請求認證、證書校驗

dio內部仍然使用HttpClient發(fā)起的請求，所以代理、請求認證、證書校驗等和HttpClient是相同的，我們可以在onHttpClientCreate回調中設置，例如：

  dio.httpClientAdapter = DefaultHttpClientAdapter();
  (dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate =
      (client) {
    // config the http client
    client.findProxy = (uri) {
      //proxy all request to localhost:8888
      return 'PROXY localhost:8888';
    };

    client.badCertificateCallback =
        (X509Certificate cert, String host, int port) {
      if (cert.pem == "PEM") {
        return true; //證書一致，則允許發(fā)送數(shù)據(jù)
      }
      return false;
    };
  };

注意: onHttpClientCreate會在當前dio實例內部需要創(chuàng)建HttpClient時調用，所以通過此回調配置HttpClient會對整個dio實例生效，如果你想針對某個應用請求單獨的代理或證書校驗策略，可以創(chuàng)建一個新的dio實例即可。

攔截器 InterceptorsWrapper

    Interceptor dInter = InterceptorsWrapper(onRequest: (options, handler) {
      print("攔截配置");
      return handler.next(options);
    }, onResponse: (res, handler) {
      print("攔截數(shù)據(jù)");
      return handler.next(res);
    }, onError: (err, handler) {
      print("攔截錯誤");
      return handler.next(err);
    });

自定義攔截器

class CustomInterceptors extends Interceptor {
  @override
  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
    print('REQUEST[${options.method}] => PATH: ${options.path}');
    return super.onRequest(options, handler);
  }

  @override
  void onResponse(Response response, ResponseInterceptorHandler handler) {
    print(
        'RESPONSE[${response.statusCode}] => PATH: ${response.requestOptions.path}');
    return super.onResponse(response, handler);
  }

  @override
  void onError(DioError err, ErrorInterceptorHandler handler) {
    print(
        'ERROR[${err.response?.statusCode}] => PATH: ${err.requestOptions.path}');
    return super.onError(err, handler);
  }
}

1.3 示例

import 'package:dio/dio.dart';
import 'config.dart';

class HttpRequest {
  static final BaseOptions baseOptions = BaseOptions(
      baseUrl: HttpConfig.baseURL, connectTimeout: HttpConfig.timeout);
  static final Dio dio = Dio(baseOptions);

  static Future<T> request<T>(String url,
      {String method = "get",
      Map<String, dynamic>? params,
      Interceptor? inter}) async {
    // 1.創(chuàng)建單獨配置
    final Options specialOptions = Options(method: method);
    // 攔截器
    Interceptor dInter = InterceptorsWrapper(onRequest: (options, handler) {
      print("攔截配置");
      return handler.next(options);
    }, onResponse: (res, handler) {
      print("攔截數(shù)據(jù)");
      return handler.next(res);
    }, onError: (err, handler) {
      print("攔截錯誤");
      return handler.next(err);
    });

    // 自定義Interceptor
    CustomInterceptors cInter = CustomInterceptors();

    List<Interceptor> inters = [cInter];

    if (inter != null) {
      inters.add(inter);
    }

    dio.interceptors.addAll(inters);

    // 發(fā)送網(wǎng)絡請求
    try {
      Response resp = await dio.request(url,
          queryParameters: params, options: specialOptions);
      return resp.data;
    } on DioError catch (e) {
      return Future.error(e);
    }
  }
}

class CustomInterceptors extends Interceptor {
  @override
  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
    print('REQUEST[${options.method}] => PATH: ${options.path}');
    return super.onRequest(options, handler);
  }

  @override
  void onResponse(Response response, ResponseInterceptorHandler handler) {
    print(
        'RESPONSE[${response.statusCode}] => PATH: ${response.requestOptions.path}');
    return super.onResponse(response, handler);
  }

  @override
  void onError(DioError err, ErrorInterceptorHandler handler) {
    print(
        'ERROR[${err.response?.statusCode}] => PATH: ${err.requestOptions.path}');
    return super.onError(err, handler);
  }
}


class HttpConfig {
  static const String baseURL = "https://httpbin.org/";
  static const int timeout = 5000;
}

https://book.flutterchina.club/chapter11/dio.html