Java中如何用JUnit 5编写测试用例-Java-PHP中文网

Java中如何用JUnit 5编写测试用例

尼克

发布： 2025-06-19 23:42:02

原创

433人浏览过

junit 5通过模块化设计、参数化测试和扩展模型提供灵活强大的java测试方案。1. 引入junit jupiter依赖以启动测试；2. 使用@test、@beforeeach等注解编写基础测试用例；3. 利用@parameterizedtest结合@valuesource或@csvsource实现参数化测试；4. 通过实现扩展接口（如beforeeachcallback）并使用@extendwith注册自定义扩展；5. 迁移时移除junit 4依赖，替换为junit jupiter和vintage以兼容旧代码。junit 5不仅支持现代测试需求，还保持对旧版本测试的兼容性。

Java中如何用JUnit 5编写测试用例

JUnit 5提供了一种灵活且强大的方式来编写Java测试用例，它不仅仅是JUnit 4的简单升级，而是一个全新的架构，允许开发者更加模块化和可扩展地进行测试。核心在于其模块化设计，包括JUnit Platform、JUnit Jupiter和JUnit Vintage三个子项目。

解决方案

JUnit 5的使用涉及几个关键步骤：首先，你需要引入JUnit Jupiter的相关依赖到你的项目中。如果你使用Maven，可以在pom.xml文件中添加相应的dependency。然后，你可以使用@Test注解来标记测试方法。JUnit 5还引入了新的注解，如@BeforeEach、@AfterEach、@BeforeAll和@AfterAll，分别用于在每个测试方法之前、之后以及所有测试方法之前、之后执行的代码。

立即学习“Java免费学习笔记（深入）”；

例如，一个简单的JUnit 5测试用例可能如下所示：

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

class MyClassTest {

    @Test
    void testAdd() {
        MyClass myClass = new MyClass();
        assertEquals(5, myClass.add(2, 3));
    }
}

登录后复制

这段代码展示了如何使用@Test注解标记一个测试方法，并使用assertEquals断言来验证MyClass的add方法的行为。

如何使用JUnit 5进行参数化测试？

参数化测试是JUnit 5的一个亮点。它允许你使用不同的输入值运行同一个测试方法，从而避免编写大量重复的测试代码。要使用参数化测试，你需要使用@ParameterizedTest注解，并提供参数的来源，比如@ValueSource、@CsvSource或者@MethodSource。

举个例子，假设你想测试一个方法是否正确地判断一个数是否为正数，你可以这样写：

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.junit.jupiter.api.Assertions.assertFalse;

class NumberCheckerTest {

    @ParameterizedTest
    @ValueSource(ints = {1, 2, 3, 4, 5})
    void testIsPositive_positiveNumbers(int number) {
        NumberChecker checker = new NumberChecker();
        assertTrue(checker.isPositive(number));
    }

    @ParameterizedTest
    @ValueSource(ints = {-1, -2, -3, -4, -5})
    void testIsPositive_negativeNumbers(int number) {
        NumberChecker checker = new NumberChecker();
        assertFalse(checker.isPositive(number));
    }
}

登录后复制

这里，@ValueSource注解提供了多组输入值，JUnit 5会为每一组输入值执行一次testIsPositive方法。

JUnit 5的扩展模型是什么，如何使用？

JUnit 5的扩展模型是其另一个强大之处。它允许开发者通过实现特定的接口来扩展JUnit的功能，例如自定义的条件判断、生命周期回调等。扩展可以通过注解来注册，例如@ExtendWith。

假设你想创建一个自定义的扩展，在每个测试方法执行前后打印日志，你可以这样实现：

import org.junit.jupiter.api.extension.BeforeEachCallback;
import org.junit.jupiter.api.extension.AfterEachCallback;
import org.junit.jupiter.api.extension.ExtensionContext;

public class MyExtension implements BeforeEachCallback, AfterEachCallback {

    @Override
    public void beforeEach(ExtensionContext context) throws Exception {
        System.out.println("Before each test: " + context.getDisplayName());
    }

    @Override
    public void afterEach(ExtensionContext context) throws Exception {
        System.out.println("After each test: " + context.getDisplayName());
    }
}

登录后复制

然后，你可以在测试类或方法上使用@ExtendWith注解来注册这个扩展：

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import static org.junit.jupiter.api.Assertions.assertTrue;

@ExtendWith(MyExtension.class)
class MyTest {

    @Test
    void myTest() {
        assertTrue(true);
    }
}

登录后复制

这样，在myTest方法执行前后，MyExtension中的beforeEach和afterEach方法会被调用，从而打印相应的日志。

JUnit 5与JUnit 4的主要区别是什么？如何迁移？

JUnit 5与JUnit 4在架构上有显著的不同。JUnit 5采用了模块化设计，将测试运行器、测试引擎和测试API分离。这意味着你可以选择不同的测试引擎来运行测试，例如JUnit Jupiter（用于编写新的测试）和JUnit Vintage（用于运行JUnit 3和JUnit 4的测试）。

迁移到JUnit 5通常涉及以下步骤：