Tests unitaires en Java - Qualité de Développement

Structure du projet¶

Supposons que votre projet a la structure suivante :

src/
    myfirstpackage/
        MyFirstClass.java
        MySecondClass.java
    mysecondpackage/
        MyThirdClass.java
        MyFourthClass.java

Dans ce cas, vous allez créer un répertoire tests/ qui aura la même structure et sera au même niveau que le répertoire src/ :

src/
    myfirstpackage/
        MyFirstClass.java
        MySecondClass.java
    mysecondpackage/
        MyThirdClass.java
        MyFourthClass.java
tests/
    myfirstpackagetest/
        MyFirstClassTest.java
        MySecondClassTest.java
    mysecondpackagetest/
        MyThirdClassTest.java
        MyFourthClassTest.java

Compilation automatique des tests¶

Pour compiler automatiquement les tests unitaires sous Eclipse :

Dans Project, assurez-vous que l’option Build automatically est activée.
Dans File > Properties, cliquez sur Java Build Path.
Dans l’onglet Source, cliquez sur le bouton Add Folder et ajoutez le répertoire tests/.
Nous avons besoin des assertions pour les tests unitaires mais assert est ignoré par défaut en Java, il faut donc ajouter l’option -ea (enable assertions) dans Run > Run configurations... > Arguments > VM arguments.

Syntaxes¶

Voici un example simple de test unitaire en Java :

MyFirstClass.java

MyFirstClassTest.java

package myfirstpackage;

public class MyFirstClass {
    public static int myStaticMethod(int myArgument) {
        // Some code
        throw new IllegalArgumentException("Some exception");
        // Some more code
        return 0; // Some return value
    }
}

package myfirstpackagetest;
import myfirstpackage.MyFirstClass;

public class MyFirstClassTest {
    public static void main(String[] args) {
        myStaticMethod_NormalInput_ExpectedReturnValue();
        myStaticMethod_IllegalInput_ThrowsIllegalArgumentException();
        System.out.println("All tests passed.");
    }

    private static void myStaticMethod_NormalInput_ExpectedReturnValue() {
        assert(MyFirstClass.myStaticMethod(0) == 0);
        System.out.println("myStaticMethod_NormalInput_ExpectedReturnValue passed.");
    }

    private static void myStaticMethod_IllegalInput_ThrowsIllegalArgumentException() {
        try {
            MyFirstClass.myStaticMethod(-1);
            assert false : "No exception thrown.";
        } catch (IllegalArgumentException error) {
            System.out.println("myStaticMethod_IllegalInput_ThrowsIllegalArgumentException passed.");
        } catch (Exception error) {
            assert false : "Expected IllegalArgumentException.";
        }
    }
}

Voici un example ou nous pouvons créer des objets avec des attributs et les tester :

MySecondClass.java

MySecondClassTest.java

package myfirstpackage;

public class MySecondClass {
    private int myPrivateAttribute;

    public MySecondClass(int someValue) {
        this.myPrivateAttribute = someValue;
    }

    public int getMyPrivateAttribute() {
        return this.myPrivateAttribute;
    }

    public int myNonStaticMethod(int myArgument) {
        return this.myPrivateAttribute + myArgument; // Example return value
    }
}

package myfirstpackagetest;
import myfirstpackage.MySecondClass;

public class MySecondClassTest {
    private MySecondClass mySecondClassObject;

    public static void main(String[] args) {
        MySecondClassTest test = new MySecondClassTest();
        test.getMyPrivateAttribute_NormalInput_ExpectedReturnValue();
        test.myNonStaticMethod_NormalInput_ExpectedReturnValue();
        System.out.println("All tests passed.");
    }

    private void setup(int someValue) {
        mySecondClassObject = new MySecondClass(someValue);
    }

    private void getMyPrivateAttribute_NormalInput_ExpectedReturnValue() {
        setup(1);
        assert(mySecondClassObject.getMyPrivateAttribute() == 1);
        System.out.println("getMyPrivateAttribute_NormalInput_ExpectedReturnValue passed.");
    }

    private void myNonStaticMethod_NormalInput_ExpectedReturnValue() {
        setup(2);
        assert(mySecondClassObject.myNonStaticMethod(3) == 5);
        System.out.println("myNonStaticMethod_NormalInput_ExpectedReturnValue passed.");
    }
}

Instructions pour le projet¶

Il est important de se répartir les fonctionnalités à tester entre les membres du groupe.
Vous n’avez pas besoin de tester l’affichage et les constructeurs qui ne contiennent pas de logique (en plus d’affecter des valeurs aux attributs), pareil pour les accesseurs qui ne contiennent pas de logique supplémentaire.
Idéalement, le membre qui implémente les tests pour une fonctionnalité ne doit pas être le même que celui qui implémente la fonctionnalité.
Seulement les méthodes publiques doivent être testées.
Remplissez votre fichier README pour expliquer comment ouvrir et lancer le projet Eclipse et les tests une fois que nous avons cloné votre dépôt.
Indiquez qui a écrit des tests pour quelle classe et quelles méthodes dans votre README.

Projet SAÉ 1256

Les branches Git

Soutien technique

Problème d’Internet sur Debian