SpringMVC（8） - 处理器映射

参考：https://docs.spring.io/spring/docs/4.3.20.RELEASE/spring-framework-reference/htmlsingle/#mvc-handlermapping

在以前的Spring版本中，用户需要在Web应用程序上下文中定义一个或多个HandlerMapping bean，以将传入的Web请求映射到适当的处理器。通过引入带注解的控制器，就不需要像之前那样定义了，因为RequestMappingHandlerMapping会自动在所有@Controller bean上查找@RequestMapping注解。但是，请记住，从AbstractHandlerMapping扩展的所有HandlerMapping类都具有以下可用于自定义其行为的属性：

• 拦截器：使用的拦截器列表
• defaultHandler：当此处理器映射未找到匹配的处理器时使用的默认处理器。
• order：基于order属性的值（参考org.springframework.core.Ordered接口），Spring对上下文中可用的所有处理程序映射进行排序，并应用第一个匹配的处理器。
• alwaysUseFullPath：如果为true，则Spring使用当前Servlet上下文中的完整路径来查找适当的处理器序。如果为false（默认值），则使用当前Servlet映射中的路径。例如，如果使用 /testing/* 映射Servlet并且将alwaysUseFullPath属性设置为true，则使用 /testing/viewPage.html，而如果该属性设置为false，则使用/viewPage.html。
• urlDecode：从Spring 2.5开始，默认为true。如果希望比较编码路径，将此标志设置为false。但是，HttpServletRequest始终以解码形式暴露Servlet路径。请注意，Servlet路径与编码路径相比是不匹配的。

以下示例显示如何配置拦截器：

<beans>
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
        <property name="interceptors">
            <bean class="example.MyInterceptor"/>
        </property>
    </bean>
<beans>
           

1. 使用HandlerInterceptor拦截请求

Spring的处理器映射机制包括处理器拦截器，当想要将特定功能应用于某些请求（例如，检查认证信息）时，它们很有用。

位于处理器映射中的拦截器必须从org.springframework.web.servlet.HandlerInterceptor。该接口定义了三种方法，这三种方法应该提供足够的灵活性来进行各种预处理和后处理，方法如下：

• 在执行实际处理程序之前调用preHandle(..)
• 执行处理程序后调用postHandle(..)
• 完成请求完成后调用afterCompletion(..)

preHandle(..)方法返回一个布尔值。可以使用此方法来中断或继续执行链的处理。当此方法返回true时，处理程序执行链将继续;当它返回false时，DispatcherServlet假定拦截器本身已处理请求（例如，呈现了适当的视图），并且不继续执行执行链中的其他拦截器和实际处理器。

可以使用interceptors属性配置拦截器，该属性存在于从AbstractHandlerMapping扩展的所有HandlerMapping类中。示例：

<beans>
    <bean id="handlerMapping" class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping">
        <property name="interceptors">
            <list>
                <ref bean="officeHoursInterceptor"/>
            </list>
        </property>
    </bean>

    <bean id="officeHoursInterceptor" class="samples.TimeBasedAccessInterceptor">
        <property name="openingTime" value="9"/>
        <property name="closingTime" value="18"/>
    </bean>
</beans>
           

TimeBasedAccessInterceptor拦截此映射处理的任何请求。如果当前时间不在办公时间，则会将用户重定向到静态HTML文件，例如，只能在办公时间访问该网站。 

package samples;

public class TimeBasedAccessInterceptor extends HandlerInterceptorAdapter {

    private int openingTime;
    private int closingTime;

    public void setOpeningTime(int openingTime) {
        this.openingTime = openingTime;
    }

    public void setClosingTime(int closingTime) {
        this.closingTime = closingTime;
    }

    public boolean preHandle(HttpServletRequest request, HttpServletResponse response,
            Object handler) throws Exception {
        Calendar cal = Calendar.getInstance();
        int hour = cal.get(HOUR_OF_DAY);
        if (openingTime <= hour && hour < closingTime) {
            return true;
        }
        response.sendRedirect("http://host.com/outsideOfficeHours.html");
        return false;
    }
}
           

注：使用RequestMappingHandlerMapping时，实际的处理器是HandlerMethod的一个实例，它标识将被调用的特定控制器方法。

如上例，Spring适配器类HandlerInterceptorAdapter使扩展HandlerInterceptor接口变得更容易。

提示：在上面的示例中，配置的拦截器将应用于使用带注解的控制器方法处理的所有请求。如果要缩小拦截器应用的URL路径，可以使用MVC命名空间或MVC Java配置，或者声明类型为MappedInterceptor的bean实例来执行此操作。

请注意，HandlerInterceptor的postHandle方法并不总是非常适合与@ResponseBody和ResponseEntity方法一起使用。在这种情况下，HttpMessageConverter在调用postHandle之前写入并提交响应，这使得无法更改响应，例如添加响应头。相反，应用程序可以实现ResponseBodyAdvice并将其声明为@ControllerAdvice bean或直接在RequestMappingHandlerAdapter上配置它。