Spring MVC中静态资源的处理

REST风格的资源URL中不带后后缀，比如

/blog/tom -> 用户tom的blog资源
/order/1234 -> 订单号为1234的订单资源

在早期的Spring MVC并不能很好的处理静态资源，所以在web.xml中配置DispatcherServlet的请求映射时，往往采用.do、.xhtml等方式。

由于REST是Spring的重要功能之一，所以Spring团队很看重静态资源处理的这项任务，给出堪称经典的两种解决方案。

<servlet><servlet-name>Spring</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><!-- <param-value>/WEB-INF/classes/spring/applicationContext.xml</param-value> --><param-value>classpath:applicationContext*.xml</param-value></init-param><load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping><servlet-name>Spring</servlet-name><!-- 此处拦截所有请求 --><url-pattern>/</url-pattern>
</servlet-mapping>

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

<mvc:default-servlet-handler/>
<mvc:default-servlet-handler default-servlet-name="Login"/>

在Spring MVC的xml配置文件中配置了\ 后，会在Spring MVC的上下文中定义一个org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler，通过这个类，将静态资源的请求转发给Web应用服务器默认的Servlet处理1。
同时用default-servlet-name自己指定Servlet的名称。

方式二：<mvc:resources/>

<mvc:resources/>允许资源放置在任何位置上，如WEB-INF、类路径下，甚至可以放置在JAR包中。

<!-- location 资源的实际位置，多个位置用逗号`,`隔开 -->
<!-- mapping 资源的映射路径，即客户端请求的路径 -->
<mvc:resources location="/images/" mapping="/resource/images/**" cache-period="10"/>

上面的配置的效果：通过/resource/images/才能访问位于/images/下的资源文件，同时通知浏览器客户端，此文件夹下的资源的缓存时间10s

注意：不要将不想暴露的资源给暴露了

<mvc:resources location="/WEB-INF/" mapping="/resource/**"/>

<mvc:resources/>扩展：缓存后，静态资源版本的控制

<mvc:resources/>的cache-period属性是告知客户端缓存该资源，从而此时间内不再请求，直接使用缓存。
如果cache-period设置的时间31557600，即1年，那么在此期间服务器静态资源（比如js、css）版本升级，这时候会因为缓存机制，不会重新请求这些资源。一个好的解决办法是在静态资源的路径上加上版本号，那么在版本升级后，更改版本号，那么对客户端来讲，资源路径已发送改变，那么就会重新请求。

1、增加某个配置文件
2、想办法将此属性放到ServletContext中，使spring配置文件和jsp界面都能获取到其属性值。比如

public class ResourcePathExposer implements ServletContextAware
{//getter、setter省略private ServletContext servletContext;//getter、setter省略private String resourceVersion = "1.2.1";// 从配置文件中获取此属性值public void init(){getServletContext().setAttribute("resourceVersion", version);}
}

<bean id="rpe" class="com.xych.ResourcePathExposer" init-method="init">
<mvc:resources location="/WEB-INF/" mapping="/resource/#{rpe.resourceVersion}/**"/>

在资源请求的时候

<html>
<head><!-- 其他标签省略 --><script src="/resource/${rpe.resourceVersion}/js/test.js" type="text/javascript"/>
</head>
</html>

参考：
[1] 陈雄华，林开雄，文建国．精通Spring4.x 企业应用开发实战[M]．北京：电子工业出版社，2017.1：639-643．

比如Tomcat、Jetty、JBoss中默认Servlet名称是default ↩