NetParser.h

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

    Parser de protocol programmable.

    \author     aerith (www.aerith.fr)
    \version    1.0
    \date       01/11/2007
*/

#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 pName nom de la requette.
        \param iPos position de \a pName dans la requette lors du pré-parse.
        \param pFunction fonction a lier.
        \param pMask syntax de la requette.
        \param iComplet si à 1, éxige que \a Mask soit completement parser
        \param pToks tokens utiliser pour rechercher le nom de la requette lors du pré-parse.
        \sa DelRequest() et GetNbRequest().
    */
    int     AddRequest(char *pName, int iPos, ROUTINE pFunction, char *pMask, int iComplet = 0, char *pToks = " \n\r\t");

    //! 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);

    //! Supprime une requette.
    /*! Supprime la requette ayant le raw \a iRaw.
        \param pName nom de la requette.
        \sa AddRequest(), GetRaw() et GetNbRequest().
    */
    inline int      DelRequest(char *pName)
    {
        int     i;

        for(i = 0; i < NbRequest; i++)
            if(!strcmp(Requests[i]->Name, pName))
                return DelRequest(i);
    };

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

        return NULL;
    };

    //! 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 la syntax de la requette.
    /*! Retourne la syntax (Mask) de la requette de nom \a pName.
        \param pName nom de la requette.
        \return pointeur sur la syntax de la requette \a Mask.
        \sa AddRequest(), DelRequest() et GetNbRequest().
    */
    inline char     *GetMask(char *pName)
    {
        for(int i = 0; i < NbRequest; i++)
            if(!strcmp(Requests[i]->Name, pName))
                return Requests[i]->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

---