spring MVC拦截器介绍

最新推荐文章于 2025-03-26 22:54:49 发布

俺就不起网名

最新推荐文章于 2025-03-26 22:54:49 发布

阅读量3.4k

点赞数 2

分类专栏： Spring/SpringMVC 文章标签： spring mvc interceptor

本文链接：https://blog.youkuaiyun.com/u012385190/article/details/51437992

版权

Spring/SpringMVC 专栏收录该内容

20 篇文章

订阅专栏

本文详细介绍了Spring MVC中的拦截器Interceptor，用于在请求处理前后进行额外操作，如权限验证和登录检查。通过实现HandlerInterceptor接口，你可以自定义拦截器。文章通过实例演示了如何创建拦截器，包括preHandle、postHandle和afterCompletion三个关键方法的使用，并给出了可能出现的问题及解决方法。最后，提供了完整的项目代码下载链接。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Spring MVC 中我们可以自己根据需求定义自己的的Interceptor 拦截器，它的主要作用是拦截用户的请求并进行相应的处理。比如通过它来进行权限验证，或者是来判断用户是否登陆等。

我们常用的Spring MVC的拦截器是通过实现接口HandlerInterceptor（org.springframework.web.servlet.HandlerInterceptor）来实现，但是还有其他方法也可以实现自定义拦截器。

一、定义拦截器类的方法：

1、定义一个类实现了spring 的HandlerInterceptor 接口，或者是这个类继承实现了HandlerInterceptor 接口的类（常用）；
2、定义一个类实现spring的WebRequestInterceptor接口，或者是继承实现了WebRequestInterceptor的类；

二、HandlerInterceptor接口

该接口提供了三个方法：
1、preHandle()：这个方法在业务处理器处理请求之前被调用。如果该拦截器对请求进行拦截处理后还要调用其他的拦截器，或者是业务处理器（即Controller）去进行处理，则返回true；如果不需要再调用其他的组件去处理请求了，则返回false；
2、postHandle()：这个方法在业务处理器处理完请求后，但是DispatcherServlet向客户端返回请求前被调用，在该方法中对用户请求request进行处理;
3、afterCompletion()：这个方法在DispatcherServlet完全处理完请求后被调用，可以在该方法中进行一些资源清理的工作；

三、自己动手写一个
在实践中学习才是最好的方法。模拟用户登录，当用户的用户名不为空且为”Amy”时，则进入hello页面，当用户名不为”Amy”则进入到登录页面；
1、搭建spring mvc框架。参考：http://blog.youkuaiyun.com/u012385190/article/details/51396704
2、定义类实现HandlerInterceptor接口

public class InterceptorDemo implements HandlerInterceptor  {

    // 在业务处理器处理请求之前被调用
        @Override
        public boolean preHandle(HttpServletRequest arg0, HttpServletResponse arg1,
                Object arg2) throws Exception {
            System.out.println("调用拦截器方法   preHandle ………………");
            String userName = arg0.getParameter("userName");
            if(userName!=null && "Amy".equals(userName)){
                System.out.println("preHandle return true:继续调用后面的Interceptor或者Controller");
                return true;
            }else{
                System.out.println("preHandle return false：后续的Interceptor 和 Controller 都不会再执行");
                System.out.println("preHandle return false：后续的postHandle 和 afterCompletion都不会执行");
                arg1.sendRedirect(arg0.getContextPath()+"/login.jsp"); // 返回提示页面  
                return false;
            }
        }

        //在业务处理器处理请求之后被调用
        @Override
        public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1,
                Object arg2, ModelAndView arg3) throws Exception {
            System.out.println("调用拦截器方法   postHandle ………………");
        }

        //在DispatcherServlet完全处理完请求后被调用 
        @Override
        public void afterCompletion(HttpServletRequest arg0,
                HttpServletResponse arg1, Object arg2, Exception arg3)
                throws Exception {
            System.out.println("调用拦截器方法   afterCompletion ………………");
        }

}

可通过控制台输出了解调用顺序。

3、在servlet.xml中添加如下拦截器配置

<!-- 定义拦截器 -->
    <mvc:interceptors>
        <!-- 使用bean定义一个Interceptor，直接定义在mvc:interceptors根下面的Interceptor将拦截所有的请求
        <bean class="demo.interceptor.InterceptorDemo" /> -->
        <mvc:interceptor>
            <mvc:mapping path="/*" />
            <!-- 定义在mvc:interceptor下面的表示是对特定的请求才进行拦截的 -->
            <bean class="demo.interceptor.InterceptorDemo" />
        </mvc:interceptor>
    </mvc:interceptors>

如果发现请求并没有进入拦截器方法，问题可能出在 mvc:mapping path=”/*” 配置上。尝试将该拦截器定义为所有请求都拦截就可以检查是否是路径错误。

4、开发业务处理器层（Controller）

 @RequestMapping(value="/lookWorld",method=RequestMethod.GET)
    public String lookWorld(Model model) {
        System.out.println("调用 controller 方法…………");
        model.addAttribute("msg", "Hello World!");
        return "hello";
    }

5、在相应路径下定义拦截器返回的login.jsp页面

注意该页面尽量不要放在WEB-INF文件夹下，因为该文件下的页面是受保护的，不可以直接访问。

6、部署，在浏览器输入地址

输入：http://localhost:8080/springMVC/lookWorld?userName=Amy
控制台打印：
调用拦截器方法 preHandle ………………
preHandle return true:继续调用后面的Interceptor或者Controller
调用 controller 方法…………
调用拦截器方法 postHandle ………………
调用拦截器方法 afterCompletion ………………

输入http://localhost:8080/springMVC/lookWorld?userName=Tom
控制台打印：
调用拦截器方法 preHandle ………………
preHandle return false：后续的Interceptor 和 Controller 都不会再执行
preHandle return false：后续的postHandle 和 afterCompletion都不会执行

至此，Spring mvc拦截器完成。
项目代码下载地址：http://download.youkuaiyun.com/detail/u012385190/9523134