Spring4.1新特性——静态资源处理增强

Spring 4.1对静态资源处理进行了细化，ResourceHttpRequestHandler细分为两大部分：ResourceResolver和ResourceTransformer。

Java代码  

1. public interface ResourceResolver {  
2.   Resource resolveResource(HttpServletRequest request, String requestPath, List<? extends Resource> locations,  
3.             ResourceResolverChain chain);  
4.   String resolveUrlPath(String resourcePath, List<? extends Resource> locations, ResourceResolverChain chain);  
5. }    

resolveResource用于把当前请求路径解析到一个在locations中存在的Resource，即相对于locations目录，这个要看实际实现，比如PathResourceResolver就是相对目录；

resolveUrlPath用于把资源路径解析为向外暴露的URL路径形式，比如VersionResourceResolver实现就是在资源路径上加上版本号。 

Java代码  

1. public interface ResourceTransformer {  
2.     Resource transform(HttpServletRequest request, Resource resource, ResourceTransformerChain transformerChain)  
3.             throws IOException;  
4. }  

用于把资源从一种形式转换为另一种形式，比如对css文件中的url进行过滤并修改。 

ResourceResolver和ResourceTransformer实现和Filter机制类似，就不多阐述了。

ResourceHttpRequestHandler核心实现：

Java代码  

1. protected Resource getResource(HttpServletRequest request) throws IOException{  
2.     String path = (String) request.getAttribute(HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE);  
3.     if (path == null) {  
4.         throw new IllegalStateException("Required request attribute '" +  
5.                 HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE + "' is not set");  
6.     }  
7.     if (!StringUtils.hasText(path) || isInvalidPath(path)) {  
8.         if (logger.isTraceEnabled()) {  
9.             logger.trace("Ignoring invalid resource path [" + path + "]");  
10.         }  
11.         return null;  
12.     }  
13.     ResourceResolverChain resolveChain = new DefaultResourceResolverChain(getResourceResolvers());  
14.     Resource resource = resolveChain.resolveResource(request, path, getLocations()); //先进行ResourceResolver  
15.     if (resource == null || getResourceTransformers().isEmpty()) {  
16.         return resource;  
17.     }  
18.     ResourceTransformerChain transformChain = new DefaultResourceTransformerChain(resolveChain, getResourceTransformers());//然后进行ResourceTransformer  
19.     resource = transformChain.transform(request, resource);  
20.     return resource;  
21. }  

交互流程是：

request(/static/js/jquery-版本.js)

        |

       V 

GzipResourceResolver（如果需要Gzip压缩，进行Gzip压缩）

        |

       V 

CacheResolver（缓存中如果找到了，直接返回）

        |

       V 

VersionResourceResolver（去掉版本号，然后查找资源）

        |

       V 

PathResourceResolver（如直接到底层文件系统找）

        |

       V

CachingResourceTransformer（判断是否有已经转换好的缓存）

        |

       V

CssLinkResourceTransformer（CSS链接替换，如加版本号，其会调用ResourceResolver的resolveUrlPath得到新的UrlPath）

        |

       V

response

对应的Spring配置文件

Java代码  

1. <mvc:resources mapping="/static/**" location="/WEB-INF/static/">  
2.     <mvc:resolvers>  
3.         <bean class="org.springframework.web.servlet.resource.GzipResourceResolver"/>  
4.         <bean class="org.springframework.web.servlet.resource.CachingResourceResolver">  
5.             <constructor-arg ref="cache"/>  
6.         </bean>  
7.         <bean class="org.springframework.web.servlet.resource.VersionResourceResolver">  
8.             <property name="strategyMap">  
9.                 <map>  
10.                     <entry key="/**">  
11.                         <bean class="org.springframework.web.servlet.resource.ContentVersionStrategy"/>  
12.                     </entry>  
13.                 </map>  
14.             </property>  
15.         </bean>  
16.         <bean class="org.springframework.web.servlet.resource.PathResourceResolver"/>  
17.     </mvc:resolvers>  
18.     <mvc:transformers>  
19.         <bean class="org.springframework.web.servlet.resource.CachingResourceTransformer">  
20.             <constructor-arg ref="cache"/>  
21.         </bean>  
22.         <bean class="org.springframework.web.servlet.resource.CssLinkResourceTransformer"/>  
23.     </mvc:transformers>  
24. </mvc:resources>  

其中版本机制是使用ContentBasedVersionStrategy，其通过MD5内容生成版本。

如果配置文件是如下形式，其默认会自动注册一个PathResourceResolver。

Java代码  

1. <mvc:resources mapping="/static/**" location="/WEB-INF/static/"/>  

如果想在页面中也完成同样的事情，可以首先注册一个拦截器：

Java代码  

1. <mvc:interceptors>  
2.     <mvc:interceptor>  
3.         <mvc:mapping path="/**"/>  
4.         <bean class="org.springframework.web.servlet.resource.ResourceUrlProviderExposingInterceptor">  
5.             <constructor-arg>  
6.                     <bean class="org.springframework.web.servlet.resource.ResourceUrlProvider"/>  
7.             </constructor-arg>  
8.         </bean>  
9.     </mvc:interceptor>  
10. </mvc:interceptors>  

然后在页面中使用如下代码完成相应的功能：

Java代码  

1. <%=((ResourceUrlProvider)request.getAttribute("org.springframework.web.servlet.resource.ResourceUrlProvider"))  
2.         .getForLookupPath("/static/css/style.css")%>  

另外ResourceUrlProvider目前实现是有问题的，没有考虑使用mvc:resources标签注册ResourceHttpRequestHandler的情况；我们需要修改下其源码：

Java代码  

1. Object handler = hm.getUrlMap().get(pattern);  
2. if(handler instanceof String) {//如果是字符串，那么接着去获取Bean才对  
3.     handler = hm.getApplicationContext().getBean((String)handler);  
4. }  
5. if (handler instanceof ResourceHttpRequestHandler) {  

上边的使用还是很麻烦，大家可以自己实现一个jstl function来简化使用。

也可以使用ResourceUrlEncodingFilter过滤器，其会对Response进行包装，当调用encodeURL时会对url进行resolver。 

当我们访问localhost:8080/test时会看到响应内容带着版本号：hello /static/css/style-23f8024fc04a067828dded9083ceab4f.css，而style.css中会变成：

@import url('other-a18c41dc0df32e9856c5c08914284553.css');

@import url('../css2/css2-ad02c833411bcdc09669b1464001c5e4.css');

当other-a18c41dc0df32e9856c5c08914284553.css请求到服务端后，会使用VersionStrategy去提取版本并进行版本的匹配，如果版本变了，而客户端没有感知到，那么将报404，这个是无法忍受的，即版本化不是持久化的。

转自 http://jinnianshilongnian.iteye.com/blog/2108894