Flutter 入门与实战（二十九）：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 的实例可以同时添加多个拦截器，以便处理不同的情况。