Comment tester avec JUnit

Voir aussi

• JUnit par Lionel Seinturier
• Get Acquainted with the New Advanced Features of JUnit 4 by Antonio Goncalves

Définition de la classe de tests

import org.junit.*;
import static org.junit.Assert.*;

public class JUnitGestionParametres {

Méthodes fournies par JUnit (org.junit.Assert) :

• assertEquals( [ String message , ] expected, actual )
  • objet : Object; la méthode equals appelée pour tester l'égalité
  • expected, actual : int, float, double, boolean
  • message : facultatif (si absent message par défaut de JUnit)
• assertEquals( [ String message , ] expected, actual, delta )
  pour les types float et double
  retourne vrai si actual est dans l'intervalle [expected-delta, expected+delta]
• assertNull( [ String message, ] Object object )
• assertSame( [ String message, ] expected, actual )
• assertTrue( [ String message, ] boolean condition )
• assertFalse( [ String message, ] boolean condition )
• assertArrayEquals( Object[], Object[] )
  égalité de référence
• fail( [ String message ] )
  conduit à l'échec du test

Exécution de tests

• Par défaut JUnit exécute dans une classe de test toutes les méthodes publiques avec l'annotation @Test

      @Test
      public void testGetParametre2() throws InvalidStringException,
          AlreadyExistsException, NonExistentException {
        gp.addParametre(NOM_PARAMETRE_LEGAL1, VALEUR_PARAMETRE_LEGAL1);
        gp.setParametre(NOM_PARAMETRE_LEGAL1, VALEUR_PARAMETRE_LEGAL2);
        assertEquals(VALEUR_PARAMETRE_LEGAL2, gp.getParametre(NOM_PARAMETRE_LEGAL1));
      }

• Si un test doit se terminer par une exception, on utilise une annotation paramétrée :
  @Test(expected = une_classe_d_exception.class)

      @Test(expected = InvalidStringException.class)
      public void testInvalidStringException2() throws InvalidStringException,
          AlreadyExistsException {
        gp.addParametre(STRING_VIDE, VALEUR_PARAMETRE_LEGAL1);
      }

• Le fichier JUnitGestionParametres.java contient les tests unitaires pour la classe GestionParametres.

Exécution de tests JUnit en Eclipse

Les tests sont exécutés en sélectionnant Run comme tests JUnit dans le menu Run pour une ressource correspondant à des tests :

• un répertoire contenant des cas de tests
• une classe de test

Exécution de tests JUnit - version 3.8.1

À la ligne de commande :

java -classpath /jupiter/home/iglewski/junit3.8.1/junit.jar:/jupiter/home/iglewski/ens/inf1583/CVS/lib/exam.jar \
junit.textui.TestRunner tests.JUnitDifferenceDeuxMots

Avec un interface graphique Swing :

java -classpath /jupiter/home/iglewski/junit3.8.1/junit.jar:/jupiter/home/iglewski/ens/inf1583/CVS/lib/exam.jar \
junit.swingui.TestRunner tests.JUnitDifferenceDeuxMots

Initialisation des tests

• chaque méthode de test est exécutée indépendamment des autres
• besoin de préparer l'environnement de tests
  • méthode avec l'annotation @Before exécutée avant chaque méthode de test
  • méthode avec l'annotation @BeforeClass exécutée avant le premier test
  • méthode avec l'annotation @After exécutée après chaque méthode de test
  • méthode avec l'annotation @AfterClass exécutée après tous les tests de cette classe

Suite de tests

Pour créer une suite de tests, on peut utiliser le schéma ci-dessous. La classe annotée avec @RunWith exécutera les tests qui se trouvent dans les classes indiquées par @SuiteClasses.

import org.junit.runner.RunWith;
import org.junit.runners.Suite;

@RunWith(Suite.class)
@Suite.SuiteClasses({
  JUnitGestionParametres.class,
  JUnitQuestionReponseU.class
})
public class TousLesTests {
}

Le fichier TousLesTests.java contient une suite de tests.

Autres fonctionnalités

• Pour ignorer un test, ajoutez l'annotation @Ignore avant ou après @Test.
• @Test peut utiliser un paramètre optionnel qui limite le temps d'exécution (en millisecondes). Utile si le code contient une boucle.

      @Test(timeout=1)
      public void testGetParametre2() throws InvalidStringException,
          AlreadyExistsException, NonExistentException {
        gp.addParametre(NOM_PARAMETRE_LEGAL1, VALEUR_PARAMETRE_LEGAL1);
        gp.setParametre(NOM_PARAMETRE_LEGAL1, VALEUR_PARAMETRE_LEGAL2);
        assertEquals(VALEUR_PARAMETRE_LEGAL2, gp.getParametre(NOM_PARAMETRE_LEGAL1));
      }

• Tests paramétrés - la possibilité d'exécuter le test sur un ensemble de données

    import Fibonacci;
    import java.util.Collection;
    import java.util.Arrays;
  
    import org.junit.Test;
    import static org.junit.Assert.assertEquals;
    import org.junit.runner.RunWith;
    import org.junit.runners.Parameterized;
    import org.junit.runners.Parameterized.Parameters;
  
    @RunWith(Parameterized.class)
    public class FibonacciTest {
      @Parameters
      public static Collection data() {
        return Arrays.asList(new Object[][] { { 0, 0 }, { 1, 1 }, { 2, 1 },
                { 3, 2 }, { 4, 3 }, { 5, 5 }, { 6, 8 } });
      }
  
      private int fInput;
      private int fExpected;
  
      public FibonacciTest(int input, int expected) {
        fInput = input;
        fExpected = expected;
      }
  
      @Test public void test() {
        assertEquals(fExpected, Fibonacci.calculer(fInput));
      }
    }
  
    ///////////////
  
    public class Fibonacci {
      public static int calculer(int i){
        int k1 = 0, k2 = 1;
        for (int m=0; m<i; m++){
          int temp = k1;
          k1 = k2;
          k2 = temp + k1;
        }
        return k1;
      }
    }

Un mauvais test

Parmi les deux tests ci-dessous, le premier est plus significatif.

assertTrue("opérateur de puissance produit un mauvais résultat", puissance(2,3) == 8);
assertTrue("opérateur de puissance produit un mauvais résultat", puissance(2,2) == 4);

Il y a plus de chances dans le deuxième cas que le test réussise par "hasard".