Objectifs :

• Apprendre à réutiliser des codes
• Utilisation du pattern Adapter
• Utilisation du pattern Observer
• Utilisation des Mocks

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

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

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 à terme³⁾. ).
   • 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éseau⁴⁾;
     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 ⁵⁾ ;
     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.

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…

Nous désirons contrôler l'activité de notre réseau. A terme nous envisageons de suivre cette activité selon plusieurs aspects (afficheur sous forme de courbes de création des membres dans le temps; lever d'alertes lorsque le nombre de relations sur un membre est important; …).

Pour l'instant, nous vous demandons d'afficher chaque fois qu'un nouveau membre ou qu'une relation est créée et bien sûr l'affichage ne se fait pas dans vos codes d'implementation du réseau.

Voici un exemple de début de trace :

New Member created Member [age=20, description=l'ami, nom =Admete]
New Member created Member [age=20, description=le dieu ..., nom =Zeus]
New Member created Member [age=20, description=la femme de zeus, nom =Hera]
New Relation created (3:Member [age=20, description=le hero, nom =Hercule], Member [age=20, description=l'ami, nom =Admete])
New Relation created (3:Member [age=20, description=l'ami, nom =Admete], Member [age=20, description=le hero, nom =Hercule])
New Relation created (2:Member [age=20, description=le hero, nom =Hercule], Member [age=20, description=le dieu ..., nom =Zeus])
New Relation created (2:Member [age=20, description=le dieu ..., nom =Zeus], Member [age=20, description=le hero, nom =Hercule])
New Member created Member [age=20, description=le hero, nom =Hercule]
New Relation created (2:Member [age=20, description=le dieu ..., nom =Zeus], Member [age=20, description=la femme de zeus, nom =Hera])
New Relation created (2:Member [age=20, description=la femme de zeus, nom =Hera], Member [age=20, description=le dieu ..., nom =Zeus])
New Member created Member [age=0, description=Asterix, le plus intelligent, nom =Asterix]
New Member created Member [age=0, description=falbala, la plus jolie, nom =Falbala]
New Member created Member [age=0, description=Obelix, le plus intelligent, nom =Obelix]
New Member created Member [age=0, description=Panoramix, le plus magique, nom =Panoramix]
New Member created Member [age=0, description=Abraracourcix, chef du village, nom =Abraracourcix]

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