静态资源

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

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

在下一个示例中，给定一个以 /resources 开头的请求，相对路径用于在 Web 应用程序根目录下或类路径下的 /public 位置查找并提供静态资源。资源的过期时间设置为一年以后，以确保浏览器缓存的最大使用，并减少浏览器发出的 HTTP 请求。从 Resource#lastModified 推断出 Last-Modified 的信息，以便支持带有 "Last-Modified" 标头的 HTTP 条件请求。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

资源处理器还支持一系列的 ResourceResolver 实现和 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 bean，以便它可以被注入到其他bean中。你还可以通过 ResourceUrlEncodingFilter 使重写对Thymeleaf、JSP、FreeMarker和其他依赖于 HttpServletResponse#encodeURL 的URL标签透明。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-lite 依赖项。spring-doc.cadn.net.cn

类似/webjars/jquery/jquery.min.js这样的无版本URL是通过 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的Java配置提供了更进一步的选项，以便进行细粒度控制，例如，最后修改行为和优化资源解析。