【Spring Boot系列】- Spring Boot拦截器

文章目录

【Spring Boot系列】- Spring Boot拦截器
- 一、概述
- 二、拦截器（Interceptor）定义步骤
- - 2.1 定义拦截器（Interceptor）
  - 2.2 注册拦截器（Interceptor）
  - 2.3 拦截器原理
- 三、过滤器与拦截器区别
- 四、拦截器的应用
- - 权限检查
  - 日志记录
  - 性能监控
  - 通用行为

一、概述

拦截器（Interceptor）是在面向切面编程中应用的，就是在service或者一个方法前调用一个方法，或者在方法后调用一个方法。是基于JAVA的反射机制。可以根据 URL 对请求进行拦截，主要应用于登陆校验、权限验证、乱码解决、性能监控和异常处理等功能。

二、拦截器（Interceptor）定义步骤

在 Spring Boot 项目中，使用拦截器功能通常需要以下 3 步

定义拦截器
注册拦截器
指定拦截规则（如果是拦截所有，静态资源也会被拦截）

2.1 定义拦截器（Interceptor）

定义拦截器十分的简单，只需要创建一个拦截器类，并实现 HandlerInterceptor 接口，重写以下三个方法:

@Slf4j
@Component
public class MyHandleInterceptor implements HandlerInterceptor {/*** 目标方法执行前* 该方法在控制器处理请求方法前执行，其返回值表示是否中断后续操作* 返回 true 表示继续向下执行，返回 false 表示中断后续操作*/@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {Object loginUser = request.getSession().getAttribute("loginUser");if (loginUser == null) {//未登录，返回登陆页request.setAttribute("msg", "您没有权限进行此操作，请先登陆！");request.getRequestDispatcher("/index.html").forward(request, response);return false;} else {//放行return true;}}/*** 目标方法执行后* 该方法在控制器处理请求方法调用之后、解析视图之前执行* 可以通过此方法对请求域中的模型和视图做进一步修改*/@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {log.info("postHandle执行{}", modelAndView);}/*** 页面渲染后* 该方法在视图渲染结束后执行* 可以通过此方法实现资源清理、记录日志信息等工作*/@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {log.info("afterCompletion执行异常{}", ex);}
}

2.2 注册拦截器（Interceptor）

创建一个实现了 WebMvcConfigurer 接口的配置类（使用了 @Configuration 注解的类），重写 addInterceptors() 方法，并在该方法中调用 registry.addInterceptor() 方法将自定义的拦截器注册到容器中。

@Configuration
public class MyMvcConfig implements WebMvcConfigurer {@Resourceprivate LoginInterceptor loginInterceptor;@Overridepublic void addInterceptors(InterceptorRegistry registry) {//注册自己的拦截器,并设置拦截的请求路径//addPathPatterns为拦截此请求路径的请求//excludePathPatterns为不拦截此路径的请求registry.addInterceptor(MyHandleInterceptor).addPathPatterns("/user/*").excludePathPatterns("/user/login");}
}

2.3 拦截器原理

根据当前请求，找到HandlerExecutionChain【可以处理请求的handler以及handler的所有拦截器】；
先来顺序执行所有拦截器的 preHandle方法；
1. 如果当前拦截器prehandler返回为true。则执行下一个拦截器的preHandle；
2. 如果当前拦截器返回为false。直接倒序执行所有已经执行了的拦截器的 afterCompletion；
如果任何一个拦截器返回false。直接跳出不执行目标方法；
所有拦截器都返回True。执行目标方法；
倒序执行所有拦截器的postHandle方法；
前面的步骤有任何异常都会直接倒序触发 afterCompletion；
页面成功渲染完成以后，也会倒序触发 afterCompletion；

三、过滤器与拦截器区别

过滤器和拦截器触发时机不一样，过滤器是在请求进入容器后，但请求进入servlet之前进行预处理的。请求结束返回也是，是在servlet处理完后，返回给前端之前。
、拦截器可以获取IOC容器中的各个bean，而过滤器就不行，因为拦截器是spring提供并管理的，spring的功能可以被拦截器使用，在拦截器里注入一个service，可以调用业务逻辑。而过滤器是JavaEE标准，只需依赖servlet api ，不需要依赖spring。
过滤器的实现基于回调函数。而拦截器（代理模式）的实现基于反射。
Filter是依赖于Servlet容器，属于Servlet规范的一部分，而拦截器则是独立存在的，可以在任何情况下使用。
Filter的执行由Servlet容器回调完成，而拦截器通常通过动态代理（反射）的方式来执行。
Filter的生命周期由Servlet容器管理，而拦截器则可以通过IoC容器来管理，因此可以通过注入等方式来获取其他Bean的实例，因此使用会更方便。