junit

适用场景

当用户希望执行以下操作时，请使用此技能：

• 使用 JUnit 4 或 JUnit 5（Jupiter）编写 Java 或 Kotlin 单元测试
• 使用注解（@Test、@BeforeEach、@AfterEach、@ParameterizedTest）
• 使用断言（assertEquals、assertThrows、assertAll）
• 集成 Mockito 或 AssertJ，以进行模拟和流畅断言
• 使用 Maven Surefire 或 Gradle 配置测试执行

如何使用此技能

工作流

1. 编写带有 @Test 注解的测试类和方法
2. 使用生命周期注解设置和清理测试状态
3. 使用断言验证预期行为
4. 使用 Mockito 模拟依赖项，以隔离单元测试

1. JUnit 5 基本测试

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class CalculatorTest {
    @Test
    void shouldAddTwoNumbers() {
        Calculator calc = new Calculator();
        assertEquals(5, calc.add(2, 3));
    }

    @Test
    void shouldThrowOnDivideByZero() {
        Calculator calc = new Calculator();
        assertThrows(ArithmeticException.class, () -> calc.divide(1, 0));
    }
}

2. 生命周期注解

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.AfterEach;

class UserServiceTest {
    private UserService userService;

    @BeforeEach
    void setUp() {
        userService = new UserService(new InMemoryUserRepository());
    }

    @AfterEach
    void tearDown() {
        // Clean up resources
    }
}

3. 参数化测试

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;

class StringTest {
    @ParameterizedTest
    @CsvSource({"hello,5", "'',0", "junit,5"})
    void shouldReturnCorrectLength(String input, int expected) {
        assertEquals(expected, input.length());
    }
}

4. 使用 Mockito 进行模拟

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import static org.mockito.Mockito.*;

@ExtendWith(MockitoExtension.class)
class OrderServiceTest {
    @Mock private OrderRepository orderRepository;
    @InjectMocks private OrderService orderService;

    @Test
    void shouldSaveOrder() {
        Order order = new Order("item-1", 2);
        orderService.placeOrder(order);
        verify(orderRepository).save(order);
    }
}

5. 运行测试

# Maven
mvn test

# Gradle
gradle test

# With coverage (JaCoCo)
mvn test jacoco:report

最佳实践

• 保持测试独立且可重复；避免依赖执行顺序或外部服务
• 使用 Mockito 将被测单元与其依赖项隔离
• 使用描述性名称命名测试（例如，shouldReturnEmptyListWhenNoUsersExist）
• 平衡测试覆盖率与速度；在 CI 中运行完整测试套件
• 使用 @Nested 类对相关测试用例进行分组

资源

• JUnit 5 用户指南：https://junit.org/junit5/docs/current/user-guide/
• Mockito：https://site.mockito.org/
• AssertJ：https://assertj.github.io/doc/

关键词

junit、JUnit 5、JUnit Jupiter、单元测试、Java、Kotlin、断言、Mockito、参数化测试、BeforeEach、AfterEach、测试生命周期