002.SpringMVC 处理静态资源方案[干货]

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

辛苦了一上午,总结了!记得转发和打赏啊! 胖先森!~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,935评论 6 342
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,845评论 18 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,742评论 18 399
  • 从三月份找实习到现在,面了一些公司,挂了不少,但最终还是拿到小米、百度、阿里、京东、新浪、CVTE、乐视家的研发岗...
    时芥蓝阅读 42,341评论 11 349
  • 在诺大的城市里,多少迷茫的年轻人,在灯彩缤纷的霓虹灯下迷失了方向!我们在这个城市,却不属于这里!因为我们的根不在这...
    我要回农村阅读 270评论 0 1