在 Maven 项目中运行 JUnit 5 测试用例

最新推荐文章于 2024-05-08 04:51:31 发布

m0_67422048

最新推荐文章于 2024-05-08 04:51:31 发布

阅读量815

点赞数 1

文章标签： maven 测试用例 java

原文链接：https://developer.aliyun.com/article/756820?spm=a2c6h.12873581.0.0.484f7e46SbqQDx

版权

本文来自于【阿里云官方镜像站：https://developer.aliyun.com/mirror/?utm_content=g_1000307095 】

原文链接：https://developer.aliyun.com/article/756820?spm=a2c6h.12873581.0.0.484f7e46SbqQDx

镜像下载、域名解析、时间同步请点击阿里巴巴开源镜像站

一、编写JUnit 5测试用例

如果你是Java开发者，那么对于JUnit应该就不陌生。JUnit是Java单元测试的基础工具。

JUnit目前最新的版本是JUnit 5.x，为了帮助广大的Java开发者使用最新版JUnit，接下来将为大家讲解如何编写JUnit 5测试用例。

1. 引入JUnit 5依赖

相比较JUnit 4而言，JUnit 5一个比较大的改变是JUnit 5拥有与JUnit 4不同的全新的API。JUnit 5分成了三部分：

JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage

JUnit Platform是在JVM上启动测试框架的基础。它还定义了TestEngine API，用于开发在平台上运行的测试框架。此外，该JUnit Platform还提供了一个控制台启动器（用于从命令行启动该平台）和一个基于JUnit 4的运行器，用于在基于JUnit 4的环境中在该平台上运行任何TestEngine。流行的IDE（IntelliJ IDEA，Eclipse，NetBeans和Visual Studio Code等）和构建工具（Gradle，Maven和Ant等）中也存在对JUnit平台的一流支持。

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

JUnit Vintage提供了一个TestEngine，用于在平台上运行基于JUnit 3和基于JUnit 4的测试。

因此，在Maven中，JUnit 5分模块的，意味着你可以按需引入上面定义的任意模块。这使得引入JUnit 5依赖就有了多个选择。

一般而言，力求省事，就可以通过引入junit-jupiter依赖。junit-jupiter就是常用JUnit 5模块的聚合包。

<groupId>org.junit.jupiter</groupId>

<artifactId>junit-jupiter</artifactId>

<version>${junit-jupiter.version}</version>

2. 编写测试用例

下面是一段简单的Java程序：

/**

* Welcome to https://waylau.com

package com.waylau.java.demo;

/**

* Hello World.

* @since 1.0.0 2020年4月12日

* @author <a href="https://waylau.com">Way Lau</a>

*/public class HelloWorld {

private String words;

public HelloWorld(String words) {

this.words = words;

}

public String getWords() {

return words;

}

按照管理，我们会在Maven工程的test目录，创建一个与之对应的单元测试用例：

/**

* Welcome to https://waylau.com

package com.waylau.java.demo;

import org.junit.jupiter.api.Test;

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

/**

* HelloWorld Test.

* @since 1.0.0 2020年4月12日

* @author <a href="https://waylau.com">Way Lau</a>

*/class HelloWorldTests {

@Test

void testGetWords() {

var words = "Hello World";

var hello = new HelloWorld(words);

assertEquals(words, hello.getWords());

}

上述用例非常简单，就是想测试下，HelloWorld的getWords方法，是否与预期的一致。

这里需要强调的是JUnit 5和JUnit 4的不同点：

JUnit 5使用的API是org.junit.jupiter.api.*包下

测试方法（比如上例testGetWords），可以不加public。

二、运行JUnit 5测试用例

上如上文所讲，在大多数主流的IDE中，都提供了对JUnit 5的支持。因此可以选择在IDE中运行，也可以通过Maven执行测试。

1. 在IDE中运行

以Eclipse IDE为例，右键类或者方法，选择“Run As -> JUnit Test”即可。如下图所示。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-tONJQN3t-1587044607054)(../images/post/20200412-ide.jpg)]

2. 通过Maven执行测试

在Maven中执行测试用例的命令如下：

mvn test

如果你执行了上述命令，会得到下面的测试结果

-------------------------------------------------------

T E S T S-------------------------------------------------------Running com.waylau.java.demo.HelloWorldTestsTests run: 0, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.002 secResults :Tests run: 0, Failures: 0, Errors: 0, Skipped: 0[INFO] ------------------------------------------------------------------------[INFO] BUILD SUCCESS[INFO] ------------------------------------------------------------------------[INFO] Total time: 1.983 s[INFO] Finished at: 2020-04-12T11:22:16+08:00[INFO] ------------------------------------------------------------------------

上面结果没有失败的用例，但同时你也发现了没有成功的用例。因为根本没有执行测试用例。

这是因为，在Maven中并不能直接识别JUnit 5测试用例。如何解决？此时，还需要额外加多Maven Surefire或Maven Failsafe两个插件。

<build>

<artifactId>maven-surefire-plugin</artifactId>

<version>${maven-surefire-plugin.version}</version>

</plugin>

<artifactId>maven-failsafe-plugin</artifactId>

<version>${maven-failsafe-plugin.version}</version>

</plugin>

</plugins></build>

在Maven中再次执行测试用例，会得到下面的测试结果：

[INFO] -------------------------------------------------------