Flutter 网络请求 Dio 拦截器详解
老王的烦恼
昔日的小王凭借这他的小心谨慎和借助漂亮能干的女友 Dio 的辅助，终于干下了一番事业，成为中华大地响当当的人物，小王也变成老王。如今，老王已经年近花甲，看似迈上了人生巅峰，却也遇到了人生的烦恼——那就是他的儿子，新的小王。
小王和他爹当年的小心谨慎不同，小王自海外留学回来，也不愿意接手老王的事业。反而迷恋起了互联网，玩游戏、微博喷人、撩网红等等。前两项倒还好，但是后一项，让老王心烦得很。这网红哪能随便撩的，万一弄出许多小小王来，多大家业都不够分的啊！
image.png
能干的老王媳妇
关键时刻，还是老王的媳妇，曾经被金屋藏娇的Dio 想出了新的招术，再次让老王佩服不已。老王媳妇Dio给小王搞了个拦截器，只要小王要在互联网做什么，都会被她给先拦截下来，然后她再根据小王要做的事情决定是不是要替他发出去；或者是收到什么消息的时候，也会先看一遍，没问题再给小王看。而且，最为关键的是，小王对这一切压根都不知道！
老王媳妇一开始是这么干的，小王在互联网有什么新的动向直接向老王汇报。
static Dio getDioInstance() {
if (_dioInstance == null) {
_dioInstance = Dio();
_dioInstance.interceptors
.add(InterceptorsWrapper(onRequest: (options, handler) {
print('报告老王，小王看上了新的网红：' + options.path);
return handler.next(options);
}, onResponse: (response, handler) {
print('报告老王，小王收到了新网红的回复：' + response.statusMessage);
handler.next(response);
}, onError: (DioError e, handler) {
print('报告老王，小王被网红喷啦！' + e.message);
return handler.next(e);
}));
}
return _dioInstance;
}
这下小王在互联网就完全被监视了——而且他压根不知道！只是，每次他说要钱的时候，老王不再随便给了！
image.png
但这个时候，小王还能在网上撩，毕竟上网在这个时代是不怎么要钱的。
狠心的老王媳妇
老王媳妇 Dio 一看这种方式不行，就又心生一计，每次小王聊网红的时候，直接狠心拒绝！
static Dio getDioInstance() {
if (_dioInstance == null) {
_dioInstance = Dio();
_dioInstance.interceptors
.add(InterceptorsWrapper(onRequest: (options, handler) {
print('报告老王，小王看上了新的网红：' + options.path);
return handler.next(options);
}, onResponse: (response, handler) {
print('报告老王，小王收到了新网红的回复：' + response.statusMessage);
throw new Exception('你死心吧！');
//handler.next(response);
}, onError: (DioError e, handler) {
print('报告老王，小王被网红喷啦！' + e.message);
return handler.next(e);
}));
}
return _dioInstance;
}
image.png
消停的小王
小王这下子懵圈了，难道是他的那些“土味情话”已经失效了？每次发出去消息都遭受到了无情的打击，让他心灰意冷。渐渐地他就淡出了互联网，至于现在在干什么，谁也不知道。感觉又像是当初老王金屋藏娇一样，现在的小王也逐渐被隐藏了起来。从此，互联网只剩下小王和各个网红的传说。
image.png
后记
借着老王和小王的故事，我们讲述了 Dio 的封装和 Dio 的拦截器。其中拦截器可以应用于很多实际场景：
- 权限验证：比如接口请求后端返回401未授权时可以跳到登录页，403跳到未授权页面；
- 异常监控：可以在拦截器处理异常，并且上报到异常监控后台或者发送异常预警消息；
- 缓存接口：可以对于某些接口将请求缓存在本地，设定一定的缓存有效时限，在时限内重复请求时直接返回本地缓存数据，而无需请求后端接口，降低后端服务器负荷。这块可以参考dio-http-cache。
- Cookie：App 本身是不会缓存 Cookie 信息的，可以使用拦截器在向后端发起请求时自动携带 Cookie信息，可以参考cookie_manager。
- 生成接口文档：可以在拦截器将请求参数，返回结果输出为 Postman格式的接口文档，参考postman_dio。
- 自定义拦截器：可以自定义自己的拦截器类，继承
Interceptor类，实现onRequest，onResponse和onError方法即可。
注意，Dio 的实例可以同时添加多个拦截器，以便处理不同的情况。
