JUnit5學習之六：引數化測試(Parameterized Tests)基礎

程式設計師欣宸發表於2021-02-27

Zed

歡迎訪問我的GitHub

https://github.com/zq2599/blog_demos

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

關於《JUnit5學習》系列

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

本篇概覽

本文是《JUnit5學習》系列的第六篇，一起來實戰強大引數化測試(Parameterized Tests)，即多次執行同一個測試方法，每次使用不同的引數；
由於引數化測試功能強大，內容也比前幾篇的知識點多，為了方便大家閱讀和實踐，這裡分為《基礎》和《進階》兩篇來介紹，本篇以學習引數化測試(Parameterized Tests)的基礎知識為主，包含以下內容：

極速體驗；
版本依賴；
ValueSource資料來源
null、空字串資料來源
列舉資料來源
方法資料來源
Csv格式資料來源
Csv檔案資料來源

原始碼下載

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

名稱	連結	備註
專案主頁	https://github.com/zq2599/blog_demos	該專案在GitHub上的主頁
git倉庫地址(https)	https://github.com/zq2599/blog_demos.git	該專案原始碼的倉庫地址，https協議
git倉庫地址(ssh)	git@github.com:zq2599/blog_demos.git	該專案原始碼的倉庫地址，ssh協議

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

在這裡插入圖片描述

junitpractice是父子結構的工程，本篇的程式碼在parameterized子工程中，如下圖：

在這裡插入圖片描述

極速體驗

現在，我們們以最少的步驟體驗最簡單的引數化測試；
在父工程junitpractice裡新建名為parameterized的子工程，pom.xml內容如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.bolingcavalry</groupId>
        <artifactId>junitpractice</artifactId>
        <version>1.0-SNAPSHOT</version>
        <relativePath>../pom.xml</relativePath>
    </parent>
    <groupId>com.bolingcavalry</groupId>
    <artifactId>parameterized</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>parameterized</name>
    <description>Demo project for parameterized expirence in Spring Boot junit</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.junit</groupId>
                <artifactId>junit-bom</artifactId>
                <version>5.7.0</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>

    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.jupiter</groupId>
                    <artifactId>junit-jupiter</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

新建測試類HelloTest.java，在這個位置：junitpractice\parameterized\src\test\java\com\bolingcavalry\parameterized\service\impl，內容如下：

package com.bolingcavalry.parameterized.service.impl;

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.MethodOrderer;
import org.junit.jupiter.api.Order;
import org.junit.jupiter.api.TestMethodOrder;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import org.springframework.boot.test.context.SpringBootTest;
import static org.junit.jupiter.api.Assertions.assertTrue;

@SpringBootTest
@Slf4j
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
public class HelloTest {

    @Order(1)
    @DisplayName("多個字串型入參")
    @ParameterizedTest
    @ValueSource(strings = { "a", "b", "c" })
    void stringsTest(String candidate) {
        log.info("stringsTest [{}]", candidate);
        assertTrue(null!=candidate);
    }
}

執行該測試類，結果如下圖：

在這裡插入圖片描述
5. 從上圖可見執行引數化測試需要兩步：首先用@ParameterizedTest取代@Test，表名此方法要執行引數化測試，然後用@ValueSource指定每次測試時的引數來自字串型別的陣列：{ "a", "b", "c" }，每個元素執行一次；
6. 至此，我們們已體驗過最簡單的引數化測試，可見就是想辦法使一個測試方法多次執行，每次都用不同的引數，接下來有關引數化測試的更多配置和規則將配合實戰編碼逐個展開，一起來體驗吧；

版本要求

先看看SpringBoot-2.3.4.RELEASE間接依賴的junit-jupiter-5.6.2版本中，ParameterizedTest的原始碼，如下圖紅框所示，此時的ParameterizedTest還只是體驗版：

在這裡插入圖片描述

再看看junit-jupiter-5.7.0版本的ParameterizedTest原始碼，此時已經是穩定版了：

在這裡插入圖片描述

綜上所述，如果要使用引數化測試，最好是將junit-jupiter升級到5.7.0或更高版本，如果您的應用使用了SpringBoot框架，junit-jupiter是被spring-boot-starter-test間接依賴進來的，需要排除這個間接依賴，再手動依賴進來才能確保使用指定版本，在pom.xml中執行如下三步操作：

dependencyManagement節點新增junit-bom，並指定版本號：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.junit</groupId>
      <artifactId>junit-bom</artifactId>
      <version>5.7.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

排除spring-boot-starter-test和junit-jupiter的間接依賴關係：

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-test</artifactId>
  <scope>test</scope>
  <exclusions>
    <exclusion>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter</artifactId>
    </exclusion>
  </exclusions>
</dependency>

新增junit-jupiter依賴，此時會使用dependencyManagement中指定的版本號：

<dependency>
  <groupId>org.junit.jupiter</groupId>
  <artifactId>junit-jupiter</artifactId>
  <scope>test</scope>
</dependency>

如下圖，重新整理可見已經用上了5.7.0版本：

在這裡插入圖片描述

版本問題解決了，接下來正式開始學習Parameterized Tests，先要了解的是有哪些資料來源；

ValueSource資料來源

ValueSource是最簡單常用的資料來源，支援以下型別的陣列：

    short

    byte

    int

    long

    float

    double

    char

    boolean

    java.lang.String
    
    java.lang.Class

下面是整形陣列的演示：

    @Order(2)
    @DisplayName("多個int型入參")
    @ParameterizedTest
    @ValueSource(ints = { 1,2,3 })
    void intsTest(int candidate) {
        log.info("ints [{}]", candidate);
        assertTrue(candidate<3);
    }

從上述程式碼可見，入參等於3的時候assertTrue無法通過，測試方法會失敗，來看看實際執行效果，如下圖：

在這裡插入圖片描述

null、空字串資料來源

在用字串作為入參時，通常要考慮入參為null的情況，此時ValueSource一般會這樣寫：

@ValueSource(strings = { null, "a", "b", "c" })

此時可以使用@NullSource註解來取代上面的null元素，下面這種寫法和上面的效果一模一樣：

    @NullSource
    @ValueSource(strings = { "a", "b", "c" })

執行結果如下圖紅框，可見null作為入參被執行了一次：

在這裡插入圖片描述
4. 與@NullSource代表null入參類似，@EmptySource代表空字串入參，用法和執行結果如下圖所示：

在這裡插入圖片描述
5. 如果想同時用null和空字串做測試方法的入參，可以使用@NullAndEmptySource，用法和執行結果如下圖所示：

在這裡插入圖片描述

列舉資料來源(EnumSource)

EnumSource可以讓一個列舉類中的全部或者部分值作為測試方法的入參；
建立列舉類Types.java，用於接下來的實戰，如下，很簡單隻有三個值：

public enum Types {
    SMALL,
    BIG,
    UNKNOWN
}

先嚐試用Types的每個值作為入參執行測試，可見只要新增@EnumSource即可，JUnit根據測試方法的入參型別知道要使用哪個列舉：

    @Order(6)
    @DisplayName("多個列舉型入參")
    @ParameterizedTest
    @EnumSource
    void enumSourceTest(Types type) {
        log.info("enumSourceTest [{}]", type);
    }

執行結果如下圖所示：

在這裡插入圖片描述
5. 如果不想執行列舉的所有值，而只要其中一部分，可以在name屬性中指定：

@EnumSource(names={"SMALL", "UNKNOWN"})

執行結果如下圖所示：

在這裡插入圖片描述
7. 也可以指定哪些值不被執行，此時要新增mode屬性並設定為EXCLUDE（mode屬性如果不寫，預設值是INCLUDE，前面的例子中就是預設值）：

@EnumSource(mode= EnumSource.Mode.EXCLUDE, names={"SMALL", "UNKNOWN"})

執行結果如下，可見SMALL和UNKNOWN都沒有執行：

在這裡插入圖片描述

方法資料來源(MethodSource)

@MethodSource可以指定一個方法名稱，該方法返回的元素集合作為測試方法的入參；
先來定義一個方法，該方法一般是static型別(否則要用@TestInstance修飾)，並且返回值是Stream型別：

    static Stream<String> stringProvider() {
        return Stream.of("apple1", "banana1");
    }

然後，測試方法用@MethodSource，並指定方法名stringProvider：

    @Order(9)
    @DisplayName("靜態方法返回集合，用此集合中每個元素作為入參")
    @ParameterizedTest
    @MethodSource("stringProvider")
    void methodSourceTest(String candidate) {
        log.info("methodSourceTest [{}]", candidate);
    }

上面的stringProvider方法和測試方法methodSourceTest在同一個類中，如果它們不在同一個類中，就要指定靜態方法的整個package路徑、類名、方法名，如下所示，類名和方法名之間用#連線：

@Order(10)
    @DisplayName("靜態方法返回集合，該靜態方法在另一個類中")
    @ParameterizedTest
    @MethodSource("com.bolingcavalry.parameterized.service.impl.Utils#getStringStream")
    void methodSourceFromOtherClassTest(String candidate) {
        log.info("methodSourceFromOtherClassTest [{}]", candidate);
    }

如果不在@MethodSource中指定方法名，JUnit會尋找和測試方法同名的靜態方法，舉例如下，靜態方法methodSourceWithoutMethodNameTest會被作為測試方法的資料來源：

    static Stream<String> methodSourceWithoutMethodNameTest() {
        return Stream.of("apple3", "banana3");
    }

    @Order(11)
    @DisplayName("靜態方法返回集合，不指定靜態方法名，自動匹配")
    @ParameterizedTest
    @MethodSource
    void methodSourceWithoutMethodNameTest(String candidate) {
        log.info("methodSourceWithoutMethodNameTest [{}]", candidate);
    }

執行結果如下：

在這裡插入圖片描述

Csv格式資料來源(CsvSource)

前面的測試方法入參都只有一個，在面對多個入參的測試方法時，@CsvSource就派上用場了，演示程式碼如下所示，可見資料是普通的CSV格式，每條記錄有兩個欄位，對應測試方法的兩個入參：

    @Order(12)
    @DisplayName("CSV格式多條記錄入參")
    @ParameterizedTest
    @CsvSource({
            "apple1, 11",
            "banana1, 12",
            "'lemon1, lime1', 0x0A"
    })
    void csvSourceTest(String fruit, int rank) {
        log.info("csvSourceTest, fruit [{}], rank [{}]", fruit, rank);
    }

執行結果如下，通過日誌可以確定，每條記錄的兩個欄位能匹配到測試方法的兩個入參中：

在這裡插入圖片描述

另外@CsvSource還提供了一個屬性nullValues，作用是將指定的字串識別為null，下面這個設定就是把CSV資料中所有的NIL識別為null，再傳給測試方法：

    @Order(13)
    @DisplayName("CSV格式多條記錄入參(識別null)")
    @ParameterizedTest
    @CsvSource(value = {
            "apple2, 21",
            "banana2, 22",
            "'lemon2, lime2', 0x0A",
            "NIL, 3" },
            nullValues = "NIL"
    )
    void csvSourceWillNullTokenTest(String fruit, int rank) {
        log.info("csvSourceWillNullTokenTest, fruit [{}], rank [{}]", fruit, rank);
    }

執行結果如下，可見字串NIL到測試方法後已變成null：

在這裡插入圖片描述

Csv檔案資料來源

@CsvSource解決了測試方法入參有多個欄位的問題，但是把作為入參的測試資料寫在原始檔中似乎不合適，尤其是資料量很大的情況下，這種場景適合用@CsvFileSource，該註解用於指定csv檔案作為資料來源，注意numLinesToSkip屬性指定跳過的行數，可以用來跳過表頭：

    @Order(14)
    @DisplayName("CSV檔案多條記錄入參")
    @ParameterizedTest
    @CsvFileSource(files = "src/test/resources/two-column.csv", numLinesToSkip = 1)
    void csvFileTest(String country, int reference) {
        log.info("csvSourceTest, country [{}], reference [{}]", country, reference);
    }

在src/test/resources/建立檔案two-column.csv，內容如下：

Country, reference
Sweden, 1
Poland, 2
"United States of America", 3

上述程式碼執行結果如下，程式碼中沒有測試資料，顯得更加簡潔一些：

在這裡插入圖片描述

期待《進階》篇

至此，我們們隊JUnit5的引數化測試(Parameterized)有了初步的瞭解，可以通過各種資料來源註解給測試方法制造更多的引數，但僅掌握這些還是不夠的，依然有一些問題待解決，例如更自由的資料來源定製、跟完善的多欄位處理方案等等，下一篇《進階》我們們一起來體驗更多引數化測試的高階功能；

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

歡迎關注公眾號：程式設計師欣宸

微信搜尋「程式設計師欣宸」，我是欣宸，期待與您一同暢遊Java世界...
https://github.com/zq2599/blog_demos

JUnit5學習之七：引數化測試(Parameterized Tests)進階
2021-02-28
Zed
滲透測試學習之報告測試引數五
2022-02-12
軟體測試學習教程—軟體測試基礎理論六
2019-09-03
記學習滲透測試之報告測試引數二
2022-01-21
記學習滲透測試之報告測試引數一
2021-12-24
記學習滲透測試之報告測試引數四
2022-02-12
記學習滲透測試之報告測試引數三
2022-01-28
軟體測試學習資料——Jmeter引數化2
2019-09-05
JMeter
軟體測試學習資料——Jmeter引數化1
2019-09-04
JMeter
fixtrue基礎之params引數實現簡單引數化
2022-08-12
Go基礎學習六之併發concurrency
2019-02-16
Go
hive學習筆記之六：HiveQL基礎
2021-07-05
Hive筆記
效能測試學習筆記：Loadrunner如何進行引數化？
2021-05-13
筆記
.net持續整合測試篇之Nunit引數化測試
2019-08-07
[效能測試] locust學習-基礎篇
2022-04-01
fixtrue基礎之scope引數
2022-08-05
fixtrue基礎之name引數
2022-08-09
fixtrue基礎之autouse引數
2022-08-10
fixtrue基礎之ids引數
2022-08-16
Android面試之——數學基礎知識
2018-03-24
Android面試
fixtrue基礎之測試初始化及測試後清理操作
2022-07-26
JAVA基礎之-引數傳遞
2024-08-19
Java
Hadoop學習之路（六）HDFS基礎
2019-01-23
Hadoop
零基礎如何學習軟體測試
2021-04-12
引數匹配模型——Python學習之引數（二）
2020-04-04
模型Python
Python學習之引數（一）
2019-03-21
Python
python基礎之函式的引數
2020-05-06
Python函式
Vue學習計劃基礎筆記(六) – 元件基礎
2018-07-18
Vue筆記元件
jmeter學習指南之引數化CSV Data Set Config
2019-08-18
JMeter
軟體測試學習教程—軟體測試基礎理論五
2019-09-03
軟體測試學習教程—軟體測試基礎理論四
2019-09-02
軟體測試學習教程—軟體測試基礎理論三
2019-09-02
opencv學習之基礎
2022-05-11
OpenCV
Jmeter基礎004----增加引數化
2020-06-16
JMeter
軟體測試學習資源—Git 基礎使用
2019-08-14
Git
軟體測試學習教程——【大蟒蛇】python基礎
2019-09-18
Python
引數匹配順序——Python學習之引數（三）
2020-04-04
Python
系統學習機器學習之半引數方法（二）--基於密度
2018-12-08
機器學習

JUnit5學習之六：引數化測試(Parameterized Tests)基礎

歡迎訪問我的GitHub

關於《JUnit5學習》系列

本篇概覽

原始碼下載

極速體驗

版本要求

ValueSource資料來源

null、空字串資料來源

列舉資料來源(EnumSource)

方法資料來源(MethodSource)

Csv格式資料來源(CsvSource)

Csv檔案資料來源

期待《進階》篇

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

歡迎關注公眾號：程式設計師欣宸

相關文章