TD1 : Prise en main de l'environnement de développement

Objectifs : Par le développement d'un mini-bus à messages (Twitter par exemple) nous mettons en place notre environnement de travail et rappelons les notions de base de la COO.

Il s'agit de construire les bases “rudimentaires” d'un “bus à messages”, pensez flux d'informations par exemple (flux RSS).

• Un agent peut créer un bus.
• Des producteurs émettent des messages vers un bus.
• Des consommateurs demandent à lire des messages sur le bus.
• Un agent peut effacer des messages sur le bus.
• Un consommateur peut demander à lire des messages et qu'il n'y en ait aucun.

Attention, il s'agit d'un exemple concret mais c'est bien la notion de bus que l'on vous demande dans un premier temps de mettre en oeuvre.

L'agence “oogle-Agency” (Agent) crée un bus logiciel “Nice-circulation”.
La voiture A (Producteur) émet un message mAttente : “Attente de 5mn” sur le bus logiciel “Nice-circulation”.
La voiture B (Consommateur) demande s'il y a de l'information sur le bus logiciel et obtient le message mAttente.
La voiture B (Consommateur) pose la même question et obtient le même message.
La voiture B (Producteur) émet un message mAccident : “Accident sortie Saint-Augustin”.
Les messages postés il y a plus de 30s sont détruits par “oogle-Agency”.

1. Quels sont les grands cas d'utilisation? Vous pouvez les faire simplement sur Papier.

1. Sous MODELIO, commencer par créer un projet (Attention à bien sélectionner Java Project)
2. Définissez un diagramme de classes de niveau Analyse.
3. Définissez, par cas d'utilisation, un diagramme de séquence élémentaire mettant en jeu les objets de votre système et compléter votre diagramme de classes au fur et à mesure. Pour cela utilisez, évidemment des lignes de vie qui font référence à des classes et les messages qui vous permettent d'identifier les méthodes et mettre à jour vos diagrammes de classes.

1. Compléter votre modèle à classes pour préparer l'implémentation :
   • Réfléchir au sens des relations
   • Vérifier les “couplages”
   • Cet exemple est très petit, en conséquence, il est possible qu'il n'y ait quasi rien à faire à cette étape.

1. Créer un projet MAVEN
   1. Nom du projet : busV1
   2. GroupID = fr.unice.iut.info.coo
   3. ArtefactID = bus
   4. ( voir comment faire ici ici )
2. La structure contient
   1. src → main → Java …
   2. test → java → …
   3. Exécutez le main sous gid et les tests…
3. Ok maintenant vous êtes prêts.

Nous allons à présent travailler sur les codes. Pour cela nous allons les générer à partir des modèles. Pour cette tâche, vous retournez sous Modelio. Aujourd'hui nous faisons le choix de générer les codes puis de travailler ces derniers sans chercher, au moins pour l'instant, à maintenir les modèles en cohérence.

1. Générez les codes (voir ici et choisissez comme répertoire de génération celui sous src/main/java/fr/unice/iut/info/coo
2. - Sélectionner votre diagramme de classe en conception;
   1. Vérifier que vous avez bien toutes les classes prévues;
   2. Préciser si vous voulez travailler avec des vecteurs ou autres (Réfléchissez!!), et préciser bien comme répertoire pour la génération votre répertoire (si besoin, spécifiez le nom du package fr.unice.iut.info.coo directement dans le code généré)
3. Retourner sous IntelliJ. Si votre répertoire est mal organisé (nouveau package par exemple, déplacer simplement les codes comme vous le voulez, par glisser/coller.)
4. Corriger vos codes pour qu'ils soient “compilables” :
   1. Afin que les annotations de Modelio soient comprises, ajouter javadesigner.jar comme une library du projet
      1. déposer sous idea/libraries… puis sélectionner le .jar et l'enregistrer comme une librairie utilisée par le projet
      2. ou bien placez vous sur le projet puis avec le menu contextuel (clique droit) > Open module Setting > Librairies et ajouter le .jar

Voici ce que doit faire a minima votre programme principal, pour cela retourner sur “MonScenario.java” et modifier le main pour :

1. créer un bus de nom “Nice-Circulation”,
2. créer un message annonçant “une attente de 5mn”
3. créer un message annonçant “un accident”
4. lire les messages,
5. afficher le contenu des message.

Ce programme ne peut pas tourner puisque quasi rien n'est implémenté, par contre vous pouvez vous aider d'IntelliJ pour qu'au moins il soit “syntaxiquement” juste et créer les bonnes méthodes si elles n'existent pas déjà, ou les appeler!

A la fin de ce TD, évidemment, il fonctionnera.

http://pierre-gerard.github.io/coo/uml-td03-annexe.html

Notre objectif est à présent de préparer les tests qui accompagneront notre développement. Pour cela, nous utiliserons l'environnement JUNIT. La structuration du projet en une partie principale et une partie test est, elle, exigée pour toute la suite de ce module.

1. Pour créer des tests sur votre classe Message, suivez les instructions sous https://www.jetbrains.com/help/idea/2016.2/creating-tests.html. La classe de test créée se trouve sous test/java/…
   • Cochez les cases setUp() ¹⁾ et tearDown() ²⁾.
2. IntelliJ a maintenant créé automatiquement le squelette de la classe de test. Il ne reste plus alors qu’à remplir cette dernière.
3. Par exemple

        protected Message mToTest;
	protected String content;
 
	@Before
	public void setUp() throws Exception {
		content = "mon message";
		mToTest = new Message(content,b);
	}
 
	@Test
	public void setContenu() throws Exception {
		String nv = "newValue";
		mToTest.setContenu("newValue");
		assertEquals(" message contents is as expected",nv,mToTest.getContenu());
		assertFalse(" message contents has been modified", mToTest.getContenu().equals(content));
	}
 
 

1. Dans le menu contextuel, cliquez sur Run As – JUnit test.

Enfin, le premier rapport de tests s’affiche !

1. Terminez la mise en oeuvre du bus en complétant les tests au fur et à mesure.

Un “bus à messages” s'appuie sur plusieurs design patterns 'Observeur/Observable“ et plus précisément “Publish/Subscribe”. Il existe aujourd'hui de nombreuses implémentations de ces systèmes permettant des communications asynchrones, où les consommateurs sont automatiquement notifiés de l'arrivée de message, où les consommateurs peuvent faire des demandes spécifiques, avec des systèmes de filtres complexes, etc.

1. Le programme est fonctionnel et le scénario de base est bien réalisé.
2. Les modèles sont cohérents avec le code.

Jalon de dépôt pour Mme Fornarino : donner comme nom du dépot : Gr<NumeroGroupe><Noms des étudiants>