JUnit5 安装与使用

虽然JUnit5 的测试版本早就出来了，但正式版直到几年9月份推出，目前最新版5.0.1。几乎所有的Java 开发人员都会使用JUnit 来做测试，但其实很多自动化测试人员也会使用Junit 。目前，Android单元测试默认使用 Junit4，相信不久的将来也会使用 JUnit5 。

但是介绍 JUnit5 安装与使用资料并不算太多。本文普及一下JUnit5 安装与基本使用。

什么是Junit5 ?

先看来个公式：

JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage

这看上去比Junit4 复杂，实际上在导入包时也会复杂一些。

JUnit Platform是在JVM上启动测试框架的基础。

JUnit Jupiter是JUnit5扩展的新的编程模型和扩展模型，用来编写测试用例。Jupiter子项目为在平台上运行Jupiter的测试提供了一个TestEngine （测试引擎）。

JUnit Vintage提供了一个在平台上运行JUnit 3和JUnit 4的TestEngine 。

环境：

IDE：IntelliJ IDEA

版本工具：Maven

如果你从没使用过IntelliJ IDEA 和Maven的话，那么本文不适合你。

接下来在 IntelliJ IDEA中创建一个Maven项目，创建项目目录结果如下：

在 pom.xml 文件中添加JUnit5的相关库。

<dependencies>

    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-launcher</artifactId>
        <version>1.0.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.0.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.vintage</groupId>
        <artifactId>junit-vintage-engine</artifactId>
        <version>4.12.1</version>
        <scope>test</scope>
    </dependency>

</dependencies>

在test.java目录下创建一个 FistJUnit5Tests 类。代码如下：

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

import org.junit.jupiter.api.Test;

class FirstJUnit5Tests {

    @Test
    void myFirstTest() {
        assertEquals(2, 1 + 1);
    }

}

明显看出和Junit4 还是有些不同的。首先，导入测试测试注解（@Test）和断言方法（assertEquals）的路径不同。其次，不需要手动把测试和测试方法声明为 public 了。

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.junit.jupiter.api.Assertions.assertAll;

import org.junit.jupiter.api.*;

class FirstJUnit5Tests {

    @BeforeEach
    @DisplayName("每条用例开始时执行")
    void start(){

    }

    @AfterEach
    @DisplayName("每条用例结束时执行")
    void end(){

    }

    @Test
    void myFirstTest() {
        assertEquals(2, 1 + 1);
    }

    @Test
    @DisplayName("描述测试用例╯°□°）╯")
    void testWithDisplayName() {

    }

    @Test
    @Disabled("这条用例暂时跑不过，忽略!")
    void myFailTest(){
        assertEquals(1,2);
    }

    @Test
    @DisplayName("运行一组断言")
    public void assertAllCase() {
        assertAll("groupAssert",
                () -> assertEquals(2, 1 + 1),
                () -> assertTrue(1 > 0)
        );
    }

    @Test
    @DisplayName("依赖注入1")
    public void testInfo(final TestInfo testInfo) {
        System.out.println(testInfo.getDisplayName());
    }

    @Test
    @DisplayName("依赖注入2")
    public void testReporter(final TestReporter testReporter) {
        testReporter.publishEntry("name", "Alex");
    }

}

上面一段代码，大概展示了Junit5的一些新的特性或与旧版本的不同。我通过用例描述，已经做了介绍。在IDEA中的运行结果如下。

参考：http://junit.org/junit5/docs/current/user-guide/