Flutter之升级3.0.9版本dio的问题

简介

在2.x.x升级到3.x.x，作者改动比较大，我这边升级遇到两个问题：

问题一、设置代理的DefaultHttpClientAdapter找不到

(dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate = (client) {
    //设置代理 
    client.findProxy = (uri) {
      return "PROXY 192.168.1.2:8888";
    };

报错：

The name 'DefaultHttpClientAdapter' isn't a type, so it can't be used in an 'as' expression.
Try changing the name to the name of an existing type, or creating a type with the name 'DefaultHttpClientAdapter'.

因为 DefaultHttpClientAdapter这个class写到另一个dart文件中 ，在当前文件引进下面的文件就可以解决

import 'package:dio/adapter.dart';

问题二、Options的contentType类型变成String

所以当你升级3.x之后代码有下面：

Options options = Options();
options.contentType = ContentType('application', 'x-www-form-urlencoded');

就会报错。所以把contentType赋值string，不是ContentType类型

Options options = Options();
//2.x版本
options.contentType = ContentType('application', 'x-www-form-urlencoded');

//3.x版本
options.contentType = "application/x-www-form-urlencoded";
    

升级3.x的变化

一、Options的变化

1. 删除Options.cookies属性
   • Cookie相关操作应该聚焦在CookieManager中。
   • Cookie在web中不需要手动管理，而options中的配置项应该尽量通用。
2. 删除Options.connectTimeout
   • 是因为在Http/1.1 Keep-alive特性和Http/2中，多个请求可能复用一个Socket连接。
   • connectTimeout表示的是请求是建立Socket连接的超时时间，一旦Socket连接建立，那么随后的Http请求都可能会复用它。
   • Options中的属性代表每一次Http请求都可以单独配置的，因此connectTimeout应该被从Options中移除。
   • 现在我们可以在BaseOptions（Dio实例配置）中来设置connectTimeout，Dio将会在建立Socket连接时来通过它设置建立连接的超时时间。
3. 重定向相关的属性字段（如Option中的followRedirects、maxRedirects，Response的redirects等）

• 因为在Flutter Web中是无意义的.这是因为浏览器中用于发送http请求的内置对象XMLHttpRequest不支持重定向相关的跟踪。
• 实际上重定向相关属性是否有意义取决于Dio的HttpClientAdapter实现，Dio默认的DefaultHttpClientAdapter在Flutter和Dart VM下都支持重定向跟踪，开发者可以放心使用。
• 但如果您要自定义HttpClientAdapter，那么请注意是否支持重定向。

二、FormData变化

1. FormData.from更名为FormData.fromMap，语义化更明确。
2. 对于读取FormData的方法：废弃了asBytes()、asBytesAsync()两个方法，取代他们的是两个新方法readAsBytes()和finalize()。前者会将FormData内容读取到一个Byte数组中，而后者会返回一个Stream（流），用于支持Stream读取。
3. 有一点需要特别注意：一个FormData对象只能被读取一次（因为一个Steam只能被读取一次）。
4. 删除UploadFileInfo类，引入了MultipartFile类；MultipartFile类不仅支持通过文件来构造上传头块，也支持通过Stream、Byte数组、字符串来构造。

三、Response变化

• Response.headers 类型从 HttpHeaders更改为自定义的Headers类。
  • 因为HttpHeaders是"dart:io"库中定义的类，而Flutter Web中不能使用"dart:io"库，所以为了一致，添加了一个自定义的Headers类。

四、拦截器变化

• 拦截器回调返回值类型从FutureOr<dynamic> 变更为Future。具体原因详见这里。

• 将CookieManager抽离成了单独的包；这是因为在Flutter web中不需要手动管理Cookie（浏览器会自动管理），因此将其抽为单独的插件按需引入会更合理。