靜態資源

此選項提供了一種便捷的方式，可以從基於 Resource 的位置列表中提供靜態資源。

在下一個示例中，給定一個以 /resources 開頭的請求，相對路徑用於查詢和提供相對於 Web 應用程式根目錄下的 /public 或類路徑下的 /static 的靜態資源。這些資源以一年後的過期時間提供，以確保最大程度地利用瀏覽器快取並減少瀏覽器發出的 HTTP 請求。Last-Modified 資訊是從 Resource#lastModified 推匯出來的，以便透過 "Last-Modified" 頭支援 HTTP 條件請求。

以下清單展示瞭如何實現：

Java
Kotlin
Xml

@Configuration
public class WebConfiguration implements WebMvcConfigurer {

	@Override
	public void addResourceHandlers(ResourceHandlerRegistry registry) {
		registry.addResourceHandler("/resources/**")
				.addResourceLocations("/public", "classpath:/static/")
				.setCacheControl(CacheControl.maxAge(Duration.ofDays(365)));
	}
}

@Configuration
class WebConfiguration : WebMvcConfigurer {

	override fun addResourceHandlers(registry: ResourceHandlerRegistry) {
		registry.addResourceHandler("/resources/**")
			.addResourceLocations("/public", "classpath:/static/")
			.setCacheControl(CacheControl.maxAge(Duration.ofDays(365)))
	}
}

<mvc:resources mapping="/resources/**" location="/public, classpath:/static/"
			   cache-period="31556926" />

另請參閱靜態資源的 HTTP 快取支援。

資源處理器還支援 ResourceResolver 實現鏈和 ResourceTransformer 實現鏈，您可以使用它們來建立用於處理最佳化資源的工具鏈。

您可以使用 VersionResourceResolver 來實現基於內容計算的 MD5 雜湊、固定應用程式版本或其他方式的版本化資源 URL。ContentVersionStrategy（MD5 雜湊）是一個不錯的選擇——除了某些顯著的例外，例如與模組載入器一起使用的 JavaScript 資源。

以下示例展示瞭如何使用 VersionResourceResolver

Java
Kotlin
Xml

@Configuration
public class VersionedConfiguration implements WebMvcConfigurer {

	@Override
	public void addResourceHandlers(ResourceHandlerRegistry registry) {
		registry.addResourceHandler("/resources/**")
				.addResourceLocations("/public/")
				.resourceChain(true)
				.addResolver(new VersionResourceResolver().addContentVersionStrategy("/**"));
	}
}

@Configuration
class VersionedConfiguration : WebMvcConfigurer {

	override fun addResourceHandlers(registry: ResourceHandlerRegistry) {
		registry.addResourceHandler("/resources/**")
			.addResourceLocations("/public/")
			.resourceChain(true)
			.addResolver(VersionResourceResolver().addContentVersionStrategy("/**"))
	}
}

<mvc:resources mapping="/resources/**" location="/public/">
	<mvc:resource-chain resource-cache="true">
		<mvc:resolvers>
			<mvc:version-resolver>
				<mvc:content-version-strategy patterns="/**"/>
			</mvc:version-resolver>
		</mvc:resolvers>
	</mvc:resource-chain>
</mvc:resources>

然後您可以使用 ResourceUrlProvider 重寫 URL 並應用解析器和轉換器的完整鏈——例如，插入版本。MVC 配置提供了一個 ResourceUrlProvider bean，以便它可以注入到其他地方。您還可以使用 ResourceUrlEncodingFilter 使重寫對 Thymeleaf、JSP、FreeMarker 和其他依賴 HttpServletResponse#encodeURL 的 URL 標籤透明。

請注意，當同時使用 EncodedResourceResolver（例如，用於提供 gzipped 或 brotli 編碼的資源）和 VersionResourceResolver 時，您必須按此順序註冊它們。這確保了基於內容的版本始終能夠可靠地計算，基於未編碼的檔案。

對於 WebJars，版本化 URL，如 /webjars/jquery/1.2.0/jquery.min.js，是使用它們的推薦且最有效的方式。相關的資源位置在 Spring Boot 中已開箱即用（或者可以透過 ResourceHandlerRegistry 手動配置），並且不需要新增 org.webjars:webjars-locator-lite 依賴項。

無版本 URL，例如 /webjars/jquery/jquery.min.js，透過 WebJarsResourceResolver 提供支援，當類路徑中存在 org.webjars:webjars-locator-lite 庫時，該解析器會自動註冊。該解析器可以重寫 URL 以包含 jar 的版本，並且還可以匹配不帶版本的傳入 URL——例如，從 /webjars/jquery/jquery.min.js 到 /webjars/jquery/1.2.0/jquery.min.js。

基於 ResourceHandlerRegistry 的 Java 配置提供了進一步的選項，用於精細控制，例如，最後修改行為和最佳化的資源解析。