spring学习笔记之handler mapping源码解读

spring学习笔记之handler mapping源码解读

   用 handler mapping 可以映射请求到合适的 handler ，比如用 SimpleUrlHandlerMapping 或者 BeanNameUrlHandlerMapping 。首先我们来看 handler mapping 这个概念。

   最基本的 HandlerMapping 提供的功能是 HandlerExecutionchain 的传递，必须包括请求匹配的处理器，也可能包括一系列应用于这个请求的的拦截器。当请求发生时， DispatcherServlet 将请求递交给 hangler mapping, 让其检测请求并提出一个合适的 HandlerExecutionChain.DispatcherServlet 将执行该处理器和拦截器。

   Handler mappings 对拦截器的配置是可选的，包括前，后执行或者前后都执行，功能很强大。很多已经支持的功能可以在 HandlerMappings 配置中定制。选择一个处理器的 handler mapping 定制不仅基于请求的 URL ，而且基于请求相关的 session 的状态。

所有 handler mapping 类都要继承 AbstractHandlerMapping 。下面是共有的属性。

Interceptors: 拦截器

defaultHandler: 默认的处理器，当没有匹配的处理器时使用。

Order: 基于 order 属性的值。

   BeanNameUrlHandlerMapping 简单而强大，根据定义在 web 应用环境的 bean 的名字映射 http 请求。比如说我们要让一名用户增加一帐号，我们已经提供了合适的表单控制器， jsp 或者 velocity 视图渲染表单。

如果使用 BeanNameUrlHandlerMapping, 请求 http://samples.com/editaccoutn.form. 配置如下： <beans>

<bean id="handlerMapping" class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/> <bean name="/editaccount.form" class="org.springframework.web.servlet.mvc.SimpleFormController"> <property name="formView" value="account"/> <property name="successView" value="account-created"/> <property name="commandName" value="account"/> <property name="commandClass" value="samples.Account"/> </bean> <beans>

所有请求的 url ／ editaccount.form 都会被 SimpleFormController 处理。当然在 web.xml 也要作如下的配置。

<web-app> <servlet> <servlet-name>sample</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <!-- maps the sample dispatcher to *.form --> <servlet-mapping> <servlet-name>sample</servlet-name> <url-pattern>*.form</url-pattern> </servlet-mapping> </web-app>

需要注意的是，你想用 BeanNameUrlHandlerMapping 是，并不需要定义。如果没有定义处理类，则 DispatcherServlet 默认创建它。

SimpleUrlHandlerMapping 功能更强大。下面是例子

<web-app> <servlet> <servlet-name>sample</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <!-- maps the sample dispatcher to *.form --> <servlet-mapping> <servlet-name>sample</servlet-name> <url-pattern>*.form</url-pattern> </servlet-mapping> <!-- maps the sample dispatcher to *.html --> <servlet-mapping> <servlet-name>sample</servlet-name> <url-pattern>*.html</url-pattern> </servlet-mapping> </web-app>

上面例子表示以 .form 或者 .html 结尾的请求都会被下面的处理器处理。

<beans> <!-- no 'id' required, HandlerMapping beans are automatically detected by the DispatcherServlet --> <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"> <property name="mappings"> <value> /*/account.form=editAccountFormController /*/editaccount.form=editAccountFormController /ex/view*.html=helpController /**/help.html=helpController </value> </property> </bean>

<bean id="helpController" class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/> <bean id="editAccountFormController" class="org.springframework.web.servlet.mvc.SimpleFormController"> <property name="formView" value="account"/> <property name="successView" value="account-created"/> <property name="commandName" value="Account"/> <property name="commandClass" value="samples.Account"/> </bean> <beans>

上面配置的意思很容易看明白的。

我们也可以用 HandlerInterceptor 拦截请求。拦截器必须实现 HandlerInterceptor 接口。这个接口定义了三个方法。见代码：

boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception; void postHandle( HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception; void afterCompletion( HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception;

上面三个方面分别负责预处理，后置处理和请求完成后的处理。下面是例子：

<beans> <bean id="handlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"> <property name="interceptors"> <list> <ref bean="officeHoursInterceptor"/> </list> </property> <property name="mappings"> <value> /*.form=editAccountFormController /*.view=editAccountFormController </value> </property> </bean> <bean id="officeHoursInterceptor" class="samples.TimeBasedAccessInterceptor"> <property name="openingTime" value="9"/> <property name="closingTime" value="18"/> </bean> <beans>

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 < closingTime) { return true; } else { response.sendRedirect("http://host.com/outsideOfficeHours.html"); return false; } } }

我们看到，拦截器类是继承了 HandlerInterceptorAdapter ，而 HandlerInterceptorAdapter 基本实现了 HandlerInterceptor 接口，接下来就是我们根据需要改写上面的三个某些方法了，而不需要全部实现。