21.4.1 使用HandlerInterceptor拦截请求

    处理器映射处理过程配置的拦截器,必须实现 包下的 HandlerInterceptor接口。这个接口定义了三个方法: preHandle(..),它在处理器实际执行 之前 会被执行; postHandle(..),它在处理器执行 完毕 以后被执行; afterCompletion(..),它在 整个请求处理完成 之后被执行。这三个方法为各种类型的前处理和后处理需求提供了足够的灵活性。

    preHandle(..)方法返回一个boolean值。你可以通过这个方法来决定是否继续执行处理链中的部件。当方法返回 true时,处理器链会继续执行;若方法返回 falseDispatcherServlet即认为拦截器自身已经完成了对请求的处理(比如说,已经渲染了一个合适的视图),那么其余的拦截器以及执行链中的其他处理器就不会再被执行了。

    1. package samples;
    2. public class TimeBasedAccessInterceptor extends HandlerInterceptorAdapter {
    3. private int openingTime;
    4. public void setOpeningTime(int openingTime) {
    5. }
    6. public void setClosingTime(int closingTime) {
    7. this.closingTime = closingTime;
    8. }
    9. public boolean preHandle(HttpServletRequest request, HttpServletResponse response,
    10. Object handler) throws Exception {
    11. int hour = cal.get(HOUR_OF_DAY);
    12. if (openingTime <= hour && hour < closingTime) {
    13. return true;
    14. }
    15. return false;
    16. }
    17. }

    在上面的例子中,所有被此处理器处理的请求都会被TimeBasedAccessInterceptor拦截器拦截。如果当前时间在工作时间以外,那么用户就会被重定向到一个HTML文件提示用户,比如显示“你只有在工作时间才可以访问本网站”之类的信息。

    上面的例子中,所有控制器方法处理的请求都会被配置的拦截器先拦截到。如果你想进一步缩小拦截的URL范围,你可以通过MVC命名空间或MVC Java编程的方式来配置,或者,声明一个MappedInterceptor类型的bean实例来处理。具体请见 21.16.1 启用MVC Java编程配置或MVC命名空间配置一小节。

    需要注意的是,HandlerInterceptor的后拦截postHandle方法不一定总是适用于注解了ResponseEntity的方法。这些场景中,HttpMessageConverter会在拦截器的postHandle方法被调之前就把信息写回响应中。这样拦截器就无法再改变响应了,比如要增加一个响应头之类的。如果有这种需求,请让你的应用实现ResponseBodyAdvice接口,并将其定义为一个bean或直接在RequestMappingHandlerMapping中配置。