96. Spring Boot之静态资源版本映射(解决js/css缓存问题)

我们在之前有一篇文章中讲过【处理静态资源】，但是在实际开发中，我们会发现我们所了解到的知识远远不够我们使用，今天这节就是在实际开发当中对碰到的问题进行一定的讲解和解决。

       问题的提出：我们对于我们编写的js和css文件，经常会做一些改变，由于浏览器缓存，用户本地的资源还是旧资源，一般为了解决这种情况导致的问题，我们会可能会选择在资源文件后面加上参数“版本号”或其他方式。

       使用版本号参数，如：

<scripttype="text/javascript"src="/js/common.js?v=1.0.1">script>

       使用这种方式，当我们文件修改后，手动修改版本号来达到URL文件不被浏览器缓存的目的。同样也存在很多文件都需要修改的问题，或者有的人会增加时间戳的形式，这样是最不可取的，每次浏览器都需要为服务器增加了不必要的压力。Spring在解决这种问题方面，提供了2中解决方式。我们看看本节的大纲吧。

本章大纲

（1）回顾默认资源映射
（2）使用webjars
（3）Spring 静态资源版本映射之资源名称md5方式
（4）Spring 静态资源版本映射之资源版本号方式
（5）md5与版本号方式的处理原理
（6）总结

 

 

       接下来我们看看具体是怎么操作的。

（1）回顾默认资源映射

       默认配置的 /** 映射到 /static （或/public、/resources、/META-INF/resources）

其中默认配置的 /webjars/** 映射到 classpath:/META-INF/resources/webjars/

 

（2）使用webjars

       先说一下什么是webjars？我们在Web开发中，前端页面中用了越来越多的JS或CSS，如jQuery等等，平时我们是将这些Web资源拷贝到Java的目录下，这种通过人工方式拷贝可能会产生版本误差，拷贝版本错误，前端页面就无法正确展示。

       WebJars 就是为了解决这种问题衍生的，将这些Web前端资源打包成Java的Jar包，然后借助Maven这些依赖库的管理，保证这些Web资源版本唯一性。

       WebJars 就是将js, css 等资源文件放到 classpath:/META-INF/resources/webjars/ 中，然后打包成jar 发布到maven仓库中。

       以jQuery为例，文件存放结构为：

       META-INF/resources/webjars/jquery/2.1.4/jquery.js

    META-INF/resources/webjars/jquery/2.1.4/jquery.min.js

    META-INF/resources/webjars/jquery/2.1.4/jquery.min.map

   META-INF/resources/webjars/jquery/2.1.4/webjars-requirejs.js

       使用方式就是在pom.xml文件添加配置：

        <dependency>

           <groupId>org.webjarsgroupId>

           <artifactId>jqueryartifactId>

           <version>2.1.4version>

        dependency>

 

       Spring Boot 默认将 /webjars/** 映射到 classpath:/META-INF/resources/webjars/ ，结合我们上面讲到的访问资源的规则，便可以得知我们在页面中引入jquery.js的方法为：

       版本号统一管理

       但是我们实际开发中，可能会遇到升级版本号的情况，如果我们有100多个页面，几乎每个页面上都有按上面引入jquery.js 那么我们要把版本号更换为3.0.0，一个一个替换显然不是最好的办法。 使用webjars的webjars-locator就可以解决以上的问题，那么具体要怎么操作呢？

       首先在pom.xml添加webjars-locator的依赖：

       <dependency>

           <groupId>org.webjarsgroupId>

           <artifactId>webjars-locatorartifactId>

       dependency>

       增加一个WebJarsController，这个Controller会将以webjarslocator路径拦截，然后重新组装处理，具体代码如下：

package com.kfit;

 

import javax.servlet.http.HttpServletRequest;

 

import org.springframework.core.io.ClassPathResource;

import org.springframework.http.HttpStatus;

import org.springframework.http.ResponseEntity;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.PathVariable;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.ResponseBody;

import org.springframework.web.servlet.HandlerMapping;

import org.webjars.WebJarAssetLocator;

 

/**

 * 这个Controller会将以webjarslocator路径拦截，然后重新组装处理

 * @author Angel --守护天使

 * @version v.0.1

 * @date 2016年12月1日

 */

@Controller

public class WebJarsController {

    privatefinal WebJarAssetLocator assetLocator = new WebJarAssetLocator();

    @ResponseBody

    @RequestMapping("/webjarslocator/{webjar}/**")

    public ResponseEntity