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

使用动态属性源进行上下文配置

Spring TestContext 框架通过DynamicPropertyRegistry这@DynamicPropertySource注释，以及DynamicPropertyRegistrar应用程序接口。spring-doc.cadn.net.cn

动态属性源基础结构最初设计为允许属性 从基于 Testcontainers 的测试轻松暴露到 Spring 集成测试。但是，这些功能可以与任何形式的外部资源一起使用 其生命周期在测试的ApplicationContext或与 生命周期由测试的ApplicationContext.spring-doc.cadn.net.cn

优先

动态属性的优先级高于加载的属性@TestPropertySource, 作系统的环境、Java 系统属性或由 应用程序通过使用@PropertySource或以编程方式。因此 动态属性可用于有选择地覆盖通过@TestPropertySource、系统属性源和应用程序属性源。spring-doc.cadn.net.cn

DynamicPropertyRegistry

一个DynamicPropertyRegistry用于将名称值对添加到Environment. 值是动态的，通过Supplier仅当属性 已解决。通常，方法引用用于提供值。以下内容 章节提供了如何使用DynamicPropertyRegistry.spring-doc.cadn.net.cn

@DynamicPropertySource

与@TestPropertySource在类级别应用的注释，@DynamicPropertySource可应用于static集成测试类中的方法，以便添加具有动态的属性 值设置为PropertySources在Environment对于ApplicationContext已加载以进行集成测试。spring-doc.cadn.net.cn

集成测试类中用@DynamicPropertySource必须 是static并且必须接受单个DynamicPropertyRegistry论点。请参阅 类级 JavadocDynamicPropertyRegistry了解更多详情。spring-doc.cadn.net.cn

如果您使用@DynamicPropertySource在基类中，并发现子类中的测试 fail 因为动态属性在子类之间发生变化，您可能需要对 您的基类具有@DirtiesContext以确保每个子类都有自己的ApplicationContext具有正确的动态 性能。spring-doc.cadn.net.cn

以下示例使用 Testcontainers 项目来管理外部的 Redis 容器 Spring的ApplicationContext.托管 Redis 的 IP 地址和端口 容器可供测试的ApplicationContext通过redis.host和redis.port性能。这些属性可以通过 Spring 的Environment抽象或直接注入到 Spring 管理的组件中 – 用于 示例，通过@Value("${redis.host}")和@Value("${redis.port}")分别。spring-doc.cadn.net.cn

@SpringJUnitConfig(/* ... */)
@Testcontainers
class ExampleIntegrationTests {

	@Container
	static GenericContainer redis =
		new GenericContainer("redis:5.0.3-alpine").withExposedPorts(6379);

	@DynamicPropertySource
	static void redisProperties(DynamicPropertyRegistry registry) {
		registry.add("redis.host", redis::getHost);
		registry.add("redis.port", redis::getFirstMappedPort);
	}

	// tests ...

}
@SpringJUnitConfig(/* ... */)
@Testcontainers
class ExampleIntegrationTests {

	companion object {

		@Container
		@JvmStatic
		val redis: GenericContainer =
			GenericContainer("redis:5.0.3-alpine").withExposedPorts(6379)

		@DynamicPropertySource
		@JvmStatic
		fun redisProperties(registry: DynamicPropertyRegistry) {
			registry.add("redis.host", redis::getHost)
			registry.add("redis.port", redis::getFirstMappedPort)
		}
	}

	// tests ...

}

DynamicPropertyRegistrar

作为实施的替代方法@DynamicPropertySource积分测试方法 类，您可以注册DynamicPropertyRegistrarAPI 作为 bean 在测试的ApplicationContext.这样做可以支持其他用途 使用@DynamicPropertySource方法。例如，由于DynamicPropertyRegistrar本身就是ApplicationContext，它可以交互 与上下文中的其他 bean 一起使用，并注册源自 那些豆子。spring-doc.cadn.net.cn

测试中的任何 beanApplicationContext实现DynamicPropertyRegistrar接口将在单例之前自动检测并急切初始化 pre-instantiation 阶段，以及accept()此类 bean 的方法将使用DynamicPropertyRegistry在 代表注册官。spring-doc.cadn.net.cn

与其他 Bean 的任何交互都会导致其他 Bean 的预先初始化 bean 及其依赖项。

以下示例演示了如何实现DynamicPropertyRegistrar作为 lambda 表达式，用于注册ApiServer豆。这api.url可以通过 Spring 的Environment抽象或注入 直接进入其他 Spring 管理的组件——例如，通过@Value("${api.url}"), 以及api.url属性将从ApiServer豆。spring-doc.cadn.net.cn

@Configuration
class TestConfig {

	@Bean
	ApiServer apiServer() {
		return new ApiServer();
	}

	@Bean
	DynamicPropertyRegistrar apiPropertiesRegistrar(ApiServer apiServer) {
		return registry -> registry.add("api.url", apiServer::getUrl);
	}
}
@Configuration
class TestConfig {

	@Bean
	fun apiServer(): ApiServer {
		return ApiServer()
	}

	@Bean
	fun apiPropertiesRegistrar(apiServer: ApiServer): DynamicPropertyRegistrar {
		return registry -> registry.add("api.url", apiServer::getUrl)
	}
}