Spring MVC静态资源url映射处理

摘要: spring mvc, static url, 静态资源处理

今天发现网上有些坑爹的博客，估计博主自己也没要用过，就写了出来，害得我折腾半天。鉴于避免其他同学出现类似的情况，写出来，也请大家指正。

优雅REST风格的资源URL不希望带 .html 或 .do 等后缀.由于早期的Spring MVC不能很好地处理静态资源，所以在web.xml中配置DispatcherServlet的请求映射，往往使用 *.do 、 *.xhtml、*.hml等后缀方式进行区分。这就决定了请求URL必须是一个带后缀的URL，而无法采用真正的REST风格的URL。通俗说RESTf风格就是在Spring MVC 3.0新增的，它通过不带扩展名的URL来访问系统资源。

如果将DispatcherServlet请求映射配置为"/"，则Spring MVC将捕获Web容器所有的请求，包括静态资源的请求，Spring MVC会将它们当成一个普通请求处理，因此找不到对应处理器将导致错误。

如何让Spring框架能够捕获所有URL的请求，同时又将静态资源的请求转由Web容器处理，是可将DispatcherServlet的请求映射配置为"/"的前提。由于REST是Spring3.0最重要的功能之一，所以Spring团队很看重静态资源处理这项任务，给出了堪称经典的两种解决方案。

先调整web.xml中的DispatcherServlet的配置，使其可以捕获所有的请求：

<servlet>
<servlet-name>springMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springMVC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>

按照上面url-pattern的配置，所有URL请求都将被Spring MVC的DispatcherServlet截获。

方案1：采用<mvc:default-servlet-handler />

注意，需要是spring3.0.5以上版本

在springMVC-servlet.xml中配置<mvc:default-servlet-handler />后，会在Spring MVC上下文中定义一个org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，它会像安检人员，对进入DispatcherServlet的URL进行过滤，如果发现是静态资源的URL请求，就将该请求转由Web应用服务器默认的Servlet处理，如果不是静态资源的请求，才由DispatcherServlet继续处理。

一般Web应用服务器默认的Servlet名称是"default"，因此DefaultServletHttpRequestHandler可以找到它。如果你所有的Web应用服务器的默认Servlet名称不是"default"，则需要通过default-servlet-name属性显示指定：<mvc:default-servlet-handler default-servlet-name="所使用的Web服务器默认使用的Servlet名称" />

我看网上其他博客大都是这样写的，我自己试了好久还是不行。

原因：缺少 <mvc:annotation-driven />

ps：我就找了半天原因，～～～～～心好累～～～～

结论：

配置文件如果没有<mvc:annotation-driven/>，那么所有的Controller可能就没有解析，所有当有请求时候都没有匹配的处理请求类，就都去<mvc:default-servlet-handler/>即default servlet处理了。添加上<mvc:annotation-driven/>后，相应的url请求被Controller处理，而静态资源因为没有相应的Controller就会被default servlet处理;即没有相应的Controller就会被default servlet处理。

<mvc:annotation-driven/>相当于注册了DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter两个bean，配置一些messageconverter。即解决了@Controller注解的使用前提配置。

方案二：采用<mvc:resources />

在springMVC-servlet中添加如下配置： <mvc:resources mapping="/static/**" location="/static/" />

首先，<mvc:resources />允许静态资源放在任何地方，完全打破了传统Web容器的静态资源只能放在Web容器的根路径。这个由Spring MVC框架自己处理静态资源，并添加一些有用的附加值功能。