JUnit – API

JUnit 5（也称为JUnit Jupiter）的API提供了一套丰富的注解、断言和扩展机制来支持单元测试的编写和执行。以下是JUnit 5中一些核心API组件的简要概述：

1. 注解（Annotations）

• @Test: 用于标记一个公共的无返回值、无参数的方法作为测试案例。
• @BeforeEach: 指定一个方法在每个测试方法执行前运行，用于设置测试的预条件。
• @AfterEach: 指定一个方法在每个测试方法执行后运行，用于清理工作。
• @BeforeAll: 用于标记一个静态方法，在所有测试方法执行前只运行一次，用于全局的初始化。
• @AfterAll: 用于标记一个静态方法，在所有测试方法执行后只运行一次，用于最终的清理工作。
• @DisplayName: 提供一个可读性更强的名称给测试类或测试方法。
• @Disabled: 临时禁用一个测试类或测试方法。
• @RepeatedTest: 用于执行指定次数的重复测试。
• @ParameterizedTest: 支持参数化的测试方法，可以使用不同的参数多次运行同一个测试。

2. 断言（Assertions）

JUnit 5 提供了org.junit.jupiter.api.Assertions类，其中包含多种断言方法来验证预期结果。一些常用的断言方法包括：

• assertEquals(expected, actual): 验证两个值是否相等。
• assertTrue(condition): 验证条件是否为真。
• assertFalse(condition): 验证条件是否为假。
• assertNull(object) 和 assertNotNull(object): 分别验证对象是否为null或非null。
• assertArrayEquals(expecteds, actuals): 验证两个数组是否相等。
• assertThrows(expected, executable): 验证执行某个代码块时是否抛出预期的异常。

3. 假设（Assumptions）

org.junit.jupiter.api.Assumptions 类提供了假设方法，用于基于某些条件决定是否执行测试代码。例如，assumeTrue(condition) 和 assumeFalse(condition) 可以根据条件跳过测试。

4. 扩展模型（Extensions）

JUnit 5 引入了一个强大的扩展模型，允许用户通过编写自定义扩展来增强测试功能。扩展可以监听测试生命周期事件、提供自定义断言或条件测试执行等。

• @ExtendWith: 注解用于指定一个或多个扩展类，这些扩展将在测试执行期间发挥作用。
• TestExtension: 开发者可以实现自定义扩展，继承或实现JUnit提供的接口和类，如ExecutionCondition, BeforeEachCallback, AfterEachCallback等。

5. 参数化测试

使用@ParameterizedTest和相应的参数源注解（如@ValueSource, @CsvSource, @MethodSource等）来实现参数化测试，这使得单个测试方法能以不同的参数集合多次执行。

6. 动态测试

JUnit 5 还允许动态生成测试案例，通过TestFactory注解标记的方法可以返回一个流或数组形式的DynamicTest对象集合。

7. 平台启动器API（JUnit Platform Launcher API）

虽然不是直接用于编写测试，但JUnit Platform Launcher API 提供了控制测试发现和执行的机制，这对于集成JUnit到构建工具和IDE非常重要。

这些API的使用结合在一起，使得JUnit 5成为一个强大而灵活的测试框架，适应各种复杂的测试需求。