REST风格的Spring MVC项目静态资源访问配置

      由于早期的Spring MVC不能很好地处理静态资源，所以在web.xml中配置DispatcherServlet的请求映射，往往使用 .htm 、.do、.action 等方式，以避免拦截controller请求时又拦截了静态资源，这就决定了请求URL必须是一个带后缀的URL。而REST风格的资源URL不希望带 .htm 、.do、.action 等后缀，因而传统的web.xml配置无法采用真正的REST风格的URL。

      如果将DispatcherServlet请求映射配置为 '/' 时（REST风格），官方文档对<url-pattern>/</url-pattern>的解释见下图：

      将DispatcherServlet请求映射配置为 '/' 后，则Spring MVC将捕获Web容器所有不带后缀的请求和CSS/JS/image等静态资源的请求，Spring MVC会将它们当成一个普通请求处理，因此找不到对应处理器将导致错误。"

      如何让Spring MVC既能捕获所有url的请求，又能将静态资源的请求转由web容器处理，是可将DispatcherServlet的请求映射配置为"/"的前提。由于REST是Spring3.0最重要的功能之一，所以Spring团队很看重静态资源处理这项任务，给出了几种解决方案。

 

方式1：使用spring提供的mvc:resources（适用于spring3.0.4以后版本） 

web.xml：

<servlet-mapping>
    <servlet-name>spring</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

<servlet>
    <servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring/spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
    <async-supported>true</async-supported>
</servlet>

spring-mvc.xml：

<mvc:annotation-driven />
<mvc:resources location="/static/js/" mapping="/js/**"/>
<mvc:resources location="/static/img/" mapping="/img/**"/>
<mvc:resources location="/static/css/" mapping="/css/**"/>
... ...

方式2：使用defaultServlet处理静态文件

web.xml：

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

方式3：<mvc:default-servlet-handler />

web.xml：

<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>

spring-mvc.xml：

<mvc:default-servlet-handler />

      在springMVC-servlet.xml中配置<mvc:default-servlet-handler />后，会在Spring MVC上下文中定义一个org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，它类似一个检查员，对进入DispatcherServlet的URL进行筛查，如果发现是静态资源的请求，就将该请求转由Web应用服务器默认的Servlet处理，如果不是静态资源的请求，才由DispatcherServlet继续处理。且<mvc:default-servlet-handler />一定要写在<servlet-mapping>后面，否则controller请求都会被当成静态资源导致报404错误。

注意：
1）<url-pattern>/</url-pattern>不要写成<url-pattern>/*</url-pattern>，/*会拦截所有的请求
2）配置为<url-pattern>/XX/*</url-pattern>时，视图名 和 静态资源存放的路径 最好不要有一致的部分，如：
     视图映射：/XX/*
     静态路径：webapp/XX/NewFile.html