JUnit5學習之二：Assumptions類

歡迎訪問我的GitHub

https://github.com/zq2599/blog_demos

內容：所有原創文章分類匯總及配套原始碼，涉及Java、Docker、Kubernetes、DevOPS等；

關于《JUnit5學習》系列

《JUnit5學習》系列旨在通過實戰提升SpringBoot環境下的單元測驗技能，一共八篇文章，鏈接如下：

1. 基本操作
2. Assumptions類
3. Assertions類
4. 按條件執行
5. 標簽(Tag)和自定義注解
6. 引數化測驗(Parameterized Tests)基礎
7. 引數化測驗(Parameterized Tests)進階
8. 綜合進階（終篇）

本篇概覽

本文是《JUnit5學習》系列的第二篇，學習一個重要的知識點：Assumptions類，只有了解了它們，才好繼續后面的學習，全篇章節如下：

1. Assertions和Assumptions簡介
2. 寫一段代碼對比效果
3. Assumptions編碼
4. 查看執行結果

原始碼下載

1. 如果您不想編碼，可以在GitHub下載所有原始碼，地址和鏈接資訊如下表所示：

2. 這個git專案中有多個檔案夾，本章的應用在junitpractice檔案夾下，如下圖紅框所示：

3. junitpractice是父子結構的工程，本篇的代碼在assertassume子工程中，如下圖：

Assertions和Assumptions簡介

Assumptions和Assertions容易混淆，因此這里通過對比它們來學習：

1. Assertions即斷言類，里面提供了很多靜態方法，例如assertTrue，如果assertTrue的入參為false，就會拋出AssertionFailedError例外，Junit對拋出此例外的方法判定為失敗；
2. Assumptions即假設類，里面提供了很多靜態方法，例如assumeTrue，如果assumeTrue的入參為false，就會拋出TestAbortedException例外，Junit對拋出此例外的方法判定為跳過；
3. 簡單的說，Assertions的方法拋出例外意味著測驗不通過，Assumptions的方法拋出例外意味著測驗被跳過(為什么稱為"跳過"？因為mvn test的執行結果被標記為Skipped)；

寫一段代碼對比效果

1. 用代碼來驗證的效果最好，如下所示，一共四個方法，assertSuccess不拋出AssertionFailedError例外，assertFail拋出AssertionFailedError例外，assumpSuccess不拋出TestAbortedException例外，assumpFail拋出TestAbortedException例外

package com.bolingcavalry.assertassume.service.impl;

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assumptions.assumeTrue;

@SpringBootTest
@Slf4j
public class AssertAssumpTest {

    /**
     * 最簡單的成功用例
     */
    @Test
    void assertSuccess() {
        assertEquals(2, Math.addExact(1,1));
    }

    /**
     * 最簡單的失敗用例
     */
    @Test
    void assertFail() {
        assertEquals(3, Math.addExact(1,1));
    }

    /**
     * assumeTrue不拋出例外的用例
     */
    @Test
    void assumpSuccess() {
        // assumeTrue方法的入參如果為true，就不會拋出例外，后面的代碼才會繼續執行
        assumeTrue(true);
        // 如果列印出此日志，證明assumeTrue方法沒有拋出例外
        log.info("assumpSuccess的assumeTrue執行完成");
        // 接下來是常規的單元測驗邏輯
        assertEquals(2, Math.addExact(1,1));
    }

    /**
     * assumeTrue拋出例外的用例
     */
    @Test
    void assumpFail() {
        // assumeTrue方法的入參如果為false，就會拋出TestAbortedException例外，后面就不會執行了
        assumeTrue(false, "未通過assumeTrue");
        // 如果列印出此日志，證明assumpFail方法沒有拋出例外
        log.info("assumpFail的assumeTrue執行完成");
        // 接下來是常規的單元測驗邏輯，但因為前面拋出了例外，就不再執行了
        assertEquals(2, Math.addExact(1,1));
    }
}

2. 點擊下圖紅框位置執行單元測驗：

3. 執行結果如下：

4. 另外，在target目錄，可以看到surefire插件生成的單元測驗報告TEST-com.bolingcavalry.assertassume.service.impl.AssertAssumpTest.xml，如下圖所示，testcase節點中出現了skipped節點：

• 上述對比驗證再次說明Assertions和Assumptions的區別：都用來對比預期值和實際值，當預期值和實際值不一致時，Assertions的測驗結果是執行失敗，Assumptions的測驗結果是跳過(或者忽略)；

Assumptions實戰

弄清楚的Assertions和Assumptions的區別，接下來趁熱打鐵，學習Assumptions類中幾個重要的靜態方法：assumeTrue、assumingThat

1. 最簡單的用法如下，可見只有assumeTrue不拋出例外，后面的log.info才會執行：

    @Test
    @DisplayName("最普通的assume用法")
    void tryAssumeTrue() {
        assumeTrue("CI".equals(envType));

        log.info("CI環境才會列印的assumeTrue");
    }

2. assumeTrue可以接受Supplier型別作為第二個入參，如果assumeTrue失敗就會將第二個引數的內容作為失敗提示：

@Test
    @DisplayName("assume失敗時帶自定義錯誤資訊")
    void tryAssumeTrueWithMessage() {
        // 第二個入參是Supplier實作，回傳的內容用作跳過用例時的提示資訊
        assumeTrue("CI".equals(envType),
                () -> "環境不匹配而跳過，當前環境：" + envType);

        log.info("CI環境才會列印的tryAssumeTrueWithMessage");
    }

效果如下圖：

3. 還有個assumingThat方法，可以接受Executable型別作為第二個入參，如果第一個入參為true就會執行Executable的execute方法，注意assumingThat方法的特點：不拋出例外，因此其所在的方法不會被跳過，這是和assumeTrue相比最大的區別(assumeTrue一旦入參為false就會拋出例外，其所在方法就被標記為跳過)：

    @Test
    @DisplayName("assume成功時執行指定邏輯")
    void tryAssumingThat() {
        // 第二個入參是Executable實作，
        // 當第一個引數為true時，執行第二個引數的execute方法
        assumingThat("CI".equals(envType),
                () -> {
                    log.info("這一行內容只有在CI環境才會列印");
                });

        log.info("無論什么環境都會列印的tryAssumingThat");
    }

• 接下來咱們執行上述代碼，看看效果；

執行Assumptions代碼

1. 先做準備作業，本次實戰的springboot工程名為assertassume，咱們在工程的resources目錄下添加兩個組態檔：application.properties和application-test.properties，位置如下圖：

2. application-test.properties內容如下：

envType:CI

3. application.properties內容如下：

envType:PRODUCTION

4. 完整的單元測驗類如下，通過注解ActiveProfiles，指定了使用application-test.properties的配置，因此envType的值為CI：

package com.bolingcavalry.assertassume.service.impl;

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.ActiveProfiles;
import static org.junit.jupiter.api.Assumptions.assumeTrue;
import static org.junit.jupiter.api.Assumptions.assumingThat;

@SpringBootTest
@Slf4j
@ActiveProfiles("test")
public class AssumptionsTest {

    @Value("${envType}")
    private String envType;

    @Test
    @DisplayName("最普通的assume用法")
    void tryAssumeTrue() {
        assumeTrue("CI".equals(envType));

        log.info("CI環境才會列印的assumeTrue");
    }

    @Test
    @DisplayName("assume失敗時帶自定義錯誤資訊")
    void tryAssumeTrueWithMessage() {
        // 第二個入參是Supplier實作，回傳的內容用作跳過用例時的提示資訊
        assumeTrue("CI".equals(envType),
                () -> "環境不匹配而跳過，當前環境：" + envType);

        log.info("CI環境才會列印的tryAssumeTrueWithMessage");
    }

    @Test
    @DisplayName("assume成功時執行指定邏輯")
    void tryAssumingThat() {
        // 第二個入參是Executable實作，
        // 當第一個引數為true時，執行第二個引數的execute方法
        assumingThat("CI".equals(envType),
                () -> {
                    log.info("這一行內容只有在CI環境才會列印");
                });

        log.info("無論什么環境都會列印的tryAssumingThat");
    }
}

5. 執行結果如下圖，可見assume通過，所有資訊都被列印出來了：

6. 接下來把代碼中的ActiveProfiles注解那一行注釋掉，如下圖紅框：

7. 執行結果如下，可見tryAssumingThat方法被標記為成功，不過從日志可見assumingThat的第二個入參executable沒有被執行：

• 至此，Assumptions類的常用方法體驗完成，接下來的章節會繼續學習其他常用類；

你不孤單，欣宸原創一路相伴

1. Java系列
2. Spring系列
3. Docker系列
4. kubernetes系列
5. 資料庫+中間件系列
6. DevOps系列

歡迎關注公眾號：程式員欣宸

微信搜索「程式員欣宸」，我是欣宸，期待與您一同暢游Java世界...
https://github.com/zq2599/blog_demos

標籤：Java

上一篇：再見！公司的爛系統……

下一篇：從崩潰的選課系統，論為什么更安全的 HTTPS 協議沒有被全面采用