Le travail dirigé 2 se réalise en deux séances de laboratoire. Il consiste à implémenter une application de décompte de jetons (tokens) dans un fichier. Les jetons correspondent à des mots et des délimiteurs.

Ce travail met en application les principes de traitement parallèle entre des composants Swing. L'utilisation de la concurrence est très importante pour créer des applications interactives qui ne bloquent pas et qui permettent à l'utilisateur de demeurer actif et en contrôle.

Notions principales

• Le fil de traitement Worker : toute tâche qui peut nécessiter un traitement notable doit être réalisé dans un fil d'exécution séparé du fil de traitement des événements afin d'éviter de "geler" l'interface. La classe abstraite SwingWorker facilite la création de tels patrons. Ainsi, le travail du décompte de jeton doit se faire sous un SwingWorker.
• L'affichage de la progression de tâches lentes. L'utilisation d'une barre de progression permet de suivre l'évolution de la tâche. Le composant JProgressBar devient un écouteur de changements d'états de la tâche. Dès que la tâche progresse, elle transmet un tel événement et la barre se met à jour.
• La possibilité d'annuler la tâche et la manipulation de l'état des boutons en fonction des actions que l'on peut effectuer.

Exigences du TD2

L'application doit satisfaire les exigences suivantes :

• Spécifier le fichier à traiter à l'aide du composant JFileChooser de Swing, ou en écrivant le nom dans un champ de texte. Le nom spécifié avec le filechooser doit s'insérer dans le champ de texte.
• Utiliser la classe CompteurJetons.java pour compter les jetons d'un fichier. Cette classe ne doit pas être modifiée
• Afficher la progression du traitement du fichier avec un JProgressBar
• Permettre l'annulation du traitement.
• Respecter les heuristiques de conception, notamment le guidage de Bastien et Scapin

Pour avoir une idée concrête des exigences, consultez cette série d'images.

Il n'est pas obligatoire d'utiliser le modèle MVC, mais la correction en tiendra compte à titre de point positif.

Tutoriels Swing pertinents

Plusieurs tutoriels disponibles sur le site de java.sun.com sont pertinents pour réaliser ce TD. Il est important de bien les maîtriser avant d'entamer le TD.

• Concurrence
• FileChooser
• ProgressBar

Pour la première séance

Dans un premier temps, vous pouvez réaliser l'application sans vous soucier d'encapsuler le CompteurJetons dans un fil d'exécution SwingWorker et, par conséquent, sans permettre l'annulation et l'affichage du progrès de la tâche. Cette implantation démontre d'ailleurs clairement le manque de réactivité d'une telle approche.

De cette version, vous pouvez alors passer à l'encapsulation du CompteurJetons dans un fil d'exécution séparé ainsi qu'à l'interconnection du composant JProgressBarr et du SwingWorker par l'écoute d'événements du type PropertyChangeEvent, puis finalement à la gestion de l'annulation du SwingWorker.

Barème

Le travail est évalué selon les critères suivants :

• l'application est conforme aux exigences
• l'architecture est modulaire et se conforme aux principes présentés dans les tutoriels
• l'application démarre sans problème en exécutant :
  java <nom du pacquetage>/Main ;
• le code est adéquatement commenté.
• les principes de la programmation orientée-objet sont respectés

Travail à remettre

Fichiers

Votre application devrait avoir les classes/fichiers suivantes :

• Le pacquetage compteurjetons avec la hiérarchie de fichier normale de NetBeans :
  
  • compteurjetons/
    • build/
      • classes/CompteurJetons.class
      • ...
    • build.xml
    • dist/
    • manifest.mf
    • nbproject/
    • src/
      • CompteurJetons.java
      • Main.java
      • ...
    • test/
• Le paquetage doit contenir un Main.java (fichier de démarrage).
• Le permier niveau de la hiérarchie doit contenir le fichier equipe.txt. Ce fichier doit contenir les noms et matricules des coéquipiers

Il n'y a pas de rapport à remettre mais insérez les commentaires pertinents directement dans le code.

Dépôt

Le dépôt de votre code doit être fait sous la forme d'une archive .zip ou .tar contenant les fichiers ci-dessus et tout autre fichier nécessaire au bon fonctionnement de l'application.

Il doit être possible de rouler le code en exécutant la fonction "main" du fichier Main.java.

Le dépôt se fait électroniquement sur le site Moodle.