Spring Boot 默認(rèn)為我們提供了靜態(tài)資源處理，使用 WebMvcAutoConfiguration 中的配置各種屬性。

建議大家使用Spring Boot的默認(rèn)配置方式，如果需要特殊處理的再通過(guò)配置進(jìn)行修改。

如果想要自己完全控制WebMVC，就需要在@Configuration注解的配置類上增加@EnableWebMvc（@SpringBootApplication 注解的程序入口類已經(jīng)包含@Configuration），增加該注解以后WebMvcAutoConfiguration中配置就不會(huì)生效，你需要自己來(lái)配置需要的每一項(xiàng)。這種情況下的配置還是要多看一下WebMvcAutoConfiguration類。

我們既然是快速使用Spring Boot，并不想過(guò)多的自己再重新配置。本文還是主要針對(duì)Spring Boot的默認(rèn)處理方式，部分配置在application 配置文件中（.properties 或 .yml）

默認(rèn)資源映射

我們?cè)趩?dòng)應(yīng)用的時(shí)候，可以在控制臺(tái)中看到如下信息：

2016-01-08 09:29:30.362 INFO 24932 --- [  main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2016-01-08 09:29:30.362 INFO 24932 --- [  main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2016-01-08 09:29:30.437 INFO 24932 --- [  main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]

其中默認(rèn)配置的 /** 映射到 /static （或/public、/resources、/META-INF/resources） 

其中默認(rèn)配置的 /webjars/** 映射到 classpath:/META-INF/resources/webjars/ 

 PS：上面的 static、public、resources 等目錄都在 classpath: 下面（如 src/main/resources/static）。

如果我按如下結(jié)構(gòu)存放相同名稱的圖片，那么Spring Boot 讀取圖片的優(yōu)先級(jí)是怎樣的呢？ 

如下圖：

當(dāng)我們?cè)L問(wèn)地址 http://localhost:8080/fengjing.jpg 的時(shí)候，顯示哪張圖片？這里博主可以直接告訴大家，優(yōu)先級(jí)順序?yàn)椋篗ETA/resources > resources > static > public

如果我們想訪問(wèn)pic2.jpg，請(qǐng)求地址 http://localhost:8080/img/pic2.jpg

自定義資源映射

上面我們介紹了Spring Boot 的默認(rèn)資源映射，一般夠用了，那我們?nèi)绾巫远x目錄？ 

這些資源都是打包在jar包中的，然后實(shí)際應(yīng)用中，我們還有很多資源是在管理系統(tǒng)中動(dòng)態(tài)維護(hù)的，并不可能在程序包中，對(duì)于這種隨意指定目錄的資源，如何訪問(wèn)？

自定義目錄

以增加 /myres/* 映射到 classpath:/myres/* 為例的代碼處理為： 

 實(shí)現(xiàn)類繼承 WebMvcConfigurerAdapter 并重寫方法 addResourceHandlers （對(duì)于 WebMvcConfigurerAdapter 上篇介紹攔截器的文章中已經(jīng)有提到）

package org.springboot.sample.config;

import org.springboot.sample.interceptor.MyInterceptor1;
import org.springboot.sample.interceptor.MyInterceptor2;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;

@Configuration
public class MyWebAppConfigurer 
  extends WebMvcConfigurerAdapter {

 @Override
 public void addResourceHandlers(ResourceHandlerRegistry registry) {
  registry.addResourceHandler("/myres/**").addResourceLocations("classpath:/myres/");
  super.addResourceHandlers(registry);
 }
}

訪問(wèn)myres 文件夾中的fengjing.jpg 圖片的地址為 http://localhost:8080/myres/fengjing.jpg

這樣使用代碼的方式自定義目錄映射，并不影響Spring Boot的默認(rèn)映射，可以同時(shí)使用。

如果我們將/myres/* 修改為 /* 與默認(rèn)的相同時(shí)，則會(huì)覆蓋系統(tǒng)的配置，可以多次使用 addResourceLocations 添加目錄，優(yōu)先級(jí)先添加的高于后添加的。

// 訪問(wèn)myres根目錄下的fengjing.jpg 的URL為 http://localhost:8080/fengjing.jpg （/** 會(huì)覆蓋系統(tǒng)默認(rèn)的配置）
// registry.addResourceHandler("/**").addResourceLocations("classpath:/myres/").addResourceLocations("classpath:/static/");

其中 addResourceLocations 的參數(shù)是動(dòng)參，可以這樣寫 addResourceLocations(“classpath:/img1/”, “classpath:/img2/”, “classpath:/img3/”);

使用外部目錄

如果我們要指定一個(gè)絕對(duì)路徑的文件夾（如 H:/myimgs/ ），則只需要使用 addResourceLocations 指定即可。

// 可以直接使用addResourceLocations 指定磁盤絕對(duì)路徑，同樣可以配置多個(gè)位置，注意路徑寫法需要加上file:
registry.addResourceHandler("/myimgs/**").addResourceLocations("file:H:/myimgs/");

通過(guò)配置文件配置

上面是使用代碼來(lái)定義靜態(tài)資源的映射，其實(shí)Spring Boot也為我們提供了可以直接在 application.properties（或.yml）中配置的方法。 

 配置方法如下：

# 默認(rèn)值為 /**
spring.mvc.static-path-pattern=
# 默認(rèn)值為 classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/ 
spring.resources.static-locations=這里設(shè)置要指向的路徑，多個(gè)使用英文逗號(hào)隔開，

使用 spring.mvc.static-path-pattern 可以重新定義pattern，如修改為 /myres/** ，則訪問(wèn)static 等目錄下的fengjing.jpg文件應(yīng)該為 http://localhost:8080/myres/fengjing.jpg ，修改之前為 http://localhost:8080/fengjing.jpg
使用 spring.resources.static-locations 可以重新定義 pattern 所指向的路徑，支持 classpath: 和 file: （上面已經(jīng)做過(guò)說(shuō)明） 

注意 spring.mvc.static-path-pattern 只可以定義一個(gè)，目前不支持多個(gè)逗號(hào)分割的方式。

頁(yè)面中使用

上面幾個(gè)例子中也已經(jīng)說(shuō)明了怎么訪問(wèn)靜態(tài)資源，其實(shí)在頁(yè)面中使用不管是jsp還是freemarker，并沒(méi)有什么特殊之處，也我們平時(shí)開發(fā)web項(xiàng)目一樣即可。 

 下面是我的index.jsp：

<body>
 <img alt="讀取默認(rèn)配置中的圖片" src="${pageContext.request.contextPath }/pic.jpg">
 <br/>
 <img alt="讀取自定義配置myres中的圖片" src="${pageContext.request.contextPath }/myres/fengjing.jpg">
</body>

使用webjars

先說(shuō)一下什么是webjars？我們?cè)赪eb開發(fā)中，前端頁(yè)面中用了越來(lái)越多的JS或CSS，如jQuery等等，平時(shí)我們是將這些Web資源拷貝到Java的目錄下，這種通過(guò)人工方式拷貝可能會(huì)產(chǎn)生版本誤差，拷貝版本錯(cuò)誤，前端頁(yè)面就無(wú)法正確展示。
WebJars 就是為了解決這種問(wèn)題衍生的，將這些Web前端資源打包成Java的Jar包，然后借助Maven這些依賴庫(kù)的管理，保證這些Web資源版本唯一性。

WebJars 就是將js, css 等資源文件放到 classpath:/META-INF/resources/webjars/ 中，然后打包成jar 發(fā)布到maven倉(cāng)庫(kù)中。

簡(jiǎn)單應(yīng)用

以jQuery為例，文件存放結(jié)構(gòu)為：

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

Spring Boot 默認(rèn)將 /webjars/** 映射到 classpath:/META-INF/resources/webjars/ ，結(jié)合我們上面講到的訪問(wèn)資源的規(guī)則，便可以得知我們?cè)贘SP頁(yè)面中引入jquery.js的方法為：

<script type="text/javascript" src="${pageContext.request.contextPath }/webjars/jquery/2.1.4/jquery.js"></script>

想實(shí)現(xiàn)這樣，我們只需要在pom.xml 文件中添加jquery的webjars 依賴即可，如下：

<dependency>
 <groupId>org.webjars</groupId>
 <artifactId>jquery</artifactId>
 <version>2.1.4</version>
</dependency>

版本號(hào)統(tǒng)一管理

但是我們實(shí)際開發(fā)中，可能會(huì)遇到升級(jí)版本號(hào)的情況，如果我們有100多個(gè)頁(yè)面，幾乎每個(gè)頁(yè)面上都有按上面引入jquery.js 那么我們要把版本號(hào)更換為3.0.0，一個(gè)一個(gè)替換顯然不是最好的辦法。  

如何來(lái)解決？按如下方法處理即可。

首先在pom.xml 中添加依賴：

<dependency>
 <groupId>org.webjars</groupId>
 <artifactId>webjars-locator</artifactId>
</dependency>

然后增加一個(gè)WebJarsController：

package org.springboot.sample.controller;

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;

/**
 * 處理WebJars，自動(dòng)讀取版本號(hào)
 *
 * @author 單紅宇(365384722)
 * @myblog http://blog.csdn.net/catoop/
 * @create 2016年1月8日
 */
@Controller
public class WebJarsController {
  private final WebJarAssetLocator assetLocator = new WebJarAssetLocator();

 @ResponseBody
 @RequestMapping("/webjarslocator/{webjar}/**")
 public ResponseEntity<Object> locateWebjarAsset(@PathVariable String webjar, HttpServletRequest request) {
  try {
   String mvcPrefix = "/webjarslocator/" + webjar + "/"; // This prefix must match the mapping path!
   String mvcPath = (String) request.getAttribute(HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE);
   String fullPath = assetLocator.getFullPath(webjar, mvcPath.substring(mvcPrefix.length()));
   return new ResponseEntity<>(new ClassPathResource(fullPath), HttpStatus.OK);
  } catch (Exception e) {
   return new ResponseEntity<>(HttpStatus.NOT_FOUND);
  }
 }
}

最后在頁(yè)面中使用的方式：

<script type="text/javascript" src="${pageContext.request.contextPath }/webjarslocator/jquery/jquery.js"></script>

靜態(tài)資源版本管理

Spring 默認(rèn)提供了靜態(tài)資源版本映射的支持。 

當(dāng)我們的資源內(nèi)容發(fā)生改變時(shí)，由于瀏覽器緩存，用戶本地的資源還是舊資源，為了防止這種情況發(fā)生導(dǎo)致的問(wèn)題。我們可能會(huì)選擇在資源文件后面加上參數(shù)“版本號(hào)”或其他方式。

使用版本號(hào)參數(shù)，如：

<script type="text/javascript" src="${pageContext.request.contextPath }/js/common.js?v=1.0.1"></script>

使用這種方式，當(dāng)我們文件修改后，手工修改版本號(hào)來(lái)達(dá)到URL文件不被瀏覽器緩存的目的。同樣也存在很多文件都需要修改的問(wèn)題?；蛘哂械娜藭?huì)增加時(shí)間戳的方式，這樣我認(rèn)為是最不可取的，每次瀏覽器都要請(qǐng)求為服務(wù)器增加了不必要的壓力。

然而Spring在解決這種問(wèn)題方面，提供了2種解決方式。

* 資源名稱md5方式 *

1. 修改 application.properties 配置文件（或.yml）

spring.resources.chain.strategy.content.enabled=true
spring.resources.chain.strategy.content.paths=/**

所有 /** 請(qǐng)求的靜態(tài)資源都會(huì)被處理。

1.創(chuàng)建 ResourceUrlProviderController 文件

package org.springboot.sample.config;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.servlet.resource.ResourceUrlProvider;
/**
 * 處理靜態(tài)資源URL
 *
 * @author 單紅宇(365384722)
 * @myblog http://blog.csdn.net/catoop/
 * @create 2016年1月8日
 */
@ControllerAdvice
public class ResourceUrlProviderController {
 @Autowired
 private ResourceUrlProvider resourceUrlProvider;

 @ModelAttribute("urls")
 public ResourceUrlProvider urls() {
  return this.resourceUrlProvider;
 }
}

1.在頁(yè)面中使用的寫法

<script type="text/javascript" src="${pageContext.request.contextPath }${urls.getForLookupPath('/js/common.js') }"></script>

當(dāng)我們?cè)L問(wèn)頁(yè)面后，HTML中實(shí)際生成的代碼為：

<script type="text/javascript" src="/myspringboot/js/common-c6b7da8fffc9be141b48c073e39c7340.js"></script>

其中 /myspringboot 為我這個(gè)項(xiàng)目的 contextPath

* 資源版本號(hào)方式 *

該方式本人覺(jué)得并無(wú)多大意義，也不做詳細(xì)說(shuō)明，這是對(duì)所有資源的統(tǒng)一版本控制，不像上面一個(gè)md5是針對(duì)文件的。
 除了在 application.properties（或.yml）中的配置有所區(qū)別，頁(yè)面使用和md5的一樣。

spring.resources.chain.strategy.fixed.enabled=true
spring.resources.chain.strategy.fixed.paths=/js/**,/v1.0.0/**
spring.resources.chain.strategy.fixed.version=v1.0.0

這樣配置后，以上面 common.js 為例，實(shí)際頁(yè)面中生成的HTML代碼為：

<script type="text/javascript" src="/myspringboot/v1.0.0/js/common.js"></script>

* md5與版本號(hào)方式的處理原理 *

頁(yè)面中首先會(huì)調(diào)用urls.getForLookupPath方法，返回一個(gè)/v1.0.0/js/common.js或/css/common-c6b7da8fffc9be141b48c073e39c7340.js

然后瀏覽器發(fā)起請(qǐng)求。 

 當(dāng)請(qǐng)求的地址為md5方式時(shí)，會(huì)嘗試url中的文件名中是否包含-，如果包含會(huì)去掉后面這部分，然后去映射的目錄（如/static/）查找/js/common.js文件，如果能找到就返回。

當(dāng)請(qǐng)求的地址為版本號(hào)方式時(shí)，會(huì)在url中判斷是否存在/v1.0.0 ，如果存在，則先從URL中把 /v1.0.0 去掉，然后再去映射目錄查找對(duì)應(yīng)文件，找到就返回。

總結(jié)

有這么多方式來(lái)管理我們的資源文件，然而在實(shí)際應(yīng)用中雖然也都有可能用到（存在就有存在的道理嘛），但是憑借個(gè)人經(jīng)驗(yàn)來(lái)說(shuō)。

1. 我們使用第三方的庫(kù)時(shí)，建議使用webjars的方式，通過(guò)動(dòng)態(tài)版本號(hào)（webjars-locator 的方式）來(lái)使用（因?yàn)榈谌綆?kù)在項(xiàng)目開發(fā)中變動(dòng)頻率很小，即便是變動(dòng)也是版本號(hào)的修改）。
2. 我們使用自己存放在靜態(tài)資源映射目錄中的資源的時(shí)候，建議使用md5 資源文件名的方式來(lái)使用（項(xiàng)目開發(fā)中一些css、js文件會(huì)經(jīng)常修改）。
3. 項(xiàng)目素材文件建議放到 classpath:/static （或其他）目錄中，打包在項(xiàng)目中，通過(guò)CMS維護(hù)的一些圖片和資源，我們使用配置引用到具體的磁盤絕對(duì)路徑來(lái)使用。
4. 注意使用md5文件名方式的時(shí)候，Spring 是有緩存機(jī)制的，也就是說(shuō)，在服務(wù)不重啟的情況下，你去變動(dòng)修改這些資源文件，其文件名的md5值并不會(huì)改變，只有重啟服務(wù)再次訪問(wèn)才會(huì)生效。如果需要每次都獲取實(shí)際文件的md5值，需要重寫相關(guān)類來(lái)實(shí)現(xiàn)，我們不建議這樣做，因?yàn)橐恢比ビ?jì)算文件md5值是需要性能代價(jià)的。

總結(jié)

以上所述是小編給大家介紹的Spring Boot 靜態(tài)資源處理，希望對(duì)大家有所幫助，如果大家有任何疑問(wèn)請(qǐng)給我留言，小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持！

最新評(píng)論