springJava Web

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

2017-04-27  本文已影响1077人  胖先森

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>

两个*，它表示映射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" />

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

上一篇 下一篇

猜你喜欢

热点阅读