GServer

G-сервер

О GServer

• Что такое GServer
• Что такое надежный udp
• Почему надежный udp лучше TCP

Использование

Классы

• Хозяин
• Сообщение
• Хранение данных
• Плагины

Примеры

• Стартовый сервер
• Обработка сообщений
• Добавление плагинов

Что такое GServer

GServer — это надежная сетевая библиотека UDP, предназначенная для игр. Его основные преимущества:

• Надежный протокол UDP
• Архитектура плагинов, обеспечивающая высокую гибкость
• Это чрезвычайно легко использовать

Что такое надежный UDP

Надежный udp (RUDP) — это протокол транспортного уровня, разработанный для ситуаций, когда TCP добавляет слишком много накладных расходов, но, тем не менее, нам необходима доставка пакетов в гарантированном порядке.

РУДП моды

RUDP поддерживает 3 мода и их комбинации. GServer реализует некоторые из наиболее полезных из них:

• Нет режима — работает как стандартный UDP
• Надежность – обеспечивает проверку доставки и гарантирует, что все посылки будут доставлены.
• Надежная последовательность - гарантирует, что все доставленные пакеты будут обработаны в правильном порядке, но доставка всех пакетов не подразумевается.
• Надежный заказ – гарантирует, что все посылки будут доставлены и обработаны в правильном порядке.

Почему надежный udp лучше TCP

• Надежный udp обеспечивает большую гибкость, чем udp, благодаря своим режимам.
• Надежный упорядоченный режим имитирует поведение TCP, но работает быстрее, поскольку ему не нужно ждать потери пакетов.

Классы

Хозяин

Host — это основной класс в GServer . Он предоставляет методы для получения, отправки и обработки сообщений. Сообщения принимаются автоматически в потоке прослушивания.

Сообщения отправляются методом «Отправить» и обрабатываются обработчиками, которые регистрируются пользователем с помощью метода «AddHandler». См. примеры.

Сообщение

Сообщения используются для отправки данных с одного хоста на другой. Он имеет 3 параметра:

• type: тип короткого сообщения, который используется для добавления обработчика к определенным сообщениям.
• mode: Mode — надежный режим (см. моды RUDP)
• body: byte[] — сериализованные данные в массиве байтов

Хранение данных

DataStorage используется для сериализации данных в массив байтов. Имеет 2 мода:

• Вызов конструктора без параметров включает режим только записи .
• Вызов конструктора с параметром byte[] или MemoryStream включает режим только для чтения .

В режиме только для чтения вы можете использовать только методы Read, которые читают данные из буфера. В режиме только записи вы можете использовать только методы Write, которые записывают данные в буфер.

Плагины

В процессе...

Примеры

Запустить сервер

сервер

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

Обработка сообщений

 /* 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 */
} ) ; 

Хранение данных

 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 ) ;
     }
}