User Tools

Site Tools


2018_2019:s3:concprogobjet:td:td6

This is an old revision of the document!


TD Réutilisation

Objectifs :

  • Apprendre à réutiliser des codes
  • Utilisation du pattern Adapter
  • Utilisation du pattern Observer
  • Utilisation des Mocks
Vous devez mettre en application ce que vous avez appris dans les séances précédentes : Héritage, Composition, Tests, conception d'une architecture simple, tests…
Nous y passerons seulement 2 séances. Il est conseillé de commencer à travailler de suite !

Présentation générale

Votre défi

Faire passer les tests sans les modifier si ce n'est la référence à la classe “SocialNetwork” qui implémente SocialNetworkInterface et en développant un code propre.

Voici les archives : 1)

    1. les classes du package grapheX, vous en avez besoin pour l'exécution, mais vous n'avez pas besoin de les comprendre.
    2. les classes du package grapheSimple vous allez en avoir besoin. Regardez bien ces classes et construisez rapidement le modèle de classes correspondant, par exemple avec ObjectAid),
  1. les classes de tests : celle sur les graphes pour vérifier et celle contenant les tests à faire passer. (pensez à la mettre dans un source folder dédié aux tests (ou sous test si vous êtes sous maven); Fixez le setup en ajoutant JUnit 5; exécutez les tests)

LOLVous n'avez que deux interfaces à implémenter : SocialNetworkInterface et MemberInterface. Ce qui suit est là pour vous aider. }}

La figure suivante visualise les interfaces et classes fournies pour les tests.

Réutilisation par composition et héritage

  1. Vous devez construire un réseau social dont les spécifications sont les suivantes (cf. Interfaces SocialNetworkInterface et MemberInterface):
    • un membre a un nom, un âge et une description;
    • Un membre a est en relation avec membre b avec une force entre 1 et 5 : 5 faible, 1 très forte. a peut se considérer en relation avec b à la force 1 et b ne pas se considérer en relation avec a!
    • On veut pouvoir savoir quels sont les membres en relation avec un membre au rang X :
      • exemple : a → b → c → a :
        • a est en relation avec b au rang 1 (on parcourt un seul arc);
        • a est en relation avec c au rang 2 (on parcourt deux arcs);
        • c est relation avec a au rang 1; etc.
      • Méthode : relateToRank(MemberInterface member, int rank)
    • On veut pouvoir calculer la distance entre 2 personnes, en choisissant la plus courte distance :
      • exemple : a –1–> b –5–> c et a –2–> d –5→ c :
        • la distance est de 1 entre a et b ;
        • elle est de 2 entre a et d;
        • la distance est de 6 entre a et c (1 + 5 qui est plus court que 2+5 )
      • Méthode : distance(MemberInterface de, MemberInterface a))

D'autres méthodes doivent être définies, il suffit de lire l'interface “SocialNetworkInterface”.

Un réseau social peut être vu comme un graphe. Rechercher des relations entre ses membres revient à parcourir le graphe.

Pour vous aider (et c'est aussi obligatoire ;-) ) vous utiliserez la classe GrapheSimple et la classe ParcoursSimple pour calculer des chemins 2).

La figure suivante visualise une part de ces codes.

Celle-ci les interfaces à implémenter

Cette partie du TD doit être terminée lors de la 1e séance. Si ce n'est pas le cas, vous devez travailler en dehors des heures du TD.

Réutilisation par adaptation

  1. On veut intégrer dans notre réseau social, des membres du réseau facebookGhost. Lisez bien toute la suite avant de commencer.
    • Les classes du package facebookGhost s'inspirent très fortement de l'interface fournie par Facebook. En cela, elles se comportent comme un “Mock” simplifié qui pourrait être remplacé par le véritable reseau Facebook à terme3). ).
    • On veut ajouter dans notre réseau des membres qui correspondent à des “Users” du reseau facebookGhost (FG). Pour cela, il suffit de créer le membre en déclarant qu'il existe dans un autre réseau4);
      1. le nom du “User” dans le reseau facebookGhost (name) devient le nom du membre dans notre réseau (nom)
      2. on garde la référence sur le “User” pour avoir toujours une description à jour qui correspond au profil. Ainsi les membres de notre réseau qui sont associés à un User de FG ne contiennent pas de description. La demande de description d'un tel membre dans notre réseau correspond à retourner son profil défini dans le réseau FG 5) ;
      3. on “récupère” dans notre réseau, les relations définies dans le réseau FG lorsque
        1. les users ciblés sont connus de notre réseau, c'est à dire que nous avons déjà un membre de même nom;
        2. elles correspondent à des relations familiales ou des relations d'amitiés. Par défaut, une relation de famille correspond à une relation de force 2 dans notre réseau et celle d'amitié ont une force 3.
        3. Nous considérons que les relations inverses existent également dans notre réseau.
        • Quand on ajoute dans notre réseau un membre correspondant au réseau FG, on recherche parmi ses relations directes dans FG s'il existe des users connus de notre propre réseau et on lui ajoute les relations si elles n'existaient pas, exemples :
          • Exemple : Hercule est connu du réseau FG et se déclare comme membre de notre réseau (addMember(“Hercule”, true))
            1. On récupère du réseau FG son nom.
            2. On récupère sa famille (Zeus, Alcmène) et ses amis (Admète)
            3. Seuls Zeus et Admete sont connus de notre réseau; la relation de Hercule vers Zeus est ajoutée avec une force de 2 (lien de famille), celle entre Hercule et Admete est ajoutée avec une force de 3 (lien d'amitié); nous mettons également à jour les relations inverses avec la même force.

Réutilisation par observation

Le réseau FG évolue. De nouvelles relations sont régulièrement créées et notre propre réseau peut alors devenir obsolète si les membres impliqués font partie de notre réseau et que nous n'enregistrons pas ces changements de relations. Mais bien sûr, il est impossible de modifier les codes du réseau FG….

Heureusement, le réseau FG est observable. On peut donc demander à être notifié des modifications du réseau FG! Chaque fois qu'une nouvelle relation est ajoutée dans FG on veut vérifier si les “users” mis en relation existent dans notre réseau et si c'est le cas on crée les relations correspondantes dans notre réseau.

Il suffit donc de déclarer notre réseau comme “Observer” du réseau FG et à chaque notification d'ajout d'une relation, de mettre à jour notre propre réseau si c'est nécessaire.

Facultatif : Chaque fois qu'un nouveau user est ajouter dans FG, on veut vérifier s'il existe déjà dans notre réseau et si c'est le cas le “connecter” à notre réseau…

Rendu

  1. un diagramme UML qui visualise uniquement les classes/interfaces dont votre code dépend directement.
    • le diagramme vise à visualiser l'architecture de votre solution
      • les attributs faisant référence à des classes/interfaces sont uniquement représentés sous la forme d'associations (rôle, cardinalité, orientée)
      • pas de getter et setter
      • pas de classes non directement utilisées par exemple, GrapheX etc.
      • les différents patterns apparaissent sous forme d'annotations
    • le diagramme peut être obtenu par reverse-engineering mais doit être adapté pour répondre aux points précédents.
  2. les codes sources des classes que vous avez créées ou modifiées exclusivement.

La date du rendu au plus tard : 28/11 à 23h45

Sur Jalon avec comme nom pour l'archive : Gr <numeroGroupe> + Nom des étudiants dans le groupe

1)
Tips : Prenez chaque archive, déposer la sous Eclipse, dezipper, refresh
2)
Ces codes sont basés sur le package GrapheX fournis par l'“X” dans ses cours, pour en savoir plus (page évolutive): https://www.enseignement.polytechnique.fr/informatique/INF431/X06-2007-2008/TD/INF431-td_6-1.php
3)
Pour cela, il faudrait quand même mettre à jour ce code avec les dernières évolutions de l'interface et le compléter… donc il reste “un peu” de travail
4)
Comme vous le feriez en vous demandant à vous connecter par votre compte facebook par exemple
5)
En résumé, si vous modifiez votre profil dans facebook, vous n'avez pas besoin de le mettre à jour notre réseau
2018_2019/s3/concprogobjet/td/td6.1542724229.txt.gz · Last modified: 2018/11/20 15:30 by blay