1. 概述
在本教程中，我们将学习如何从JUnit 4迁移到最新的JUnit 5版本，并概述两个版本的JUnit之间的差异。
有关使用JUnit 5的一般指南，请在此处查看我们的文章。
2. Junit 5的优势
让我们从以前的版本JUnit 4开始，它有一些明显的局限性：
- 单个jar包含整个框架。我们需要导入整个库，即使我们只需要一个特定的功能。在JUnit 5中，我们可以做更细粒度的控制，并且可以只导入必要的内容。
- 在JUnit 4中一次只有一个测试Runner可以执行测试(例如SpringJUnit4ClassRunner或Parameterized)。JUnit 5允许多个Runner同时工作。
- JUnit 4从未超越Java 7，错过了Java 8的许多特性。JUnit 5很好地利用了Java 8的功能。
JUnit 5背后的想法是完全重写JUnit 4，以消除大多数这些缺点。
3. 差异
JUnit 4分为构成JUnit 5的模块：
- JUnit Platform：此模块涵盖了我们可能感兴趣的所有扩展框架：测试执行、发现和报告。
- JUnit Vintage：此模块允许向后兼容JUnit 4甚至JUnit 3。
3.1 注解
JUnit 5对其注解进行了重要更改。最重要的一点是我们不能再使用@Test注解来指定expected属性。
在JUnit 4中，我们可以根据以下方式指定expected属性来断言一个异常的抛出：
@Test(expected = Exception.class)
public void shouldRaiseAnException() throws Exception {
// ...
}
在JUnit 5中我们可以使用assertThrows方法：
void shouldRaiseAnException() throws Exception {
Assertions.assertThrows(Exception.class, () -> {
//...
});
}
JUnit 4中的timeout属性：
@Test(timeout = 1)
public void shouldFailBecauseTimeout() throws InterruptedException {
Thread.sleep(10);
}
在Junit 5中我们可以使用assertTimeout()方法：
@Test
void shouldFailBecauseTimeout() throws InterruptedException {
Assertions.assertTimeout(Duration.ofMillis(1), () -> Thread.sleep(10));
}
以下是在JUnit 5中中更改的其他一些注解：
- @Before更换为@BeforeEach
- @After更换为@AfterEach
- @BeforeClass更换为@BeforeAll
- @AfterClass更换为@AfterAll
- @Ignore更换为@Disabled
3.2 断言
我们还可以在JUnit 5中使用lambda编写断言消息，允许惰性求值跳过复杂的消息构造，直到需要：
@Test
void shouldFailBecauseTheNumbersAreNotEqual_lazyEvaluation() {
assertTrue(2 == 3, () -> "Numbers " + 2 + " and " + 3 + " are not equal!");
}
此外，我们可以在JUnit 5中对断言进行分组：
@Test
void shouldAssertAllTheGroup() {
List<Integer> list = Arrays.asList(1, 2, 3);
assertAll("List is not incremental",
() -> assertEquals(list.get(0).intValue(), 1),
() -> assertEquals(list.get(1).intValue(), 2),
() -> assertEquals(list.get(2).intValue(), 3)
);
}
3.3 假设
新的Assumptions类现在位于org.junit.jupiter.api包中。JUnit 5完全支持JUnit 4中现有的假设方法，并且还添加了一组新方法，允许我们仅在特定场景下运行一些断言：
@Test
void whenEnvironmentIsWeb_thenUrlsShouldStartWithHttp() {
assumingThat("WEB".equals(System.getenv("ENV")), Assertions::fail);
}
3.4 标签和过滤
在JUnit 4中，我们可以使用@Category注解对测试进行分组。在JUnit 5中，@Category注解被@Tag注解取代：
@Tag("junit5")
@Tag("annotations")
public class AnnotationTestExampleUnitTest {
// ...
}
我们可以使用maven-surefire-plugin包含/排除特定标签:
<build>
<plugins>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<properties>
<includeTags>junit5</includeTags>
</properties>
</configuration>
</plugin>
</plugins>
</build>
3.5 运行测试的新注解
在JUnit 4中，我们使用@RunWith注解将测试上下文与其他框架集成，或更改测试用例中的整体执行流程。
在JUnit 5中，我们现在可以使用@ExtendWith注解来提供类似的功能。
例如，要使用JUnit 4中的Spring功能：
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration({"/app-config.xml", "/test-data-access-config.xml"})
public class SpringExtensionTest {
// ...
}
在JUnit 5中，它是一个简单的Extension：
@ExtendWith(SpringExtension.class)
@ContextConfiguration({ "/app-config.xml", "/test-data-access-config.xml" })
class SpringExtensionTest {
// ...
}
3.6 新的测试Rule注解
在JUnit 4中，我们使用@Rule和@ClassRule注解为测试添加特殊功能。
在JUnit 5中，我们可以使用@ExtendWith注解实现相同的逻辑。
例如，假设我们在JUnit 4中有一个自定义Rule，用于在测试之前和之后写入日志记录：
public class TraceUnitTestRule implements TestRule {
@Override
public Statement apply(Statement base, Description description) {
return new Statement() {
@Override
public void evaluate() throws Throwable {
// Before and after an evaluation tracing here
// ...
}
};
}
}
我们在测试套件中实现它：
@Rule
public TraceUnitTestRule traceRuleTests = new TraceUnitTestRule();
在JUnit 5中，我们可以以更直观的方式编写相同的内容：
public class TraceUnitExtension implements AfterEachCallback, BeforeEachCallback {
@Override
public void beforeEach(TestExtensionContext context) throws Exception {
// ...
}
@Override
public void afterEach(TestExtensionContext context) throws Exception {
// ...
}
}
使用JUnit 5的AfterEachCallback和BeforeEachCallback接口(在org.junit.jupiter.api.extension包中提供)，我们可以轻松地在测试套件中实现此Rule：
@ExtendWith(TraceUnitExtension.class)
class RuleExampleUnitTest {
@Test
void whenTracingTests() {
// ...
}
}
3.7 JUnit 5 Vintage
JUnit Vintage通过在JUnit 5上下文中运行JUnit 3或JUnit 4测试来帮助迁移JUnit测试。
我们可以通过导入junit-vintage-engine来使用它：
<dependency>
<groupId>org.junit.vintage</groupId>
<artifactId>junit-vintage-engine</artifactId>
<version>${junit5.vintage.version}</version>
<scope>test</scope>
</dependency>
4. 总结
JUnit 5是JUnit 4框架的模块化和现代版本。在本文中，我们介绍了这两个版本之间的主要区别，并介绍了如何从JUnit 4迁移到JUnit 5。
本文的代码实现可以在GitHub上找到。
Post Directory
