Spring JUnit 4 测试注解

@IfProfileValue

@IfProfileValue 指示注释的测试是否为特定测试环境启用。如果配置的 ProfileValueSource 为提供的 name 返回匹配的 value，则启用测试。否则，测试将被禁用，实际上会被忽略。

您可以将 @IfProfileValue 应用于类级别、方法级别或两者。对于该类或其子类中的任何方法，@IfProfileValue 的类级别使用优先于方法级别使用。具体来说，如果测试在类级别和方法级别都被启用，则启用测试。没有 @IfProfileValue 意味着测试隐式启用。这类似于 JUnit 4 的 @Ignore 注释的语义，只是 @Ignore 的存在始终会禁用测试。

以下示例显示了一个带有 @IfProfileValue 注释的测试

  • Java

  • Kotlin

@IfProfileValue(name="java.vendor", value="Oracle Corporation") (1)
@Test
public void testProcessWhichRunsOnlyOnOracleJvm() {
	// some logic that should run only on Java VMs from Oracle Corporation
}
1 仅当 Java 供应商为“Oracle Corporation”时才运行此测试。 
@IfProfileValue(name="java.vendor", value="Oracle Corporation") (1)
@Test
fun testProcessWhichRunsOnlyOnOracleJvm() {
	// some logic that should run only on Java VMs from Oracle Corporation
}
1 仅当 Java 供应商为“Oracle Corporation”时才运行此测试。

或者，您可以使用 values 列表（使用 OR 语义）配置 @IfProfileValue，以在 JUnit 4 环境中实现类似 TestNG 的测试组支持。请考虑以下示例

  • Java

  • Kotlin

@IfProfileValue(name="test-groups", values={"unit-tests", "integration-tests"}) (1)
@Test
public void testProcessWhichRunsForUnitOrIntegrationTestGroups() {
	// some logic that should run only for unit and integration test groups
}
1 针对单元测试和集成测试运行此测试。 
@IfProfileValue(name="test-groups", values=["unit-tests", "integration-tests"]) (1)
@Test
fun testProcessWhichRunsForUnitOrIntegrationTestGroups() {
	// some logic that should run only for unit and integration test groups
}
1 针对单元测试和集成测试运行此测试。

@ProfileValueSourceConfiguration

@ProfileValueSourceConfiguration 是一个类级别注释，它指定在检索通过 @IfProfileValue 注释配置的配置文件值时使用哪种类型的 ProfileValueSource。如果未为测试声明 @ProfileValueSourceConfiguration，则默认情况下使用 SystemProfileValueSource。以下示例显示了如何使用 @ProfileValueSourceConfiguration

  • Java

  • Kotlin

@ProfileValueSourceConfiguration(CustomProfileValueSource.class) (1)
public class CustomProfileValueSourceTests {
	// class body...
}
1 使用自定义配置文件值源。 
@ProfileValueSourceConfiguration(CustomProfileValueSource::class) (1)
class CustomProfileValueSourceTests {
	// class body...
}
1 使用自定义配置文件值源。

@Timed

@Timed 指示注释的测试方法必须在指定的时间段内（以毫秒为单位）完成执行。如果文本执行时间超过指定的时间段，则测试失败。

时间段包括运行测试方法本身、测试的任何重复（参见 @Repeat），以及测试夹具的任何设置或拆卸。以下示例显示了如何使用它

  • Java

  • Kotlin

@Timed(millis = 1000) (1)
public void testProcessWithOneSecondTimeout() {
	// some logic that should not take longer than 1 second to run
}
1 将测试的时间段设置为一秒。 
@Timed(millis = 1000) (1)
fun testProcessWithOneSecondTimeout() {
	// some logic that should not take longer than 1 second to run
}
1 将测试的时间段设置为一秒。

Spring 的 @Timed 注解与 JUnit 4 的 @Test(timeout=…​) 支持具有不同的语义。具体来说，由于 JUnit 4 处理测试执行超时的方式（即在单独的 Thread 中执行测试方法），@Test(timeout=…​) 会在测试花费太长时间时抢先使测试失败。另一方面，Spring 的 @Timed 不会抢先使测试失败，而是等到测试完成后再失败。

@Repeat

@Repeat 表示要重复运行带注释的测试方法。要在注释中指定要运行测试方法的次数。

要重复执行的范围包括执行测试方法本身以及任何设置或拆卸测试夹具。当与 SpringMethodRule 一起使用时，该范围还包括通过 TestExecutionListener 实现来准备测试实例。以下示例展示了如何使用 @Repeat 注解

  • Java

  • Kotlin

@Repeat(10) (1)
@Test
public void testProcessRepeatedly() {
	// ...
}
1 重复此测试十次。 
@Repeat(10) (1)
@Test
fun testProcessRepeatedly() {
	// ...
}
1 重复此测试十次。