NetServer.h

Aller à la documentation de ce fichier.

/*! \file NetServer.h
    \brief Systeme serveur.

    Serveur multitache.

    \author     aerith (http://aerith.fr)
    \version    2.0
    \date       153003/2008
*/


#ifndef INCLUDE_RSRC_NET_SERVER
#define INCLUDE_RSRC_NET_SERVER

#include    "../Surcouche/SurcoucheReseau.h"
#include    "../Surcouche/SurcoucheMultitache.h"
#include    "../Surcouche/SurcoucheTemp.h"
#include    "../Tools/Tools.h"
#include    "../Error/Error.h"
#include    "NetConnect.h"
#include    <vector>

#define     NET_LIMIT           100                 /*!< Nombre max de client par défaut.           */
#define     NET_GARBAGE         100                 /*!< Rafrachissement du garbage des clients.    */
#define     NET_WAIT_FULL       10                  /*!< Temp d'attente si serveur plein.           */

//! Systeme serveur.
/*! Serveur multiclient et multitache autonome.
*/
class NetServer
{
private :
    NetConnect                  *conInfo;           /*!< Information sur la connection du serveur.  */
    THREAD                      threadClients;      /*!< Thread d'attente de client.                */
    THREAD                      threadGarbage;      /*!< Thread de suppression de client.           */
    std::vector<NetConnect *>   clients;            /*!< Chaque ligne est les infos d'un client.    */
    ROUTINE                     routineClient;      /*!< Routine executé pour gérer un client.      */
    unsigned int                limit;              /*!< Nombre de client max connecté.             */
    SSL_CTX                     *sslCTX;            /*!< Contexte pour OpenSSL.                     */
    string                      keyFile;            /*!< Chemin vers la clé privée SSL.             */
    string                      certifFile;         /*!< Chemin vers le certificat SSL.             */
    unsigned int                crypt;              /*!< Cryptage activé.                           */

public  :
    /*! Initialise avec des paramétres par defaut.
        \param pKeyFile chemin vers la clé privée SSL du serveur
        \param pCertifFile chemin vers le certificat SSL du serveur
    */
    NetServer(const char *pKeyFile = NULL, const char *pCertifFile = NULL);
    
    /*! Libère la mémoire proprement
    */
    ~NetServer();
    
    //! Démare le serveur.
    /*! Démare le serveur.
        \param iPort port d'écoute
        \param pRoutine nom de la routine appeler pour gérée un client.
        \param iLimit nombre max de clients
    */
    void    Start(unsigned int iPort, ROUTINE pRoutine, unsigned int iLimit = NET_LIMIT);
    
    //! Arrète le serveur.
    /*! Arrète le serveur.
    */
    void    Stop();

    //! Retourne un client.
    /*! Retourne le client d'Id \a iId.
        \param iId Id du client.
        \return Pointeur sur une class \a NetConnect.
    */
    inline NetConnect   *GetClient(unsigned int iId)
    {
        for(unsigned int i = 0; i < clients.size(); i++)
            if(clients[i]->GetId() == iId)
                return clients[i];

        return NULL;
    };

    //! Retourne un client.
    /*! Retourne le client numéro \a iNo.
        \param iNo numéro du client.
        \return Pointeur sur une class \a NetConnect.
    */
    inline NetConnect   *GetClientNo(unsigned int iNo)
    {
        if(iNo < clients.size())
            return clients[iNo];

        return NULL;
    };

    //! Déconnect un client.
    /*! Force la déconnéxion du client d'Id \a iId.
        \param iId Id du client.
    */
    void    KillClient(unsigned int iId);

    //! Déconnect un client.
    /*! Force la déconnéxion du client numéro \a iNo.
        \param iNo numéro du client.
    */
    void    KillClientNo(unsigned int iNo);

    //! Retourne le nombre de clients.
    /*! Retourne le nombre de client \a NbClient.
        \return le nombre de client \a NbClient.
    */
    inline unsigned int GetNbClient()
    {
        return clients.size();
    };

    //! Retourne le nombre de clients max.
    /*! Retourne le nombre de client maximum \a Limit.
        \return le nombre de client \a Limit.
    */
    inline unsigned int GetLimit()
    {
        return limit;
    };

    //! Attente de client.
    /*! Routine d'attente de client.
        \warning Ne pas utiliser, réservée à la class.
    */
    void    WaitClient();

    //! Suppression de client.
    /*! Routine de suppression de client.
        \warning Ne pas utiliser, réservée à la class.
    */
    void    GarbageClient();
};


#endif

---