拦截器概述

没有拦截器之前

当需要对请求进行一些通用的操作，如请求数据的封装、类型转换、数据校验、解析上传的文件、防止表单的多次提交等。早期的MVC框架将这些操作都写死在核心控制器中，而这些常用的操作又不是所有的请求都需要实现的，这就导致了框架的灵活性不足，可扩展性降低

有了拦截器之后

SpringMVC提供了Interceptor拦截器机制，类似于Servlet中的Filter过滤器，用于拦截用户的请求并做出相应的处理。比如通过拦截器来进行用户权限验证，或者用来判断用户是否已经登录。Spring MVC拦截器是可插拔式的设计，需要某一功能拦截器，只需在配置文件中应用该拦截器即可；如果不需要这个功能拦截器，只需在配置文件中取消应用该拦截器。

拦截器与过滤器的关系

处理器拦截器HandlerInterceptor是Spring MVC提供的特性，依赖于Spring MVC框架，而不依赖Servlet容器，Filter则是Servlet的特性，属于Servlet的规范，并且依赖Servlet容器。
应用中可以存在多个拦截器形成拦截器链，也可以存在多个过滤器形成过滤器链！
拦截器链和过滤器链的预处理和后处理的调用顺序都是相反的，即预处理调用时按照链从前向后调用，而后处理调用时则按照链从后向前调用。
过滤器可用于对所有到达该应用的请求进行拦截，而拦截器则只能对通过DispatcherServlet进行处理的请求进行拦截。
在Request请求到达Servlet之前执行过滤器的预处理逻辑，在请求到达DispatcherServlet之后、执行Handler之前执行拦截器的预处理逻辑，并在成功执行Handler之后执行拦截器的后处理逻辑，在DispatcherServlet返回之后最后执行过滤器的后处理逻辑。
Filter在doFilter一个方法中定义预处理和后处理逻辑，在方法中通过filterChain.doFilter进行分隔，而HandlerInterceptor将预处理和后处理逻辑拆分成两个方法，即preHandle、postHandle方法。
Filter有该类本身的初始化和销毁的回调方法，即init和destroy，而HandlerInterceptor则没有，但是HandlerInterceptor拥有afterCompletion处理方法，无论有没有抛出异常，在DispatcherServlet请求处理的最后都会执行！

拦截器的定义与使用

在Spring MVC中定义一个拦截器有两种方法：实现HandlerInterceptor接口，实现WebRequestInterceptor接口。（本文主要基于HandlerInterceptor）

方式一：实现HandlerInterceptor接口

1）定义一个类实现HandlerInterCeptor接口

2）分别重载preHandle、postHandle、afterCompletion方法

preHandle(req,resp)：在controller的方法被调用之前执行该方法，返回boolean类型的值，可以使用该方法中断或继续处理执行链。
1）如果返回true，拦截器链将继续执行后续拦截器的preHandle方法；
2）如果返回false，DispatchServlet会假定烂机器本身已经处理完毕请求，此时将直接倒序执行此前已经方形的拦截器链的afterCompletion方法，随后return结束处理

postHandle(req, resp)：在方法被调用视图解析之前调用。对于采用了@ResponseBody注解或者返回ResponseEntity的方法，postHandle后处理不太有效，因为在Handler执行成功时响应的数据（比如JSON数据）已经被写入response并且已被提交，并且是在postHandle方法被执行之前进行的！此时对于response的任何修改（比如添加额外的头部信息）都为时已晚。对于这种情况，我们可以实现ResponseBodyAdvice接口并且声明为ControllerAdvice，或者直接在RequestMappingHandlerAdapter中配置。

afterCompletion(req, resp)：在请求处理完毕之后执行，无论是否有响应视图，无论有没有通过preHandle，无论有没有抛出异常。只会对此前放行成功（preHandle返回true）的拦截器进行倒序调用。

代码如下：

package ...;import ...;/*** 自定义请求头拦截器，将Header数据封装到线程变量中方便获取* 注意：此拦截器会同时验证当前用户有效期自动刷新有效期** @author liulianglin*/
public class HeaderInterceptor implements AsyncHandlerInterceptor
{@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception{// 这里做一些事情，return true or return false}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,ModelAndView modelAndView) {// 这里做一些事情}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)throws Exception{// 这里做一些事情}
}

3）配置拦截器

3.1）传统spring mvc项目

在spring-mvc的配置文件中配置拦截器，可以配置多个拦截器，哪个在上边，最先执行哪个拦截器。

3.2）SpringBoot项目

自定义配器实现WebMvcConfigurer配置器接口。

package ...;import ...;/*** 拦截器配置** @author bonc*/
public class WebMvcConfig implements WebMvcConfigurer{/** 不需要拦截地址 */public static final String[] excludeUrls = { "/login", "/logout", "/refresh" };@Overridepublic void addInterceptors(InterceptorRegistry registry)    {registry.addInterceptor(getHeaderInterceptor()).addPathPatterns("/**").excludePathPatterns(excludeUrls).order(-10);}/*** 自定义请求头拦截器*/public HeaderInterceptor getHeaderInterceptor(){return new HeaderInterceptor();}
}

词库加载错误:未能找到文件“E:\highferrum_mysql\Configuration\Dict_Stopwords.txt”。

上一篇：47-外卖店优先级

SpringMVC--拦截器使用原理