Concordion - 返回对象

Concordion execute 命令可以用来以对象的形式获取行为的结果，通过该对象我们可以获取行为的多个输出。例如，考虑以下需求：

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

我们需要一个拆分函数，它接受用户名并返回一个结果对象，该对象具有名字和姓氏作为其属性，以便我们可以使用它们。

如果我们想为这样一个拆分函数编写规范，该函数将期望用户名并输出结果对象，那么规范如下：

<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”，并将其传递给拆分函数。然后，它将使用 execute 命令使用参数 #TEXT 执行 split() 方法，并将结果设置到 #result 变量中，并使用结果对象打印 firstName 和 lastName 属性作为输出。

示例

让我们准备好一个可运行的 Eclipse IDE，并按照以下步骤创建一个 Concordion 应用程序：

步骤	描述
1	创建一个名为 concordion 的项目，并在创建的项目中的 src 文件夹下创建一个包 com.tutorialspoint。
2	按照 Concordion - 第一个应用程序一章中说明的方法，使用添加外部 JAR 选项添加所需的 Concordion 库。
3	在 com.tutorialspoint 包下创建 Java 类 System、Result。
4	在 specs.tutorialspoint 包下创建 Fixture 类 SystemFixture。
5	在 specs.tutorialspoint 包下创建规范 html 文件 System.html。
6	最后一步是创建所有 Java 文件和规范文件的内容，然后按照以下说明运行应用程序。

以下是 Result.java 文件的内容：

package com.tutorialspoint;
public class Result {
   private String firstName;
   private String lastName;
	
   public String getFirstName() {
      return firstName;
   }
	
   public void setFirstName(String firstName) {
      this.firstName = firstName;
   }
	
   public String getLastName() {
      return lastName;
   }
	
   public void setLastName(String lastName) {
      this.lastName = lastName;
   } 
}

以下是 System.java 文件的内容：

package com.tutorialspoint;
public class System {
   public Result split(String userName){
      Result result = new Result();
      String[] words = userName.split(" ");
      result.setFirstName(words[0]);
      result.setLastName(words[1]);
      return result;
   }
}

以下是 SystemFixture.java 文件的内容：

package specs.tutorialspoint;

import com.tutorialspoint.Result;
import com.tutorialspoint.System;
import org.concordion.integration.junit4.ConcordionRunner;
import org.junit.runner.RunWith;

@RunWith(ConcordionRunner.class)

public class SystemFixture {
   System system = new System();
   public Result 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: 1, Failures: 0

System.html 是 Concordion 测试运行的输出。

打印页面

步骤	描述
1	创建一个名为 concordion 的项目，并在创建的项目中的 src 文件夹下创建一个包 com.tutorialspoint。
2	按照 Concordion - 第一个应用程序一章中说明的方法，使用添加外部 JAR 选项添加所需的 Concordion 库。
3	在 com.tutorialspoint 包下创建 Java 类 System、Result。
4	在 specs.tutorialspoint 包下创建 Fixture 类 SystemFixture。
5	在 specs.tutorialspoint 包下创建规范 html 文件 System.html。
6	最后一步是创建所有 Java 文件和规范文件的内容，然后按照以下说明运行应用程序。