Concordion - comando verifyRows
O comando Concordion verifyRows pode ser usado para verificar o conteúdo de uma coleção retornada como resultado pelo sistema. Por exemplo, se configurarmos um conjunto de usuários no sistema e fizermos uma pesquisa parcial sobre eles, o sistema deverá retornar os elementos correspondentes, caso contrário, nossos testes de aceitação deverão falhar.
Considere o seguinte requisito -
<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>
Se quisermos escrever uma especificação para uma função de pesquisa que irá pesquisar e retornar uma coleção, a especificação será a seguinte -
<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>
Quando o Concordion analisa o documento, ele executará addUser () em cada linha da primeira tabela e, em seguida, definirá o searchString como J. Em seguida, o Concordion executará a função de pesquisa que deve retornar um objeto Iterable com uma ordem de iteração previsível (por exemplo, um List, LinkedHashSet ou TreeSet), verifyRows é executado para cada item da coleção e executa o comando assertEquals.
Exemplo
Vamos ter um Eclipse IDE funcionando e seguir as etapas abaixo para criar um aplicativo Concordion -
Degrau | Descrição |
---|---|
1 | Criar um projeto com um nome concordion e criar um pacote com.tutorialspoint sob asrc pasta no projeto criado. |
2 | Adicione as bibliotecas do Concordion necessárias usando a opção Adicionar JARs externos conforme explicado no capítulo Concordion - Primeiro Aplicativo . |
3 | Crie a classe Java System sob o pacote com.tutorialspoint . |
4 | Crie a classe Fixture SystemFixture sob o pacote specs.tutorialspoint . |
5 | Crie Specification html System.html sob o pacote specs.tutorialspoint . |
6 | A etapa final é criar o conteúdo de todos os arquivos Java e o arquivo de especificação e executar o aplicativo conforme explicado abaixo. |
Aqui está o conteúdo do arquivo System.java -
package com.tutorialspoint;
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;
}
}
A seguir está o conteúdo do arquivo SystemFixture.java -
package specs.tutorialspoint;
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 void addUser(String username) {
system.addUser(username);
}
public Iterable<String> search(String searchString) {
return system.search(searchString);
}
}
A seguir está o conteúdo do arquivo 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>
Quando terminar de criar os arquivos de origem e de especificação, vamos executar o aplicativo como Teste JUnit. Se tudo estiver bem com o seu aplicativo, ele produzirá o seguinte resultado -
C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\concordion\specs\tutorialspoint\System.html
Successes: 2, Failures: 0
System.html é o resultado da execução do teste Concordion.