Nom des étudiants de ce binôme

(les DEUX noms) : William TOMAS et Chloé BAIL

Commentaires éventuels des étudiants : ex 3 et 4 se trouvent dans le répertroire ex3.

Pré-requis

• Disposer d'au moins un compte github par binome
• Apporter son portable (les postes de l'université n'ont pas accès au proxy depuis Eclipse). Pas de préférence pour l'OS (Linux, OSX ou Windows).
• JDK 8 ou 9
• Eclipse récent installé
• Plugins Eclipse à installer : infinitest, natural (chercher "cucumber")
• Utiliser votre connexion Internet (data), pas le wifi de l'université (pour lequel il faut configurer le proxy HTTP).
• Forker sur Github le projet bflorat/tp1-miage-2019 puis cloner votre dépôt Github (avec l'url ssh) dans votre workspace. Attention : un seul fork par binôme.
• Dans le README.md de votre projet, mentionner votre nom et celui de votre binome (ne pas oublier !)

Déroulement du TP

<Rappel sur les remotes git : trois dépots utilisés : le dépot Github upstream, le dépot Github personnel, le dépot local>

Nous fournissons trois projets Eclipse servant de base de travail aux exercices suivant. Cela permet un point de synchronisation de tous les étudiants à différents moments du TP.

• Le projet ex1-ini est le code initial du TP et sert de base aux exercices 1 et 2. Une fois terminés, faire un push vers Github et fermer le projet Eclipse (ne pas le supprimer).
• Le projet ex3-ini sert de code de base aux exercices 3 et 4. Une fois terminés, faire un push vers Github et fermer le projet Eclipse (ne pas le supprimer).
• Le projet ex5-ini sert de code de base à l'exercice 5. Une fois terminé faire un push vers Github.

Exercice 1 - Refactoring

Temps estimé : 20 mins

Travailler dans le projet fourni mailreader-ex1-ini

1. Réusiner la classe MailComparator

Raccourcis clavier à connaître :

• ALT-SHIFT-S : fonctions Eclipse de génération de sources (ex : constructeurs)
• ALT-SHIFT-T : fonctions de réusinage
• ALT-SHIFT-M : extraction de méthode (sur sélection)
• ALT-SHIFT-R : renommage (sur sélection)

Exercice 2 - Découpage en couches

Temps estimé : 20 mins

1. Réorganiser le code dans les couches standards.

Faire en sorte par exemple que divers frontends puisse récupérer les mails. Nous aurons dans ce TP un seul frontend : un CLI (ligne de commande) qui sera implémenté sous la forme d'une classe ClientMail avec main(). Cette méthode main attend deux arguments : un booleen production qui précise si le mail doit vraiment être envoyé (true) ou si nous sommes en environnement de recette (false). Le second argument est le sujet du mail.

Rappel : exemple de méthode main qui parse un boolean :

public static void main(String[] args) {
   production = Boolean.parseBoolean(args[0]);
   ...		

Conception :

Prévoir une cinquième couche commun pour les éléments communs à toutes les couches comme les exceptions.

MailSender est une interface, le choix de l'implémentation est fait par l'application en fonction de la valeur du booléen production.

Exercice 3 - Injection de dépendances avec Guice

Temps estimé : 20 mins

Point de synchro : repartir du projet fourni mailreader-ex3-ini

Guice est le framework d'injection de dépendance en Java de Google. Il est léger et la configuration se fait en java (et non par fichier XML ou par annotations). Ses concurrents en Java sont principalement Spring Core et CDI dans le monde JEE. Ce pattern est également présent dans la plupart des languages, comme dans Symphony en PHP ou AngularJS en JavaScript.

La méthode configure() de la classe MailReaderModule contient la configuration de Guice. C'est ici qu'on associe une interface à la classe contrète qui sera injectée. Exemple :

bind(MonInterface.class).to(MaClasseConcrete.class)

Il est bien sûr également possible d'injecter des classes concrètes (comme ici le MailService).

1. Compléter la méthode configure() Observer la méthode ClientMail.main() : elle charge la configuration et créé l'objet de haut niveau de l'arbre d'injection : un InterpreteurLigneCommande.

2. L'objet InterpreteurLigneCommande a besoin d'un MailService. Lui injecter (injection par constructeur) via l’annotation (standard java) @Inject.

3. Faire de même pour l'injection du MailSender dans le MailService.

Exercice 4 - TU

Temps estimé : 30 mins

1. Compléter les tests unitaires ou en écrire de nouveaux dans les test cases MailTest et MailComparatorTest. Enlever les annotations @Ignore s'il y en a.

2. Exécuter vos tests si besoin (automatique si vous pratiquez le test continu avec infinitest).

Exercice 5 - BDD avec Cucumber-jvm

Temps estimé : 40 mins

Point de synchro : repartir du projet fourni mailreader-ex5-ini

cucumber-jvm est l'implémentation java de cucumber, un framework de BDD (Behavioral Driven Development) très populaire. Il est existe d'autres : JBehave (l'original, très similaire), Concordion, JGiven ...

Pour les besoins du TP, nous utilisons ici les notions de Scenario Outline, de Data Table et de Transformer permettant l'utilisation de données tabulaires et de formats custom.

1. Compléter la classe MailComparaisonStep

2. Lancer le test CucumberRunnerTest en junit

3. Ouvrir dans un navigateur target/cucumber/index.html

4. Ajouter des cas de test dans la feature trier_mail.feature. Notez qu'aucun nouveau code n'a été nécessaire pour ajouter ces tests contrairement à un TU.

5. Ecrire un scenario simple au format textuel et les steps correspondants.

Cleanup

Si vous le désirez, vous pourrez supprimer votre projet github mais pas avant fin juin (noté)