Flutter网络请求库Dio与Future特性

Flutter自带的网络请求引擎HttpClient功能，但HttpClient本身功能较弱，很多常用功能都不支持。Dio是Flutter的一个第三方网络库，它是一个强大易用的dart http请求库，支持Restful API、FormData、拦截器、请求取消、Cookie管理、文件上传/下载、超时等。

Dio使用方法

1.添加依赖：

dependencies:
  dio: ^x.x.x  // 请使用pub上的最新版本

2.在调用的文件导入：

import 'package:dio/dio.dart';

3.发起一个Post网络请求：

Response response = await dio.post(
          url , 
          data: paramters,
          options: opt,
        );

url 表示请求的地址；
data:Post提交的参数，key-value的Map类型；
options参数：网络请求头设置、其他自定义配置等。

其中Options是一个配置类：

Options({
    String method,
    int connectTimeout,
    int sendTimeout,
    int receiveTimeout,
    Iterable cookies,
    Map extra,
    Map headers,
    ResponseType responseType,
    ContentType contentType,
    ValidateStatus validateStatus,
    bool receiveDataWhenStatusError,
    bool followRedirects,
    int maxRedirects,
  })

通过其内部的属性可以看到，可以设置
method：Get/Post方式；
connectTimeout超时时间（毫秒单位）；
headers就是设置请求头。
contentType和responseType可设置返回的内容是xml/json/text-plain等格式。
followRedirects可设置是否允许重定向。
cookies可以设置cookies。

Dart Future

网络请求离不开异步机制，Dart语法特性对异步机制使用了Future机制。这套机制和ES6的Promise原理是一样的。

如果你对Js的ES6熟悉，那么你将很容易理解和使用。他们都是协程，大致都是采用async/await 机制，将一个异步请求的过程放入一个协程里面，将结果以“同步”的方式返回，注意：不是真正的同步请求，实际上任何异步请求都是天然存在的客观事实，你无法真正将一个异步请求改成一个同步请求。

回到我们Dart语法中：
像上面的post请求方法，如果一个方法是异步的，那么该方法在没有返回结果前需要等待，dart语法要求在方法前加上“await”标识：

await xxxxxx()

那么，响应的该语句执行的方法返回也必须在结尾添加异步标识async：

Future xxxxxxx(paramters) async {
await xxxxxx()
}

该方法的放回类型一般为Future类型，以便调用方使用then()取得结果。（注意：返回类型不必一定为Future，可也是void，那么调用方就不能使用then()取结果而已）。

可能很多人不知道Future标识有什么意思，标识Future标识该方法的返回是一个then()-catchError(e)结果体，其中then({闭包})里是正确的返回结果，catchError({闭包})就是异步异常的结果。

当然，异步的请求也可以不以Future形式返回，我们可以通过自定义闭包结构体返回，比如我的网络请求返回是2个callback:

void request (String url, 
                Map paramters, 
                Function completeCallback, 
                Function errorCallback) async {

    if (!url.startsWith("http")) {
      String baseUrl = "https://www.wowoshenghuo.com";
      url = baseUrl + url;
    }
    String errorMsg = "";
    try {
      Options opt = await wowoLifeHeaders();
      Response response = await dio.post(
          url , 
          data: paramters,
          options: opt,
        );
      print("网络请求状态码：" + response.statusCode.toString());
      //处理错误部分
      if (response.statusCode < 200 || response.statusCode > 400) {
        errorMsg = "网络请求错误,状态码:" + response.statusCode.toString();
        _handError(errorCallback, errorMsg);
        return;
      }

      //网络connected
      Map json;
      if (response.data is Map) {
        json = response.data;
      }else {
        json = jsonDecode(response.data);
      }
      print(json);
      //转模型
      YWResponse resp = YWResponse.fromJson(json);
      
      if (completeCallback != null) {
        completeCallback(resp);
      }

    } catch(exception) {
      _handError(errorCallback, exception.toString());
    }
  }

  void _handError(Function errorCallback, String errorMsg) {
    if (errorCallback != null) {
      errorCallback(errorMsg);
    }
  }

}

我的网络返回是通过两个Function返回的：
completeCallback：网络正常的回调（当然业务错误也属于这种）
errorCallback：网络异常、不通的回调。

虽然我的网络请求是async标识的，由于我自定义了网络回调，所以我仅仅申明void返回即可。

获取设备信息和APP包信息

我们经常需要获取手机设备诸如系统版本，平台信息以及APP包名称，APP版本等信息。这些Flutter有一些第三方插件提供了这方面的api.

device_info

device_info 插件同样需要安装然后import
初始化：

DeviceInfoPlugin deviceInfo = DeviceInfoPlugin();

deviceInfo为我们提供了iosInfo和androidInfo;
那么我们首先需要自己判断当前设备是哪个平台：

if (Platform.isIOS) {
      IosDeviceInfo iosInfo = await deviceInfo.iosInfo;
      device["sysVersion"] = iosInfo.systemVersion;
      device["model"] = iosInfo.localizedModel;
      device["imei"] = iosInfo.identifierForVendor;
      device["brand"] = "iPhone";
    }else {
      AndroidDeviceInfo androidInfo = await deviceInfo.androidInfo;
      device["sysVersion"] = androidInfo.version.baseOS;
      device["model"] = androidInfo.model;
      device["imei"] = androidInfo.id;
      device["brand"] = androidInfo.brand;
    }

然后通过iosInfo或者AndroidInfo即可获取system、model等设备信息。
需要注意的是：deviceInfo获取设备信息的方法是个异步的
需要await/async。

package_info

package_info是读取APP工程的信息的，如APP名称、APP唯一标识、APP迭代版本号等。
同样，和device_info一样，这个方法也是异步获取pakage信息：

Future pakageInfo() async {
    PackageInfo packageInfo = await PackageInfo.fromPlatform();
    return packageInfo;
  }

最后根据我们公司需要将设备信息作为header的获取方法全部完成了，贴一下我的header代码：

Future wowoLifeHeaders() async {

    if (store == null) {
      store = await storage();
    }
    if (deviceMap == null) {
      deviceMap = await deviceSystemVersion();
    }
    if (pakage == null) {
      pakage = await pakageInfo();
    }

    String uToken = "-1";
    if (store != null && store.getString("user_token") != null) {
      uToken = store.getString("user_token");
    } 
    Options options = Options(
      headers: {
        HttpHeaders.contentTypeHeader:"application/json;charset=UTF-8",
        "source" : Platform.isIOS ? "2" : "1",
        "sys_version" : deviceMap["sysVersion"],
        "model" : deviceMap["model"],
        "imei" : deviceMap["imei"],
        "app_version" : pakage.version,
        "user_token" : uToken,
        "userToken" : uToken,
      },
      connectTimeout: 30000,
      receiveTimeout: 25000,
      contentType: ContentType.json,
      responseType: ResponseType.json,
      );
    return options;
  }

以上。