Concordion - 返回多值結果

Concordion 的 execute 命令可以用來以 Map 的形式獲取行為的結果，透過它我們可以獲取行為的多個輸出。例如，考慮以下需求：

The full name Robert De is to be broken into its first name Robert and last name De.

這裡我們需要一個 split 函式，它接受一個使用者名稱並返回一個 Map 物件，該物件具有 firstName 和 lastName 作為鍵，並帶有它們對應的值，以便我們可以使用它們。

如果我們想編寫一個這樣的 split 函式的規範，它將接受一個使用者名稱並輸出一個結果物件，那麼規範如下：

<p>The full name <span concordion:execute = "#result = split(#TEXT)">Robert 
   De</span> is to be broken into first name 
   <span concordion:assertEquals = "#result.firstName">Robert</span> and last name 
   <span concordion:assertEquals = "#result.lastName">De</span>.</p>

當 Concordion 解析文件時，它會將特殊變數 #TEXT 的值設定為當前元素的值“Robert De”，並將其傳遞給 split 函式。然後，它將使用 execute 命令使用引數 #TEXT 執行 split() 方法，並將結果設定為 #result 變數，並使用結果對映列印 firstName 和 lastName 值作為輸出。

示例

讓我們準備好一個可執行的 Eclipse IDE，並按照以下步驟建立一個 Concordion 應用程式：

步驟	描述
1	建立一個名為 concordion 的專案，並在建立的專案的 src 資料夾下建立一個名為 com.tutorialspoint 的包。
2	如Concordion - 第一個應用程式章節所述，使用新增外部 JAR 選項新增所需的 Concordion 庫。
3	在 com.tutorialspoint 包下建立 Java 類 System。
4	在 specs.tutorialspoint 包下建立 Fixture 類 SystemFixture。
5	在 specs.tutorialspoint 包下建立規範 html 檔案 System.html。
6	最後一步是建立所有 Java 檔案和規範檔案的內容，並按如下所述執行應用程式。

這是 System.java 檔案的內容：

package com.tutorialspoint;
import org.concordion.api.MultiValueResult;

public class System { 
   public MultiValueResult split(String userName){  
      MultiValueResult result = new MultiValueResult();
      String[] words = userName.split(" ");   
      result.with("firstName", words[0]).with("lastName", words[1]);       
      return result;
   }
}

以下是 SystemFixture.java 檔案的內容：

package specs.tutorialspoint;

import org.concordion.api.MultiValueResult;
import org.concordion.integration.junit4.ConcordionRunner;
import org.junit.runner.RunWith;

import com.tutorialspoint.System;

@RunWith(ConcordionRunner.class)
public class SystemFixture {
   System system = new System();
   public MultiValueResult split(String userName){
      return system.split(userName);
   }  
}

以下是 System.html 檔案的內容：

<html xmlns:concordion = "http://www.concordion.org/2007/concordion">
   <head>
      <link href = "../concordion.css" rel = "stylesheet" type = "text/css" />
   </head>

   <body>
      <h1>System Specifications</h1>
      <p>We are building specifications for our online order tracking application.</p>
      <p>Following is the requirement to split full name of a logged in 
         user to its constituents by splitting name by whitespace:</p>
		
      <div class = "example">      
         <h3>Example</h3>
         <p>The full name <span concordion:execute = "#result = split(#TEXT)">Robert De</span> 
            is to be broken into first name <span 
            concordion:assertEquals = "#result.firstName">Robert</span> and last name <span 
            concordion:assertEquals = "#result.lastName">De</span>.</p>
      </div>
		
   </body>

</html>

建立原始檔和規範檔案後，讓我們將其作為 JUnit 測試執行。如果應用程式一切正常，則會產生以下結果：

C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\concordion\specs\tutorialspoint\System.html
Successes: 2, Failures: 0

System.html 是 Concordion 測試執行的輸出。

列印頁面