Ant - JUnit Integration
JUnit is the commonly used unit testing framework for Java-based developments. It is easy to use and easy to extend. There are a number of JUnit extensions available. If you are unfamiliar with JUnit, you should download it from www.junit.org and read its manual.
This chapter shows how to execute JUnit tests using Ant. Ant makes it straight forward through the JUnit task.
The attributes of the JUnit task are presented below −
| Sr.No. |
Properties & Description |
| 1 |
dir
Where to invoke the VM from. This is ignored when fork is disabled. |
| 2 |
jvm
Command used to invoke the JVM. This is ignored when fork is disabled. |
| 3 |
fork
Runs the test in a separate JVM |
| 4 |
errorproperty
The name of the property to set if there is a JUnit error |
| 5 |
failureproperty
The name of the property to set if there is a JUnit failure |
| 6 |
haltonerror
Stops execution when a test error occurs |
| 7 |
haltonfailure
Stops execution when a failure occurs |
| 8 |
printsummary
Advises Ant to display simple statistics for each test |
| 9 |
showoutput
Advises Ant to send the output to its logs and formatters |
| 10 |
tempdir
Path to the temporary file that Ant will use |
| 11 |
timeout
Exits the tests that take longer to run than this setting (in milliseconds). |
Let us continue the theme of the Hello World Fax web application and add a JUnit target.
The following example shows a simple JUnit test execution −
<target name = "unittest">
<junit haltonfailure = "true" printsummary = "true">
<test name = "com.howcodex.UtilsTest"/>
</junit>
</target>
This example shows the execution of JUnit on the com.howcodex.UtilsTest junit class. Running the above code produces the following output −
test:
[echo] Testing the application
[junit] Running com.howcodex.UtilsTest
[junit] Tests run: 12, Failures: 0, Errors: 0, Time elapsed: 16.2 sec
BUILD PASSED
