Spring MVC 处理静态资源文件

摘要: 三个方案：

1.方案一：激活Tomcat的defaultServlet来处理静态文件

2.方案二： 在spring3.0.4以后版本提供了mvc:resources (需要配置annotation-driven)

3.方案三 ，使用<mvc:default-servlet-handler/>(需要配置annotation-driven)

一、问题：Spring MVC 处理静态资源文件 

以下情况需要先了解 

1.1  如果你的DispatcherServlet拦截 *.do这样的URL，就不存在访问不到静态资源的问题。如果你DispatcherServlet拦截“/”，拦截了所有的请求，同时对*.js,*.jpg的访问也就被拦截了。目的：可以正常访问静态文件，不要找不到静态文件报404

1.2  如果出现下面的错误，可能是没有配置<mvc:annotation-driven />的原因。 
      WARNING: No mapping found for HTTP request with URI [/xxx/xxx/xxx/] in DispatcherServlet with name 'springMVC'

 

方案一：激活Tomcat的defaultServlet来处理静态文件

<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>*.png</url-pattern>
    <url-pattern>*.js</url-pattern>
    <url-pattern>*.jpg</url-pattern>
    <url-pattern>*.css</url-pattern>
</servlet-mapping>

要写在DispatcherServlet的前面， 让 defaultServlet先拦截，这个就不会进入Spring了  

Tomcat, Jetty, JBoss, and GlassFish  默认 Servlet的名字 -- " default" 
Google App Engine 默认 Servlet的名字 -- " _ah_default" 
Resin 默认 Servlet的名字 -- "resin-file" 
WebLogic 默认 Servlet的名字  -- " FileServlet" 
WebSphere  默认 Servlet的名字 -- " SimpleFileServlet" 

方案二： 在spring3.0.4以后版本提供了mvc:resources (需要配置annotation-driven)

<!-- Spring MVC设置不拦截静态资源 -->
<mvc:annotation-driven/>  
<mvc:resources mapping="/images/**" location="/images/" />

 如果没有<mvc:annotation-driven/> 这句话，本来可以正常请求的URL,会报404的。

使用<mvc:resources/>元素,把mapping的URI注册到SimpleUrlHandlerMapping的urlMap中,key为mapping的URI pattern值，value为ResourceHttpRequestHandler,这样就巧妙的把对静态资源的访问由HandlerMapping转到ResourceHttpRequestHandler处理并返回,所以就支持classpath目录,jar包内静态资源的访问.

另外需要注意的一点是,不要对SimpleUrlHandlerMapping设置defaultHandler.因为static uri的defaultHandler就是ResourceHttpRequestHandler,否则无法处理static resources request.

方案三 ，使用<mvc:default-servlet-handler/>(需要配置annotation-driven)

<mvc:default-servlet-handler/>

完整的使用方法参见：http://jtuts.com/2014/09/05/serving-static-resources-spring/

会把"/**" url注册到SimpleUrlHandlerMapping的urlMap中，把对静态资源的访问由HandlerMapping转到org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler处理并返回.DefaultServletHttpRequestHandler使用就是各个Servlet容器自己的默认Servlet. 

  
补充说明：

多个HandlerMapping的执行顺序问题： 
DefaultAnnotationHandlerMapping的order属性值是：0 
<mvc:resources/ >自动注册的 SimpleUrlHandlerMapping的order属性值是： 2147483646 
<mvc:default-servlet-handler/>自动注册 的SimpleUrlHandlerMapping 的order属性值是： 2147483647 

Spring会先执行order值比较小的。

当访问一个a.jpg图片文件时，先通过 DefaultAnnotationHandlerMapping 来找处理器，一定是找不到的，我们没有叫a.jpg的Action。

再按order值升序找，由于最后一个 SimpleUrlHandlerMapping 是匹 "/**"的，所以一定会匹配上，再响应图片。