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.