Flutter实战 Http请求-Dio http库
通过上一节介绍，我们可以发现直接使用 HttpClient 发起网络请求是比较麻烦的，很多事情得我们手动处理，如果再涉及到文件上传/下载、Cookie 管理等就会非常繁琐。幸运的是，Dart 社区有一些第三方 http 请求库，用它们来发起 http 请求将会简单的多，本节我们介绍一下目前人气较高的dio (opens new window)库。
dio 是一个强大的 Dart Http 请求库，支持 Restful API、FormData、拦截器、请求取消、Cookie 管理、文件上传/下载、超时等。dio 的使用方式随着其版本升级可能会发生变化，如果本节所述内容和 dio 官方有差异，请以 dio 官方文档为准。
#引入
引入 dio:
dependencies:
dio: ^x.x.x #请使用pub上的最新版本导入并创建 dio 实例：
import 'package:dio/dio.dart';
Dio dio = Dio();接下来就可以通过 dio 实例来发起网络请求了，注意，一个 dio 实例可以发起多个 http 请求，一般来说，APP 只有一个 http 数据源时，dio 应该使用单例模式。
#示例
发起 GET 请求 :
Response response;
response=await dio.get("/test?id=12&name=wendu")
print(response.data.toString());
对于GET请求我们可以将 query 参数通过对象来传递，上面的代码等同于：
response=await dio.get("/test",queryParameters:{"id":12,"name":"wendu"})
print(response);
发起一个 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/",_savePath);发送 FormData:
FormData formData = new FormData.from({
"name": "wendux",
"age": 25,
});
response = await dio.post("/info", data: formData)
如果发送的数据是 FormData，则 dio 会将请求 header 的contentType设为“multipart/form-data”。
通过 FormData 上传多个文件:
FormData formData = new FormData.from({
"name": "wendux",
"age": 25,
"file1": new UploadFileInfo(new File("./upload.txt"), "upload1.txt"),
"file2": new UploadFileInfo(new File("./upload.txt"), "upload2.txt"),
// 支持文件数组上传
"files": [
new UploadFileInfo(new File("./example/upload.txt"), "upload.txt"),
new UploadFileInfo(new File("./example/upload.txt"), "upload.txt")
]
});
response = await dio.post("/info", data: formData)
值得一提的是，dio 内部仍然使用 HttpClient 发起的请求，所以代理、请求认证、证书校验等和 HttpClient 是相同的，我们可以在onHttpClientCreate回调中设置，例如：
(dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate = (client) {
//设置代理
client.findProxy = (uri) {
return "PROXY 192.168.1.2:8888";
};
//校验证书
httpClient.badCertificateCallback=(X509Certificate cert, String host, int port){
if(cert.pem==PEM){
return true; //证书一致，则允许发送数据
}
return false;
};
};
注意，onHttpClientCreate会在当前 dio 实例内部需要创建 HttpClient 时调用，所以通过此回调配置 HttpClient 会对整个 dio 实例生效，如果你想针对某个应用请求单独的代理或证书校验策略，可以创建一个新的 dio 实例即可。
怎么样，是不是很简单，除了这些基本的用法，dio 还支持请求配置、拦截器等，官方资料比较详细，故本书不再赘述，详情可以参考dio 主页 。 下一节我们将使用 dio 实现一个分块下载器。
#实例
我们通过 Github 开放的 API 来请求 flutterchina 组织下的所有公开的开源项目，实现：
- 在请求阶段弹出 loading
- 请求结束后，如果请求失败，则展示错误信息；如果成功，则将项目名称列表展示出来。
代码如下：
class _FutureBuilderRouteState extends State<FutureBuilderRoute> {
Dio _dio = new Dio();
@override
Widget build(BuildContext context) {
return new Container(
alignment: Alignment.center,
child: FutureBuilder(
future: _dio.get("https://api.github.com/orgs/flutterchina/repos"),
builder: (BuildContext context, AsyncSnapshot snapshot) {
//请求完成
if (snapshot.connectionState == ConnectionState.done) {
Response response = snapshot.data;
//发生错误
if (snapshot.hasError) {
return Text(snapshot.error.toString());
}
//请求成功，通过项目信息构建用于显示项目名称的ListView
return ListView(
children: response.data.map<Widget>((e) =>
ListTile(title: Text(e["full_name"]))
).toList(),
);
}
//请求未完成时弹出loading
return CircularProgressIndicator();
}
),
);
}
}