JUnit5學習之四:按條件執行
歡迎訪問我的GitHub
github.com/zq2599/blog_demos
內容:所有原創文章分類彙總及配套原始碼,涉及Java、Docker、Kubernetes、DevOPS等;
本篇概覽
本文是《JUnit5學習》系列的第四篇,有時我們們希望測試方法僅在一定條件下才執行,例如有的測試方法只適合Linux環境,這就是按條件執行的需求,本篇的主要內容就是學習如何為測試方法設定前提條件,只有滿足了這些條件測試才會被執行,本篇大綱如下:
- 自定義測試方法的執行順序
- 按作業系統設定條件
- 按JAVA環境設定條件
- 按系統屬性設定條件
- 按環境變數設定條件
- 自定義條件
原始碼下載
- 如果您不想編碼,可以在GitHub下載所有原始碼,地址和連結資訊如下表所示:
名稱 | 連結 | 備註 |
---|---|---|
專案主頁 | github.com/zq2599/blog_demos | 該專案在GitHub上的主頁 |
git倉庫地址(https) | github.com/zq2599/blog_demos.git | 該專案原始碼的倉庫地址,https協議 |
git倉庫地址(ssh) | :zq2599/blog_demos.git | 該專案原始碼的倉庫地址,ssh協議 |
- 這個git專案中有多個資料夾,本章的應用在junitpractice資料夾下,如下圖紅框所示:
- junitpractice是父子結構的工程,本篇的程式碼在conditional子工程中,如下圖:
自定義測試方法的執行順序
今天要寫的測試方法很多,為了管理好這些方法,在學習按條件執行之前先來看看如何控制測試方法的執行順序:
- 給測試類新增註解TestMethodOrder,註解的value是OrderAnnotation.class
- 給每個測試方法新增Order註解,value值是數字,越小的value越優先執行
- 使用方法如下圖所示:
- 接下來的實戰中,我們們就用上述方法控制測試方法的執行順序;
按作業系統設定條件
- 註解EnabledOnOs指定多個作業系統,只有當前作業系統是其中的一個,測試方法才會執行;
- 註解DisabledOnOs指定多個作業系統,只要當前作業系統是其中的一個,測試方法就不會執行;
- 測試程式碼如下:
@Test
@Order(1)
@EnabledOnOs(OS.WINDOWS)
@DisplayName("作業系統:只有windows才會執行")
void onlyWindowsTest() {
assertEquals(2, Math.addExact(1, 1));
}
@Test
@Order(2)
@EnabledOnOs({OS.WINDOWS, OS.LINUX})
@DisplayName("作業系統:windows和linux都會執行")
void windowsORLinuxTest() {
assertEquals(2, Math.addExact(1, 1));
}
@Test
@Order(3)
@DisabledOnOs({OS.MAC})
@DisplayName("作業系統:只有MAC才不會執行")
void withoutMacTest() {
assertEquals(2, Math.addExact(1, 1));
}
- 我這裡是windows作業系統,上述三個方法執行結果如下:
按JAVA環境設定條件
- 註解EnabledOnJre指定多個JRE版本,只有當前JRE是其中的一個,測試方法才會執行;
- 註解DisabledOnJre指定多個JRE版本,只要當前JRE是其中的一個,測試方法就不會執行;
- 註解EnabledForJreRange指定JRE版本的範圍,只有當前JRE在此範圍內,測試方法才會執行;
- 註解DisabledForJreRange指定JRE版本的範圍,只要當前JRE在此範圍內,測試方法就不會執行;
- 測試程式碼如下:
@Test
@Order(4)
@EnabledOnJre({JRE.JAVA_9, JRE.JAVA_11})
@DisplayName("Java環境:只有JAVA9和11版本才會執行")
void onlyJava9And11Test() {
assertEquals(2, Math.addExact(1, 1));
}
@Test
@Order(5)
@DisabledOnJre({JRE.JAVA_9})
@DisplayName("Java環境:JAVA9不執行")
void withoutJava9Test() {
assertEquals(2, Math.addExact(1, 1));
}
@Test
@Order(6)
@EnabledForJreRange(min=JRE.JAVA_8, max=JRE.JAVA_11)
@DisplayName("Java環境:從JAVA8到1之間的版本都會執行")
void fromJava8To11Test() {
assertEquals(2, Math.addExact(1, 1));
}
- 我這裡是JDK8,執行結果如下:
按系統屬性設定條件
- 註解EnabledIfSystemProperty指定系統屬性的key和期望值(模糊匹配),只有當前系統有此屬性並且值也匹配,測試方法才會執行;
- 註解DisabledIfSystemProperty指定系統屬性的key和期望值(模糊匹配),只要當前系統有此屬性並且值也匹配,測試方法就不會執行;
- 測試程式碼如下:
@Test
@Order(7)
@EnabledIfSystemProperty(named = "os.arch", matches = ".*64.*")
@DisplayName("系統屬性:64位作業系統才會執行")
void only64BitArch() {
assertEquals(2, Math.addExact(1, 1));
}
@Test
@Order(8)
@DisabledIfSystemProperty(named = "java.vm.name", matches = ".*HotSpot.*")
@DisplayName("系統屬性:HotSpot不會執行")
void withOutHotSpotTest() {
assertEquals(2, Math.addExact(1, 1));
}
- 上述測試方法執行結果如下:
按環境變數設定條件
- 註解EnabledIfEnvironmentVariable指定環境變數的key和期望值(模糊匹配),只有當前系統有此環境變數並且值也匹配,測試方法才會執行;
- 註解DisabledIfEnvironmentVariable指定環境變數的key和期望值(模糊匹配),只要當前系統有此環境變數並且值也匹配,測試方法就不會執行;
- 測試程式碼如下:
@Test
@Order(9)
@EnabledIfEnvironmentVariable(named = "JAVA_HOME", matches = ".*")
@DisplayName("環境變數:JAVA_HOME才會執行")
void onlyJavaHomeExistsInEnvTest() {
assertEquals(2, Math.addExact(1, 1));
}
@Test
@Order(10)
@DisabledIfEnvironmentVariable(named = "GOPATH", matches = ".*")
@DisplayName("環境變數:有GOPATH就不執行")
void withoutGoPathTest() {
assertEquals(2, Math.addExact(1, 1));
}
- 上述測試方法執行結果如下:
自定義條件(從junit5.7版本開始)
- 前面的條件註解很豐富,但終究是固定、有限的,無法滿足所有場景,它們不夠用時,我們們還可以自定義前提條件,即EnabledIf和DisabledIf註解;
- 有兩個關鍵點要格外注意,首先是EnabledIf和DisabledIf的package,注意是org.junit.jupiter.api.condition,不要用這個:org.springframework.test.context.junit.jupiter.EnabledIf,一旦用錯,執行測試時會丟擲異常;
- 第二個要注意的是EnabledIf和DisabledIf對應的junit版本,它們是從5.7版本版本才開始的,而本文用的SpringBoot版本是2.3.4.RELEASE,間接依賴的junit版本是5.6.2,因此,必須在pom.xml中做下圖紅框中的修改,將間接依賴去掉,並主動依賴5.7.0,才能將junit從5.6.2升級到5.7,這樣才能用上EnabledIf和DisabledIf:
4. EnabledIf的用法很簡單,value是個存在的方法的名字,該方法必須返回boolean型別,demo如下,customCondition是個很簡單的方法,被用來做是否執行單元測試的判斷條件:
boolean customCondition() {
return true;
}
@Test
@Order(11)
@EnabledIf("customCondition")
@DisplayName("自定義:customCondition返回true就執行")
void onlyCustomConditionTest() {
assertEquals(2, Math.addExact(1, 1));
}
@Test
@Order(12)
@DisabledIf("customCondition")
@DisplayName("自定義:customCondition返回true就不執行")
void withoutCustomConditionTest() {
assertEquals(2, Math.addExact(1, 1));
}
- 上述測試方法執行結果如下:
6. 前面的程式碼中,EnabledIf和DisabledIf註解被用來修飾方法,其實它們還可以修飾類,用於控制整個類是否執行單元測試,不過修飾類的時候,對應的自定義方法必須是static型別;
7. 前面的程式碼中,customCondition方法和使用它的EnabledIf註解在同一個類中,其實它們也可以在不同的類中,不過此時EnabledIf註解的value要給出:包名、類名、方法名,如下所示,注意類名和方法名之間的連線符是#:
@Test
@Order(12)
@DisabledIf("com.example.Conditions#customCondition")
@DisplayName("自定義:customCondition返回true就不執行")
void withoutCustomConditionTest() {
assertEquals(2, Math.addExact(1, 1));
}
- 以上就是常用的按條件執行單元測試的各種例項了,希望本文能給您提供參考,助您在各種場景更加精確的控制用例的執行邏輯;
我是欣宸,期待與您一同暢遊Java世界…
github.com/zq2599/blog_demos
來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/2318/viewspace-2827012/,如需轉載,請註明出處,否則將追究法律責任。
相關文章
- Junit5系列-Junit5中DisabledCondition條件測試執行
- MySQL學習筆記之約束條件MySql筆記
- ARM技術 —— 條件執行
- Junit5系列-Junit5中@Disabled禁止執行
- Aspectj 實現Method條件執行
- 學習Rust 條件語句Rust
- JUnit5學習之八:綜合進階(終篇)
- 多執行緒(2)-執行緒同步條件變數執行緒變數
- 多執行緒06:條件變數執行緒變數
- React學習筆記-條件渲染React筆記
- JUnit5註解學習指引
- MongoDb學習之Explain執行計劃MongoDBAI
- Java學習筆記之執行緒Java筆記執行緒
- java執行緒學習5——執行緒同步之同步方法Java執行緒
- JUnit5學習之三:Assertions類
- JUnit5學習之一:基本操作
- JUnit5學習之二:Assumptions類
- JUnit5的條件測試、巢狀測試、重複測試巢狀
- 04 Windows批處理中的條件執行Windows
- C#多執行緒學習(四) 多執行緒的自動管理(執行緒池)C#執行緒
- JUnit5學習之五:標籤(Tag)和自定義註解
- Go 條件語句 - Go 學習記錄Go
- Java學習需要具備什麼條件?Java
- 條件分支與迴圈結構學習
- redis原始碼學習之lua執行原理Redis原始碼
- Python學習之程式和執行緒Python執行緒
- SQL學習系列之對執行計時SQL
- less學習之Bootstrap(按鈕篇)boot
- Java 多執行緒學習筆記(四)yield 介紹Java執行緒筆記
- JUnit5學習之六:引數化測試(Parameterized Tests)基礎Zed
- JUnit5學習之七:引數化測試(Parameterized Tests)進階Zed
- Python執行緒條件變數Condition解析Python執行緒變數
- Python執行緒專題7:條件變數Python執行緒變數
- java多執行緒與併發 - Condition(條件)Java執行緒
- connect by與where條件執行順序問題
- 【C/C++多執行緒程式設計之八】pthread條件變數C++執行緒程式設計thread變數
- Mysql按條件計數的幾種方法MySql
- mysql,where條件查詢等學習筆記MySql筆記