====== 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 ===== 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 : //((Tips : Prenez chaque archive, déposer la sous Eclipse, dezipper, refresh))// - les {{:2018_2019:s3:concprogobjet:td:archivegraphes.zip|classes de manipulation des graphes}} : - les classes du package grapheX, vous en avez besoin pour l'exécution, mais vous n'avez pas besoin de les comprendre. - 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), - les {{:2018_2019:s3:concprogobjet:td:archivetests.zip|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) - {{:2018_2019:s3:concprogobjet:td:facebookghost.zip|les classes définissant le réseau Facebookghost}} - {{:2018_2019:s3:concprogobjet:td:archivereseausocial.zip|les interfaces à implémenter pour faire passer les tests,}} ===> Pour ceux qui ont déjà chargé des codes, voici les codes de {{:2018_2019:s3:concprogobjet:td:graphesimple.zip|ParcoursSimple}} corrigés et dans l'archive de tests les codes ont été corrigés en conséquence. LOL**Vous 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. {{ :2016_2017:s3:concprogobjet:td:capture_d_e_cran_2016-10-16_a_22.07.17.png?direct&300 |}} {{ :2016_2017:s3:concprogobjet:td:capture_d_e_cran_2016-10-16_a_22.42.15.png?direct&300 |}} ===== Réutilisation par composition et héritage ===== - 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 ((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 )). La figure suivante visualise une part de ces codes. {{ :2018_2019:s3:concprogobjet:td:existant.gif?direct&300 |}} Celle-ci les interfaces à implémenter {{ :2018_2019:s3:concprogobjet:td:reseau.gif?direct&300 |}} 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 ===== - 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((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)). ). * 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((Comme vous le feriez en vous demandant à vous connecter par votre compte facebook par exemple)); - le **nom** du "User" dans le reseau facebookGhost (//name//) devient le nom du membre dans notre réseau (//nom//) - 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 ((En résumé, si vous modifiez votre profil dans facebook, vous n'avez pas besoin de le mettre à jour notre réseau)) ; - on "récupère" dans notre réseau, les **relations** définies dans le réseau FG lorsque - les users ciblés sont connus de notre réseau, c'est à dire que nous avons déjà un membre de même nom; - 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. - 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)'') - On récupère du réseau FG son nom. - On récupère sa famille (Zeus, Alcmène) et ses amis (Admète) - 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 & Difficile// : 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 ... En fait si vous avez utilisé un adaptateur comme étant un extends de Member, vous ne pourrez pas le faire facilement. ===== A vous, tout seul ! (5mn) ===== 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] ===== Remarque ===== **[[https://docs.oracle.com/javase/9/docs/api/java/util/Observable.html|Dépréciation]] des Interfaces Observer et Observable en Java 9.** //This class and the Observer interface have been deprecated. The event model supported by Observer and Observable is quite limited, the order of notifications delivered by Observable is unspecified, and state changes are not in one-for-one correspondence with notifications.// Ce n'est pas grave. Si vous avez compris les principes du Patron, vous pourrez les retrouver dans d'autres paradigmes tels que les files d’attente (queues), les sémaphores (semaphores ), ou les gestionnaires d'évènements dans ''java.beans'' package. ===== Rendu ===== - 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 différents patterns apparaissent sous forme d'annotations** si ce n'est pas évident (e.g. si une classe hérite ''d'observable'' c'est évident, mais si ''User'' correspond à l''''' cela ne l'est pas.) * le diagramme peut être obtenu par reverse-engineering, c'est même conseillé, mais doit être adapté pour répondre aux points précédents. - les codes sources des classes que vous avez créées ou modifiées exclusivement. La date du rendu au plus tard : mardi 4 décembre à 8h (S3T) La date du rendu au plus tard : vendredi 14 décembre à 19h (S3A) Sur [[http://jalon.unice.fr/cours/blay/Cours-blay-20150930110548/BoiteDepot-blay-20161116105407498020|Jalon]] avec comme nom pour l'archive : Gr + Nom des étudiants dans le groupe