【SpringMVC 从 0 开始】拦截器介绍

时间：2021-08-22 14:28:04 阅读：37 评论：0 收藏：0 [点我收藏+]

springMVC 中的拦截器用于拦截控制器方法的执行。

先创建出前置需要的一些条件：

<a th:href="@{/testInterceptor}">测试拦截器</a>

后端：

@Controller
public class TestController {

    @RequestMapping("/testInterceptor")
    public String testInterceptor() {
        return "success";
    }
}

一、创建拦截器

新建一个包 interceptors，在下面创建一个拦截器 FirstInterceptor ，并且要实现 HandlerInterceptor 接口。

技术分享图片

快捷键Ctrl + O，快速重写方法，图示里的 3 个。

public class FirstInterceptor implements HandlerInterceptor {
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("FirstInterceptor --> preHandle");
        return false;
    }

    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("FirstInterceptor --> postHandle");
    }

    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("FirstInterceptor --> afterCompletion");
    }
}

preHandle: 在当前控制器方法执行之前执行。
postHandle: 在当前控制器方法执行之后执行。
afterCompletion：处理完视图和模型数据，渲染视图完毕之后执行。

二、配置拦截器

在 springMVC 配置文件里配置拦截器，对象就是FirstInterceptor 类:

  <!-- 配置拦截器 -->
  <mvc:interceptors>
      <bean class="com.pingguo.mvc.interceptors.FirstInterceptor"></bean>
  </mvc:interceptors>

重新部署，访问http://localhost:8080/springmvc/，发现页面空白，查看控制器日志看到有打印：

技术分享图片

说明拦截成功。

看下上面重新的三个方法中，只有preHandle有返回值，是个布尔类型：false 表示拦截，true 表示放行。

修改上面preHandle的返回为 true，重新部署后再次访问首页，可以访问成功。

技术分享图片

查看控制台打印输出，看到在渲染之前，前面2个方法执行了：preHandle、postHandle 。

技术分享图片

在非常多的 Thymeleaf 渲染之后，最后一个 afterCompletion 也执行了。

技术分享图片

现在继续点击首页里的新加的超链接，发现也会被拦截放行。

技术分享图片

说明这种配置方式，会拦截所有的请求。

设置不需要拦截的请求

可以通过 ref 或 bean 标签设置拦截器:

通过mvc:mapping设置需要拦截的请求
通过mvc:exclude-mapping设置需要排除的请求

    <bean name="firstInterceptor" class="com.pingguo.mvc.interceptors.FirstInterceptor"></bean>
    <!-- 配置拦截器 -->
    <mvc:interceptors>
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <mvc:exclude-mapping path="/"></mvc:exclude-mapping>
            <ref bean="firstInterceptor"></ref>
        </mvc:interceptor>
    </mvc:interceptors>

注意这里我在外部注册了一个 bean 叫 firstInterceptor，以便 ref 引用。

<mvc:mapping path="/**"/>，表示拦截所有请求。
<mvc:exclude-mapping path="/">，表示除了首页不拦截。

也就是说，现在我访问http://localhost:8080/springmvc/的时候，应该不拦截。访问http://localhost:8080/springmvc/testInterceptor就会拦截了。

试一下，先访问 http://localhost:8080/springmvc/：

可以正常打开首页，并且控制台也没有输出拦截器里的内容：

技术分享图片

现在继续访问 http://localhost:8080/springmvc/testInterceptor，

技术分享图片

拦截了。

三、多个拦截器的执行顺序

继续新建一个拦截器SecondInterceptor，注意这次我加了 @Component，方便在配置文件中直接ref引用使用。

@Component
public class SecondInterceptor implements HandlerInterceptor {

    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("SecondInterceptor --> preHandle");
        return true;
    }

    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("SecondInterceptor --> postHandle");
    }

    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("SecondInterceptor --> afterCompletion");
    }
}

修改拦截器配置：

    <!-- 配置拦截器 -->
    <mvc:interceptors>
        <ref bean="firstInterceptor"></ref>
        <ref bean="secondInterceptor"></ref>
    </mvc:interceptors>

重新部署，访问下首页http://localhost:8080/springmvc/，查看控制台打印输出。

技术分享图片