快捷導(dǎo)航

SpringBoot通過源碼探究靜態(tài)資源的映射規(guī)則實現(xiàn)

更新時間：2021年05月06日 11:04:54 作者：萬里顧—程

這篇文章主要介紹了SpringBoot通過源碼探究靜態(tài)資源的映射規(guī)則實現(xiàn),文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

我們開發(fā)一個Spring Boot項目，肯定要導(dǎo)入許多的靜態(tài)資源，比如css，js等文件

如果我們是一個web應(yīng)用，我們的main下會有一個webapp，我們以前都是將所有的頁面導(dǎo)在這里面的，對吧！但是我們現(xiàn)在的pom呢，打包方式是為jar的方式，那么這種方式SpringBoot能不能來給我們寫頁面呢？當然是可以的，但是SpringBoot對于靜態(tài)資源放置的位置，是有規(guī)定的！

1、靜態(tài)資源映射規(guī)則

1.1、第一種映射規(guī)則

SpringBoot中，SpringMVC的web配置都在 WebMvcAutoConfiguration 這個配置類里面；

WebMvcAutoConfigurationAdapter 中有很多配置方法；其中就有一個添加資源處理方法：addResourceHandlers ()，源碼如下。

@Override
		protected void addResourceHandlers(ResourceHandlerRegistry registry) {
			super.addResourceHandlers(registry);
			if (!this.resourceProperties.isAddMappings()) {
				logger.debug("Default resource handling disabled");
				return;
			}
			ServletContext servletContext = getServletContext();
			addResourceHandler(registry, "/webjars/**", "classpath:/META-INF/resources/webjars/");
			addResourceHandler(registry, this.mvcProperties.getStaticPathPattern(), (registration) -> {
				registration.addResourceLocations(this.resourceProperties.getStaticLocations());
				if (servletContext != null) {
					registration.addResourceLocations(new ServletContextResource(servletContext, SERVLET_LOCATION));
				}
			});
		}

通過分析上面源碼可得，添加的靜態(tài)資源映射路徑為/webjars/**，資源路徑為classpath:/META-INF/resources/webjars/

什么是webjars

WebJars是將客戶端（瀏覽器）資源（JavaScript，Css等）打成jar包文件，以對資源進行統(tǒng)一依賴管理。WebJars的jar包部署在Maven中央倉庫上。

webjars官網(wǎng)

我們可以到webjars官網(wǎng)上找到自己需要的資源，在自己的工程中添加入maven依賴，即可直接使用這些資源了。

比如，我們要導(dǎo)入jquery資源

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

導(dǎo)入后我們可以通過資源路徑找到資源的存放位置并訪問，我們在webjars網(wǎng)站導(dǎo)入的資源都符合下圖的結(jié)構(gòu)

在這里插入圖片描述

通過路徑訪問，成功訪問到靜態(tài)資源！

在這里插入圖片描述

1.2、第二種映射規(guī)則

下面我們繼續(xù)分析源碼

在這里插入圖片描述

getStaticPathpattern()：獲得靜態(tài)路徑模式，點進去看一下源碼

public String getStaticPathPattern() {
		return this.staticPathPattern;
	}

再看一下staticPathPattern的源碼

在這里插入圖片描述

/**就是當前目錄下的所有靜態(tài)資源都能識別，但是當前目錄下具體指的又是什么呢？我們點開resourceProperties的源碼便可看出來。源碼如下：

在這里插入圖片描述

上面源碼很清楚的給出了我們四個靜態(tài)資源路徑，所以只要是這四個目錄下的靜態(tài)資源，都可以直接獲取。

我們來測試一下，先補齊上面的目錄，然后再resource目錄放一個js資源

在這里插入圖片描述

啟動springboot應(yīng)用測試：成功訪問到靜態(tài)資源！

在這里插入圖片描述

1.3、總結(jié)

以下四個目錄存放的靜態(tài)資源可以被我們識別：

"classpath:/META-INF/resources/"
"classpath:/resources/"
"classpath:/static/"
"classpath:/public/"

注意：

第一個目錄的訪問路徑為localhost:8080/webjars/資源目錄結(jié)構(gòu)，后面三個訪問路徑為localhost:8080/資源名

第二種映射規(guī)則的優(yōu)先級為：resources>static（默認）>public

2、自定義靜態(tài)資源路徑

我們可以自己通過配置文件來指定一下，哪些文件夾是需要我們放靜態(tài)資源文件的，在application.properties中配置；

spring.resources.static-locations=classpath:/coding/,classpath:/cheng/

但是通過下面源碼我們可以看出，如果自定義了資源路徑，那么上面默認的四個路徑就失效了，所以最好不要自定義路徑，使用springboot幫我們自動配置好的就行。

if (!this.resourceProperties.isAddMappings()) {
				logger.debug("Default resource handling disabled");
				return;
			}

到此這篇關(guān)于SpringBoot通過源碼探究靜態(tài)資源的映射規(guī)則實現(xiàn)的文章就介紹到這了,更多相關(guān)SpringBoot 靜態(tài)資源映射規(guī)則內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: