此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Framework 6.2.10！spring-doc.cadn.net.cn

静态资源

请参阅响应式堆栈中的等效项spring-doc.cadn.net.cn

此选项提供了一种方便的方式来提供列表中的静态资源Resource基于位置。spring-doc.cadn.net.cn

在下一个示例中，给定一个以/resources，相对路径为用于查找和提供相对于/public在 Web 应用程序下 root 或在类路径上/static.这些资源的未来为一年 expiration 以确保最大限度地利用浏览器缓存并减少 HTTP 请求由浏览器制作。这Last-Modified信息是从Resource#lastModified以便 HTTP 条件请求支持"Last-Modified"头。spring-doc.cadn.net.cn

以下列表显示了如何执行此作：spring-doc.cadn.net.cn

@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 缓存支持。spring-doc.cadn.net.cn

资源处理程序还支持ResourceResolverimplementations 和ResourceTransformer实现您可以使用它来创建用于处理优化资源的工具链。spring-doc.cadn.net.cn

您可以使用VersionResourceResolver对于基于 MD5 哈希的版本化资源 URL 根据内容、固定应用程序版本或其他计算。一个ContentVersionStrategy（MD5 哈希）是一个不错的选择——但有一些值得注意的例外，例如与模块加载器一起使用的 JavaScript 资源。spring-doc.cadn.net.cn

以下示例演示如何使用VersionResourceResolver:spring-doc.cadn.net.cn

@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豆子，这样就可以注射到别人身上。您还可以使用ResourceUrlEncodingFilter对于 Thymeleaf、JSP、FreeMarker 和其他具有 URL 标签的恃HttpServletResponse#encodeURL.spring-doc.cadn.net.cn

请注意，当同时使用EncodedResourceResolver（例如，用于提供 gzip 或 Brotli 编码的资源）和VersionResourceResolver，您必须按此顺序注册它们。这可确保始终根据未编码的文件可靠地计算基于内容的版本。spring-doc.cadn.net.cn

对于 WebJars，版本化 URL （例如/webjars/jquery/1.2.0/jquery.min.js是推荐且最有效的使用方式。相关资源位置是使用 Spring Boot 开箱即用的（或者可以配置手动通过ResourceHandlerRegistry），并且不需要添加org.webjars:webjars-locator-liteDependency。spring-doc.cadn.net.cn

无版本 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.spring-doc.cadn.net.cn

基于ResourceHandlerRegistry提供更多选项用于细粒度控制，例如，上次修改的行为和优化的资源解析。