TD2 : qui est Responsable?

Objectifs : Travailler sur de petits exemples différents points d'un développement pragmatique.

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. ¹⁾
• 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²⁾ 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.

1. Quels modèles utilisez-vous pour analyser le problème ?
2. 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.
3. Qui est responsable de retrouver à partir de son nom un forum? un canal de messages? (Pattern expert)
4. Qui est responsable de créer un forum? un canal de message? pourquoi? (Pattern créateur)
5. Qui est responsable de créer un message ? pourquoi? (Pattern créateur)
6. Avez-vous des relations bi-directionnelles? Si oui, avez-vous décidé de qui est le “maître” et de qui est l'“esclave”?
7. Avez-vous bien prévu les tests unitaires? Que se passe-t-il si vous demandez
   1. à lire les messages sur un canal qui n'existe pas?
   2. à créer un forum d'un nom déjà utilisé?
   3. …
8. 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):
   1. Je crée un forum “NiceInformation”
   2. Je crée une canal “Circulation” sur le forum “NiceInformation”
   3. Je crée un canal de Breves “@dept-info-iut-Nice” qui autorise uniquement des messages de 140 caractères.
   4. Je poste un message “Embouteillage” dans le canal “Circulation” du forum “NiceInformation”
   5. Je poste un message “Nouveau rond point” dans le canal “Circulation” du forum “NiceInformation” ³⁾
   6. Je lis les messages qui se trouvent dans le canal “Circulation”, i.e. je récupère les messages.
   7. Je demande à effacer les messages du canal “Circulation” du forum “NiceInformation” ⁴⁾
   8. Je poste un message “SoireeIUT” sur le forum “NiceInformation”
   9. Je poste un message “WEI … apres les cours de …” dans le canal “@dept-info-iut-Nice”
   10. 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 ?
   11. J'attends 2s (Thread.sleep(2000));
   12. Je poste un message “SoireeIntegrationIUT Choisissez vos parrain….” sur le forum “NiceInformation”
   13. J'attends 2s (Thread.sleep(2000));
   14. <Optionnel> Je demande à effacer tous les messages postés depuis plus de 4s sur le forum “NiceInformation”
9. Regardez vos codes, et vérifiez que vous avez bien respecté la loi de Demeter⁵⁾. Si ce n'est pas le cas, corrigez vos codes.
10. Fixer MAX_MESSAGES à 1… comment se comporte votre programme?
11. Complétez les tests pour prendre en compte les “brèves”.
12. Comment avez-vous géré le canal par défaut? (Avez-vous pensé à définir des constantes?)
13. Pouvez-vous décrire chacune de vos classes avec une seule phrase? Faîtes-le dans les commentaires de vos classes.

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 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.

1. Développez le code correspondant. Utilisez les informations et codes donnés ci-dessous.
2. 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?
3. Vous devez à présent pouvoir jouer le scénario précédent en utilisant votre interface graphique.
4. Pouvez-vous décrire chacune de vos classes avec une seule phrase? Faîtes-le dans les commentaires de vos classes.

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éé");
    }

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 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;
    }

1. 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é?
2. 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.
3. Analyser les dépendances entre vos classes.

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<Message> messagesContenus = new ArrayList<Message>(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);
       }