11.拦截器

拦截器的作用

Spring MVC 的处理器拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。用户可以自己定义一些拦截器来实现特定的功能。还要向大家提一个词——拦截器链（Interceptor Chain）。拦截器链就是将拦截器按一定的顺序联结成一条链。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。
它和过滤器是有几分相似，但是也有区别，接下来我们就来说说他们的区别：

• 过滤器是 servlet 规范中的一部分，任何 java web 工程都可以使用。
• 拦截器是 SpringMVC 框架自己的，只有使用了 SpringMVC 框架的工程才能用。
• 过滤器在 url-pattern 中配置了/*之后，可以对所有要访问的资源拦截。
• 拦截器它是只会拦截访问的控制器方法，如果访问的是 jsp，html,css,image 或者 js 是不会进行拦截的。
  它也是 AOP 思想的具体应用。我们要想自定义拦截器， 要求必须实现：HandlerInterceptor。

自定义拦截器的步骤

1.编写一个普通类实现 HandlerInterceptor 接口

public class HandlerInterceptorDemo1 implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle 拦截器拦截了");
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle 方法执行了");
    }

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

2.配置拦截器

<!-- 配置拦截器 -->
<mvc:interceptors>
	<mvc:interceptor>
		<mvc:mapping path="/**"/>
		<bean id="handlerInterceptorDemo1"
		class="com.suncaper.interceptor.HandlerInterceptorDemo1"></bean>
		</mvc:interceptor>
</mvc:interceptors>

拦截器的细节

拦截器的放行

放行的含义是指，如果有下一个拦截器就执行下一个，如果该拦截器处于拦截器链的最后一个，则执行控制器中的方法。

拦截器中方法的说明

public interface HandlerInterceptor {
    /**
     * 如何调用：
     * 按拦截器定义顺序调用
     * 何时调用：
     * 只要配置了都会调用
     * 有什么用：
     * 如果程序员决定该拦截器对请求进行拦截处理后还要调用其他的拦截器，或者是业务处理器去
     * 进行处理，则返回 true。
     * 如果程序员决定不需要再调用其他的组件去处理请求，则返回 false。
     */
    default boolean preHandle(HttpServletRequest request, HttpServletResponse
            response, Object handler)
            throws Exception {
        return true;
    }

    /**
     * 如何调用：
     * 按拦截器定义逆序调用
     * 何 时调用：
     * 在拦截器链内所有拦截器返成功调用
     * 有什么用：
     * 在业务处理器处理完请求后，但是 DispatcherServlet 向客户端返回响应前被调用，
     * 在该方法中对用户请求 request 进行处理。
     */
    default void postHandle(HttpServletRequest request, HttpServletResponse
            response, Object handler,
                            @Nullable ModelAndView modelAndView) throws Exception {
    }

    /**
     * 如何调用：
     * 按拦截器定义逆序调用
     * 何时调用：
     * 只有 preHandle 返回 true 才调用
     * 有什么用：
     * 在 DispatcherServlet 完全处理完请求后被调用，
     * 可以在该方法中进行一些资源清理的操作。
     */
    default void afterCompletion(HttpServletRequest request, HttpServletResponse
            response, Object handler,
                                 @Nullable Exception ex) throws Exception {
    }
}

拦截器的作用路径

<!-- 配置拦截器 -->
<!-- 配置拦截器的作用范围 -->
<mvc:interceptors>
	<mvc:interceptor>
		<mvc:mapping path="/**" /><!--  用于指定对拦截的 url -->
		<mvc:exclude-mapping path=""/><!--  用于指定排除的 url-->
		<bean id="handlerInterceptorDemo1"
			class="com.suncaper.web.interceptor.HandlerInterceptorDemo1"></bean>
	</mvc:interceptor>
</mvc:interceptors>