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
↩