15.5 网络请求封装
本节我们会基于前面介绍过的dio网络库封装APP中用到的网络请求接口,并同时应用一个简单的缓存策略。下面我们先介绍一下网络接口缓存原理,然后再封装APP的业务请求接口。
15.5.1 网络接口缓存
由于在国内访问Github服务器速度较慢,所以我们应用一些简单的缓存策略:将请求的url作为key,对请求的返回值在一个指定时间段类进行缓存,另外设置一个最大缓存数,当超过最大缓存数后移除最早的一条缓存。但是也得提供一种针对特定接口或请求决定是否启用缓存的机制,这种机制可以指定哪些接口或那次请求不应用缓存,这种机制是很有必要的,比如登录接口就不应该缓存,又比如用户在下拉刷新时就不应该再应用缓存。在实现缓存之前我们先定义保存缓存信息的CacheObject类:
1class CacheObject {
2 CacheObject(this.response)
3 : timeStamp = DateTime.now().millisecondsSinceEpoch;
4 Response response;
5 int timeStamp; // 缓存创建时间
6
7
8 bool operator ==(other) {
9 return response.hashCode == other.hashCode;
10 }
11
12 //将请求uri作为缓存的key
13
14 int get hashCode => response.realUri.hashCode;
15}接下来我们需要实现具体的缓存策略,由于我们使用的是dio package,所以我们可以直接通过拦截器来实现缓存策略:
1import 'dart:collection';
2import 'package:dio/dio.dart';
3import '../index.dart';
4
5class CacheObject {
6 CacheObject(this.response)
7 : timeStamp = DateTime.now().millisecondsSinceEpoch;
8 Response response;
9 int timeStamp;
10
11
12 bool operator ==(other) {
13 return response.hashCode == other.hashCode;
14 }
15
16
17 int get hashCode => response.realUri.hashCode;
18}
19
20class NetCache extends Interceptor {
21 // 为确保迭代器顺序和对象插入时间一致顺序一致,我们使用LinkedHashMap
22 var cache = LinkedHashMap<String, CacheObject>();
23
24
25 onRequest(RequestOptions options) async {
26 if (!Global.profile.cache.enable) return options;
27 // refresh标记是否是"下拉刷新"
28 bool refresh = options.extra["refresh"] == true;
29 //如果是下拉刷新,先删除相关缓存
30 if (refresh) {
31 if (options.extra["list"] == true) {
32 //若是列表,则只要url中包含当前path的缓存全部删除(简单实现,并不精准)
33 cache.removeWhere((key, v) => key.contains(options.path));
34 } else {
35 // 如果不是列表,则只删除uri相同的缓存
36 delete(options.uri.toString());
37 }
38 return options;
39 }
40 if (options.extra["noCache"] != true &&
41 options.method.toLowerCase() == 'get') {
42 String key = options.extra["cacheKey"] ?? options.uri.toString();
43 var ob = cache[key];
44 if (ob != null) {
45 //若缓存未过期,则返回缓存内容
46 if ((DateTime.now().millisecondsSinceEpoch - ob.timeStamp) / 1000 <
47 Global.profile.cache.maxAge) {
48 return cache[key].response;
49 } else {
50 //若已过期则删除缓存,继续向服务器请求
51 cache.remove(key);
52 }
53 }
54 }
55 }
56
57
58 onError(DioError err) async {
59 // 错误状态不缓存
60 }
61
62
63 onResponse(Response response) async {
64 // 如果启用缓存,将返回结果保存到缓存
65 if (Global.profile.cache.enable) {
66 _saveCache(response);
67 }
68 }
69
70 _saveCache(Response object) {
71 RequestOptions options = object.request;
72 if (options.extra["noCache"] != true &&
73 options.method.toLowerCase() == "get") {
74 // 如果缓存数量超过最大数量限制,则先移除最早的一条记录
75 if (cache.length == Global.profile.cache.maxCount) {
76 cache.remove(cache[cache.keys.first]);
77 }
78 String key = options.extra["cacheKey"] ?? options.uri.toString();
79 cache[key] = CacheObject(object);
80 }
81 }
82
83 void delete(String key) {
84 cache.remove(key);
85 }
86}关于代码的解释都在注释中了,在此需要说明的是dio包的option.extra是专门用于扩展请求参数的,我们通过定义了“refresh”和“noCache”两个参数实现了“针对特定接口或请求决定是否启用缓存的机制”,这两个参数含义如下:
| 参数名 | 类型 | 解释 |
|---|---|---|
| refresh | bool | 如果为true,则本次请求不使用缓存,但新的请求结果依然会被缓存 |
| noCache | bool | 本次请求禁用缓存,请求结果也不会被缓存。 |
15.5.2 封装网络请求
一个完整的APP,可能会涉及很多网络请求,为了便于管理、收敛请求入口,工程上最好的作法就是将所有网络请求放到同一个源码文件中。由于我们的接口都是请求的Github 开发平台提供的API,所以我们定义一个Git类,专门用于Github API接口调用。另外,在调试过程中,我们通常需要一些工具来查看网络请求、响应报文,使用网络代理工具来调试网络数据问题是主流方式。配置代理需要在应用中指定代理服务器的地址和端口,另外Github API是HTTPS协议,所以在配置完代理后还应该禁用证书校验,这些配置我们在Git类初始化时执行(init()方法)。下面是Git类的源码:
1import 'dart:async';
2import 'dart:convert';
3import 'dart:io';
4import 'package:dio/dio.dart';
5import 'package:dio/adapter.dart';
6import 'package:flutter/material.dart';
7import '../index.dart';
8
9class Git {
10 // 在网络请求过程中可能会需要使用当前的context信息,比如在请求失败时
11 // 打开一个新路由,而打开新路由需要context信息。
12 Git([this.context]) {
13 _options = Options(extra: {"context": context});
14 }
15
16 BuildContext context;
17 Options _options;
18 static Dio dio = Dio(BaseOptions(
19 baseUrl: 'https://api.github.com/',
20 headers: {
21 HttpHeaders.acceptHeader: "application/vnd.github.squirrel-girl-preview,"
22 "application/vnd.github.symmetra-preview+json",
23 },
24 ));
25
26 static void init() {
27 // 添加缓存插件
28 dio.interceptors.add(Global.netCache);
29 // 设置用户token(可能为null,代表未登录)
30 dio.options.headers[HttpHeaders.authorizationHeader] = Global.profile.token;
31
32 // 在调试模式下需要抓包调试,所以我们使用代理,并禁用HTTPS证书校验
33 if (!Global.isRelease) {
34 (dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate =
35 (client) {
36 client.findProxy = (uri) {
37 return "PROXY 10.1.10.250:8888";
38 };
39 //代理工具会提供一个抓包的自签名证书,会通不过证书校验,所以我们禁用证书校验
40 client.badCertificateCallback =
41 (X509Certificate cert, String host, int port) => true;
42 };
43 }
44 }
45
46 // 登录接口,登录成功后返回用户信息
47 Future<User> login(String login, String pwd) async {
48 String basic = 'Basic ' + base64.encode(utf8.encode('$login:$pwd'));
49 var r = await dio.get(
50 "/users/$login",
51 options: _options.merge(headers: {
52 HttpHeaders.authorizationHeader: basic
53 }, extra: {
54 "noCache": true, //本接口禁用缓存
55 }),
56 );
57 //登录成功后更新公共头(authorization),此后的所有请求都会带上用户身份信息
58 dio.options.headers[HttpHeaders.authorizationHeader] = basic;
59 //清空所有缓存
60 Global.netCache.cache.clear();
61 //更新profile中的token信息
62 Global.profile.token = basic;
63 return User.fromJson(r.data);
64 }
65
66 //获取用户项目列表
67 Future<List<Repo>> getRepos(
68 {Map<String, dynamic> queryParameters, //query参数,用于接收分页信息
69 refresh = false}) async {
70 if (refresh) {
71 // 列表下拉刷新,需要删除缓存(拦截器中会读取这些信息)
72 _options.extra.addAll({"refresh": true, "list": true});
73 }
74 var r = await dio.get<List>(
75 "user/repos",
76 queryParameters: queryParameters,
77 options: _options,
78 );
79 return r.data.map((e) => Repo.fromJson(e)).toList();
80 }
81}可以看到我们在init()方法中,我们判断了是否是调试环境,然后做了一些针对调试环境的网络配置(设置代理和禁用证书校验)。而Git.init()方法是应用启动时被调用的(Global.init()方法中会调用Git.init())。
另外需要注意,我们所有的网络请求是通过同一个dio实例(静态变量)发出的,在创建该dio实例时我们将Github API的基地址和API支持的Header进行了全局配置,这样所有通过该dio实例发出的请求都会默认使用者些配置。
在本实例中,我们只用到了登录接口和获取用户项目的接口,所以在Git类中只定义了login(…)和getRepos(…)方法,如果读者要在本实例的基础上扩充功能,读者可以将其它的接口请求方法添加到Git类中,这样便实现了网络请求接口在代码层面的集中管理和维护。