JUnit5单元测试框架的使用教程与简单实例_junit5使用

1、JUnit5的使用教程

1.1 简介

JUnit是一个Java语言的单元测试框架。它由Kent Beck和Erich Gamma建立，逐渐成为源于Kent Beck的sUnit的xUnit家族中最为成功的一个。 JUnit有它自己的JUnit扩展生态圈。多数Java的开发环境都已经集成了JUnit作为单元测试的工具。

JUnit5旨在调整java8样式的编码，并且比JUnit4更强大和灵活。

什么是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 。

1.2 安装

这里使用Maven进行安装，pom.xml配置文件如下：

<dependencies>
    <!-- JUnit5单元测试框架 -->
    <dependency>
        <groupId>org.junit.platform</groupId>
        <artifactId>junit-platform-launcher</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.vintage</groupId>
        <artifactId>junit-vintage-engine</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

1.3 JUnit5注解

所有支持的注解都在包 org.junit.jupiter.api 下;

使用@Test、@TestTemplate、@RepeatedTest、@BeforeAll、@AfterAll、@BeforeEach或@AfterEach注释的方法不能返回值。

1.4 JUnit5与JUnit4注释的比较

两个版本中的大多数注释都是相同的，但很少有区别。这是一个快速比较。

1.5 JUnit5断言（Assertions类）

JUnit Jupiter附带了许多JUnit 4拥有的断言方法，并添加了一些可以很好地用于Java 8 lambdas的断言方法。 
所有JUnit5断言都是 org.junit.jupiter.api.Assertions 中的静态方法断言类。

Asser类中主要方法如下：

注意：上面的每一 个方法， 都有对应的重载方法，可以在前面加一个String类型的参数，表示如果断言失败时的提示。

推荐教程：

推荐JUnit5使用教程：《JUnit5入门系列教程》（作者：叶止水）。

2、JUnit5的简单实例

【实例】在IDEA开发工具中，中使用JUnit5实现一个简单的测试实例。

IDEA开发工具默认已经安装好了JUnit插件，如下图：

如果没有安装JUnit插件，请执行安装。

（1）编写pom.xml配置文件，引入JUnit5所需的jar包。

<?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>com.pjb.mvnbook</groupId>
    <artifactId>hello-world</artifactId>
    <version>1.0-SNAPSHOT</version>
 
    <dependencies>
        <!-- JUnit5单元测试框架 -->
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-launcher</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
 
</project>

（2）创建HelloWorld.java类，该类是被测试的对象。

/**
 * 业务类
 * @author pan_junbiao
 **/
public class HelloWorld
{
    public String sayHello()
    {
        return "您好，欢迎访问 pan_junbiao的博客";
    }
 
    public static void main(String[] args)
    {
        System.out.println(new HelloWorld().sayHello());
    }
}

（3）创建测试类。

创建测试类的方法一：

选择需要被测试的类，点击鼠标右键（弹出菜单）→ Go To → Test。

创建测试类的方法二：

选择需要被测试的类，使用快捷键： Ctrl + Shift + T

在弹出的Create Test窗口中，输入相关测试类信息，并勾选需要被测试的方法。

编写测试代码：

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
 
/**
 * 使用JUnit5进行测试类
 * @author pan_junbiao
 **/
class HelloWorldTest
{
    @BeforeEach
    void setUp()
    {
        System.out.println("@BeforeEach，测试开始");
    }
 
    @AfterEach
    void tearDown()
    {
        System.out.println("@AfterEach，测试结束");
    }
 
    @Test
    void sayHello()
    {
        HelloWorld helloWorld = new HelloWorld();
        String result = helloWorld.sayHello();
        System.out.println(result);
        assertEquals("您好，欢迎访问 pan_junbiao的博客",result);
    }
}

执行结果：