NetParser.h

/*! \file NetParser.h
    \brief Parser de protocol.

    Parser de protocol programmable.

    \author     aerith (www.aerith.fr)
    \version    1.0
    \date       23/01/2008
*/

#ifndef INCLUDE_RSRC_NET_PARSER
#define INCLUDE_RSRC_NET_PARSER

#include    "../Surcouche/SurcoucheModule.h"
#include    "../Tools/Tools.h"
#include    "../Error/Error.h"
#include    "NetRequest.h"
#include    <stdio.h>
#include    <string.h>
#include    <stdlib.h>
#include    <vector>

//! Parser de protocol.
/*! Parser de protocol programmable.
*/
class NetParser
{
private :
    int                         NbRequest;      /*!< Nombre de requette.                                    */
    std::vector<NetRequest *>   Requests;       /*!< Chaque lignes est une requette.                        */
    NetConnect                  *Connect;       /*!< Class d'info sur la connection utilisant le parser.    */

public  :
    /*! Initialise avec des paramétres par defaut.
        \param pConnect class de la connection reseau
    */
    NetParser(NetConnect *pConnect);

    /*! Libère la mémoire proprement
    */
    ~NetParser();

    //! Ajoute une requette.
    /*! Ajoute une requette avec un raw et une fonction lier.
        \param pFunction fonction a lier.
        \param pMask syntax de la requette.
        \sa DelRequest() et GetNbRequest().
    */
    int     AddRequest(ROUTINE pFunction, char *pMask);

    //! Supprime une requette.
    /*! Supprime la requette à la position \a iPos.
        \param iPos position de la requette.
        \sa AddRequest(), GetRaw() et GetNbRequest().
    */
    int     DelRequest(int iPos);

    //! Retourne la syntax de la requette.
    /*! Retourne la syntax (Mask) de la requette \a iPos.
        \param iPos Position de la requette.
        \return pointeur sur la syntax de la requette \a Mask.
        \sa AddRequest(), DelRequest() et GetNbRequest().
    */
    inline char     *GetMask(int iPos)
    {
        if(iPos < NbRequest)
            return Requests[iPos]->Mask;

        return NULL;
    };

    //! Retourne le nombre de requettes.
    /*! Retourne le nombre de requette du parser.
        \return nombre de requette du parser.
        \sa AddRequest(), DelRequest() et GetRequest().
    */
    inline int      GetNbRequest()
    {
        return NbRequest;
    };

    //! Parse un buffer.
    /*! Parse un buffer ligne à ligne, recherche et éxécute les requettes.\n
        \param pBuffer buffer à parser.
        \return code d'erreur de la fonction retournant l'erreur.
    */
    int     ParseLine(char *pBuffer);

    //! Parse un buffer.
    /*! Parse le buffer en un seul block, recherche et éxécute une requette.\n
        \param pBuffer buffer à parser.
        \return code d'erreur de la fonction.
    */
    int     Parse(char *pBuffer);
};


#endif

---