Concordion - verifyRows命令

Concordion verifyRows命令可用于检查系统返回的集合的内容.例如,如果我们在系统中设置一组用户并对它们进行部分搜索,那么系统应该返回匹配的元素,否则我们的验收测试应该失败.

考虑以下要求 :

<table>
   <tr><th>Users</th></tr>
   <tr><td>Robert De</td></tr>
   <tr><td>John Diere</td></tr>
   <tr><td>Julie Re</td></tr>
</table>

<p>Search for J should return:</p>

<table>
   <tr><th>Matching Users</th></tr>
   <tr><td>John Diere</td></tr>
   <tr><td>Julie Re</td></tr>
</table>

如果我们想要为搜索和返回集合的搜索函数编写规范,那么规范将如下 :

<table concordion:execute = "addUser(#username)">
   <tr><th concordion:set = "#username">Username</th></tr>
   <tr><td>Robert De</td></tr>
   <tr><td>John Diere</td></tr>
   <tr><td>Julie Re</td></tr>
</table>

<p>Search for "<b concordion:set = "#searchString">J</b>" should return:</p>

<table concordion:verifyRows = "#username : search(#searchString)">
   <tr><th concordion:assertEquals = "#username">Matching Usernames</th></tr>
   <tr><td>John Diere</td></tr>
   <tr><td>Julie Re</td></tr>
</table>

当Concordion解析文档时,它将在第一个表的每一行上执行addUser(),然后将searchString设置为J.接下来,Concordion将执行搜索函数,该函数应返回具有可预测迭代顺序的Iterable对象(例如,List,LinkedHashSet或TreeSet),verifyRows为集合的每个项运行并运行assertEquals命令.

示例

让我们使用一个可用的Eclipse IDE并按照下面给出的步骤创建一个Concordion应用程序 :

Step描述
1创建一个名为 concordion的项目在创建的项目中的 src 文件夹下创建一个包 com.it1352.
2使用添加外部JAR 选项添加所需的Concordion库,如 Concordion  -  First Application
3创建Java类系统 com.it1352包下.
4 specs.it1352包下创建Fixture类 SystemFixture .
5创建规范html System.html specs.it1352包下.
6最后一步是创建所有Java文件和规范文件的内容并运行应用程序,如下所述.

这是System.java文件的内容 :

package com.it1352;

import java.util.HashSet;
import java.util.Set;
import java.util.SortedSet;
import java.util.TreeSet;

public class System { 
   private Set<String> users = new HashSet<String>();
	
   public void addUser(String username) {
      users.add(username);
   }
	
   public Iterable<String> search(String searchString) {
      SortedSet<String> matches = new TreeSet<String>();
		
      for (String username : users) {
         if (username.contains(searchString)) {
            matches.add(username);
         }
      }
		
      return matches;
   }
}

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

package specs.it1352;

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

@RunWith(ConcordionRunner.class)

public class SystemFixture {
   System system = new System();
   public void addUser(String username) {
      system.addUser(username);
   }
	
   public Iterable<String> search(String searchString) {
      return system.search(searchString);
   }
}

以下是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 add a partial search capability on user names:</p>
		
      <div class = "example">      
         <h3>Example</h3>
			
         <table concordion:execute = "addUser(#username)">
            <tr><th concordion:set = "#username">Username</th></tr>
            <tr><td>Robert De</td></tr>
            <tr><td>John Diere</td></tr>
            <tr><td>Julie Re</td></tr>
         </table>
			
         <p>Search for "<b concordion:set = "#searchString">J</b>" should return:</p>
			
         <table concordion:verifyRows = "#username : search(#searchString)">
            <tr><th concordion:assertEquals = "#username">Matching Usernames</th></tr>
            <tr><td>John Diere</td></tr>
            <tr><td>Julie Re</td></tr>
         </table>
			
      </div> 
		
   </body>

</html>

完成创建源文件和规范文件之后,让我们以JUnit Test的身份运行应用程序.如果您的应用程序一切正常,那么它将产生以下结果 :

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

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

concordion verifyRows Output