JUnit

Installer JUnit

Pour installer Junit, il vous faudra télécharger les deux fichiers JAR contenant la librairie : hamcrest-core.jar et junit.jar, disponibles sur le site de Junit. Notons que si vous comptez faire du mocking (Technique de test : le Mocking), PowerMock fournis un fichier zip contenant l'ensemble des dépendances recquises (comprenant JUnit et hamcrest entre autres).

Une fois ces deux fichiers téléchargés, il vous suffira de les ajouter à votre classpath. Pour ce faire, il suffira d'ajouter l'option -cp lors de la compilation et de l'exécution du programme, avec comme argument l'emplacement des deux fichiers. Par exemple, si vous avez placé ces deux fichiers dans le répertoire /usr/share/java/ (location standard), il vous suffit de compiler vos fichiers comme ceci :

javac -cp .:/usr/share/java/junit.jar:/usr/share/java/hamcrest-core.jar MonFichier1.java MonFichier2.java

Vous pourrez ensuite exécuter votre programme comme ceci :

java -cp .:/usr/share/java/junit.jar:/usr/share/java/hamcrest-core.jar MonFichier1

Notez que les ":" dans les chemins des fichiers .jar permettent d'indiquer à l'option -cp que l'on donne le chemin d'un nouveau fichier .jar contenant une librairie Java. Le "." signifie à l'option -cp qu'il faut aussi chercher des classes dans le dossier courant (sur les systèmes UNIX, le "." signifie "le dossier dans lequel on se trouve actuellement")

Méthodes de JUnit

JUnit met à votre disposition différentes fonctions dans son API. L'API de la classe Assert fournit des méthodes très utiles, semblables aux assertions, notamment :

• AssertEquals, qui permet de vérifier si deux objets ou valeurs sont égaux (au sens de equals).
• AssertNotEquals, qui permet de vérifier si deux objets ou valeurs sont différents (au sens de equals).
• AssertTrue, qui permet de vérifier si une expression booléenne est vraie.
• AssertFalse, qui permet de vérifier si une expression booléenne est fausse.
• AssertNull, qui permet de vérifier si une référence vers un objet est null.
• AssertNotNull, qui permet de vérifier si une référence vers un objet est non null
• fail, qui se comporte comme une assertion qui échoue tout le temps (lance toujours une AssertionError).

Ces méthodes peuvent toutes prendre comme premier argument une chaîne de caractères qui contiendra le message d'erreur qui sera affiché lorsque l'assertion échoue. Quand l'assertion échoue, une AssertionError est lancée et le programme s'arrêtera avec le message d'erreur.

Remarque: depuis la version 4 de JUnit, il existe maintenant des assertions du type

assertThat(feedback,studentValue,is(CorrectValue))

Ces assertions ont l'avantage d'être plus lisible. Pour plus d'information, voir la documentation officielle de JUnit