JUnit Launcher (junit.jar)

The JUnit launcher allows interfacing with JUnit v3 or v4 tests.
It has been tested with JUnit v4.7.


Configuration

The junit.xml file allows pre-configuring the launcher with some default values:


Parameter Description
General
Test root path This must indicate where are located all the JUnit tests.
This is a root path. Each test in XStudio has a canonical path that will be appended to this path.
This path MUST not include an ending slash.

Default value is: C:/build/classes
Additional classpath This must indicate potential additional jar classpath necessary to test the SUT. This can contain several path separated by ‘;’.

Default value is empty
JUnit
JUnit version This must indicate the version of JUnit. Indeed, JUnit v3.x and JUnit v4.x are using different mechanism to run the tests.

Default value is: JUnit4
Java install path This must indicate the path to the java install.

Default value is: C:/Program Files/Java/jdk1.6.0_06
JUnit jar path This must indicate the path to the JUnit library.

Default value is: C:/Program Files/junit4.7/junit-4.7.jar


These values can be changed while creating the campaign session from XStudio.


Requirements

The tests are executed by the launcher using this syntax:


For JUnitv3:
"<javaInstallPath>/bin/java.exe" –classpath "<junitJarPath>;<additionalClassPath>;<testRootPath>"
junit.textui.TestRunner <testPath>.<testName>

For JUnitv4:
"<javaInstallPath>/bin/java.exe" –classpath "<junitJarPath>;<additionalClassPath>;<testRootPath>"
org.junit.runner.JUnitCore <testPath>.<testName>

And this is executed from the working directory <testRootPath>


The test will be marked as passed or failed depending on the log file generated by JUnit. The text file is parsed by the launcher. The log and the execution trace of the command are also attached to the testcase execution in XStudio.


Tutorial: Creating and executing JUnit tests

In this tutorial, we will learn to run some AutoIt test scripts.


Prerequisites

Install JUnit 4.7 in the folder C:\Program files\JUnit4.7



Create a dedicated category for JUnit tests and create a test

  • create a category JUnit associated to the launcher junit.jar
  • under this category, create (somewhere in the tree) a test with name MoneyTest and with a canonical path set to org.junit.samples.money.



Creating a test campaign

  • create a campaign including only the test MoneyTest
  • create a campaign session specifying in the configuration:
    • Test root path: C:/Program Files/junit4.7 (in this case, the test root path must be set this way because the test MoneyTest is part of JUnit and physically stored at the location: C:/Program files/Junit4.7/org/junit/samples/money/Moneytest).
    • Additional classpath: <empty>
    • JUnit version: JUnit4
    • Java install path: C:/Program Files/Java/jdk1.6.0_06
    • JUnit jar path: C:/Program Files/junit4.7/junit-4.7.jar



Run a campaign session

Run the campaign session