GServer

Serveur GS

À propos de GServer

• Qu'est-ce que GServer
• Qu'est-ce qu'UDP fiable
• Pourquoi UDP fiable est meilleur que TCP

Usage

Cours

• Hôte
• Message
• Stockage de données
• Plugins

Exemples

• Démarrage du serveur
• Gestion des messages
• Ajout de plugins

Qu'est-ce que GServer

GServer est une bibliothèque réseau UDP fiable, conçue pour les jeux. Ses principaux avantages sont :

• Protocole UDP fiable
• Architecture de plugin qui offre une grande flexibilité
• C'est extrêmement simple à utiliser

Qu'est-ce qu'UDP fiable

Reliable udp (RUDP) est un protocole de couche transport conçu pour les situations où TCP ajoute trop de surcharge, mais nous avons néanmoins besoin d'une livraison de paquets dans un ordre garanti.

Mods RUDP

RUDP prend en charge 3 mods et leurs combinaisons. GServer implémente certains des plus utiles d'entre eux :

• Aucun mode - fonctionne comme UDP standard
• Fiable : assure le contrôle de la livraison et garantit que tous les colis seront livrés
• Séquencé fiable : garantit que tous les colis livrés seront traités dans le bon ordre, mais aucune implication quant à la livraison de tous les colis n'est faite.
• Commande fiable - garantit que tous les colis seront livrés et traités dans le bon ordre

Pourquoi UDP fiable est meilleur que TCP

• UDP fiable offre plus de flexibilité que UDP en raison de ses modes
• Le mode ordonné fiable simule le comportement de TCP mais fonctionne plus rapidement car il n'a pas besoin d'attendre les paquets perdus.

Cours

Hôte

Host est la classe principale de GServer . Il fournit des méthodes pour recevoir, envoyer et traiter des messages. Les messages sont acceptés automatiquement dans le fil d'écoute.

Les messages sont envoyés à l'aide de la méthode "Send" et traités avec des gestionnaires enregistrés par l'utilisateur à l'aide de la méthode "AddHandler". Voir des exemples.

Message

Les messages sont utilisés pour envoyer des données d'un hôte à un autre. Il comporte 3 paramètres :

• type : short - type de message utilisé pour ajouter un gestionnaire à des messages spécifiques.
• mode : Mode - mode fiable (voir mods RUDP)
• body : byte[] - données sérialisées dans un tableau d'octets

Stockage de données

DataStorage est utilisé pour sérialiser les données dans un tableau d'octets. Il dispose de 2 mods :

• L’appel du constructeur sans paramètres active le mode écriture seule .
• L’appel du constructeur avec byte[] ou le paramètre MemoryStream active le mode lecture seule .

En mode lecture seule , vous pouvez utiliser uniquement les méthodes Read qui lisent les données du tampon. En mode écriture seule , vous pouvez utiliser uniquement les méthodes Write qui écrivent les données dans le tampon.

Plugins

En cours...

Exemples

Démarrer le serveur

serveur

 Host host = new Host ( portNumber ) ; //instantiate host on portNumber port
host . StartListen ( numberOfThreads ) ; //StartListen on numberOfThreads threads

Timer timer = new Timer ( o => host . Tick ( ) ) ;
timer . Change ( 10 , 10 ) ; // enables timer tick every 10 milliseconds

client

 Host host = new Host ( portNumber ) ; //instantiate host on portNumber port
host . StartListen ( numberOfThreads ) ; //StartListen on numberOfThreads threads

Timer timer = new Timer ( o => host . Tick ( ) ) ;
timer . Change ( 10 , 10 ) ; // enables timer tick every 10 milliseconds

host . OnConnect = ( ) => Console . WriteLine ( "Connected" ) ; // connect handler 

host . BeginConnect ( serverEndpoint ) ; // connecting to server endpoint 

Gestion des messages

 /* host inicialization here */

//add handler to message with id == messageId
//when message with that id will arrive callback will be invoked
//connection - connection associated with sender
host . AddHanlder ( messageId , ( message , connection ) => 
{
    /* deserialize message buffer */
    /* process message buffer */
    /* send response if needed */
} ) ; 

Stockage de données

 class SimpleClass : ISerializable , IDeserializable 
{
     public int IntField { get ; set ; }
     public byte [ ] ByteArray { get ; set } // arraySize = IntField
     public byte [ ] Serialize ( ) 
     {
          var ds = DataStorage . CreateForWrite ( ) ;
          ds . Push ( IntField ) ;
          ds . Push ( ByteArray ) ;
          return ds . Serialize ( ) ;
     }
     public void FillDeserialize ( byte [ ] buffer )
     {
          var ds = DataStorage . CreateForRead ( buffer ) ;
          IntField = ds . ReadInt32 ( ) ;
          ByteArray = ds . ReadBytes ( IntField ) ;
     }
}