Conception Plateforme Messagerie

Transcription

1 Conception Plateforme Messagerie Date du document Vendredi 19 mai 2006 Sommaire du document I. Introduction...1 II. Une vision globale du système Le diagramme de classes UML Détail des méthodes de chaque classe...2 a. La plateforme...2 b. Les paramètres de la plateforme...2 c. La gestion des modules...3 d. La gestion des contacts...3 e. La gestion des profils...4 III. Les diagrammes de séquence... 5 a. Diagramme de séquence du démarrage...5 b. Diagramme de séquence du lancement des modules...5 c. Diagramme de séquence d un chat avec le module messagerie...6 IV. Structure RMS (gestion du stockage) Diagrammes d activité...9 a. Lancement de BlueStorm...9 b. Fermeture de BlueStorm...10

2 I. Introduction Ce document présente la conception de la plate-forme. Il est composé de diagrammes UML expliqués en détail. Il permet à tous les membres du groupe de bien comprendre la structure du projet en aillant une vision globale. Ce document a pour but de fournir à chacun le même modèle pour travailler ce qui assure une bonne cohésion au sein de l équipe et une meilleure efficacité. II. Une vision globale du système 1. Le diagramme de classes UML Le diagramme de classes ci-dessous présente les classes principales de la plateforme. Projet BlueStorm Conception - Plateforme - Messagerie 1

3 2. Détail des méthodes de chaque classe a. La plateforme La classe Plateforme gère toute les interactions avec les autres classes. Voici le détail des principales méthodes de cette classe : void loadparams() : permet le chargement des paramètres qui sont enregistrés dans la base de données RMS afin d initialiser les paramètres globaux du programme au lancement. Vector listneighbors() : détecte les périphériques Bluetooth à proximité possédant le logiciel BlueStorm. Les utilisateurs correspondants sont affichés dans la liste de contacts. Cette fonction sera par la suite appelée périodiquement pour mettre à jour la liste des voisins. Elle renvoie un vecteur avec la liste des voisins. msg recvmsg() : un thread permanent écoute l'arrivée éventuelle de messages. Lors d une arrivée, le message est traité puis orienté vers le module concerné. L2CAPConnection connect(contact i) : cette méthode ouvre une connexion, de type client-serveur avec un voisin, renvoie un objet identifiant de la socket, de type L2CAPConnection. void sendmsg(msg m, Contact i) : un thread envoie un message au voisin. Pour cela, il utilise la fonction connect() pour ouvrir la socket. En cas d échec, la méthode lève une exception. void treat() : cette méthode traite les messages reçus et les achemine vers le module concerné (jeu ou messagerie). Vector modulesregistry() : retourne un vecteur avec les identifiants des modules lancés. C est une liste non exhaustive. D autres méthodes seront sans doute mises en place pour assurer une plateforme complète conforme aux spécifications de l analyse fonctionnelle. On peut déjà citer la suivante : void progress() : cette fonction sera exécutée dans un thread en parallèle au démarrage afin d afficher la barre de progression du démarrage du programme. b. Les paramètres de la plateforme Ils sont gérés par la classe Paramètres dont les méthodes sont présentés ci-dessous. setparam() : lorsqu on modifie un paramètre (volume, type d'alerte, ), on appelle cette méthode pour le charger au niveau du programme. Cette fonction peut utiliser la fonction save() afin de sauvegarder les paramètres dans le RMS. getparam() : permet de récupérer les paramètres de la base de données RMS pour les placer dans un vecteur qui permettra au programmeur de les manier plus facilement. resetallparam() : cette méthode réinitialise tous les paramètres du logiciel. Ils reprennent les valeurs par défaut prédéfinis dans BlueStorm. Projet BlueStorm Conception - Plateforme - Messagerie 2

4 save() : cette méthode permet de sauvegarder sur le mobile des données. Selon le type du paramètre en entrée de la méthode (profil, discussion, ou high score...), un switch permettra la sauvegarde des données correspondantes, dans l'espace alloué à l'utilisateur. c. La gestion des modules La gestion des modules est effectué par la classe Module. C est cette classe qui lance les modules et gère leur cycle de vie. Vector listmodavailable() : affiche la liste des nouveaux modules disponibles sur ce serveur. Cette méthode demande au préalable l autorisation d effectuer une connexion de type WAP ou autre pour accéder au serveur. void addnewmods(module) : récupère le nom du nouveau module, que l'utilisateur souhaite télécharger, pour le placer dans la liste des modules à installer. Cette liste est toujours visible par l utilisateur et est modifiable. void delnewmods(module) : permet de retirer un module de la liste précédemment évoquée. void installmod(module) : envoie la BDD ( manifest + profils + params + ) au serveur ainsi que la liste des nouveaux modules à installer pour créer le nouveau Jar. Cette méthode effectue le téléchargement puis la mise à jour de BlueStorm. void runmod(module) : lance un module dans un nouveau thread. Vector listmods() : permet de renvoyer un vecteur avec la liste des modules installés dans la plateforme, à partir du fichier manifest pris en paramètre. Vector requestmod(contact i) : demande à un contact la liste de ses modules. void sendmodlist(vector listmod) : renvoie le vecteur de l'ensemble des modules installés, et ce en réponse à la méthode requestmode() d. La gestion des contacts La classe GestionContacts est conçue pour de gérer toutes les fonctionnalités relatives à la liste des contacts. Une classe Contact est d ailleurs définie, elle permet de spécifier les attributs propres à chaque contact. int deletecontact(contact i) : supprime le contact de la liste de contacts. void listcontact() : affiche la liste des contacts qui sont en ligne et hors ligne, après une découverte du réseau. Contact searchcontact() : permet de trouver un contact en entrant un critère de recherche. La classe Contact spécifie les attributs nécessaires pour l'identification d'un voisin : String Pseudo String adressebluetooth Projet BlueStorm Conception - Plateforme - Messagerie 3

5 int Statut Profil profil (la classe Profil est définie ci dessous). La liste ci dessous représente des méthodes complémentaires, pour assurer les fonctions d'estime de la gestion des contacts. void deletelist() : supprime tous les contacts de la liste, en se servant de la fonction deletecontact() void blockcontact(voisin i) : permet de bloquer un contact en n apparaissant pas dans sa liste de contact présent ou en restant hors ligne pour lui, tout en étant connecté. void TriContact(), cette fonction trie les contacts par ordre de préférence, en donnant une priorité à un contact, qui sera affiché en tête de liste. e. La gestion des profils La classe Profil permet de spécifier les attributs propres à un profil : nom age humeur La classe GestionProfils définit l ensemble des méthodes nécessaires à la manipulation des profils de l utilisateur. Elle gère par la même occasion les profils des contacts. void addprofile(profil ) : ajoute un profil (un utilisateur peut en créer plusieurs). En cas d'échec, cette méthode lève une exception. void deleteprofile(profil) : supprime un profil sélectionné par l'utilisateur. void changestatus(int) : permet de changer le statut (visible ou invisible), avec lequel l'utilisateur souhaite apparaître. void viewprofil(contact i) : affiche le profil d'un contact voisin. Une requête est envoyé au contact en question afin de demander son profil. La liste ci dessous présente des méthodes complémentaires à la classe GestionProfils, relatives à la manipulation d'un profil existant. void modifyprofile(profil, age, nom, humeur) : permet d' affecter de nouveaux paramètres à un profil existant, en modifiant l'âge, le nom ou l'humeur. void selectprofile(profil) : permet de sélectionner et afficher un des profils créés par l'utilisateur. void BroadcastProfil(Profil) : permet de diffuser un profil dans le réseau, afin qu'il soit visible par tout le monde. Cette méthode assure la confidentialité et le respect de vie privée des utilisateurs. Projet BlueStorm Conception - Plateforme - Messagerie 4

6 III. Les diagrammes de séquence a. Diagramme de séquence du démarrage Le diagramme ci dessous présente le séquencement des actions lors du démarrage de la plateforme. Un objet de chaque classe (Paramètres, Modules, GestionContacts et GestionProfils) est instancié. Les paramètres sont récupérés avant qu'ils ne soient chargés en mémoire. Ensuite, la plateforme procède à la découverte du réseau. objet : Plateforme objet : Paramètres objet : Modules objet : GestionContacts objet : GestionProfils 1: Main() 2: Paramètres( ) 3: getparam( ) 4: loadparams( ) 5: Modules( ) 6: GestionContacts( ) 7: GestionProfils( ) 8: listneighbors( ) b. Diagramme de séquence du lancement des modules Le diagramme ci dessous présente le séquencement des actions lors du lancement d'un module (messagerie, jeu de bataille navale...). Le module messagerie est pris comme exemple. Une fois que la liste des modules disponibles est récupérée par la plateforme, l'utilisateur choisit celui qu'il souhaite lancer. Ainsi, l'objet module fait l'interface entre la plateforme et l'objet messagerie instancié dans un nouveau thread par l'objet module. Chaque module lancé est enregistré par la suite dans la plateforme. Projet BlueStorm Conception - Plateforme - Messagerie 5

7 c. Diagramme de séquence d un chat avec le module messagerie Le diagramme ci dessous illustre le séquencement des actions, quand l'utilisateur souhaite discuter avec un contact, via le module messagerie. Ainsi, l'adresse du contact est récupérée à partir de l'objet GestionContact, afin de pouvoir ouvrir une connexion de type Client/serveur. Un nouveau thread est créé permettant l'écoute de messages qui pourraient arriver. A la réception d'un message, un deuxième thread est créé afin d'assurer son traitement et son acheminement vers le module concerné (messagerie dans ce scénario). Enfin, l'objet messagerie réceptionne le message qui lui est destiné, le décode afin de l'afficher sur l'écran, et avertit l'utilisateur par un vibreur ou une sonnerie. Projet BlueStorm Conception - Plateforme - Messagerie 6

8 er1 : eforme objet : Modules objet : Messagerie objet : GestionContacts user2 : Plateforme 1: Messagerie( ) 2: Chat() 3: getcontact() 4: 5: Connect() 6: Connect() 7: 8: Thread 1 9: SendMsg(, ) 10: RecvMsg( ) 11: Thread 2 12: treat( ) 13: forward() 14: treat 15: receivemsg( ) 16: Decode( ) 17: Alert( ) Projet BlueStorm Conception - Plateforme - Messagerie 7

9 IV. Structure RMS (gestion du stockage) La structure RMS (record management system) utilisée dans BlueStorm fonctionne comme suit : RMS permet de stocker des informations dans des tables. Nous utiliseront ces tables à la fois comme registre d accès aux autres tables mais aussi pour le stockage d informations. Ce système pourra servir pour le stockage des contacts, des paramètres, des high scores ainsi que de toutes informations devant être conservé. Ci-dessous la structure pour le stockage des voisins n 1 friendly name pseudo status profil profil n n n n n 2 friendly name pseudo status profil nom age n 3 friendly name pseudo status profil L adresse Bluetooth de chaque terminal mobile étant unique, on l utilise pour pouvoir différentier chaque nœud du réseau. La table des adresses Bluetooth sert de registre initial, elle stocke les adresses des contacts. Pour chaque contact, on crée une table rassemblant toutes les informations le concernant, le nom de cette table sera l adresse Bluetooth du contact, elle est unique et répertoriée dans le registre Ce système permet une grande liberté d accès aux données sans occuper la mémoire vive du terminal. Projet BlueStorm Conception - Plateforme - Messagerie 8

10 1. Diagrammes d activité a. Lancement de BlueStorm Ce diagramme permet de spécifier le cheminement des actions à réaliser après découverte du réseau. Chaque nouveau contact est testé pour savoir s il est connu ou non. Les contacts «amis» (permanents) qui sont rajoutés à la liste de contact par l'utilisateur, sont enregistrés dans RMS. Ces contacts sont affichés qu ils soient hors ligne ou en ligne (leur statut est en permanence précisé). Les voisins découverts (encore inconnus par l'utilisateur), sont ajoutés à une base de données temporaire. Celle-ci est détruite lors de la déconnexion du logiciel. Ainsi, ces contacts ne figurent dans la liste de contact que lorsqu ils sont effectivement en ligne. Projet BlueStorm Conception - Plateforme - Messagerie 9

11 b. Fermeture de BlueStorm Ce diagramme spécifie le déroulement des actions lors de la déconnexion du logiciel. Le statut de chaque contact, figurant dans la liste, est vérifié. S'il est enregistré dans la base de données RMS permanente, on le garde. S il est enregistré dans la base de données RMS temporaire, on le supprime. Projet BlueStorm Conception - Plateforme - Messagerie 10