在SpringBoot中我们可以使用HandlerInterceptorAdapter这个适配器来实现自己的拦截器。这样就可以拦截所有的请求并做相应的处理。

1. 应用场景

  • 日志记录,可以记录请求信息的日志,以便进行信息监控、信息统计等。
  • 权限检查:如登陆检测,进入处理器检测是否登陆,如果没有直接返回到登陆页面。
  • 性能监控:典型的是慢日志。
  1. 在HandlerInterceptorAdapter中主要提供了以下的方法:
    preHandle:在方法被调用前执行。在该方法中可以做类似校验的功能。如果返回true,则继续调用下一个拦截器。如果返回false,则中断执行,也就是说我们想调用的方法 不会被执行,但是你可以修改response为你想要的响应。
  2. postHandle:在方法执行后调用。
  3. afterCompletion:在整个请求处理完毕后进行回调,也就是说视图渲染完毕或者调用方已经拿到响应。

2. HandlerInterceptor

HandlerInterceptorAdapter - 图1

2.1 拦截器适配器HandlerInterceptorAdapter

  1. public abstract class HandlerInterceptorAdapter implements AsyncHandlerInterceptor {
  2. /**
  3. * This implementation always returns {@code true}.
  4. */
  5. @Override
  6. public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
  7. throws Exception {
  8. return true;
  9. }
  10. /**
  11. * This implementation is empty.
  12. */
  13. @Override
  14. public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
  15. @Nullable ModelAndView modelAndView) throws Exception {
  16. }
  17. /**
  18. * This implementation is empty.
  19. */
  20. @Override
  21. public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler,
  22. @Nullable Exception ex) throws Exception {
  23. }
  24. /**
  25. * This implementation is empty.
  26. */
  27. @Override
  28. public void afterConcurrentHandlingStarted(HttpServletRequest request, HttpServletResponse response,
  29. Object handler) throws Exception {
  30. }
  31. }

有时候我们可能只需要实现三个回调方法中的某一个,如果实现HandlerInterceptor接口的话,三个方法必须实现,不管你需不需要,此时spring提供了一个HandlerInterceptorAdapter适配器(种适配器设计模式的实现),允许我们只实现需要的回调方法。
这样在我们业务中比如要记录系统日志,日志肯定是在afterCompletion之后记录的,否则中途失败了,也记录了,那就扯淡了。一定是程序正常跑完后,我们记录下那些对数据库做个增删改的操作日志进数据库。所以我们只需要继承HandlerInterceptorAdapter,并重写afterCompletion一个方法即可,因为preHandle默认是true。

运行流程总结如下:

  1. 拦截器执行顺序是按照Spring配置文件中定义的顺序而定的。
  2. 会先按照顺序执行所有拦截器的preHandle方法,一直遇到return false为止,比如第二个preHandle方法是return false,则第三个以及以后所有拦截器都不会执行。若都是return true,则按顺序加载完preHandle方法。
  3. 然后执行主方法(自己的controller接口),若中间抛出异常,则跟return false效果一致,不会继续执行postHandle,只会倒序执行afterCompletion方法。
  4. 在主方法执行完业务逻辑(页面还未渲染数据)时,按倒序执行postHandle方法。若第三个拦截器的preHandle方法return false,则会执行第二个和第一个的postHandle方法和afterCompletion(postHandle都执行完才会执行这个,也就是页面渲染完数据后,执行after进行清理工作)方法。(postHandle和afterCompletion都是倒序执行)

3. demo来演示执行流程

3.1 定义一个类实现HandlerInterceptor,并重写方法

快捷键ctrl+o打开可以重写的方法面板选择

public class MyHandlerInterceptorAdapter implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle被执行");
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("psotHandle被执行");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion被执行");

    }
}

WebMvcConfigurerAdapter 抽象类是对WebMvcConfigurer接口的简单抽象(增加了一些默认实现),但在在SpringBoot2.0及Spring5.0中WebMvcConfigurerAdapter已被废弃 。官方推荐直接实现WebMvcConfigurer或者直接继承WebMvcConfigurationSupport

3.2 实现WebMvcConfigurer配置拦截器

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MyHandlerInterceptorAdapter());
    }
}

3.3 在控制器中写一个方法并访问

@ApiOperation(value = "test mybatis", notes = "")
@RequestMapping(value = "getuser", method = RequestMethod.GET)
public User getUser() {
    return userService.getUser();
}

HandlerInterceptorAdapter - 图2

此时在加入一个拦截器,会按照配置的顺序执行,配置如下

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MyHandlerInterceptorAdapter());
        registry.addInterceptor(new MyHandlerInterceptorAdapter2());
    }
}

控制的输出反映了配置多个拦截器的执行流程:

HandlerInterceptorAdapter - 图3

如果controller出现异常,则不会继续执行postHandle,只会倒序执行afterCompletion方法

HandlerInterceptorAdapter - 图4

HandlerInterceptorAdapter - 图5