junit 5 是 java 单元测试的主流框架，升级和使用它能提升代码质量。1. 添加 junit 5 依赖：maven 或 gradle 项目分别配置对应依赖，确保使用最新版本（如 5.11.0）。2. 编写测试类：使用 @test、@beforeeach、@aftereach 等注解定义测试逻辑，并用 assertequals 等方法进行断言。3. 使用 mockito 模拟依赖：引入 mockito 依赖后，通过 mock() 和 when(...).thenreturn(...) 构建模拟对象以隔离外部服务。4. 注意事项：命名清晰、避免测试私有方法、不重复测试逻辑、利用参数化测试提高效率。合理结合断言、生命周期管理和 mock 工具，才能充分发挥单元测试的作用。
在Java开发中，单元测试是确保代码质量的重要手段。JUnit 5 是目前最主流的单元测试框架之一，它不仅支持函数式编程风格，还引入了更灵活的扩展机制。如果你还在用老版本的 JUnit 或者还没开始写单元测试，现在正是升级和入手的好时机。
1. 添加JUnit 5依赖
在开始写测试之前，首先要确保你的项目里已经引入了JUnit 5的依赖。如果你使用的是Maven项目，可以在pom.xml中添加如下内容：
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<version>5.11.0</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-engine</artifactId>
<version>5.11.0</version>
<scope>test</scope>
</dependency>如果你使用Gradle，则可以这样添加：
立即学习“Java免费学习笔记（深入）”；
testImplementation 'org.junit.jupiter:junit-jupiter:5.11.0'
注意：确保你使用的是最新版本（当前为5.11.0），以获得最新的特性和改进。
2. 编写第一个测试类
JUnit 5 使用注解来标识测试方法和生命周期行为。以下是一个简单的示例：
import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;
class CalculatorTest {
@Test
void add_TwoPositiveNumbers_ReturnsSum() {
Calculator calculator = new Calculator();
int result = calculator.add(2, 3);
assertEquals(5, result, "2 + 3 should equal 5");
}
}说明：
-
@Test注解标记这是一个测试方法。 -
assertEquals()是常用的断言方法，用于验证预期值与实际结果是否一致。 - 可以加上可选的失败提示信息，帮助快速定位问题。
除了 @Test，还有几个常用注解：
-
@BeforeEach/@AfterEach：每个测试方法执行前后运行。 -
@BeforeAll/@AfterAll：整个测试类执行前后运行（必须是静态方法）。
3. 使用Mockito进行模拟测试
当你的测试对象依赖外部服务或复杂对象时，可以使用 Mockito 来创建“假”的依赖对象。
首先添加Mockito依赖：
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<version>5.7.0</version>
<scope>test</scope>
</dependency>然后你可以这样使用：
import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;
@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class OrderServiceTest {
private OrderRepository orderRepository = mock(OrderRepository.class);
private OrderService orderService = new OrderService(orderRepository);
@Test
void placeOrder_ShouldReturnTrue_WhenOrderSaved() {
when(orderRepository.save(any(Order.class))).thenReturn(true);
boolean result = orderService.placeOrder(new Order());
assertTrue(result);
}
}要点：
- 使用
mock()创建一个虚拟的对象。 - 使用
when(...).thenReturn(...)定义其行为。 - 这样就可以在不调用真实数据库或网络请求的情况下完成测试。
4. 常见注意事项和技巧
-
测试命名要清晰：比如
methodName_condition_expectedBehavior，例如add_negativeNumber_throwsException。 - 不要测试私有方法：只关注公共API的行为，私有方法的变化不应影响测试逻辑。
- 避免重复测试逻辑：一个测试方法只验证一个行为，便于定位问题。
-
利用参数化测试：JUnit 5 支持
@ParameterizedTest，可以对多个输入进行批量测试。
基本上就这些。JUnit 5 的用法虽然看起来简单，但在实际项目中结合好断言、生命周期管理和Mock工具，才能真正发挥出单元测试的价值。
