快捷導(dǎo)航

SpringBoot靜態(tài)資源的訪問(wèn)方法詳細(xì)介紹

更新時(shí)間：2022年09月30日 15:27:48 作者：劉婉晴

最近在做SpringBoot項(xiàng)目的時(shí)候遇到了“白頁(yè)”問(wèn)題，通過(guò)查資料對(duì)SpringBoot訪問(wèn)靜態(tài)資源做了總結(jié)，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)吧

一. 靜態(tài)資源

在web場(chǎng)景中的靜態(tài)圖片、html網(wǎng)頁(yè)等

二. 靜態(tài)資源訪問(wèn)目標(biāo)

在SpringBoot中，靜態(tài)資源訪問(wèn)目標(biāo)有 resources文件下的 public、resources、static 以及 META-INF 文件夾下的 recources

如下圖所示：

（注意文件夾要自己創(chuàng)建，不要寫錯(cuò)名字?。?！名字是固定的，就這幾個(gè)）

三. 靜態(tài)資源訪問(wèn)前綴

1. 默認(rèn)訪問(wèn)路徑為 /

放于上述文件夾下的靜態(tài)資源可以直接在根目錄下訪問(wèn)

如下：以訪問(wèn)qqVeiw.jpg為例

2. 配置訪問(wèn)前綴

為什么需要：在Request訪問(wèn)以及靜態(tài)資源訪問(wèn)同名時(shí)，SpringBoot會(huì)訪問(wèn)優(yōu)先訪問(wèn)Request請(qǐng)求

因此，需要給靜態(tài)資配置訪問(wèn)前綴，配置方法非常簡(jiǎn)單，只需在yaml配置文件中加入如下：

spring:
mvc:
static-path-pattern: /res/** #靜態(tài)資源訪問(wèn)前綴為res

如下圖：

3. 配置靜態(tài)資源默認(rèn)訪問(wèn)位置

我們可以設(shè)置一個(gè)或多個(gè)自定義文件夾為靜態(tài)資源默認(rèn)訪問(wèn)位置（數(shù)組形式），只需在yaml配置文件中加入如下：

spring:
resources:
static-locations: [classpath:/haha/, classpath/static/] #在類路徑的haha文件夾下的靜態(tài)資源才能被訪問(wèn)到

四. 歡迎頁(yè)及網(wǎng)頁(yè)圖標(biāo)設(shè)置

1. 歡迎頁(yè)的設(shè)置

只需將 index.html 網(wǎng)頁(yè)加入配置的static-locations中，再去訪問(wèn)根目錄，就可以看到SpringBoot為我們配置好的歡迎頁(yè)

（1）yaml文件配置

（2）index.html加入靜態(tài)資源訪問(wèn)目標(biāo)

spring:
resources:
static-locations: [classpath:/haha/] #在類路徑的haha文件夾下的靜態(tài)資源才能被訪問(wèn)到

2. 網(wǎng)頁(yè)圖標(biāo)的設(shè)置

將命名為favicon.ico的圖標(biāo)加入靜態(tài)資源訪問(wèn)目錄

注意：若設(shè)置了訪問(wèn)前綴，則上述兩功能不生效使用設(shè)置網(wǎng)頁(yè)圖標(biāo)功能，要開啟禁用瀏覽器緩存功能

分析源碼

WelcomePageHandlerMapping類

1. 實(shí)現(xiàn) 歡迎頁(yè)

		public WelcomePageHandlerMapping welcomePageHandlerMapping(ApplicationContext applicationContext,
				FormattingConversionService mvcConversionService, ResourceUrlProvider mvcResourceUrlProvider) {
			WelcomePageHandlerMapping welcomePageHandlerMapping = new WelcomePageHandlerMapping(
					new TemplateAvailabilityProviders(applicationContext), applicationContext, getWelcomePage(),
					this.mvcProperties.getStaticPathPattern());
			welcomePageHandlerMapping.setInterceptors(getInterceptors(mvcConversionService, mvcResourceUrlProvider));
			welcomePageHandlerMapping.setCorsConfigurations(getCorsConfigurations());
			return welcomePageHandlerMapping;
		}

2.實(shí)現(xiàn)靜態(tài)資源訪問(wèn)

		public void addResourceHandlers(ResourceHandlerRegistry registry) {
			if (!this.resourceProperties.isAddMappings()) {
				logger.debug("Default resource handling disabled");
				return;
			}
			Duration cachePeriod = this.resourceProperties.getCache().getPeriod();
			CacheControl cacheControl = this.resourceProperties.getCache().getCachecontrol().toHttpCacheControl();
			if (!registry.hasMappingForPattern("/webjars/**")) {
				customizeResourceHandlerRegistration(registry.addResourceHandler("/webjars/**")
						.addResourceLocations("classpath:/META-INF/resources/webjars/")
						.setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
			}
			String staticPathPattern = this.mvcProperties.getStaticPathPattern();
			if (!registry.hasMappingForPattern(staticPathPattern)) {
				customizeResourceHandlerRegistration(registry.addResourceHandler(staticPathPattern)
						.addResourceLocations(getResourceLocations(this.resourceProperties.getStaticLocations()))
						.setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
			}
		}

繼續(xù)往下走——

WelcomePageHandlerMapping類

實(shí)現(xiàn)歡迎頁(yè)

	WelcomePageHandlerMapping(TemplateAvailabilityProviders templateAvailabilityProviders,
			ApplicationContext applicationContext, Optional<Resource> welcomePage, String staticPathPattern) {
			// 從這里我們也可以看出來(lái)為什么歡迎頁(yè)不能加靜態(tài)資源訪問(wèn)前綴
		if (welcomePage.isPresent() && "/**".equals(staticPathPattern)) {
			logger.info("Adding welcome page: " + welcomePage.get());
			setRootViewName("forward:index.html");
		}
		else if (welcomeTemplateExists(templateAvailabilityProviders, applicationContext)) {
			logger.info("Adding welcome page template: index");
			setRootViewName("index");
		}
	}

到此這篇關(guān)于SpringBoot靜態(tài)資源的訪問(wèn)方法詳細(xì)介紹的文章就介紹到這了,更多相關(guān)SpringBoot靜態(tài)資源的訪問(wèn)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: