Flutter 入门与实战（二十九）：Dio 之拦截器

「本文已参与好文召集令活动，点击查看：后端、大前端双赛道投稿，2万元奖池等你挑战！」

老王的烦恼

昔日的小王凭借这他的当心谨慎和借助漂亮能干的女朋友 Dio 的辅助，终于干下了一番事业，成为中华大地响当当的人物，小王也变成老王。现在，老王已经年近花甲，看似迈上了人生巅峰，却也遇到了人生的烦恼——那就是他的儿子，新的小王。

小王和他爹当年的当心谨慎不一样，小王自海外留学回来，也不肯意接手老王的事业。反而迷恋起了互联网，玩游戏、微博喷人、撩网红等等。前两项倒还好，可是后一项，让老王心烦得很。这网红哪能随便撩的，万一弄出许多小小王来，多你们业都不够分的啊！

能干的老王媳妇

关键时刻，仍是老王的媳妇，曾经被金屋藏娇的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;
}
复制代码

这下小王在互联网就彻底被监视了——并且他压根不知道！只是，每次他说要钱的时候，老王再也不随便给了！

但这个时候，小王还能在网上撩，毕竟上网在这个时代是不怎么要钱的。

狠心的老王媳妇

老王媳妇 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;
}
复制代码

消停的小王

小王这下子懵圈了，难道是他的那些“土味情话”已经失效了？每次发出去消息都遭受到了无情的打击，让他心灰意冷。渐渐地他就淡出了互联网，至于如今在干什么，谁也不知道。感受又像是当初老王金屋藏娇同样，如今的小王也逐渐被隐藏了起来。今后，互联网只剩下小王和各个网红的传说。

后记

借着老王和小王的故事，咱们讲述了 Dio 的封装和 Dio 的拦截器。其中拦截器能够应用于不少实际场景：

• 权限验证：好比接口请求后端返回401未受权时能够跳到登陆页，403跳到未受权页面；
• 异常监控：能够在拦截器处理异常，而且上报到异常监控后台或者发送异常预警消息；
• 缓存接口：能够对于某些接口将请求缓存在本地，设定必定的缓存有效时限，在时限内重复请求时直接返回本地缓存数据，而无需请求后端接口，下降后端服务器负荷。这块能够参考dio-http-cache。
• Cookie：App 自己是不会缓存 Cookie 信息的，可使用拦截器在向后端发起请求时自动携带 Cookie信息，能够参考cookie_manager。
• 生成接口文档：能够在拦截器将请求参数，返回结果输出为 Postman格式的接口文档，参考postman_dio。
• 自定义拦截器：能够自定义本身的拦截器类，继承Interceptor类，实现 onRequest，onResponse 和 onError方法便可。

注意，Dio 的实例能够同时添加多个拦截器，以便处理不一样的状况。