====== TD2 : qui est Responsable? ====== **Objectifs :** Travailler sur de petits exemples différents points d'un développement pragmatique. ===== Responsabilités : Analyse et développement de la partie "Métier" ===== Le forum logiciel est maintenant composé de //canaux//. * Un administrateur demande à créer un forum en précisant le nom du forum. Si un forum avec ce nom existe déjà, il ne se passe rien. * Un administrateur peut demander s'il existe un forum de nom donné. * Un administrateur peut lister (Cela veut dire obtenir la liste des noms de forum, pas les afficher!) les noms des forums existants qu'il a créé. * Un membre demande à créer un canal dans un forum en précisant le nom du canal. Si le canal existe déjà, il ne se passe rien. Par défaut un canal ne peut pas contenir plus de "MAX_MESSAGES", mais il est possible de modifier le nombre maximum de messages autorisés. ((Comment //gérez-vous// le dépassement du nombre de messages alors que rien de vous est dit dans ce cas?)) * Un membre demande à créer un canal de "brèves" (Messages) associé à un forum en précisant le nom du canal et la taille maximum des brèves, par exemple 140 caractères. Si un canal de même nom existe déjà, il ne se passe rien. * Un producteur poste un message dans un forum et //éventuellement// vers un canal spécifique du forum, en précisant leurs noms (forum et canal) et le contenu du message. En l'absence de canal, le message est posté dans le //canal par défaut//. * Un consommateur peut demander à lister((obtenir la liste des messages)) les messages qui se trouvent dans un canal sur un forum. * Un consommateur peut demander à lister tous les messages qui se trouvent sur le forum, dans ce cas tous les messages dans tous le canaux lui sont retournés. * un canal ne peut pas être associé à plusieurs forums. Un forum peut évidemment avoir plusieurs canaux. Pour vous aider vous pouvez, dans un premier temps, ne pas tenir compte du canal par défaut et n'en tenir compte qu'à la fin du TD en identifiant bien les impacts sur le modèle et sur le code, en particulier avec les responsabilités qui en résultent. - Quels modèles utilisez-vous pour analyser le problème ? - Dans vos diagrammes de séquences, faîtes bien apparaître les interfaces graphiques et les contrôleurs mais dans les diagrammes de classe concentrez vous uniquement sur la partie métier dans un premier temps. - Qui est responsable de retrouver à partir de son nom un forum? un canal de messages? (Pattern expert) - Qui est responsable de créer un forum? un canal de message? pourquoi? (Pattern créateur) - Qui est responsable de créer un message ? pourquoi? (Pattern créateur) - Avez-vous des relations bi-directionnelles? Si oui, avez-vous décidé de qui est le "maître" et de qui est l'"esclave"? - Avez-vous bien prévu les tests unitaires? Que se passe-t-il si vous demandez - à lire les messages sur un canal qui n'existe pas? - à créer un forum d'un nom déjà utilisé? - ... - A partir de maintenant, on s'intéresse au scénario suivant, sans tenir compte de l'interface graphique. Est-ce que vous pouvez l'implémenter, revenez sur votre code si besoin (Vous pouvez vous aider des tuyaux donnés plus bas si besoin): - Je crée un forum "NiceInformation" - Je crée une canal "Circulation" sur le forum "NiceInformation" - Je crée un canal de Breves "@dept-info-iut-Nice" qui autorise uniquement des messages de 140 caractères. - Je poste un message "Embouteillage" dans le canal "Circulation" du forum "NiceInformation" - Je poste un message "Nouveau rond point" dans le canal "Circulation" du forum "NiceInformation" ((pareil pour le forum "AntibesInformation", ça passe? )) - Je lis les messages qui se trouvent dans le canal "Circulation", i.e. je récupère les messages. - Je demande à effacer les messages du canal "Circulation" du forum "NiceInformation" ((pareil pour le forum "AntibesInformation", ça passe? )) - Je poste un message "SoireeIUT" sur le forum "NiceInformation" - Je poste un message "WEI ... apres les cours de ..." dans le canal "@dept-info-iut-Nice" - Yoann plus bavard poste un message de plus de 140 caractères " N'oubliez pas d'emmener ...... et de choisir votre filleul ....." dans le canal "@dept-info-iut-Nice"... que se passe-t-il ? - J'attends 2s (Thread.sleep(2000)); - Je poste un message "SoireeIntegrationIUT Choisissez vos parrain...." sur le forum "NiceInformation" - J'attends 2s (Thread.sleep(2000)); - Je demande à effacer tous les messages postés depuis plus de 4s sur le forum "NiceInformation" - Regardez vos codes, et vérifiez que vous avez bien respecté la [[https://fr.wikipedia.org/wiki/Loi_de_D%C3%A9m%C3%A9ter|loi de Demeter]]((Quand on l'aura vu en cours)). Si ce n'est pas le cas, corrigez vos codes. - Fixer MAX_MESSAGES à 1... comment se comporte votre programme? - Complétez les tests pour prendre en compte les "brèves". - Comment avez-vous géré le canal par défaut? (Avez-vous pensé à définir des constantes?) - Pouvez-vous décrire chacune de vos classes avec une seule phrase? Faîtes-le dans les commentaires de vos classes. Aie aie votre propriétaire vient de réaliser que sur des forum de type "Community" il veut interdire d'avoir plus de 2 canaux, sur un forum "Premium" on ne peut pas en avoir plus de 5 et sur les forum "PRO" le nombre de canaux n'est pas limité. \\ Comment réagissez vous à ce changement? Modifiez vos codes et modèles pour tenir compte de cette nouvelle fonctionnalité. ===== Architecture : Interface graphique et contrôleur ===== L'objectif est ici de décomposer l'application pour que : * L'interface n'interagit jamais directement avec le métier * Le contrôleur joue le rôle de chef d'orchestre entre le métier et l'interface. Pour se concentrer sur l'architecture, l'interface est une classe Java qui utilise ''Scanner'' pour lire au clavier et ''System.out.print...'' pour l'affichage. Vous pouvez vous inspirer du {{:2015_2016:s3:concprogobjet:td:ui.java|code ci-joint}}. Le contrôleur n'a pas le droit de modifier la partie métier sans passer par des objets métiers. Il n'est pas autorisé à stocker la liste des forum etc. Pensez à utiliser le principe de délégation. - Développez le code correspondant. **[[https://mbf-iut.i3s.unice.fr/doku.php?id=2015_2016:s3:concprogobjet:td:td2&#aide|Utilisez les informations et codes donnés]]** ci-dessous. - Quel type de contrôleur avez-vous défini en respectant les directives données? Est-il "bon"? Que feriez-vous sinon pour l'améliorer? - Vous devez à présent pouvoir jouer le scénario précédent en utilisant votre interface graphique. - Pouvez-vous décrire chacune de vos classes avec une seule phrase? Faîtes-le dans les commentaires de vos classes. ==== aide ==== **Pour vous aider** voici un exemple possible du programme principal dont vous pouvez vous inspirer : Controleur c = new Controleur(); c.start(); Et pour le contrôleur : public class Controleur { RegistreDeforum registre = new RegistreDeforum(); UI ui = new UI(); public void start() { String commande = ui.lireCommande(); switch (commande.charAt(0)) { case 'c': creerforum(); start(); break; case 'b': creerBoite(); start(); break; ..... private void creerforum() { String nomDuforum = ui.getNomDuforum(registre.getNomsforum()); boolean reussi = registre.creerforum(nomDuforum); if (!reussi) ui.afficher("Erreur le forum existe déjà"); else ui.afficher("forum " + nomDuforum + " créé"); } ===== Architecture : Persistance simplifiée ===== 1- On désire sauvegarder l'ensemble des forums à chaque fin d'exécution du programme principal et recharger l'état des forum à chaque lancement du programme principal. Vous pouvez utiliser le {{:2015_2016:s3:concprogobjet:td:memoire.java|code suivant}}. Pour l'utiliser il suffit que vos classes "implements Serializable'. **Exemple de sauvegarde :** Memoire.save(registre, NomFichier); **Exemple de lecture :** Object o = Memoire.read(NomFichier); if (o != null) if (o instanceof RegistreDeforum) registre = (RegistreDeforum) o; } ===== Evolutions ===== - Dans certains canaux dès qu'un message est lu, il est effacé. Modifier votre code pour permettre la création de tels canaux. Attention, les autres canaux sont toujours utilisables. Utilisez bien les tests unitaires, pour vérifier que vous ne "cassez" pas vos codes. Comment votre modèle est-il modifié? - Pour certains forums, lorsque l'on poste un message en donnant comme nom de canal "*", le message est posté dans tous les canaux. Modifier votre code pour tenir compte de ce nouveau besoin. - Analyser les dépendances entre vos classes. ===== Rendus ===== * Utilisez la [[http://jalon.unice.fr/cours/blay/Cours-blay-20150930110548/BoiteDepot-blay-20150930110658584420|boite de dépôt]] pavec date limite : le 17 octobre à minuit. * Le rendu consiste en : - Un document contenant * votre modèle((Modèle = diagrammes UML)) final (Tout le monde n'aboutit pas au même modèle, c'est certain, bien mettre des diagrammes pas le projet Modelio) * des explications sur les raisons de ce modèle, les choix que vous avez faits et les leçons apprises. - Les codes et les tests en particulier les tests JUNIT; - Il est préférable que les codes soient commentés en respectant les consignes d'une javadoc mais ce n'est pas essentiel (([[https://www.jetbrains.com/help/idea/2016.2/creating-documentation-comments.html|Utiliser IntelliJ pour vous aider à commenter les méthodes]])) Dans cet exercice nous évaluons votre capacité à concevoir les bons modèles et la "bonne" architecture relativement à vos objectifs. Des modèles incomplets sont évidemment considérés comme faux au regard de ces objectifs. ==== Tuyaux ==== Vous avez besoin dans ce TD de manipuler des collections et des dates, voici quelques tuyaux que vous pourriez retrouver sur le Web et qui sont extraits des codes que nous avons mis en oeuvre pour ce TD. Vous pouvez évidemment avoir d'autres solutions : * Pour parcourir une ArrayList (le for qui suit) * Pour pouvoir effacer dans une liste que l'on parcourt, il faut d'abord en faire une copie ArrayList messagesContenus = new ArrayList(messages); for (Message m : messagesContenus) { if (m.perime(i)) { m.detruire(); messages.remove(m); } * Une manière "facile" pour savoir si un message est périmé de plus de x secondes : public boolean estPerime(int second){ Date d = new Date(); long ms = d.getTime(); ms = ms - second*1000; d.setTime(ms); return this.dateEmission.before(d); } * Si vous avez utilisé des HashMap vous avez peut être besoin de récupérer la liste des objets contenus comme par exemple : public void detruireMessages(int i) { for (Boite b : boites.values()) { b.detruire(i); }