|
对于最新的稳定版本，请使用 Spring Framework 6.2.0！ |
测试的元注释支持
您可以使用大多数与测试相关的注释作为元注释来创建自定义组合 注释并减少测试套件中的配置重复。
您可以将以下各项作为 TestContext 框架的元注释。
-
@BootstrapWith -
@ContextConfiguration -
@ContextHierarchy -
@ContextCustomizerFactories -
@ActiveProfiles -
@TestPropertySource -
@DirtiesContext -
@WebAppConfiguration -
@TestExecutionListeners -
@Transactional -
@BeforeTransaction -
@AfterTransaction -
@Commit -
@Rollback -
@Sql -
@SqlConfig -
@SqlMergeMode -
@SqlGroup -
@Repeat（仅在 JUnit 4 上受支持） -
@Timed（仅在 JUnit 4 上受支持） -
@IfProfileValue（仅在 JUnit 4 上受支持） -
@ProfileValueSourceConfiguration（仅在 JUnit 4 上受支持） -
@SpringJUnitConfig（仅在 JUnit Jupiter 上受支持） -
@SpringJUnitWebConfig（仅在 JUnit Jupiter 上受支持） -
@TestConstructor（仅在 JUnit Jupiter 上受支持） -
@NestedTestConfiguration（仅在 JUnit Jupiter 上受支持） -
@EnabledIf（仅在 JUnit Jupiter 上受支持） -
@DisabledIf（仅在 JUnit Jupiter 上受支持）
请考虑以下示例：
-
Java
-
Kotlin
@RunWith(SpringRunner.class)
@ContextConfiguration({"/app-config.xml", "/test-data-access-config.xml"})
@ActiveProfiles("dev")
@Transactional
public class OrderRepositoryTests { }
@RunWith(SpringRunner.class)
@ContextConfiguration({"/app-config.xml", "/test-data-access-config.xml"})
@ActiveProfiles("dev")
@Transactional
public class UserRepositoryTests { }@RunWith(SpringRunner::class)
@ContextConfiguration("/app-config.xml", "/test-data-access-config.xml")
@ActiveProfiles("dev")
@Transactional
class OrderRepositoryTests { }
@RunWith(SpringRunner::class)
@ContextConfiguration("/app-config.xml", "/test-data-access-config.xml")
@ActiveProfiles("dev")
@Transactional
class UserRepositoryTests { }如果我们发现我们在基于 JUnit 4 的 test 套件中，我们可以通过引入自定义组合注解来减少重复 集中了 Spring 的通用测试配置，如下所示：
-
Java
-
Kotlin
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@ContextConfiguration({"/app-config.xml", "/test-data-access-config.xml"})
@ActiveProfiles("dev")
@Transactional
public @interface TransactionalDevTestConfig { }@Target(AnnotationTarget.TYPE)
@Retention(AnnotationRetention.RUNTIME)
@ContextConfiguration("/app-config.xml", "/test-data-access-config.xml")
@ActiveProfiles("dev")
@Transactional
annotation class TransactionalDevTestConfig { }然后我们可以使用我们的自定义@TransactionalDevTestConfig注解来简化
配置基于 JUnit 4 的各个测试类，如下所示：
-
Java
-
Kotlin
@RunWith(SpringRunner.class)
@TransactionalDevTestConfig
public class OrderRepositoryTests { }
@RunWith(SpringRunner.class)
@TransactionalDevTestConfig
public class UserRepositoryTests { }@RunWith(SpringRunner::class)
@TransactionalDevTestConfig
class OrderRepositoryTests
@RunWith(SpringRunner::class)
@TransactionalDevTestConfig
class UserRepositoryTests如果我们编写使用 JUnit Jupiter 的测试，我们可以进一步减少代码重复。 因为 JUnit 5 中的注解也可以用作元注解。请考虑以下 例：
-
Java
-
Kotlin
@ExtendWith(SpringExtension.class)
@ContextConfiguration({"/app-config.xml", "/test-data-access-config.xml"})
@ActiveProfiles("dev")
@Transactional
class OrderRepositoryTests { }
@ExtendWith(SpringExtension.class)
@ContextConfiguration({"/app-config.xml", "/test-data-access-config.xml"})
@ActiveProfiles("dev")
@Transactional
class UserRepositoryTests { }@ExtendWith(SpringExtension::class)
@ContextConfiguration("/app-config.xml", "/test-data-access-config.xml")
@ActiveProfiles("dev")
@Transactional
class OrderRepositoryTests { }
@ExtendWith(SpringExtension::class)
@ContextConfiguration("/app-config.xml", "/test-data-access-config.xml")
@ActiveProfiles("dev")
@Transactional
class UserRepositoryTests { }如果我们发现我们在 JUnit 中重复上述配置 基于 Jupiter 的测试套件，我们可以通过引入自定义组合的 注解集中了 Spring 和 JUnit Jupiter 的通用测试配置， 如下：
-
Java
-
Kotlin
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@ExtendWith(SpringExtension.class)
@ContextConfiguration({"/app-config.xml", "/test-data-access-config.xml"})
@ActiveProfiles("dev")
@Transactional
public @interface TransactionalDevTestConfig { }@Target(AnnotationTarget.TYPE)
@Retention(AnnotationRetention.RUNTIME)
@ExtendWith(SpringExtension::class)
@ContextConfiguration("/app-config.xml", "/test-data-access-config.xml")
@ActiveProfiles("dev")
@Transactional
annotation class TransactionalDevTestConfig { }然后我们可以使用我们的自定义@TransactionalDevTestConfig注解来简化
配置基于 JUnit Jupiter 的各个测试类，如下所示：
-
Java
-
Kotlin
@TransactionalDevTestConfig
class OrderRepositoryTests { }
@TransactionalDevTestConfig
class UserRepositoryTests { }@TransactionalDevTestConfig
class OrderRepositoryTests { }
@TransactionalDevTestConfig
class UserRepositoryTests { }由于 JUnit Jupiter 支持使用@Test,@RepeatedTest,ParameterizedTest,
和其他作为元注释的注释，您还可以在
测试方法级别。例如，如果我们希望创建一个组合
这@Test和@Tag来自 JUnit Jupiter 的注释，带有@Transactional注解，我们可以创建一个@TransactionalIntegrationTestannotation 中，作为
遵循：
-
Java
-
Kotlin
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Transactional
@Tag("integration-test") // org.junit.jupiter.api.Tag
@Test // org.junit.jupiter.api.Test
public @interface TransactionalIntegrationTest { }@Target(AnnotationTarget.TYPE)
@Retention(AnnotationRetention.RUNTIME)
@Transactional
@Tag("integration-test") // org.junit.jupiter.api.Tag
@Test // org.junit.jupiter.api.Test
annotation class TransactionalIntegrationTest { }然后我们可以使用我们的自定义@TransactionalIntegrationTest注解来简化
配置基于 JUnit Jupiter 的各个测试方法，如下所示：
-
Java
-
Kotlin
@TransactionalIntegrationTest
void saveOrder() { }
@TransactionalIntegrationTest
void deleteOrder() { }@TransactionalIntegrationTest
fun saveOrder() { }
@TransactionalIntegrationTest
fun deleteOrder() { }有关更多详细信息，请参阅 Spring Annotation Programming Model wiki 页面。