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测试运行的输出.