120.SpringMVC 的拦截器

Spring MVC 的处理器拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。用户可以自己定义一些拦截器来实现特定的功能。

搭建环境

我们可以删除之前的 Java 代码，并将配置文件中的异常处理的类删掉；

并且初始化 index.jsp 的内容为：

html

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>
        <title>Title</title>
    </head>
    <body>
      <h3>拦截器</h3>
      <a href="user/testInterceptor">拦截器</a>
    </body>
</html>

success.jsp

html

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>
        <title>Title</title>
    </head>
    <body>
        <h3>执行成功</h3>

        <% System.out.println("执行成功"); %>
    </body>
</html>

error.jsp

html

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<html>
    <head>
        <title>Title</title>
    </head>
    <body>
      <h3>错误页面</h3>
    </body>
</html>

‍

新建 Controller

java

package com.peterjxl.controller;


import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/testInterceptor")
    public String testInterceptor() {
        System.out.println("testInterceptor执行了...");
        return "success";
    }
}

编写拦截器

新建一个类，实现 HandlerInterceptor 接口；

java

package com.peterjxl.interceptor;
import org.springframework.web.servlet.HandlerInterceptor;
public class MyInterceptor implements HandlerInterceptor {}

‍ 我们实现后，可以看到 IDE 没有报错，也就是我们不用实现里面的方法，也没有报错；我们可以看到其源码中，是有方法定义的，但是已经实现了，这是 Java8 的一个增强：

java

package org.springframework.web.servlet;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.lang.Nullable;

public interface HandlerInterceptor {
    default boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        return true;
    }

    default void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable ModelAndView modelAndView) throws Exception {
    }

    default void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable Exception ex) throws Exception {
    }
}

‍ 该接口的 3 个方法的作用：

preHandle 是在控制器之前执行，返回值为 true 则表示放行，执行下一个拦截器，如果没有，则执行 controller。如果 return false，则不放行，并且我们可以用方法中的 req 和 resp 对象，跳转到某个错误页面上。例如可以判断是否登录。
postHandle 是在控制器之后执行，可用于记录一些日志之类的
afterCompletion 是在返回页面之后执行，可用于释放一些资源 ‍ 我们实现一下其方法：

java

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    System.out.println("MyInterceptor执行了...");
    return true;
}

配置拦截器

‍ 在 springmvc.xml 中配置：

html

<!-- 配置拦截器 -->
    <mvc:interceptors>
        <!-- 拦截器第一个拦截器 -->
        <mvc:interceptor>
            <!-- 拦截的路径 -->
            <mvc:mapping path="/user/*"/>
            <!-- 排除不拦截的路径 -->
            <bean class="com.peterjxl.interceptor.MyInterceptor"/>
        </mvc:interceptor>
    </mvc:interceptors>

这样配置之后，就会拦截/user 路径的所有请求，而其他路径的请求不拦截。我们可以在 <mvc:interceptors> 中配置多个拦截器，每个 <mvc:interceptor> 标签中定义一个拦截器

除了配置拦截的路径之外，还可以配置不拦截的路径，这样除了这些不拦截的路径，其他路径都拦截：

xml


<!-- 配置拦截器 -->
    <mvc:interceptors>
        <!-- 拦截器第一个拦截器 -->
        <mvc:interceptor>
            <!-- 拦截的路径 -->
            <mvc:exclude-mapping path="/user/*"/> <!-- 排除拦截的路径 -->
            <!-- 排除不拦截的路径 -->
            <bean class="com.peterjxl.interceptor.MyInterceptor"/>
        </mvc:interceptor>
    </mvc:interceptors>

‍

测试

测试之前，我们可以先自己思考一下方法执行的顺序：

首先是拦截器中的方法会被执行
然后拦截器放行，执行控制器中的方法
然后是 success 中的 sout 输出“执行成功” ‍ 运行结果：

‍

控制台输出：

html

MyInterceptor执行了...
testInterceptor执行了...
执行成功

‍

测试不放行

Java

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    System.out.println("MyInterceptor执行了...");
//        return true;

    request.getRequestDispatcher("/WEB-INF/pages/error.jsp").forward(request, response);
    return false; // 拦截器拦截请求，不再执行controller方法
}

‍ ‍

测试完后，我们改为放行，方便后续的测试。 ‍

后处理方法 `postHandle`

postHandle 方法是在控制器方法执行后，success.jsp 执行前，执行的方法。 ‍ 运行结果：

Java

MyInterceptor执行了...
testInterceptor执行了...
MyInterceptor执行了...postHandle
执行成功

其实在后处理方法中，跳转页面也是可以的：

Java

@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
    System.out.println("MyInterceptor执行了...postHandle");
    request.getRequestDispatcher("/WEB-INF/pages/error.jsp").forward(request, response);
}

‍

`afterCompletion` 方法

success.jsp 执行后，afterCompletion 方法会执行，我们实现一下：

Java

@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
    System.out.println("MyInterceptor执行了...afterCompletion");
}

运行结果：

Java

MyInterceptor执行了...
testInterceptor执行了...
MyInterceptor执行了...postHandle
执行成功
MyInterceptor执行了...afterCompletion

‍ 注意，此时页面已经响应完成，再设置跳转到其他页面是不会成功的。

源码

本项目已将源码上传到 GitHub 和 Gitee 上。并且创建了分支 demo11，读者可以通过切换分支来查看本文的示例代码。 ‍

120.SpringMVC 的拦截器 ​

相关术语 ​

搭建环境 ​

新建 Controller ​

编写拦截器 ​

配置拦截器 ​

测试 ​

测试不放行 ​

后处理方法 postHandle ​

afterCompletion 方法 ​

源码 ​

120.SpringMVC 的拦截器

相关术语

搭建环境

新建 Controller

编写拦截器

配置拦截器

测试

测试不放行

后处理方法 `postHandle`

`afterCompletion` 方法

源码