Section 1.1: outil de validation #

1.1.1 Démarrer l’outil #

Pour utiliser l’outil de validation, il faut l’intégrer à un projet Java. Pour l’exemple présenté en Introduction, on débutera avec le code suivant :

public class MonTableau extends Tableau {

    public void deplacerDecaler() {
        // implanter la procédure ici
    }
}

public class Procedure extends ProcedureDecaler<MonTableau> {

    public static void main(String[] args) {
        NtroClientFx.launch(args);
    }

    protected Class<MonTableau> classeMonTableau() {
        return MonTableau.class;
    }
}

À l’exception de la méthode deplacerDecaler, qui doit être complétée, les étudiant·e·s n’ont pas à comprendre ce code, qui ne sert qu’à intégrer l’outil de validation à leur projet Java. Pour plus de détails, voir les exemples d’ateliers à l’Annexe 4.

Exécuter le projet Java va démarrer l’outil :

À noter que bien que le manuel fait référence à un outil de validation (au singulier), il faut en réalité intégrer une version différente de l’outil de validation pour chaque procédure à valider. Chaque version définit aussi sa propre visualisation des données avec des cartes à jouer. Voir l’Annexe 2 pour plus de détails.

1.1.2 Utiliser l’outil #

Voici les affichages principaux de l’outil de validation.

• Le panneau principal (1) affiche des cartes à jouer.
• Le panneau des cas de tests (2) permet de :
  • Sélectionner un nouveau cas de test.
  • Visualiser les résultats de la validation.
• Le panneau de navigation (3) permet d’avancer et/ou reculer dans la séquence d’exécution.
• Le panneau des variables (4) visualise les diverses valeurs pour l’état courant de l’exécution.

1.1.2.1 Visualisation avec des cartes à jouer #

Des cartes à jouer animées permettent de visualiser l’exécution d’une procédure informatique.

L’exécution de la procédure se déroule en un certain nombre d’étapes. La transition d’une étape à l’autre est illustrée par une animation où p. ex. une carte peut changer de position.

À noter que la visualisation est différente pour chaque procédure, tel qu’expliqué à la Section 1.3. À noter aussi qu’utiliser des cartes à jouer s’accompagne de certaines limitations, telles que discutées au Chapitre 2.

1.1.2.2 Sélection de différents cas de test #

Au démarrage, l’outil charge plusieurs cas de tests. La première étape d’un cas de test contient des valeurs pour chaque variable importante de la procédure informatique. Les étapes subséquentes correspondent à l’exécution de la procédure.

Pour chaque cas de test, on peut soit sélectionner une solution ou la validation du code étudiant. Pour la solution, l’icône représente le nombre d’étapes contenu dans la solution. Pour le code étudiant, l’icône représente le résultat de validation.

1.1.2.3 Navigation entre les étapes de la procédure #

Pour le cas de test sélectionné, on peut naviguer à travers la séquence d’exécution de la procédure. Cette option est particulièrement utile pour détecter une erreur. On peut comparer, étape par étape, le déroulement de la solution au déroulement de procédure implantée par l’étudiant·e.