1.激活Tomcat的DefaultServlet来处理静态文件
一定要说明: 我测试如果在项目的web.xml配置是无法启动作用的,需要在全局的tomcat->conf->web.xml中激活处理静态文件的方式
<!-- 方式一:激活Tomcat的defaultServlet来处理静态文件 开始 -->
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.ico</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>/static/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>/resources/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>/upload/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.png</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.gif</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>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.css</url-pattern>
</servlet-mapping>
<!-- 结束,一定要配置 / 的前面 -->
<!-- 原来的路径 -->
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
2.使用<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 default-servlet-name="default"/>
default-servlet-name在不同容器中的名字
- Tomcat, Jetty, JBoss, and GlassFish 自带的默认Servlet的名字 -- "default"
- Google App Engine 自带的 默认Servlet的名字 -- "_ah_default"
- Resin 自带的 默认Servlet的名字 -- "resin-file"
- WebLogic 自带的 默认Servlet的名字 -- "FileServlet"
- WebSphere 自带的 默认Servlet的名字 -- "SimpleFileServlet"
3.在spring3.0.4以后版本提供了<mvc:resources>
<mvc:default-servlet-handler />将静态资源的处理经由Spring MVC框架交回Web应用服务器处理。而<mvc:resources />更进一步,由Spring MVC框架自己处理静态资源,并添加一些有用的附加值功能。
->需要仔细读一下
首先,<mvc:resources />允许静态资源放在任何地方,如WEB-INF目录下、类路径下等,你甚至可以将JavaScript等静态文件打到JAR包中。通过location属性指定静态资源的位置,由于location属性是Resources类型,因此可以使用诸如"classpath:"等的资源前缀指定资源位置。传统Web容器的静态资源只能放在Web容器的根路径下,<mvc:resources />完全打破了这个限制。
其次,<mvc:resources />依据当前著名的Page Speed、YSlow等浏览器优化原则对静态资源提供优化。你可以通过cacheSeconds属性指定静态资源在浏览器端的缓存时间,一般可将该时间设置为一年,以充分利用浏览器端的缓存。在输出静态资源时,会根据配置设置好响应报文头的Expires 和 Cache-Control值。
在接收到静态资源的获取请求时,会检查请求头的Last-Modified值,如果静态资源没有发生变化,则直接返回303相应状态码,提示客户端使用浏览器缓存的数据,而非将静态资源的内容输出到客户端,以充分节省带宽,提高程序性能。
示例代码
<mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>
以上配置将Web根路径"/"及类路径下 /META-INF/publicResources/ 的目录映射为/resources路径。假设Web根路径下拥有images、js这两个资源目录,在images下面有bg.gif图片,在js下面有test.js文件,则可以通过 /resources/images/bg.gif 和 /resources/js/test.js 访问这二个静态资源。
假设WebContent还拥有images/bg1.gif 及 js/test1.js,则也可以在网页中通过 /resources/images/bg1.gif 及 /resources/js/test1.js 进行引用。
或者 我的习惯
<!-- 静态资源映射,如果有多个目录使用逗号进行分割 -->
<mvc:resources location="/WEB-INF/static/images/,/WEB-INF/static/img/" mapping="/image/**" ></mvc:resources>
<mvc:resources location="/WEB-INF/static/css/" mapping="/css/**" ></mvc:resources>
<mvc:resources location="/WEB-INF/static/js/" mapping="/js/**" ></mvc:resources>
- mapping:映射
- cache-period:可以指定静态资源在浏览器端的缓存时间,这里设置是一年,springmvc在输出响应流时,会设置好响应头部的Expries还有Cache-Control的值
- location:Spring Resource类型,可以读取任意位置的静态资源,报错jar中的静态资源,使用”classpath:”的静态资源,还有WEB-INF目录下的静态资源等等。
两个*,它表示映射resources/下所有的URL,包括子路径(即接多个/)
映射到ResourceHttpRequestHandler进行处理 location指定静态资源的位置.可以是web application根目录下、jar包里面,这样可以把静态资源压缩到jar包中 cache-period 可以使得静态资源进行
web cache
异常
如果出现下面的错误,可能是没有配置<mvc:annotation-driven />的原因。
报错WARNING: No mapping found for HTTP request with URI [/shxt/image/0.icon] in DispatcherServlet with name 'springMVC'
使用<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:resources mapping="/resources/**" cache-period="3000" location="/resources/" order="0">
<mvc:resource-chain resource-cache="true">
<mvc:resolvers>
<bean class="org.springframework.web.servlet.resource.GzipResourceResolver"/>
</mvc:resolvers>
</mvc:resource-chain>
</mvc:resources>
<mvc:resources mapping="/static/**" cache-period="30" location="/static/" order="0"/>
<mvc:default-servlet-handler default-servlet-name="default" />
因为我这里的静态文件都在resources和static目录下,所以这里只配置了这两个路径。后面的location最后一定要有一个/结束,否则静态资源是访问不到的,order参数是Spring配置的优先级,数字越小越优先。cache-period是缓存的秒数,这里将resources的缓存设置为3000秒,也就是50分钟,static的是30秒。然后在resources里面配置了GzipResourceResolver,是用来尝试返回GZIP的文件,如果有则返回,没有就返回原文件。像是比较大的JS文件就应该使用GZIP压缩后的文件返回,可以大大的减小下载的时间。
放在后面的话
最后再说明一下,方案二、方案三 在访问静态资源时,如果有匹配的(近似)总拦截器,就会走拦截器。如果你在拦截中实现权限检查,要注意过滤这些对静态文件的请求。
静态资源版本控制解决方案-加入版本号码
/**
* 资源版本控制器
*/
public class ResVersionExposer implements ServletContextAware {
private ServletContext servletContext ;
private String resPath ;
@Override
public void setServletContext(ServletContext servletContext) {
this.servletContext = servletContext;
}
public void init(){
String version = "1.2.1" ; //可以把版本号配置在application.properties
resPath = "resource/" + version + "/";
servletContext.setAttribute("resPath", resPath);
}
public String getResPath() {
return resPath;
}
}
然后我们在配置文件中配置静态文件的路径
<bean id="rve" init-method="init" class="com.hanpang.util.resource.ResVersionExposer" />
<mvc:resources location="/content/" cache-period="31556926" mapping="${rve.resPath}" />
jsp页面就这样子请求静态资源文件
<link rel="stylesheet" type="text/css"
href="${resPath}/css/catalog/catalogEdit.css" />
辛苦了一上午,总结了!记得转发和打赏啊! 胖先森!~