12、SpringMVC之拦截器

12.1、环境搭建

创建名为spring_mvc_interceptor的新module,过程参考9.1节和9.5节

12.1.1、页面请求示例

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

12.1.2、控制器方法示例

    @RequestMapping("/test/hello")
    public String testHello(){
        return "success";
    }

12.2、拦截器的入门示例

12.2.1、创建拦截器

package online.liaojy.interceptor;

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * @author liaojy
 * @date 2023/11/7 - 20:57
 */
// SpringMVC 中的拦截器要实现 HandlerInterceptor 接口
public class AAAInterceptor implements HandlerInterceptor {

    // preHandle()方法在控制器方法执行之前执行
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("AAAInterceptor-->preHandle()");

        // 返回true表示不拦截,即执行控制器方法
        // 返回false表示拦截,即不再执行控制器方法
        return true;
    }

    // postHandle()方法在控制器方法执行之后执行
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("AAAInterceptor-->postHandle()");
    }

    // afterCompletion()方法在渲染完视图之后执行
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("AAAInterceptor-->afterCompletion()");
    }

}

12.2.2、配置拦截器

与自定义的过滤器一样,自定义的拦截器也要配置后才能生效;

过滤器是服务器中的组件,所以配置到 web.xml 中;

拦截器是 springmvc 中的组件,因此要配置到 springmvc 的配置文件中。

    <mvc:interceptors>
        <bean class="online.liaojy.interceptor.AAAInterceptor"></bean>
    </mvc:interceptors>

12.2.3、测试效果

因为在配置拦截器时,没有指定要拦截的路径,所以访问任何DispatcherServlet处理的资源时,拦截器都会执行。

12.3、拦截器的注解配置

除了使用 bean 标签通过全限定类名来配置拦截器,还可以通过 ref 标签引用已存在的 bean 组件来配置拦截器

12.3.1、将拦截器标识为bean组件

因为拦截器不属于持久层、业务层和控制层,所以应该用 @Component 注解将其标识为一个 bean 组件

@Component

12.3.2、通过ref标签引用配置拦截器

    <mvc:interceptors>
        <ref bean="AAAInterceptor"></ref>
    </mvc:interceptors>

12.4、拦截器的进阶示例

通过上述的方式来配置拦截器,会对 DispatcherServlet 所处理的所有请求都进行拦截;

在实际情况中,可能只需要拦截部分请求,或排除部分请求的拦截。

12.4.1、精确的拦截配置

    <mvc:interceptors>
        <mvc:interceptor>
            <!--通过mvc:mapping设置要拦截的请求,可以设置多个;用通配符时,/*表示只拦截一级路径的,/**才表示拦截任意的-->
            <mvc:mapping path="/**"/>
            <!--通过mvc:exclude-mapping设置要排除拦截的请求,可以设置多个 -->
            <mvc:exclude-mapping path="/abc"/>
            <!--设置实行精确拦截规则的拦截器-->
            <bean class="online.liaojy.interceptor.AAAInterceptor"></bean>
        </mvc:interceptor>
    </mvc:interceptors>

12.4.2、测试效果

如上图所示,拦截了一级路径的请求

如上图所示,拦截了二级路径的请求

如上图所示,没有拦截/abc的请求

注意:为实现演示效果,本例已在springmvc配置文件中设置了关于/abc请求的视图控制器

<mvc:view-controller path="/abc" view-name="success"></mvc:view-controller>

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

12.5.1、创建另一个拦截器

package online.liaojy.interceptor;

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * @author liaojy
 * @date 2023/11/9 - 7:27
 */
public class BBBInterceptor implements HandlerInterceptor {
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("BBBInterceptor-->preHandle()");
        return true;
    }

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

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

12.5.2、配置多个拦截器

    <mvc:interceptors>
        <bean class="online.liaojy.interceptor.AAAInterceptor"></bean>
        <bean class="online.liaojy.interceptor.BBBInterceptor"></bean>
    </mvc:interceptors>

12.5.3、情况一

  • 如果每个拦截器的preHandle()都返回true

  • 此时多个拦截器的执行顺序和拦截器在SpringMVC的配置文件的配置顺序有关

  • preHandle()会按照配置的顺序执行,而postHandle()和afterCompletion()会按照配置的反序执行

注意:此时 AAAInterceptor 和 BBBInterceptor 拦截器的 preHandle() 方法返回值都是 true

12.5.4、情况二

  • 如果某个拦截器的preHandle()返回了false

  • 返回false的拦截器和它之前的拦截器的preHandle()都会执行

  • 所有postHandle()都不执行

  • 返回false的拦截器之前的拦截器的afterCompletion()会执行

注意:此时 AAAInterceptor 拦截器的 preHandle() 方法返回值为true,而 BBBInterceptor 拦截器的为 false

12.5.5、执行顺序流程图

12.6、相关拓展

12.6.1、拦截器与过滤器的区别

  • 过滤器是 Tomcat 服务器中的对象,拦截器是 SpringMVC 框架中的对象;

  • 过滤器实现的是 Java 中的 Filter 接口,拦截器实现的是 SpringMVC 中的 HandleInterceptor 接口;

  • 过滤器配置在 web.xml 中,拦截器配置在 SpringMVC 配置文件中;

  • 过滤器在拦截器之前执行;

  • 过滤器是一个执行时间点;拦截器是三个执行时间点;

  • 过滤器除了对动态资源进行过滤之外,还可以对静态资源(HTML、CSS、JS、图片等)进行过滤;

  • 拦截器侧重对控制器方法进行拦截处理,如果一个请求不能被DispatcherServlet接收,那这个请求也不会被拦截器处理。

12.6.2、拦截器的应用场景

  • 权限校验:用户在访问某资源时,可以使用拦截器对用户请求进行拦截,
    判断当前用户有没有登录,如果没有登录则强制回到登录页面进行登录。

  • 性能监控:如果想统计用户访问某个控制器方法的时间,可以使用拦截器对控制器方法进行前置拦截和后置拦截,
    在前置拦截器里面记录用户访问资源的起始时间,在后置拦截器里面记录用户访问资源的结束时间,
    两个时间之差就是当前用户访问控制器方法是总时长。

  • 日志记录:记录请求资源的日志信息,比如请求方式、请求参数、请求响应等,都可以通过拦截器来实现信息记录。

热门相关:龙骑战机   试婚老公,用点力!   都市剑说   星界游民   余生皆是喜欢你