如何在Maven項目中運行JUnit 5測試用例


本文演示了如何如何編寫JUnit 5測試用例,在Maven項目中運行JUnit 5測試用例。

編寫JUnit 5測試用例

如果你是Java開發者,那么對於JUnit應該就不陌生。JUnit是Java單元測試的基礎工具。

JUnit目前最新的版本是JUnit 5.x,但廣大的Java開發者估計還停留在JUnit 4.x,因此有必要演示下如何編寫JUnit 5測試用例。

引入JUnit 5依賴

相比較JUnit 4而言,JUnit 5一個比較大的改變是JUnit 5擁有與JUnit 4不同的全新的API。JUnit 5分成了三部分:

?
1
JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage
 
  1. JUnit Platform是在JVM上啟動測試框架的基礎。 它還定義了TestEngine API,用於開發在平台上運行的測試框架。 此外,該JUnit Platform還提供了一個控制台啟動器(用於從命令行啟動該平台)和一個基於JUnit 4的運行器,用於在基於JUnit 4的環境中在該平台上運行任何TestEngine。 流行的IDE(IntelliJ IDEA,Eclipse,NetBeans和Visual Studio Code等)和構建工具(Gradle,Maven和Ant等)中也存在對JUnit平台的一流支持。
  2. JUnit Jupiter是新編程模型和擴展模型的組合,用於在JUnit 5中編寫測試和擴展。Jupiter子項目提供了一個TestEngine,用於在平台上運行基於Jupiter的測試。
  3. JUnit Vintage提供了一個TestEngine,用於在平台上運行基於JUnit 3和基於JUnit 4的測試。

因此,在Maven中,JUnit 5分模塊的,意味着你可以按需引入上面定義的任意模塊。這使得引入JUnit 5依賴就有了多個選擇。

一般而言,力求省事,就可以通過引入junit-jupiter依賴。junit-jupiter就是常用JUnit 5模塊的聚合包。

?
1
2
3
4
5
6
< dependency >
   < groupId >org.junit.jupiter</ groupId >
   < artifactId >junit-jupiter</ artifactId >
   < version >${junit-jupiter.version}</ version >
   < scope >test</ scope >
</ dependency >
 

編寫測試用例

下面是一段簡單的Java程序:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/**
  * 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" rel="external nofollow" rel="external nofollow" >Way Lau</a>
  */
public class HelloWorld {
 
  private String words;
 
  public HelloWorld(String words) {
  this .words = words;
  }
  
  public String getWords() {
  return words;
  }
 
}
 

按照管理,我們會在Maven工程的test目錄,創建一個與之對應的單元測試用例:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/**
  * 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" rel="external nofollow" rel="external nofollow" >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執行測試。

在IDE中運行

以Eclipse IDE為例,右鍵類或者方法,選擇“Run As -> JUnit Test”即可。如下圖所示。

通過Maven執行測試

在Maven中執行測試用例的命令如下:

?
1
mvn test
 

如果你執行了上述命令,會得到下面的測試結果

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.waylau.java.demo.HelloWorldTests
Tests run: 0, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.002 sec

Results :

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兩個插件。

?
1
2
3
4
5
6
7
8
9
10
11
12
< build >
   < plugins >
     < plugin >
       < artifactId >maven-surefire-plugin</ artifactId >
       < version >${maven-surefire-plugin.version}</ version >
     </ plugin >
     < plugin >
       < artifactId >maven-failsafe-plugin</ artifactId >
       < version >${maven-failsafe-plugin.version}</ version >
     </ plugin >
   </ plugins >
</ build >
 

在Maven中再次執行測試用例,會得到下面的測試結果:

[INFO] -------------------------------------------------------
[INFO]  T E S T S
[INFO] -------------------------------------------------------
[INFO] Running com.waylau.java.demo.HelloWorldTests
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.045 s - in com.waylau.java.demo.HelloWorldTests
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  4.116 s
[INFO] Finished at: 2020-04-12T11:30:29+08:00
[INFO] ------------------------------------------------------------------------

可以看到,HelloWorldTests類已經得到了測試執行。

參考引用

Eclipse IDE支持Java 14: https://www.jb51.net/article/185636.htm
本文示例源碼:https://github.com/waylau/java-data-structures-and-algorithms-in-action

到此這篇關於如何在Maven項目中運行JUnit5測試用例實現的文章就介紹到這了,更多相關Maven運行JUnit5測試內容請搜索腳本之家以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持腳本之家!

 

 

出處:https://www.jb51.net/article/185640.htm


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM