JUnit Jupiter (Aggregator) Java类库框架解析
JUnit Jupiter (Aggregator) 是一个用于编写和执行 Java 单元测试的框架，它是 JUnit 5 的一部分。这个框架提供了一系列的注解和类，用来管理测试套件和测试用例。它的特点是灵活、易于扩展和自定义，并且提供了许多新的特性，以辅助开发人员编写更整洁、可读性更强的单元测试代码。
JUnit Jupiter 的核心组件是 Aggregator（聚合器），它是一个注解接口，可以用于将多个测试类或测试方法归为一组，以便一起执行。Aggregator 由 @AggregateWith 注解标记在测试类或测试方法上，通过指定一个 Aggregator 类型的参数，来指定要使用的具体聚合器实现。
下面是一个示例，演示了如何使用 JUnit Jupiter 的 Aggregator 来组织测试套件：
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.junit.jupiter.api.extension.ExtensionContext;
import org.junit.jupiter.api.extension.TestTemplateInvocationContext;
import org.junit.jupiter.api.extension.TestTemplateInvocationContextProvider;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Stream;
import static org.junit.jupiter.api.Assertions.assertEquals;
@ExtendWith(TestAggregatorProvider.class)
class AggregatorExampleTest {
@TestTemplate
@ExtendWith(TestAggregatorExtension.class)
void aggregateTest(int input1, int input2, int expectedOutput) {
assertEquals(expectedOutput, input1 + input2);
}
static class TestAggregatorProvider implements TestTemplateInvocationContextProvider {
@Override
public boolean supportsTestTemplate(ExtensionContext context) {
return true;
}
@Override
public Stream<TestTemplateInvocationContext> provideTestTemplateInvocationContexts(ExtensionContext context) {
List<Object[]> testCases = Arrays.asList(
new Object[]{1, 2, 3},
new Object[]{2, 3, 5},
new Object[]{4, 5, 9}
);
return testCases.stream().map(inputs -> TestTemplateInvocationContext.of(inputs, this::getDisplayName));
}
private String getDisplayName(ExtensionContext context, Object[] inputs) {
return String.format("Test with inputs: %d, %d", inputs[0], inputs[1]);
}
}
static class TestAggregatorExtension implements AfterTestExecutionCallback {
@Override
public void afterTestExecution(ExtensionContext context) throws Exception {
int input1 = (int) context.getTestMethod().get().getInvocation().get().getArguments().get()[0];
int input2 = (int) context.getTestMethod().get().getInvocation().get().getArguments().get()[1];
int expectedOutput = (int) context.getTestMethod().get().getInvocation().get().getArguments().get()[2];
int actualOutput = (int) context.getExecutionException().get().getWrappedThrowable().get().getMessage();
assertEquals(expectedOutput, actualOutput);
}
}
}
在上述示例中，我们定义了一个 `aggregateTest` 方法，并将其标记为 `@TestTemplate` 和 `@ExtendWith(TestAggregatorExtension.class)`。`aggregateTest` 方法接受三个参数，分别为 `input1`、`input2` 和 `expectedOutput`。该方法会对这两个输入进行加法运算，并断言结果是否等于预期输出。
为了提供测试数据和测试方法的组合，我们实现了一个 `TestAggregatorProvider` 类，并实现了 `TestTemplateInvocationContextProvider` 接口。在 `provideTestTemplateInvocationContexts` 方法中，我们定义了三个测试用例，并使用 `TestTemplateInvocationContext.of` 创建相应的测试上下文。
我们还定义了一个 `TestAggregatorExtension` 类，并实现了 `AfterTestExecutionCallback` 接口。在 `afterTestExecution` 方法中，我们获取了测试方法的输入参数和预期输出，以及实际输出，并进行断言验证。
这是一个简单示例，展示了如何使用 JUnit Jupiter（Aggregator）来组织和执行测试套件。你可以根据自己的需求扩展和定制这个框架，以便更好地满足你的测试需求。
