1. Dio

dio是一個(gè)強(qiáng)大的Dart Http請(qǐng)求庫(kù)，支持Restful API、FormData、攔截器、請(qǐng)求取消、Cookie管理、文件上傳/下載、超時(shí)、自定義適配器等...

1.1 Dio 引入

Dio 引入

dependencies:
  dio: ^x.x.x #請(qǐng)使用pub上的最新版本

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

導(dǎo)入并創(chuàng)建dio實(shí)例：

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

注意，一個(gè)dio實(shí)例可以發(fā)起多個(gè)http請(qǐng)求，一般來(lái)說(shuō)，APP只有一個(gè)http數(shù)據(jù)源時(shí)，dio應(yīng)該使用單例模式。

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ā)起多個(gè)并發(fā)請(qǐng)求:

  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會(huì)將請(qǐng)求header的contentType設(shè)為“multipart/form-data”。

通過(guò)FormData上傳多個(gè)文件:

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)聽(tīng)上傳進(jì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');
  },
);

設(shè)置代理、請(qǐng)求認(rèn)證、證書(shū)校驗(yàn)

dio內(nèi)部仍然使用HttpClient發(fā)起的請(qǐng)求，所以代理、請(qǐng)求認(rèn)證、證書(shū)校驗(yàn)等和HttpClient是相同的，我們可以在onHttpClientCreate回調(diào)中設(shè)置，例如：

  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; //證書(shū)一致，則允許發(fā)送數(shù)據(jù)
      }
      return false;
    };
  };

注意: onHttpClientCreate會(huì)在當(dāng)前dio實(shí)例內(nèi)部需要?jiǎng)?chuàng)建HttpClient時(shí)調(diào)用，所以通過(guò)此回調(diào)配置HttpClient會(huì)對(duì)整個(gè)dio實(shí)例生效，如果你想針對(duì)某個(gè)應(yīng)用請(qǐng)求單獨(dú)的代理或證書(shū)校驗(yàn)策略，可以創(chuàng)建一個(gè)新的dio實(shí)例即可。

攔截器 InterceptorsWrapper

    Interceptor dInter = InterceptorsWrapper(onRequest: (options, handler) {
      print("攔截配置");
      return handler.next(options);
    }, onResponse: (res, handler) {
      print("攔截?cái)?shù)據(jù)");
      return handler.next(res);
    }, onError: (err, handler) {
      print("攔截錯(cuò)誤");
      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)建單獨(dú)配置
    final Options specialOptions = Options(method: method);
    // 攔截器
    Interceptor dInter = InterceptorsWrapper(onRequest: (options, handler) {
      print("攔截配置");
      return handler.next(options);
    }, onResponse: (res, handler) {
      print("攔截?cái)?shù)據(jù)");
      return handler.next(res);
    }, onError: (err, handler) {
      print("攔截錯(cuò)誤");
      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)絡(luò)請(qǐ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