Dio 3.0发布，支持Flutter Web 和 Http/2.0

Flutter 一周前发布了1.9 版本，其中最大特性是将Flutter Web合入了主分支。而今天，Dio 也正式发布了3.0.0，该版本最大的特性是支持Flutter Web 和 Http/2.0。

升级提示：由于Dio 3.0需要支持Flutter Web，需要对代码进行较大的重构，所以并不能完全向下兼容，2.1版本用户可参考 3.0升级指南 。

支持Flutter Web

开发者只需要将Flutter升级到1.9或更新的dev版本，然后将Dio升级到最新的3.x即可支持Flutter Web即可。

Http/2.0支持

Http/2.0 有链接复用、头部压缩、二进制传输、服务端推送等重多特性。Dio 3.0版本后，官方提供了一个 dio_http2_adapter 插件（HttpClientAdapter）来支持Http/2.0。下面是官方示例：

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

main() async {
  var dio = Dio()
    ..options.baseUrl = "https://google.com"
    ..interceptors.add(LogInterceptor())
    ..httpClientAdapter = Http2Adapter(
      ConnectionManager(idleTimeout: 10000),
    );

  Response response;
  response = await dio.get("/?xx=6");
  print(response.data);
}

可以看到只需要配置一下Http2Adapter即可。值得注意的是Http2Adapter需要一个ConnectionManager参数。ConnectionManager 主要职责是管理链接，是Http/2.0中链接复用策略的实现载体。官方提供了一个默认的ConnectionManager ，它的策略是同一个域名下的请求共享一个Socket链接，当请求完成时，连接默认继续保持15秒，开发者可以通过idleTimeout来自定义保持时间。开发者提供自己的ConnectionManager来自定义链接复用策略。

另外，Http2Adapter内部已经默认处理了重定向，我们可以通过以下代码验证：

response.redirects.forEach((e){
  print("redirect: ${e.statusCode} ${e.location}");
});

输出：

redirect: 301 https://www.google.com/?xx=6
redirect: 302 https://www.google.com.hk/url?sa=p&hl=zh-CN&pref=hkredirect&pval=yes&q=https://www.google.com.hk/%3Fxx%3D6&ust=1568810110125304&usg=AOvVaw0YbFhKFoslI0LPOPFcekGy
redirect: 302 https://www.google.com.hk/?xx=6

可以看到我们在大陆请求google时进行了三次重定向！

其它更新

• FormData 支持嵌套。
• 删除了UploadFileInfo类，引入了MultipartFile类；MultipartFile类不仅支持通过文件来构造上传头块，也支持通过Stream、Byte数组、字符串来构造。
• 将CookieManager抽离成了单独的包；这是因为在Flutter web中不需要手动管理Cookie（浏览器会自动管理），因此将其抽为单独的插件按需引入会更合理。
• 请求取消后，取消Error可以入队拦截器队列（2.1中取消的异常是直接抛给用户处理）。
• 代码优化：API标准化、语义化；对核心代码进行了全部重构。

详情请参考：https://github.com/flutterchina/dio 。