时间:2025-06-19 23:13
人气:
作者:admin
@DisplayName("用户服务测试")
class UserServiceTest {
@Test
@DisplayName("根据ID获取用户 - 当ID无效时抛出异常")
void testGetUserByIdWithInvalidId() {
// 测试逻辑
}
@Test
@DisplayName("创建用户 - 成功场景 ✅")
void testCreateUserSuccessfully() {
// 测试逻辑
}
}
在IDE或构建工具生成的测试报告中,你会看到更具描述性的测试名称,而不是原始的方法名。这对于大型项目中的测试维护特别有帮助,新成员可以快速理解每个测试的意图。
@DisplayName("订单服务测试")
class OrderServiceTest {
@Nested
@DisplayName("创建订单")
class CreateOrder {
@Test
@DisplayName("当库存充足时 - 成功创建订单")
void whenStockSufficient_thenCreateOrderSuccessfully() {
// 测试逻辑
}
@Test
@DisplayName("当库存不足时 - 抛出异常")
void whenStockInsufficient_thenThrowException() {
// 测试逻辑
}
}
@Nested
@DisplayName("取消订单")
class CancelOrder {
@Test
@DisplayName("当订单状态为新订单时 - 成功取消")
void whenOrderStatusIsNew_thenCancelSuccessfully() {
// 测试逻辑
}
@Test
@DisplayName("当订单状态为已发货时 - 不允许取消")
void whenOrderStatusIsShipped_thenNotAllowCancel() {
// 测试逻辑
}
}
}
这种嵌套结构清晰地表达了测试的组织逻辑,每个嵌套类代表一个功能点,每个测试方法代表该功能下的一个具体场景。
@DisplayName("随机数生成测试")
class RandomNumberTest {
@RepeatedTest(value = 100, name = "第{currentRepetition}次测试,共{totalRepetitions}次")
@DisplayName("验证随机数在合理范围内")
void testRandomNumberInRange(RepetitionInfo repetitionInfo) {
int random = RandomUtils.nextInt(1, 101);
assertTrue(random >= 1 && random <= 100,
() -> "第"repetitionInfo.getCurrentRepetition() + "次测试失败: "random);
}
}
这个测试会运行100次,每次都会生成一个1-100的随机数并验证其范围。如果任何一次测试失败,报告中会明确指出是哪一次运行失败。@RepeatedTest支持以下配置:
@ParameterizedTest
@ValueSource(ints = {1, 3, 5, -3, 15})
@DisplayName("测试奇数验证")
void testIsOdd(int number) {
assertTrue(MathUtils.isOdd(number),
() -> number + " 应被识别为奇数");
}
@ParameterizedTest
@ValueSource(strings = {"racecar", "radar", "madam"})
@DisplayName("回文字符串验证")
void testPalindrome(String candidate) {
assertTrue(StringUtils.isPalindrome(candidate));
}
@ParameterizedTest
@ValueSource(doubles = {1.5, 2.0, 3.8})
@DisplayName("双精度数验证")
void testDouble(double num) {
assertTrue(num > 1.0);
}
enum Status {
NEW, PROCESSING, COMPLETED, CANCELLED
}
@ParameterizedTest
@EnumSource(Status.class)
@DisplayName("测试所有状态转换")
void testStatusTransition(Status status) {
assertDoesNotThrow(() -> OrderService.transitionStatus(status));
}
// 测试枚举子集
@ParameterizedTest
@EnumSource(value = Status.class, names = {"NEW", "PROCESSING"})
@DisplayName("测试可编辑状态")
void testEditableStatus(Status status) {
assertTrue(OrderService.isEditable(status));
}
// 模式匹配排除枚举值
@ParameterizedTest
@EnumSource(value = Status.class, mode = EXCLUDE, names = {"CANCELLED"})
@DisplayName("测试非取消状态")
void testNonCancelledStatus(Status status) {
assertNotEquals("CANCELLED", status.name());
}
@ParameterizedTest
@NullSource
@DisplayName("测试处理null输入")
void testWithNullInput(String input) {
assertThrows(IllegalArgumentException.class,
() -> StringUtils.calculateLength(input));
}
@ParameterizedTest
@EmptySource
@DisplayName("测试处理空字符串")
void testWithEmptyString(String input) {
assertEquals(0, StringUtils.calculateLength(input));
}
// 组合使用
@ParameterizedTest
@NullAndEmptySource
@DisplayName("测试处理null和空字符串")
void testWithNullAndEmpty(String input) {
assertTrue(input == null || input.isEmpty());
}
@ParameterizedTest
@CsvSource({
"1, 1, 2", // 正常加法
"2, 3, 5", // 正常加法
"10, -5, 5", // 正负相加
"0, 0, 0" // 零值相加
})
@DisplayName("加法运算测试")
void testAdd(int a, int b, int expected) {
assertEquals(expected, MathUtils.add(a, b),
() -> String.format("%d + %d 应等于 %d", a, b, expected));
}
// 支持不同类型参数
@ParameterizedTest
@CsvSource({
"apple, 1",
"banana, 2",
"'', 0"
})
@DisplayName("字符串长度测试")
void testStringLength(String input, int expected) {
assertEquals(expected, input.length());
}
// 使用特殊分隔符
@ParameterizedTest
@CsvSource(delimiter = '|', value = {
"John Doe | 30 | true",
"Alice | 25 | false"
})
@DisplayName("用户验证测试")
void testUserValidation(String name, int age, boolean isAdult) {
assertEquals(isAdult, age >= 18);
}
addend1,addend2,sum
1,1,2
2,3,5
-5,5,0
1000000,1000000,2000000
@ParameterizedTest
@CsvFileSource(resources = "/test-data/add_test_cases.csv", numLinesToSkip = 1)
@DisplayName("CSV文件数据驱动加法测试")
void testAddWithCsvFile(int addend1, int addend2, int sum) {
assertEquals(sum, Calculator.add(addend1, addend2),
() -> String.format("%d + %d 应等于 %d", addend1, addend2, sum));
}
// 使用不同分隔符的CSV文件
@ParameterizedTest
@CsvFileSource(resources = "/test-data/user_test_cases.tsv", delimiter = '\t')
void testUserImport(String username, String email, boolean expectedValid) {
assertEquals(expectedValid, UserValidator.isValid(username, email));
}
@ParameterizedTest
@MethodSource("stringProvider")
@DisplayName("字符串长度验证")
void testLength(String input, int expectedLength) {
assertEquals(expectedLength, input.length(),
() -> "'"input + "' 的长度应为 "expectedLength);
}
// 基础数据提供方法
static Stream<Arguments> stringProvider() {
return Stream.of(
Arguments.of("hello", 5),
Arguments.of("world", 5),
Arguments.of("", 0),
Arguments.of(" ", 2)
);
}
// 复杂对象测试
@ParameterizedTest
@MethodSource("userProvider")
@DisplayName("用户年龄验证")
void testUserAge(User user, boolean expected) {
assertEquals(expected, user.isAdult());
}
static Stream<Arguments> userProvider() {
return Stream.of(
Arguments.of(new User("Alice", 25), true),
Arguments.of(new User("Bob", 17), false),
Arguments.of(new User("Charlie", 18), true)
);
}
// 多参数组合测试
@ParameterizedTest
@MethodSource("rangeProvider")
@DisplayName("数字范围验证")
void testInRange(int number, int min, int max, boolean expected) {
assertEquals(expected, MathUtils.isInRange(number, min, max));
}
static Stream<Arguments> rangeProvider() {
return Stream.of(
Arguments.of(5, 1, 10, true),
Arguments.of(15, 1, 10, false),
Arguments.of(0, 0, 0, true)
);
}
@ParameterizedTest
@NullAndEmptySource
@ValueSource(strings = {" ", "\t", "\n"})
@DisplayName("测试各种空白输入")
void testBlankInputs(String input) {
assertTrue(StringUtils.isBlank(input));
}
@ParameterizedTest
@EnumSource(TimeUnit.class)
@ValueSource(ints = {1, 5, 10})
@DisplayName("测试时间单位转换")
void testTimeUnitConversion(TimeUnit unit, int value) {
assertNotNull(unit.toMillis(value));
}
| 数据源 | 适用场景 | 优点 | 缺点 |
| @ValueSource | 基本数据类型简单测试 | 使用简单 | 不支持复杂对象 |
| @EnumSource | 枚举值测试 | 自动生成所有枚举用例 | 仅适用于枚举 |
| @CsvSource | 结构化多参数测试 | 可读性好 | 维护大量数据时代码臃肿 |
| @CsvFileSource | 大量测试数据 | 数据与代码分离 | 需要维护外部文件 |
| @MethodSource | 需要动态生成或复杂对象的测试 | 最灵活,支持任意数据类型 | 需要额外编写提供方法 |
@ParameterizedTest
@ArgumentsSource(MyArgumentsProvider.class)
void testWithArgumentsSource(String argument) {
assertNotNull(argument);
}
static class MyArgumentsProvider implements ArgumentsProvider {
@Override
public Stream<? extends Arguments> provideArguments(ExtensionContext context) {
return Stream.of("apple", "banana").map(Arguments::of);
}
}
另可参考博客:https://www.baeldung.com/parameterized-tests-junit-5
@Test
@EnabledOnOs(OS.LINUX)
void onlyOnLinux() {
// 只在Linux系统上运行
}
@Test
@DisabledOnJre(JRE.JAVA_8)
void notOnJava8() {
// 不在Java 8上运行
}
@Test
@EnabledIfSystemProperty(named = "os.arch", matches = ".*64.*")
void onlyOn64BitArchitecture() {
// 只在64位架构上运行
}
@Test
@EnabledIfEnvironmentVariable(named = "ENV", matches = "ci")
void onlyOnCiServer() {
// 只在CI服务器上运行
}
@Test
@EnabledIf("customCondition")
void onlyIfCustomCondition() {
// 只在自定义条件满足时运行
}
boolean customCondition() {
return // 自定义条件逻辑;
}
@Test
@EnabledForTenant("tenantA")
void testFeatureForTenantA() {
// 只对租户A运行的测试
}
@Test
@EnabledForTenant({"tenantA", "tenantB"})
void testFeatureForMultipleTenants() {
// 对租户A和B运行的测试
}
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@ExtendWith(EnabledForTenantCondition.class)
public @interface EnabledForTenant {
String[] value();
}
public class EnabledForTenantCondition implements ExecutionCondition {
@Override
public ConditionEvaluationResult evaluateExecutionCondition(ExtensionContext context) {
Optional<EnabledForTenant> annotation = context.getElement()
.map(e -> e.getAnnotation(EnabledForTenant.class));
if (annotation.isPresent()) {
String currentTenant = System.getProperty("tenant");
if (Arrays.asList(annotation.get().value()).contains(currentTenant)) {
return ConditionEvaluationResult.enabled("租户匹配");
}
return ConditionEvaluationResult.disabled("当前租户不匹配");
}
return ConditionEvaluationResult.enabled("无租户限制");
}
}
@Test
void testComplexObject() {
ComplexObject obj = service.createComplexObject();
assertNotNull(obj, () -> "创建的对象不应为null");
assertEquals("expected", obj.getValue(),
() -> String.format("对象值不匹配,实际值:%s", obj.getValue()));
}
异常断言:
@Test
void testException() {
Executable executable = () -> service.methodThatShouldThrow();
assertThrows(ExpectedException.class, executable,
() -> "方法应抛出ExpectedException");
}
集合断言:
@Test
void testCollection() {
List<String> result = service.getItems();
assertAll("集合验证",
() -> assertFalse(result.isEmpty(), "集合不应为空"),
() -> assertTrue(result.contains("expected"), "应包含'expected'"),
() -> assertEquals(3, result.size(), "集合大小应为3")
);
}
@TestFactory
Stream<DynamicTest> databaseRecordTests() {
// 从数据库动态获取测试数据
List<Product> products = productRepository.findAllActive();
return products.stream()
.map(product -> dynamicTest(
"测试产品ID: "product.getId(),
() -> {
assertNotNull(product.getName());
assertTrue(product.getPrice() > 0);
assertFalse(product.isExpired());
}
));
}
@TestFactory
Stream<DynamicTest> crossBrowserTests() {
List<String> browsers = Arrays.asList("Chrome", "Firefox", "Safari");
List<String> osList = Arrays.asList("Windows", "macOS", "Linux");
List<String> resolutions = Arrays.asList("1920x1080", "1366x768", "800x600");
return browsers.stream()
.flatMap(browser -> osList.stream()
.flatMap(os -> resolutions.stream()
.map(res -> dynamicTest(
browser + " on "os + " @"res,
() -> testCompatibility(browser, os, res)
))
)
);
}
@TestFactory
Stream<DynamicTest> environmentSpecificTests() {
Stream.Builder<DynamicTest> builder = Stream.builder();
// 基础测试(所有环境都执行)
builder.add(dynamicTest("基本功能测试", this::testBasicFunctionality));
// 仅预发布环境执行的测试
if ("pre".equals(System.getenv("APP_ENV"))) {
builder.add(dynamicTest("预发布环境专有测试", this::testProductionFeature));
}
// 当有GPU时才执行的测试
if (GraphicsEnvironment.isHeadless()) {
builder.add(dynamicTest("GPU加速测试", this::testGpuAcceleration));
}
return builder.build();
}
@TestFactory
Stream<DynamicTest> performanceBenchmarks() {
intloadLevels = {100, 1000, 5000, 10000};
return Arrays.stream(loadLevels)
.mapToObj(load -> dynamicTest(
load + "并发请求负载测试",
() -> {
long startTime = System.nanoTime();
simulateLoad(load);
long duration = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startTime);
assertTrue(duration < getThresholdFor(load),
() -> String.format("%d请求耗时%dms超过阈值", load, duration));
}
));
}
@TestFactory
Stream<DynamicNode> hierarchicalAPITests() {
return Stream.of(
DynamicContainer.dynamicContainer("用户API",
Stream.of(
dynamicTest("创建用户", this::testUserCreation),
dynamicTest("查询用户", this::testUserQuery)
)),
DynamicContainer.dynamicContainer("订单API",
Stream.of(
dynamicTest("创建订单", this::testOrderCreation),
DynamicContainer.dynamicContainer("支付流程",
Stream.of(
dynamicTest("支付请求", this::testPaymentRequest),
dynamicTest("支付回调", this::testPaymentCallback)
)
)
))
);
}
@TestFactory
Stream<DynamicTest> employeeWorkflowTests() {
// 测试数据准备
List<Employee> employees = Arrays.asList(
new Employee(1, "Fred"), // 有firstName的员工
new Employee(2), // 无firstName的员工(测试边界条件)
new Employee(3, "John") // 有firstName的员工
);
EmployeeService service = new EmployeeService();
// 测试流1:测试基础保存功能(所有员工)
Stream<DynamicTest> basicSaveTests = employees.stream()
.map(emp -> dynamicTest(
"基础保存-员工ID: "emp.getId(),
() -> {
Employee saved = service.save(emp.getId());
assertEquals(emp.getId(), saved.getId());
}
));
// 测试流2:测试带名称的保存功能(仅过滤有firstName的员工)
Stream<DynamicTest> namedSaveTests = employees.stream()
.filter(emp -> emp.getFirstName() != null && !emp.getFirstName().isEmpty())
.map(emp -> dynamicTest(
"带名称保存-"emp.getFirstName(),
() -> {
Employee saved = service.save(emp.getId(), emp.getFirstName());
assertEquals(emp.getId(), saved.getId());
assertEquals(emp.getFirstName(), saved.getFirstName());
}
));
// 合并两个测试流
return Stream.concat(basicSaveTests, namedSaveTests);
}
Stream<DynamicTest> // 最常用的流式处理
Collection<DynamicTest> // 基础集合类型
Iterable<DynamicTest> // 可迭代接口
Iterator<DynamicTest> // 迭代器实现
@BeforeEach // 每个动态测试前不会执行
@AfterEach // 每个动态测试后不会执行
dynamicTest("自定义生命周期", () -> {
// 初始化代码
try {
// 测试逻辑
} finally {
// 清理代码
}
})
| 特性 | 动态测试 | 静态测试 (@Test) |
| 生成时机 | 运行时动态生成 | 编译时静态定义 |
| 用例独立性 | 每个测试完全独立 | 共享相同测试方法体 |
| 组织结构 | 支持嵌套容器复杂结构 | 仅支持平面结构 |
| 生命周期支持 | 无自动回调 | 完整生命周期支持 |
| 数据驱动方式 | 完全自由的数据生成 | 通过参数化注解限定 |