以下是关于“Flutter网络请求插件dio2的使用”的详细内容和完整示例代码：

Flutter网络请求插件dio2的使用

添加依赖

在pubspec.yaml文件中添加dio插件依赖：

dependencies:
  dio: ^4.0.0 # 使用最新版本

超简单的使用方法

首先导入dio库：

import 'package:dio/dio.dart';

然后使用dio进行HTTP请求：

void getHttp() async {
  try {
    Response response = await Dio().get("http://www.google.com");
    print(response);
  } catch (e) {
    print(e);
  }
}

示例代码

GET请求

Response response;
Dio dio = new Dio();
response = await dio.get("/test?id=12&name=wendu");
print(response.data.toString());

// 或者也可以这样写
response = await dio.get("/test", queryParameters: {"id": 12, "name": "wendu"});
print(response.data.toString());

POST请求

response = await dio.post("/test", data: {"id": 12, "name": "wendu"});

多并发请求

response = await Future.wait([dio.post("/info"), dio.get("/token")]);

下载文件

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

获取响应流

Response<ResponseBody> rs = await Dio().get<ResponseBody>(url,
  options: Options(responseType: ResponseType.stream), // 设置响应类型为流
);
print(rs.data.stream); // 响应流

获取字节响应

Response<List<int>> rs = await Dio().get<List<int>>(url,
  options: Options(responseType: ResponseType.bytes), // 设置响应类型为字节
);
print(rs.data); // 字节列表

发送FormData

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

多文件上传

FormData 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"),
  ]
});
response = await dio.post("/info", data: formData);

监听上传进度

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");
  },
);

通过Stream发送二进制数据

List<int> postData = [...];
await dio.post(
  url,
  data: Stream.fromIterable(postData.map((e) => [e])), // 创建一个 Stream<List<int>>
  options: Options(
    headers: {
      Headers.contentLengthHeader: postData.length, // 设置内容长度
    },
  ),
);

配置Dio实例

创建Dio实例并设置默认配置：

Dio dio = new Dio(); // 使用默认选项

// 设置默认配置
dio.options.baseUrl = "https://www.xx.com/api";
dio.options.connectTimeout = 5000; // 5秒
dio.options.receiveTimeout = 3000;

// 或者用BaseOptions实例创建Dio
BaseOptions options = new BaseOptions(
    baseUrl: "https://www.xx.com/api",
    connectTimeout: 5000,
    receiveTimeout: 3000,
);
Dio dio = new Dio(options);

拦截器

添加拦截器以拦截请求或响应：

dio.interceptors.add(InterceptorsWrapper(
    onRequest: (RequestOptions options) async {
        // 在请求发送前做些操作
        return options; // 继续
    },
    onResponse: (Response response) async {
        // 对响应数据做些操作
        return response; // 继续
    },
    onError: (DioError e) async {
        // 对错误做些操作
        return e; // 继续
    }
));

锁定/解锁拦截器

dio.interceptors.requestLock.lock();
// 执行异步请求并解锁
dio.interceptors.requestLock.unlock();

自定义拦截器

可以通过继承Interceptor类来自定义拦截器。例如实现简单的缓存策略：

class CacheInterceptor extends Interceptor {
  @override
  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
    super.onRequest(options, handler);
    // 实现缓存逻辑
  }

  @override
  void onResponse(Response response, ResponseInterceptorHandler handler) {
    super.onResponse(response, handler);
    // 实现缓存逻辑
  }

  @override
  void onError(DioError err, ErrorInterceptorHandler handler) {
    super.onError(err, handler);
    // 实现缓存逻辑
  }
}

错误处理

当发生错误时，Dio会将错误包装成DioError：

try {
  // 404
  await dio.get("https://wendux.github.io/xsddddd");
} on DioError catch(e) {
  if(e.response) {
    print(e.response.data);
    print(e.response.headers);
    print(e.response.request);
  } else {
    print(e.request);
    print(e.message);
  }
}

其他功能

dio还支持设置代理、HTTPS证书验证、HTTP/2支持等功能，具体可以查看dio的官方文档。