使用ezSpec落實行為驅動開發與實例化需求（6）：Scenario Outline

March 21 18:06~19:30

▲一個Test Method，N個綠燈

 

前言

上一集介紹在ezSpec中四種撰寫Scenario Outline的方式（請參考<使用ezSpec落實行為驅動開發與實例化需求（5）：撰寫Scenario Outline的四種方法>），所使用的Examples是比較簡單的單一表格。這一集介紹當Scenario Outline的Examples比較複雜的時候，該如何表達這些Examples。

***

JUnit 5的ArgumentsProvider

在說明如何表達複雜的Examples之前，先介紹兩個基本的介面/類別：ArgumentsProvider與Junit5Examples。

JUnit 5 的@ParameterizedTest原本就支援好幾種提供測試資料的方式，上一集使用最簡單的@CsvSource，這一集要用ArgumentsProvider來提供測試資料。參考圖1，ArgumentsProvider是一個介面，只有一個provideArguments method，回傳Stream<? extends Arguments>。

Arguments也是一個介面，參考圖2，它身上有一個get mehtod，回傳 Object 陣列，這就是存放參數的地方。

 

▲圖1：JUnit 5的ArgumentsProvider 介面

 

▲圖2：JUnit 5的Arguments介面

***

ezSpec的Junit5Examples

ArgumentsProvider是JUnit 5 設計給的@ParameterizedTest使用的介面，ezSpec的Scenario Outline接受的參數是Examples，兩者介面不同。因此Teddy設計一個Junit5Examples抽象類別，透過它可以轉換ezSpec的Examples以及 JUnit 5的ArgumentsProvider，如圖3所示。

 

▲圖3：ezSpec的Junit5Examples抽象類別

***

 

RenameWorkflow Use Case的Scenario Outline

參考圖4，假設你要幫ezKanban的RenameWorkflow使用案例定規格，你想到兩個主要的Scenarios：

• Scenario 1：新的名稱與舊的名稱不同，執行RenameWorkflow使用案例之後會產生一個領域事件。
• Scenario 2：新的名稱與舊的名稱相同，執行RenameWorkflow使用案例之後不會產生領域事件。

針對這兩個Scenario，你一共找出五種不同的測試資料，例如把Workflow的名字從dev改成deV、從dev改成DEV，或是從dev改成dev。

 

▲圖4：Rename a workflow 範例

 

圖4的Scenario Outline，要如何用ezSpec來表達？首先定義測試資料，請參考圖5與圖6。

 

▲圖5：不同Workflow名稱的測試資料（Examples）

 

▲圖6：相同Workflow名稱的測試資料（Examples）

 

準備好Examples之後，就可以在Scenario Outline中使用它們。參考圖7，採用上一集所介紹的方法一來撰寫Scenario Outline，唯一不同處在第61行：

WithExamples( Junit5Examples.get(different_name_examples.class),

                          Junit5Examples.get(same_name_examples.class))

直接指定Examples的class name來獲得測試資料。

 

▲圖7：使用Junit5Examples的具體類別當作測試資料來源提供給ezSpec

 

另外，different_name_examples與same_name_examples也可以作為@ParameterizedTest的資料來源，用來執行Scenario Outline的，請參考圖8。

▲圖8：使用Junit5Examples的具體類別當作測試資料來源提供給@ParameterizedTest

***

更複雜的測試資料：表格中還有表格

請參考圖9，這是提供給ezKanban的MoveLane使用案例的驗收測試資料，其中givenWorkflow表示在Given階段初始化的Workflow狀態，expectedSubStageAsRootStage表示移動Lane之後Workflow的狀態。

 

▲圖9：Examples包含表格的範例

 

MoveLane的Scenario Outline如圖10所示，可以看到在89行指定了<given_workflow>參數（圖9中的givenWorkflow表格），以及在123行指定了<expected_workflow>參數（圖9中的expectedSubStageAsRootStage表格）。

▲圖10：MoveLane Scenario Outline範例

 

圖10的執行結果如圖11所示，可以看到第22是最外層的Examples表格，其內部的given_workflow與expected_workflow這兩個column各是另一個表格。可以透過ezSpec很簡單的設計複雜的驗收測試資料，使用上也很簡單。

▲圖11：MoveLane Scenario Outline執行結果報表（只顯示部分）

***

結語

透過ezSpec的Junit5Examples可以設計同時讓ezSpec與JUnit 5的ParameterizedTest所使用的驗收測試資料，每一種測試資料獨立定義在一個Junit5Examples類別中，容易管理與撰寫。

寫到這裡，常用的ezSpec功能已經介紹完畢。下一集介紹Background，可以用來將相同的Given寫在一起，以利重複使用與減少重複程式碼。

***

友藏內心獨白：Table內的Table，還是Table。