快捷導(dǎo)航

SpringBoot訪問(wèn)靜態(tài)資源的配置及順序說(shuō)明

更新時(shí)間：2022年03月21日 09:07:29 作者：zzzgd816

這篇文章主要介紹了SpringBoot訪問(wèn)靜態(tài)資源的配置及順序說(shuō)明，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教

訪問(wèn)靜態(tài)資源的配置及順序

今天在玩SpringBoot的demo的時(shí)候,放了張圖片在resources目錄下,啟動(dòng)區(qū)訪問(wèn)的時(shí)候,突然好奇是識(shí)別哪些文件夾來(lái)展示靜態(tài)資源的, 為什么有時(shí)候放的文件夾不能顯示,有的卻可以.

1. SpringBoot的默認(rèn)配置

首先我們打開(kāi)WebMvcAutoConfiguration類(lèi), 因?yàn)槭庆o態(tài)資源的位置, 所以搜索location,找到這一行代碼:

?String staticPathPattern = this.mvcProperties.getStaticPathPattern();
? ? if (!registry.hasMappingForPattern(staticPathPattern)) {
? ? ? this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{staticPathPattern}).addResourceLocations(getResourceLocations(this.resourceProperties.getStaticLocations())).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl));
? ? }

然后進(jìn)入getStaticLocations這個(gè)方法,到了ResourceProperties類(lèi)中的

? public String[] getStaticLocations() {
? ? return this.staticLocations;
? }

這個(gè)方法,那接著看staticLocations這個(gè)屬性,其實(shí)就到了這個(gè)類(lèi)的頂部

public class ResourceProperties {
? private static final String[] CLASSPATH_RESOURCE_LOCATIONS = new String[]{"classpath:/META-INF/resources/", "classpath:/resources/", "classpath:/static/", "classpath:/public/"};
? private String[] staticLocations;
? private boolean addMappings;
? private final ResourceProperties.Chain chain;
? private final ResourceProperties.Cache cache;
? public ResourceProperties() {
? ? this.staticLocations = CLASSPATH_RESOURCE_LOCATIONS;
? ? this.addMappings = true;
? ? this.chain = new ResourceProperties.Chain();
? ? this.cache = new ResourceProperties.Cache();
? }
...
}

可以看出,靜態(tài)資源默認(rèn)的位置是classpath,也就是resource目錄下的:

/META-INF/resources
/resources
/static
/public

而且順序就是數(shù)組的順序.

2. 測(cè)試

我們創(chuàng)建一個(gè)index.html頁(yè)面,然后<h1>標(biāo)簽分別是各自的路徑,比如在/META-INF/resources下的index.html:

<!DOCTYPE html >
<html>
<head lang="en">
? ? <meta charset="UTF-8" />
? ? <title>http-template</title>
</head>
<body>
<h1 >META-INF.resources</h1>
</body>
</html>

在上面四個(gè)文件夾中各自放一個(gè)不同標(biāo)題的頁(yè)面,啟動(dòng)springboot,訪問(wèn)localhost:8080

可以看到頁(yè)面的標(biāo)題是/META-INF/resources, 說(shuō)明是按照上面的默認(rèn)配置讀取順序讀取的

注意,這里不需要加這個(gè)靜態(tài)資源文件夾的名字!!,比如localhost:8080能看到頁(yè)面,但是localhost:8080/static或localhost:8080/META-INF/resources是訪問(wèn)不了的

為了繼續(xù)證實(shí)四個(gè)文件夾都可以,我放了同一個(gè)圖片在各自文件夾,只是名字不同,結(jié)構(gòu)如下:

訪問(wèn)

localhost:8080/2b.jpg
localhost:8080/3b.jpg
localhost:8080/4b.jpg
localhost:8080/5b.jpg

都能訪問(wèn)(不需要加靜態(tài)資源文件夾的名字!!!), 反而是resource根目錄,也就是classpath下的1b.jpg不能訪問(wèn)

3.配置

配置一: 是否可以訪問(wèn)靜態(tài)資源

spring:
  mvc:
    static-path-pattern: /static/**

這個(gè)配置默認(rèn)是/**, 表示的是正則匹配到這種路徑才去訪問(wèn)靜態(tài)資源,所以默認(rèn)情況下,上面四個(gè)能夠訪問(wèn)的路徑也必須加上/zgd才可以訪問(wèn)

另一個(gè)需要注意的事,默認(rèn)情況下訪問(wèn)index.html頁(yè)面,不需要加這個(gè)文件名,比如localhost:8080,但是配置了該項(xiàng)后,需要文件名.localhost:8080/zgd/index.html

加上index.html資源全稱(chēng)后可以訪問(wèn)

配置二: 去哪找靜態(tài)資源

這個(gè)配置就是我們上面說(shuō)的那四個(gè)文件夾的配置了,注釋掉上面的配置,啟動(dòng)看看

spring:
  resources:
    static-locations: classpath:/static/

啟動(dòng)訪問(wèn)localhost:8080

不出意料的顯示的是static的標(biāo)題,也就是static文件夾下的html文件.

此時(shí)嘗試訪問(wèn)3b.jpg,4b.jpb都是無(wú)法訪問(wèn)的,只能訪問(wèn)2b.jpg

靜態(tài)資源的配置心得

在springboot的application.properties中，下面2個(gè)配置是配置靜態(tài)資源的。

# 默認(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)隔開(kāi)

上面的那個(gè)是匹配規(guī)則，換句話說(shuō)，只有靜態(tài)資源滿(mǎn)足什么樣的匹配條件，Spring Boot才會(huì)處理靜態(tài)資源請(qǐng)求。

下面的是匹配后指向的路徑。也就是說(shuō) ，這個(gè)配置項(xiàng)是告訴springboot去哪找資源。

舉例

spring.mvc.static-path-pattern=/gw/**

如果原先訪問(wèn)首頁(yè)的地址是：http://localhost:8080/index.html,那么在你配置這個(gè)配置后，上面的訪問(wèn)就失效了，現(xiàn)在訪問(wèn)同樣的頁(yè)面需要這樣訪問(wèn)：http://localhost:8888/gw/index.html

配置訪問(wèn)路徑為/gw/后原本可以訪問(wèn)resources下其他文件夾的目錄下的靜態(tài)資源，現(xiàn)在不可以了。

比如下面截圖中pay.html不能訪問(wèn)了，在沒(méi)有配置為/static/可以通過(guò)http://localhost:8080/pay.html訪問(wèn),注意地址欄。（測(cè)試時(shí)，spring.mvc.static-path-pattern=/static/**）