JUnit5的條件測試、巢狀測試、重複測試

測試開發客棧發表於2021-07-14

條件測試

JUnit5支援條件註解，根據布林值判斷是否執行測試。

自定義條件

@EnabledIf和@DisabledIf註解用來設定自定義條件，示例：

@Test
@EnabledIf("customCondition")
void enabled() {
    // ...
}

@Test
@DisabledIf("customCondition")
void disabled() {
    // ...
}

boolean customCondition() {
    return true;
}

其中customCondition()方法用來返回布林值，它可以接受一個ExtensionContext型別的引數。如果定義在測試類外部，那麼需要是static方法。

內建條件

JUnit5的org.junit.jupiter.api.condition包中內建了一些條件註解。

作業系統條件

@EnabledOnOs和DisabledOnOs，示例：

@Test
@EnabledOnOs(MAC)
void onlyOnMacOs() {
    // ...
}

@TestOnMac
void testOnMac() {
    // ...
}

@Test
@EnabledOnOs({ LINUX, MAC })
void onLinuxOrMac() {
    // ...
}

@Test
@DisabledOnOs(WINDOWS)
void notOnWindows() {
    // ...
}

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Test
@EnabledOnOs(MAC)
@interface TestOnMac {
}

JRE條件

@EnabledOnJre和@DisabledOnJre用於指定版本，@EnabledForJreRange和@DisabledForJreRange用於指定版本範圍，示例：

@Test
@EnabledOnJre(JAVA_8)
void onlyOnJava8() {
    // ...
}

@Test
@EnabledOnJre({ JAVA_9, JAVA_10 })
void onJava9Or10() {
    // ...
}

@Test
@EnabledForJreRange(min = JAVA_9, max = JAVA_11)
void fromJava9to11() {
    // ...
}

@Test
@EnabledForJreRange(min = JAVA_9)
void fromJava9toCurrentJavaFeatureNumber() {
    // ...
}

@Test
@EnabledForJreRange(max = JAVA_11)
void fromJava8To11() {
    // ...
}

@Test
@DisabledOnJre(JAVA_9)
void notOnJava9() {
    // ...
}

@Test
@DisabledForJreRange(min = JAVA_9, max = JAVA_11)
void notFromJava9to11() {
    // ...
}

@Test
@DisabledForJreRange(min = JAVA_9)
void notFromJava9toCurrentJavaFeatureNumber() {
    // ...
}

@Test
@DisabledForJreRange(max = JAVA_11)
void notFromJava8to11() {
    // ...
}

JVM系統屬性條件

@EnabledIfSystemProperty和@DisabledIfSystemProperty，示例：

@Test
@EnabledIfSystemProperty(named = "os.arch", matches = ".*64.*")
void onlyOn64BitArchitectures() {
    // ...
}

@Test
@DisabledIfSystemProperty(named = "ci-server", matches = "true")
void notOnCiServer() {
    // ...
}

環境變數條件

@EnabledIfEnvironmentVariable和@DisabledIfEnvironmentVariable，示例：

@Test
@EnabledIfEnvironmentVariable(named = "ENV", matches = "staging-server")
void onlyOnStagingServer() {
    // ...
}

@Test
@DisabledIfEnvironmentVariable(named = "ENV", matches = ".*development.*")
void notOnDeveloperWorkstation() {
    // ...
}

巢狀測試

巢狀測試可以幫助我們對測試結構進行分層。藉助於Java巢狀類的語法，JUnit5可以通過@Nested註解，實現巢狀測試，示例：

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;

import java.util.EmptyStackException;
import java.util.Stack;

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Test;

@DisplayName("A stack")
class TestingAStackDemo {

    Stack<Object> stack;

    @Test
    @DisplayName("is instantiated with new Stack()")
    void isInstantiatedWithNew() {
        new Stack<>();
    }

    @Nested
    @DisplayName("when new")
    class WhenNew {

        @BeforeEach
        void createNewStack() {
            stack = new Stack<>();
        }

        @Test
        @DisplayName("is empty")
        void isEmpty() {
            assertTrue(stack.isEmpty());
        }

        @Test
        @DisplayName("throws EmptyStackException when popped")
        void throwsExceptionWhenPopped() {
            assertThrows(EmptyStackException.class, stack::pop);
        }

        @Test
        @DisplayName("throws EmptyStackException when peeked")
        void throwsExceptionWhenPeeked() {
            assertThrows(EmptyStackException.class, stack::peek);
        }

        @Nested
        @DisplayName("after pushing an element")
        class AfterPushing {

            String anElement = "an element";

            @BeforeEach
            void pushAnElement() {
                stack.push(anElement);
            }

            @Test
            @DisplayName("it is no longer empty")
            void isNotEmpty() {
                assertFalse(stack.isEmpty());
            }

            @Test
            @DisplayName("returns the element when popped and is empty")
            void returnElementWhenPopped() {
                assertEquals(anElement, stack.pop());
                assertTrue(stack.isEmpty());
            }

            @Test
            @DisplayName("returns the element when peeked but remains not empty")
            void returnElementWhenPeeked() {
                assertEquals(anElement, stack.peek());
                assertFalse(stack.isEmpty());
            }
        }
    }
}

外部測試類通過@BeforeEach向內部測試類傳遞變數。

執行後結果：

writing tests nested test ide

重複測試

@RepeatedTest註解能控制測試方法的重複執行次數，示例：

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

import java.util.logging.Logger;

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.RepeatedTest;
import org.junit.jupiter.api.RepetitionInfo;
import org.junit.jupiter.api.TestInfo;

class RepeatedTestsDemo {

    private Logger logger = // ...

    @BeforeEach
    void beforeEach(TestInfo testInfo, RepetitionInfo repetitionInfo) {
        int currentRepetition = repetitionInfo.getCurrentRepetition();
        int totalRepetitions = repetitionInfo.getTotalRepetitions();
        String methodName = testInfo.getTestMethod().get().getName();
        logger.info(String.format("About to execute repetition %d of %d for %s", //
            currentRepetition, totalRepetitions, methodName));
    }

    @RepeatedTest(10)
    void repeatedTest() {
        // ...
    }

    @RepeatedTest(5)
    void repeatedTestWithRepetitionInfo(RepetitionInfo repetitionInfo) {
        assertEquals(5, repetitionInfo.getTotalRepetitions());
    }

    @RepeatedTest(value = 1, name = "{displayName} {currentRepetition}/{totalRepetitions}")
    @DisplayName("Repeat!")
    void customDisplayName(TestInfo testInfo) {
        assertEquals("Repeat! 1/1", testInfo.getDisplayName());
    }

    @RepeatedTest(value = 1, name = RepeatedTest.LONG_DISPLAY_NAME)
    @DisplayName("Details...")
    void customDisplayNameWithLongPattern(TestInfo testInfo) {
        assertEquals("Details... :: repetition 1 of 1", testInfo.getDisplayName());
    }

    @RepeatedTest(value = 5, name = "Wiederholung {currentRepetition} von {totalRepetitions}")
    void repeatedTestInGerman() {
        // ...
    }

}

其中name可以用來自定義重複測試的顯示名字，{currentRepetition}和{totalRepetitions}是當前次數和總共次數的變數。

執行結果：

├─ RepeatedTestsDemo ✔
│  ├─ repeatedTest() ✔
│  │  ├─ repetition 1 of 10 ✔
│  │  ├─ repetition 2 of 10 ✔
│  │  ├─ repetition 3 of 10 ✔
│  │  ├─ repetition 4 of 10 ✔
│  │  ├─ repetition 5 of 10 ✔
│  │  ├─ repetition 6 of 10 ✔
│  │  ├─ repetition 7 of 10 ✔
│  │  ├─ repetition 8 of 10 ✔
│  │  ├─ repetition 9 of 10 ✔
│  │  └─ repetition 10 of 10 ✔
│  ├─ repeatedTestWithRepetitionInfo(RepetitionInfo) ✔
│  │  ├─ repetition 1 of 5 ✔
│  │  ├─ repetition 2 of 5 ✔
│  │  ├─ repetition 3 of 5 ✔
│  │  ├─ repetition 4 of 5 ✔
│  │  └─ repetition 5 of 5 ✔
│  ├─ Repeat! ✔
│  │  └─ Repeat! 1/1 ✔
│  ├─ Details... ✔
│  │  └─ Details... :: repetition 1 of 1 ✔
│  └─ repeatedTestInGerman() ✔
│     ├─ Wiederholung 1 von 5 ✔
│     ├─ Wiederholung 2 von 5 ✔
│     ├─ Wiederholung 3 von 5 ✔
│     ├─ Wiederholung 4 von 5 ✔
│     └─ Wiederholung 5 von 5 ✔

小結

本文分別對JUnit5的條件測試、巢狀測試、重複測試進行了介紹，它們可以使得測試更加靈活和富有層次。除了這些，JUnit5還支援另一個重要且常見的測試：引數化測試。

參考資料：

https://junit.org/junit5/docs/current/user-guide/#writing-tests-conditional-execution

https://junit.org/junit5/docs/current/user-guide/#writing-tests-nested

https://junit.org/junit5/docs/current/user-guide/#writing-tests-repeated-tests

Junit5系列-Junit5中DisabledCondition條件測試執行
2019-01-10
OGG雙向條件複製的部署與測試
2018-03-28
測試測試測試測試測試測試
2024-09-03
C++ 巢狀類簡單測試
2024-08-30
C++巢狀
測試平臺系列(84) 支援複製其他前置條件
2021-11-29
JUnit5編寫基本測試
2021-07-09
TestNG測試框架之失敗測試重跑
2020-12-19
框架
[20190502]查詢條件不等於測試.txt
2019-05-03
測試—測試方法
2020-10-06
測試測試用
2019-01-03
MySQL製作具有千萬條測試資料的測試庫
2020-11-29
MySql
小測試：HashSet可以插入重複的元素嗎？
2023-11-05
JUnit5依賴注入與測試介面
2021-07-18
依賴注入
App測試、Web測試和介面測試一般測試流程
2022-05-07
APPWeb
Flutter 學習之路 - 測試（單元測試，Widget 測試，整合測試）
2019-04-10
Flutter
測試面試-測試用例
2020-12-05
面試
MariaDB刪除重複記錄效能測試
2018-06-13
介面測試測試流程
2022-05-05
測試工作重複枯燥，必須成為測開才能避免？
2020-12-28
測試——水杯的測試用例
2018-08-05
介面測試，負載測試，併發測試，壓力測試區別
2021-08-31
負載
功能測試、自動化測試、效能測試的區別
2024-03-06
軟體測試中的功能測試和非功能測試
2022-12-30
小白測試系列:介面測試與效能測試的區別
2020-07-31
Tessy—支援複雜場景測試的單元整合測試工具
2020-10-29
Laravel 單元測試實戰（4）- 測試成功後的方法重構並再次測試透過
2022-09-26
Laravel
測試CMS同步測試CMS同步測試CMS同步
2020-07-29
（一）效能測試（壓力測試、負載測試）
2020-12-15
負載
程式碼重構與單元測試——重構1的單元測試（四）
2021-07-22
Jmeter介面測試+效能測試
2024-04-16
JMeter
介面測試 - 引數測試
2024-05-17
【軟體測試】——介面測試
2020-12-26
黑盒測試、白盒測試與灰盒測試方法
2021-12-24
微服務測試之介面測試和契約測試
2019-04-08
微服務
測試之Java單元測試、Android單元測試
2018-06-23
JavaAndroid
程式碼重構與單元測試——測試專案（二）
2021-07-06
Sysbench測試神器：一條命令生成百萬級測試資料
2020-10-27
軟體測試應該重點關注的測試過程，廣東軟體測試公司推薦
2022-12-06