基于SpringMVC的拦截器（Interceptor）和过滤器（Filter）的区别与联系

2025-01-15 技术教程

一简介

（1）过滤器：

依赖于servlet容器。在实现上基于函数回调，可以对几乎所有请求进行过滤，但是缺点是一个过滤器实例只能在容器初始化时调用一次。使用过滤器的目的是用来做一些过滤操作，获取我们想要获取的数据，比如：在过滤器中修改字符编码；在过滤器中修改HttpServletRequest的一些参数，包括：过滤低俗文字、危险字符等

关于过滤器的一些用法可以参考我写过的这些文章：

继承HttpServletRequestWrapper以实现在Filter中修改HttpServletRequest的参数：https://www.zifangsky.cn/677.html

在SpringMVC中使用过滤器（Filter）过滤容易引发XSS的危险字符：https://www.zifangsky.cn/683.html

（2）拦截器：

依赖于web框架，在SpringMVC中就是依赖于SpringMVC框架。在实现上基于Java的反射机制，属于面向切面编程（AOP）的一种运用。由于拦截器是基于web框架的调用，因此可以使用Spring的依赖注入（DI）进行一些业务操作，同时一个拦截器实例在一个controller生命周期之内可以多次调用。但是缺点是只能对controller请求进行拦截，对其他的一些比如直接访问静态资源的请求则没办法进行拦截处理

关于过滤器的一些用法可以参考我写过的这些文章：

在SpringMVC中使用拦截器（interceptor）拦截CSRF***（修）：https://www.zifangsky.cn/671.html

SpringMVC中使用Interceptor+Cookie实现在一定天数之内自动登录：https://www.zifangsky.cn/700.html

二多个过滤器与拦截器的代码执行顺序

如果在一个项目中仅仅只有一个拦截器或者过滤器，那么我相信相对来说理解起来是比较容易的。但是我们是否思考过：如果一个项目中有多个拦截器或者过滤器，那么它们的执行顺序应该是什么样的？或者再复杂点，一个项目中既有多个拦截器，又有多个过滤器，这时它们的执行顺序又是什么样的呢？

下面我将用简单的代码来测试说明：

（1）先定义两个过滤器：

i）过滤器1：

packagecn.zifangsky.filter;importjava.io.IOException;importjavax.servlet.FilterChain;importjavax.servlet.ServletException;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;importorg.springframework.web.filter.OncePerRequestFilter;publicclassTestFilter1extendsOncePerRequestFilter{protectedvoiddoFilterInternal(HttpServletRequestrequest,HttpServletResponseresponse,FilterChainfilterChain)throwsServletException,IOException{//在DispatcherServlet之前执行System.out.println("############TestFilter1doFilterInternalexecuted############");filterChain.doFilter(request,response);//在视图页面返回给客户端之前执行，但是执行顺序在Interceptor之后System.out.println("############TestFilter1doFilterafter############");//try{//Thread.sleep(10000);//}catch(InterruptedExceptione){//e.printStackTrace();//}}}

ii）过滤器2：

packagecn.zifangsky.filter;importjava.io.IOException;importjavax.servlet.FilterChain;importjavax.servlet.ServletException;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;importorg.springframework.web.filter.OncePerRequestFilter;publicclassTestFilter2extendsOncePerRequestFilter{protectedvoiddoFilterInternal(HttpServletRequestrequest,HttpServletResponseresponse,FilterChainfilterChain)throwsServletException,IOException{System.out.println("############TestFilter2doFilterInternalexecuted############");filterChain.doFilter(request,response);System.out.println("############TestFilter2doFilterafter############");}}

iii）在web.xml中注册这两个过滤器：

<filter><filter-name>testFilter1</filter-name><filter-class>cn.zifangsky.filter.TestFilter1</filter-class></filter><filter-mapping><filter-name>testFilter1</filter-name><url-pattern>/*</url-pattern></filter-mapping><filter><filter-name>testFilter2</filter-name><filter-class>cn.zifangsky.filter.TestFilter2</filter-class></filter><filter-mapping><filter-name>testFilter2</filter-name><url-pattern>/*</url-pattern></filter-mapping>

（2）再定义两个拦截器：

i）拦截器1，基本拦截器：

packagecn.zifangsky.interceptor;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;importorg.springframework.web.servlet.HandlerInterceptor;importorg.springframework.web.servlet.ModelAndView;publicclassBaseInterceptorimplementsHandlerInterceptor{/***在DispatcherServlet之前执行**/publicbooleanpreHandle(HttpServletRequestarg0,HttpServletResponsearg1,Objectarg2)throwsException{System.out.println("************BaseInterceptorpreHandleexecuted**********");returntrue;}/***在controller执行之后的DispatcherServlet之后执行**/publicvoidpostHandle(HttpServletRequestarg0,HttpServletResponsearg1,Objectarg2,ModelAndViewarg3)throwsException{System.out.println("************BaseInterceptorpostHandleexecuted**********");}/***在页面渲染完成返回给客户端之前执行**/publicvoidafterCompletion(HttpServletRequestarg0,HttpServletResponsearg1,Objectarg2,Exceptionarg3)throwsException{System.out.println("************BaseInterceptorafterCompletionexecuted**********");//Thread.sleep(10000);}}

ii）指定controller请求的拦截器：

packagecn.zifangsky.interceptor;importjavax.servlet.http.HttpServletRequest;importjavax.servlet.http.HttpServletResponse;importorg.springframework.web.servlet.HandlerInterceptor;importorg.springframework.web.servlet.ModelAndView;publicclassTestInterceptorimplementsHandlerInterceptor{publicbooleanpreHandle(HttpServletRequestarg0,HttpServletResponsearg1,Objectarg2)throwsException{System.out.println("************TestInterceptorpreHandleexecuted**********");returntrue;}publicvoidpostHandle(HttpServletRequestarg0,HttpServletResponsearg1,Objectarg2,ModelAndViewarg3)throwsException{System.out.println("************TestInterceptorpostHandleexecuted**********");}publicvoidafterCompletion(HttpServletRequestarg0,HttpServletResponsearg1,Objectarg2,Exceptionarg3)throwsException{System.out.println("************TestInterceptorafterCompletionexecuted**********");}}

iii）在SpringMVC的配置文件中注册这两个拦截器：

<mvc:interceptors><beanname="baseInterceptor"class="cn.zifangsky.interceptor.BaseInterceptor"/><mvc:interceptor><mvc:mappingpath="/test.html"/><beanclass="cn.zifangsky.interceptor.TestInterceptor"/></mvc:interceptor></mvc:interceptors>

（3）定义一个测试使用的controller：

packagecn.zifangsky.controller;importorg.springframework.stereotype.Controller;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.servlet.ModelAndView;@ControllerpublicclassTestController{@RequestMapping("/test.html")publicModelAndViewhandleRequest(){System.out.println("---------TestControllerexecuted--------");returnnewModelAndView("test");}}

（4）视图页面test.jsp：

<%@pagelanguage="java"contentType="text/html;charset=UTF-8"pageEncoding="UTF-8"%><%Stringpath=request.getContextPath();StringbasePath=request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";%><html><head><metahttp-equiv="Content-Type"content="text/html;charset=UTF-8"><basehref="<%=basePath%>"><title>FilterDemo</title></head><body><%System.out.println("test.jspisloading");%><divalign="center">Thisistestpage</div></body></html>

（5）测试效果：

启动此测试项目，可以看到控制台中输出如下：

这就说明了过滤器的运行是依赖于servlet容器的，跟springmvc等框架并没有关系。并且，多个过滤器的执行顺序跟xml文件中定义的先后关系有关

接着清空控制台中的输出内容并访问：http://localhost:9180/FilterDemo/test.html

可以看到，此时的控制台输出结果如下：

相信从这个打印输出，大家就可以很清晰地看到有多个拦截器和过滤器存在时的整个执行顺序了。当然，对于过个拦截器它们之间的执行顺序跟在SpringMVC的配置文件中定义的先后顺序有关

注：对于整个SpringMVC的执行流程来说，如果加上上面的拦截器和过滤器，其最终的执行流程就如下图所示：

PS：这个图是我用画图软件画出来的，将就着看吧^_^

参考：

《Spring实战（第4版）》第5章

PS：上面图片中的水印是我个人博客的域名，因此还请管理员手下留情不要给我标为“转载文章”，谢谢！！！