Blog

Concordion – Execute on List

Concordion execute command can be used to run the operation of concordion fixture in a repeating manner. For example, it will be useful if we want to illustrate a requirement with multiple examples in the form of a list.

Consider the following requirement −

<ul>
   <li>The full name Zafrul Khan is to be split as
      <ul>
         <li>Zafrul</li>
         <li>Khan</li>
      </ul>
   </li>
	
   <li>The full name Yash Khan is to be split as
      <ul>
         <li>Yash</li>
         <li>Khan</li>
      </ul>
   </li>
	
</ul>

If we want write a specification for a split function which will split a name into its first name and last name, then the specification would be as follows −

<ul>
   <li>The full name <span concordion:execute = "#result = split(#TEXT)">
      Zafrul Khan</span> is to be splited as
      <ul>
         <li><span concordion:assertEquals = "#result.firstName">Zafrul</span></li>
         <li><span concordion:assertEquals = "#result.lastName">Khan</span></li>
      </ul>
   </li>
	
   <li>The full name <span concordion:execute = "#result = split(#TEXT)">
      Yash Khan</span> is to be splited as
      <ul>
         <li><span concordion:assertEquals = "#result.firstName">Yash</span></li>
         <li><span concordion:assertEquals = "#result.lastName">Khan</span></li>
      </ul>
   </li>
</ul>

When Concordion parses the document, it will set the value of the special variable #TEXT to be the value of the current element as “Zafrul Khan” and pass it to the split function. Then it will execute the split() method with parameters as #TEXT using execute command and set the result into #result variable and using result, print the firstName and lastName values as the output.

Example

Let us have a working Eclipse IDE in place and follow the steps given below to create a Concordion application −

StepDescription
1Create a project with a name concordion and create a package com.Adglob under the src folder in the created project.
2Add required Concordion libraries using Add External JARs option as explained in the Concordion – First Application chapter.
3Create Java class System under the  com.Adglob package.
4Create Fixture class SystemFixture under the specs.Adglob package.
5Create Specification html System.html under the specs.Adglob  package.
6The final step is to create the content of all the Java files and specification file and run the application as explained below.

Here is the content of System.java file −

package com.Adglob;
import org.concordion.api.MultiValueResult;

public class System { 
   public MultiValueResult split(String userName){  
      MultiValueResult result = new MultiValueResult();
      String[] words = userName.split(" ");   
      result.with("firstName", words[0]).with("lastName", words[1]);       
      return result;
   }
}

Following is the content of SystemFixture.java file −

package specs.Adglob;

import org.concordion.api.MultiValueResult;
import org.concordion.integration.junit4.ConcordionRunner;
import org.junit.runner.RunWith;
import com.Adglob.System;

@RunWith(ConcordionRunner.class)

public class SystemFixture {
   System system = new System();
   public MultiValueResult split(String userName){
      return system.split(userName);
   }  
}

Following is the content of System.html file −

<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>
         <ul>
            <li>The full name <span concordion:execute = "#result = split(#TEXT)">
               Zafrul Khan</span> is to be splited as
               <ul>
                  <li><span concordion:assertEquals = "#result.firstName">
                     Zafrul</span></li>
                  <li><span concordion:assertEquals = "#result.lastName">
                     Khan</span></li>
               </ul>
            </li>
				
            <li>The full name <span concordion:execute ="#result = split(#TEXT)">
               Yash Khan</span> is to be splited as
               <ul>
                  <li><span concordion:assertEquals = "#result.firstName">
                     Yash</span></li>
                  <li><span concordion:assertEquals = "#result.lastName">
                     Khan</span></li>
               </ul>
            </li>
         </ul>
      </div>
   </body>

</html>

Once you are done with creating source and specification files, let us run the application as JUnit Test. If everything is fine with your application, then it will produce the following result −

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

Leave a Reply