当DispatcherServlet接收到web请求时,它只会将请求分发给适当的处理程序来处理请求。为DispatcherServlet定义一种策略,用来将请求映射到处理中。
在Spring MVC应用程序中,web请求被web应用程序上下文中声明的一个或多个处理程序映射Bean映射到处理程序上。这些Bean必须实现HandlerMapping接口,这样DispatcherServlet才能自动侦测它们。Spring MVC提供了几个HandlerMapping实现,让你可以利用不同的策略来映射请求。默认情况下,如果你没有显式地配置程序映射,DispatcherServlet将利用BeanNameUrlHandlerMapping作为它的默认处理程序映射,它根据Bean名称中指定URL模式将请求映射到处理程序上。因此,如果你觉得这一策略还好用,就不需要定义自己的处理程序映射了。
处理程序映射根据它们与上下文路径和Servlet路径的相对路径来匹配URL。因此,对于http://localhost:8080/court/welcome.htm这个URL而言,与之匹配的路径应该是/weblcome.htm,因为上下文路径是/court,没有Servlet路径。
1. 按Bean名称映射请求
要将请求映射到处理程序,最简单的策略是按照处理程序的Bean名称进行映射,这也是默认的策略。为了让这个策略生效,必须将每个处理程序的Bean名称声明成URL模式的形式,它可以接受通配符,供处理程序处理多个URL。如果处理程序的Bean名称与请求的URL相匹配,DispatcherServlet就会将请求分布给这个处理程序,让它处理请求。
xml文件
<beans...>
...
<bean name="/welcome.htm" class="com.apress.springrecipes.court
.web.WelcomeController">
...
</bean>
<bean name="/reservationQuery.htm" class="com.apress.springrecipes.court
.web.ReservationQueryController">
...
</bean>
</beans>
在使用这个映射策略时,必须通过name属性设置处理程序的名称,因为id属性无法包含”/”符号。
2. 按控制器类名称映射请求
Spring提供的另一个处理程序映射是ControllerClassNameHandlerMapping,它为实现Controller接口的处理程序生成处理程序映射。它根据web应用程序上下文中声明的控制器的类名称,自动生成映射。
xml文件
<beans...>
...
<bean class="org.springframework.web.servlet.mvc.support.
ControllerClassNameHandlerMapping"/>
<bean class="com.apress.springrecipes.court.web.WelcomeController">
...
</bean>
<bean class="com.apress.springrecipes.court.web.ReservationQueryController">
...
</bean>
</beans>
对于这些Bean配置,ControllerClassNameHandlerMapping会移除类名称中的Controller后缀,并将其他部分转换成小写字母,以此来自动生成处理程序映射。
Java代码
WelcomeController --> /welcome*
ReservationQueryController --> /reservationquery*
然而,如果想让你的URL模式遵循java的变量命名约定(如生成/reservationQuery而不是/reservationquery),必须将caseSensitive属性设置为true。此外,可以在pathPrefix属性中为生成的URL模式指定一个前缀。你还可以在basePackage属性中指定基包,然后在映射中就会包含相对于基包的子包。
Xml代码
<bean class="org.springframework.web.servlet.mvc.support.
ControllerClassNameHandlerMapping">
<property name="caseSensitive" value="true"/>
<property name="pathPrefix" value="/reservation"/>
<property name="basePackage" value="com.apress.springrecipes.court"/>
</bean>
这个ControllerClassNameHandlerMapping定义会生成下面的处理程序映射。
Java代码
WelcomeController --> /reservation/web/welcome*
ReservationQueryController --> /reservation/web/reservationQuery*
3. 用定制的映射定义来映射请求
将请求映射到处理程序的最直接且最灵活的策略,是显式地指定URL模式和处理程序之间的映射定义。你可以通过
SimpleUrlHandlerMapping来做到这一点。
xml文件
<beans...>
...
<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<propery name="mappings">
<props>
<prop key="/welcom.htm">welcomeController</prop>
<prop key="/reservationQuery.htm">reservationQueryController</prop>
</props>
</property>
</bean>
<bean id="welcomeController" class="com.apress.springrecipes.court.web
.WelcomeController">
...
</bean>
<bean id="reservationQueryController"
class="com.apress.springrecipes.court.web.ReservationQuerController">
...
</bean>
</beans>
SimplerUrlHandlerMapping接受Properties对象形式的映射定义。属性键是URL模式,而属性值则是处理器ID或名称。URL模式也可以接受通配符,让处理程序能够处理多个URL。
4. 按多种策略映射请求
在带有大量处理程序的web应用程序中,只选择一种处理程序映射策略经常是不够用的。一般情况下,ControllerClassNameHandlerMapping可以满足大多数的映射。然而,有些映射必须利用SimpleUrlHandlerMapping显式地进行映射。在这种情况下,要结合这两种策略来处理映射。
xml文件
<beans...>
...
<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<prop key="/index.htm">welcomeController</prop>
<prop key="/main.htm">welcomeController</prop>
</props>
</property>
<property name="order" value="0"/>
</bean>
<bean class="org.springframework.web.servlet.mvc.support.
ControllerClassNameHandlerMapping">
<property name="caseSensitive" value="true"/>
<property name="order" vlaue="1"/>
</bean>
</beans>
当同时选择不止一种策略时,重要的是指定映射优先级。为此,可以设置处理程序映射Bean的order属性。order值越小,表示优先级越高。对于这两种处理程序映射,web请求映射是下面这样的。
Java代码
/index.html --> WelcomeController
/amin.html --> WelcomeController
/welcome* --> WelcomController
/reservationQuery* --> ReservationQueryController