springmvc拦截器(定义、配置以及执行流程)
一、拦截器概念
springmvc中的拦截器(interceptor)类似于Servlet中的过滤器(Filter),它主要用于拦截用户请求并做相应的处理。在实际项目中会经常使用到拦截器,例如在购物网站中通过拦截器可以拦截未登录的用户,禁止其购买商品,或者使用它来验证已登录用户是否有相应的操作权限(即权限验证),记录请求信息的日志等应用。
所谓拦截器,就是能够在进行某个操作之前拦截请求,如果请求符合条件就允许在往下执行。比如说,海关就是一个拦截器,他拦截进出口的货物,如果货物满足进出口条件,则放行,否则就拦截,退回处理。
二、拦截器定义和配置使用
在springmvc中要使用拦截器,就需要对拦截器类进行定义和配置,通常拦截器类可以通过两种方式来定义。
第一种通过实现HandleInterceptor接口,或者继承HandleInterceptor接口的实现类HandleInterceptorAdapter来定义;
第二种通过实现WebRequestInterceptor接口,或继承WebRequestInterceptor接口的实现类来定义。
1、拦截器的定义:以实现HandleInterceptor接口为例
public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { //做一些操作 方法返回类型为布尔值 return false; } @Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception { //做一些操作 } @Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception { //做一些操作 } }
从以上可以看出,自定义的拦截器类实现了HandlerInterceptor接口,并且实现了接口中的三个方法。对这三个方法解释如下:
(1)、preHandle()方法
该方法会在控制器方法前执行,其返回值表示是否中断后续操作。当返回值为true时,表示继续向下执行;当返回值为false时,会中断后续的所有操作(包括调用下一个拦截器和控制器类中的方法执行等)。
(2)、postHandle()方法
该方法会在控制器方法调用之后,且解析视图之前执行。可以通过此方法对请求域中的模型和视图做出进一步的修改。
(3)、afterCompletion()方法
该方法会在整个请求完成,即视图渲染结束之后执行。可以通过此方法实现一些资源清理、记录日志信息等工作。
2、拦截器的配置
要使自定义的拦截器类生效,还需要在springmvc的配置文件中进行配置。配置如下所示:
<!-- 配置拦截器 --> <mvc:interceptors> <!-- 使用bean直接定义在<mvc:interceptors>下面的Interceptor将拦截所有请求 --> <bean class="com.config.AllInterceptor"/> <!-- 拦截器1 --> <mvc:interceptor> <!-- 配置拦截器作用的路径,/**表示拦截所有路径 --> <mvc:mapping path="/**"/> <!-- 配置不需要拦截器作用的路径 /admin表示放行所有以/admin结尾的路径 --> <mvc:exclude-mapping path="/admin"/> <!-- 定义在<mvc:interceptor>下面的Interceptor,表示对匹配路径的请求才进行拦截 --> <bean class="com.config.AdminInterceptor"/> </mvc:interceptor> <!-- 拦截器2 --> <mvc:interceptor> <mvc:mapping path="/index/**"/> <bean class="com.config.IndexInterceptor"/> </mvc:interceptor> <!-- 后面可以配置多个拦截器--> </mvc:interceptors>
需要注意的是在进行配置拦截器时,必须按照如上的顺序进行配置,否则拦截器将失效。
三、拦截器执行流程
在运行程序时,拦截器的执行是有一定的顺序的,该顺序与配置文件中所定义的拦截器的顺序是相关的。拦截器执行顺序有两种情况,即单个拦截器和多个拦截器的情况,单个拦截器和多个拦截器的执行顺序是不一样的,略有差别。
1、单个拦截器执行流程
当只定义了一个拦截器时,它的执行流程如下图所示:
对单个拦截器执行流程解释如下:
从以上图中可以看出,程序首先会执行拦截器类中的preHandle()方法,如果该方法返回true,则程序会继续向下执行处理器中的方法,否则程序将不再往下继续执行。在业务处理器(即控制器Controller类)处理完请求后,会执行postHandle()方法,然后会通过DispatcherServlet向客户端返回响应,在DispatcherServlet处理完请求后,才会执行afterCompletion()方法。
因此单个拦截器的执行流程:
prehandle()——Handle(也就是控制器里的方法)——postHandle()——afterCompletion()。
2、多个拦截器执行流程
在大型的企业级项目中,通常会配置多个拦截器来实现不同的功能。例如在springmvc配置文件中配置了两个拦截器Interceptor1和Interceptor2。配置顺序Interceptor1在Interceptor2的前面。
则它们的执行流程如下图所示:
从以上执行流程图中可以看出,当有多个拦截器同时工作时,它们的preHandle()方法会按照配置文件中拦截器的配置顺序执行,而它们的postHandle()和afterCompletion()方法则会按照配置顺序的反序执行。
因此当多个拦截器工作时,其执行流程:
preHandle1——preHandle2——Handle——postHandle2——postHandle1——afterCompletion2——afterCompletion1··········
多个拦截器存在时,其preHandle方法是按次序执行,其余的则是相反顺序执行。
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· 10年+ .NET Coder 心语 ── 封装的思维:从隐藏、稳定开始理解其本质意义
· 地球OL攻略 —— 某应届生求职总结
· 提示词工程——AI应用必不可少的技术
· Open-Sora 2.0 重磅开源!
· 字符编码:从基础到乱码解决