Documentation du serveur de jeu Introduction Ce document décrit le rôle de notre serveur de jeu et les fonctionnalités qu il fournit à l application Android. Nous détaillerons aussi l architecture et les services fournis par tous les paquetages du serveur. Enfin, nous décrirons la base de données que le serveur interroge. Benoît Raymond - Matiaz Ouine - David Duménil - Florian Guffon 1/5
Table des matières Introduction... 1 Description du serveur de jeu... 3 Description de l architecture du serveur... 3 Schéma des paquetages du serveur... 3 Description et services fournis par les paquetages... 3 Paquetage server... 3 Paquetage GGPpacket... 4 Paquetage game... 4 Paquetage database... 4 Détail de l architecture de la BD... 5 Diagramme de Classes... 5 Benoît Raymond - Matiaz Ouine - David Duménil - Florian Guffon 2/5
Description du serveur de jeu Le serveur de jeu permet de faire l interface entre les clients et la base de données où sont enregistrées toutes les données relatives au jeu. Ce serveur permet aussi de faire le traitement des requêtes des joueurs et de leurs actions. Le serveur écoute sur un port spécifique et attend les connexions. À chaque nouvelle connexion, il crée un thread indépendant qui va traiter la requête et renvoyer la réponse. Les paquets sont envoyés grâce au protocole de communication Geo Game Protocol (GGP), un protocole, développé par nos soins, facilitant la communication de données de localisation ainsi que la communication d action interactive des joueurs. Les traitements des requêtes effectués par les threads du serveur permettent de traiter les différents types de paquets du protocole GGP. Ils permettent aussi de lancer les algorithmes du jeu, notamment celui du combat. Description de l architecture du serveur Schéma des paquetages du serveur Description et services fournis par les paquetages Paquetage server Ce paquetage se compose de plusieurs classes : la classe ServerMain qui contient le main du serveur et permet la création du serveur ainsi que sa mise en écoute sur une socket. la classe ServerThread qui est appelée par ServerMain à chaque nouvelle connexion au serveur. Cette classe permet la réception des requêtes, l appel à leurs traitements ainsi que le renvoi de la réponse au client. La classe PacketProcessing qui a pour seul but d appeler la bonne fonction de traitement pour un type de paquet reçu. Benoît Raymond - Matiaz Ouine - David Duménil - Florian Guffon 3/5
La classe ThreadDeconnection qui est lancée au démarrage du serveur et qui permet de détecter les joueurs inactifs et de les déconnecter du serveur. Ce paquetage contient aussi une interface, l interface RequestProcessing. Elle permet de définir les signatures des fonctions de traitement des paquets qui sont appelées par PacketProcessing. Cette interface fait la liaison entre la partie communication du serveur et la partie traitement du jeu. Elle permet ainsi d implémenter facilement un autre jeu ou une autre application basée sur les même principes tout en gardant la base commune. Paquetage GGPpacket Ce paquetage implémente le protocole GGP, créé au cours de notre projet. Pour voir les spécifications détaillés de GGP, se référer à la documentation détaillée du protocole GGP. Ce paquetage définit les structures de données associées au paquet GGP (en-tête, données, ). Il définit également la réception et l envoi des messages dans la socket créée avec le client. Sous paquetage: Création Le paquetage Création, permet de convertir un message de type Packet (avec les structure de données définies dans GGPpacket) en un message de type String. Cette conversion est nécessaire pour envoyer un message au travers de la socket. Sous paquetage: Validation Le paquetage Création permet de convertir un message de type String en un message de type Packet (avec les structures de données définies dans GGPpacket). Cette conversion est nécessaire lors de la réception d un message pour pouvoir faciliter les traitements ultérieurs sur le paquet. Sous paquetage: Exception Le paquetage Exception définit les différentes exceptions que le paquetage GGPpacket peut lever. Elles sont liées à l utilisation d un message qui ne respecte pas le protocole GGP (voir la documentation du protocole GGP pour plus d information). Paquetage game Ce paquetage contient l implémentation de l interface RequestProcessing, appelée GameRequestProcessing et permet ainsi de traiter les différents paquets reçus suivant notre spécification pour le jeu. Le paquetage game contient aussi une classe PlayProcessing qui contient des traitements spécifiques et complètement dépendants du jeu comme la gestion de l achat/vente d objets, les combats ou encore le stockage des messages et combats en attente de transmission au destinataire. Paquetage database Le paquetage database fournit toutes les interactions avec la Base de Donnée. La classe AbstractDB permet d initialiser et de créer la connexion avec la base de donnée mysql. La classe JoueurDB assure l interaction avec la table Joueur de la BD. Les principales créer un nouveau joueur mettre à jour de la position d un joueur Benoît Raymond - Matiaz Ouine - David Duménil - Florian Guffon 4/5
récupérer le pseudo, le mot de passe et la position d un joueur mettre en ligne / hors ligne un joueur avoir les objets d un joueur connaître les joueurs disponibles dans la zone d interaction d un joueur La classe ObjetDB assure l interaction avec la table Objet de la BD. Les principales créer un nouvel objet obtenir les informations de l objet (prix, valeur, type, nom, ) La classe LieuDB assure l interaction avec la table Lieu de la BD. Les principales créer un nouveau lieu connaître les objets disponibles du lieu avoir la position géographique du lieu Détail de l architecture de la BD Diagramme de Classes Ceci est le diagramme de classe de notre base de donnée. Il est composé de trois éléments principaux: joueur, lieux et objet. Ils représentent les différentes composants de notre jeu. Benoît Raymond - Matiaz Ouine - David Duménil - Florian Guffon 5/5