Step by step

Using tests in Jar files

Contents:

Import Jar file
Attach source code
Run tests

Preamble

Tests are distributed as jar files. The procedure to run tests and fix possible problems is as follows:

Note: This procedure has been tested with Eclipse 3.2

Import Jar file

Save the .jar file on the local file system.
If you received the tests by email, it is possible that your email client does not show the correct file name, marking the assignment as a normal (e.g. binary file); then you can save the binary file as test.jar.
Copy&Paste or Drag&Drop the .jar file into the project to be tested
Now the file appears in Eclipse as a normal file represented with the icon ;
We need to add the .jar file to the project classpath
Right click on the .jar file, select Build Path and then Add to Build Path.
Now the icon of the file jar should have been turned into indicating the file has been added to the project classpath.
We need now to add the Junit library (if not already present):
Right click on the .jar file, select Build Path and then Configure Build Path.
The project properties window appears
Select the Libraries tab () and click on the Add Variable button
The new entry dialog appears, select JUNIT_HOME and the click ont the Extend... button
The variable extension dialog appears, showing the available jar files:
Select junit.jar and then click OK
Now the JUnit library should be present in the properties window, click Ok to return to the Eclipse main window.

Attach source code

Up to now it is possible to run the tests but is not possible to look at the test code, which is required to fix the errors possibly revealed by the tests.
You need to associate the source code to the class files:

Right click on the .jar file and chose Properties, the properties window appears:
Select Java Source Attachment then click on Workspace...
Select the .jar file in the current project and click on OK and the again on OK in the properties window.
Now the icon should have been changed into and double-clicking on any class in the .jar file you should be able to see the source code.

Run tests

After the previous set-up it is possible to run the tests.

Expand the jar and the packages contained in it by clicking on the '+' simbols until you locate the AllTests class.
Right click on the class (AllTests.class), select Run As then if it is present chose Junit Test otherwise select .
I the latter case the Run profile dialog should appear:
Then double click on the JUnit item (a new run profile is created) and then click Run
The Junit tab should appear on the left with the result of the tests.

Top of the page