1.拦截器
1.1 拦截器的定义
在Spring MVC中使用拦截器,需要对拦截器类进行定义和配置。一般拦截器可以通过两种方式类定义。
- 一种是通过实现HandlerInterceptor接口或继承该接口的实现类来定义;
- 一种是通过实现WebRequestInterceptor接口或继承该接口的实现类来定义。
下面我们以实现HandlerInterceptor接口的方式来自定义拦截器类:
@Component
public class MyFirstInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("MyFirstInterceptor=====================>preHandle");
return true;
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("MyFirstInterceptor=====================>postHandle");
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("MyFirstInterceptor=====================>afterCompletion");
}
}
可以看出自定义的拦截器类实现了HandlerInterceptor接口,并重写了接口中的三个方法。
1.2 拦截器的方法
拦截器有3个回调方法:
preHandle: 预处理回调方法,实现处理器的预处理,第三个参数为响应的处理器返回值:true表示继续向下执行(如调用下一个拦截器);false表示中断后续操作,不会继续调用其他的拦截器和控制器类的方法执行。
postHandle: 后处理回调方法,实现处理器的后处理,在渲染视图之前,此时我们可以通过modelAndView对模型数据进行处理或对视图进行处理。
afterCompletion: 整个请求处理完成,即在视图渲染结束之后执行,可以通过该方法进行一些资源清理,类似于trycatchfinally中的finally,但仅调用处理器执行链中preHandle返回true的拦截器才会执行。
1.3 拦截器的配置
想要使自定义的拦截器类生效,还需要在Spring MVC的配置文件中进行配置。
我们通过<mvc:interceptors>
元素来配置一组拦截器,若要拦截DispatcherServlet处理的所有请求,则如下面配置:
<!--配置拦截器-->
<mvc:interceptors>
<!--1.对DispatcherServlet处理的所有请求进行拦截-->
<bean class="com.it.interceptor.MyFirstInterceptor"/>
<ref bean="myFirstInterceptor"/>
</mvc:interceptors>
当然,我们也可以通过<mvc:interceptors>
的子元素\<mvc:interceptor\>来定义指定路径的拦截器,他会对指定路径下的请求生效。
<mvc:interceptors>
<mvc:interceptor>
<!--配置拦截器作用的路径,path的属性值“/**”表示拦截所有路径-->
<mvc:mapping path="/**"/>
<!--配置拦截请求中不需要拦截的请求-->
<mvc:exclude-mapping path="/interceptor"/>
<ref bean="myFirstInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
注意:\<mvc:interceptor\>元素中的子元素的配置顺序不能变。
1.4 定义多个拦截器
1.4.1 添加另一个拦截器
@Component
public class MySecondInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("MySecondInterceptor=================>preHandle");
return true;
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("MySecondInterceptor==================>postHandle");
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("MySecondInterceptor=============>afterCompletion");
}
}
1.4.2 配置拦截器
<mvc:interceptors>
<ref bean="myFirstInterceptor"/>
<ref bean="mySecondInterceptor"/>
</mvc:interceptors>
可以看到如下图所示的执行顺序:
从上面能够看到,若每个拦截器的preHandle()都返回true,则preHandle()会按照配置的顺序执行,而postHandle()和afterComplation()会按照配置的反序执行。若某个拦截器的preHandle()返回了false,那么preHandle()返回false和它之前的拦截器的preHandle()都会执行,而postHandle()都不执行,返回false的拦截器之前的拦截器的afterComplation()会执行。也就是已经通过的拦截器的afterCompletion会执行。
1.4.1 示例
比如:我们将第二个拦截器的preHandle方法的返回值改为false,可以看到preHandle方法都执行了,postHandle没有执行,而afterComplation只执行了第一个拦截器的。
1.5 拦截器的执行流程
1.5.1 单个拦截器执行流程
单个拦截器,程序会首先执行拦截器类中的preHandle()方法,若该方法返回true,则继续向下执行处理器中的方法,否则中断;处理完请求之后会执行postHandle()方法,然后再通过DispatcherServlet请求处理之后,最后执行afterComplation()方法。
1.5.2 多拦截器执行流程
多个拦截器同时工作时,每个拦截器的preHandle()方法都会按照配置的顺序执行,而postHandle()和afterComplation()会按照配置的反序执行。