JUnit5教程(1)：JUnit5架构和第一个测试示例

你好啊，我是大阳。

有小伙伴编程但不进行单元测试的吗？答应我，看完这个专栏《JUnit5教程》，提高编码调试效率，跟bug说拜拜。

1. JUnit5架构

JUnit 5 是 Java 应用程序使用最广泛的测试框架。很长一段时间以来，JUnit 一直在完美地完成它的工作。

与以前的 JUnit 版本不同，JUnit 5 由三个不同子项目的几个不同模块组成。

JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage

JUnit Platform是在 JVM 上启动测试框架的基础。它还定义了TestEngine(测试引擎)用于开发在平台上运行的测试框架的 API。此外，该平台还提供了一个控制台启动器，用于从命令行启动平台，并提供JUnit 平台套件引擎（JUnit Platform Suite Engine），用于使用平台上的一个或多个测试引擎运行自定义测试套件。可以使用流行的 IDE（IntelliJ IDEA、 Eclipse、NetBeans和 Visual Studio Code）和构建工具（参见Gradle、 Maven和Ant）来创建你的测试示例。

JUnit Jupiter是用于在 JUnit 5 中编写测试和扩展的新编程模型和 扩展模型的组合。Jupiter 子项目提供了一个TestEngine（测试引擎）用于在平台上运行基于 Jupiter 的测试。

JUnit Vintage提供了一个TestEngine（测试引擎）用于在平台上运行基于 JUnit 3 和 JUnit 4 的测试。但要求 JUnit 4.12 或更高版本出现在类路径或模块路径中。

JUnit 5 在运行时需要 Java 8（或更高版本）。

2. 第一个测试示例

2.1 依赖引用

我们使用maven构建第一个JUnit5测试实例。首先在maven的pom文件中引入依赖：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>cn.dayangshuo</groupId>
    <artifactId>cn.dayangshuo.junit5-tutorial</artifactId>
    <version>1.0.0</version>

    <properties>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <junit.jupiter.version>5.8.2</junit.jupiter.version>
        <junit.platform.version>1.8.2</junit.platform.version>
    </properties>

    <dependencies>
        <!--junit-jupiter-->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>${junit.jupiter.version}</version>
            <scope>test</scope>
        </dependency>
        <!--junit-platform-suite-->
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-suite</artifactId>
            <version>${junit.platform.version}</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.22.2</version>
            </plugin>
        </plugins>
    </build>
</project>

我们主要引入了两个依赖junit-jupiter和junit-platform-suite。

其中junit-jupiter是由三个依赖组成，分别是：

• junit-jupiter-api：是所有核心注解所在的主模块，如@Test、生命周期方法注解和断言。
• junit-jupiter-engine：它具有在运行时执行测试所需的测试引擎实现。
• junit-jupiter-params：参数化测试组件。

而junit-platform-suite模块提供的@Suite支持可以让 JUnitPlatform 运行器可以进行分组测试。

2.2 测试示例

第一个测试示例，首先在main>java>cn.dayangshuo.junit5创建简单的两数相加方法类：

package cn.dayangshuo.junit5;

/**
 * @author DAYANG
 */
public class Calculator {
    //两数相加
    public static int add(int a, int b) {
        return a + b;
    }
}

测试示例：

package cn.dayangshuo.junit5.tests;

import cn.dayangshuo.junit5.Calculator;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

/**
 * @author DAYANG
 */
public class SimpleTests {

    @Test
    void addsTwoNumbers() {
        Assertions.assertEquals(2, Calculator.add(1, 1), "1 + 1 should equal 2");
    }
}

好啦，这样我们就完成了第一个JUnit5测试示例，接下来我们讨论JUnit5测试阶段的生命周期，以及一些和JUnit4不同的注解的使用方法。