MySQL.h

Aller à la documentation de ce fichier.

/*! \file MySQL.h
    \brief Gestion base de MySQL.

    Gestionnaire de base de données MySQL. \n

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

#ifndef INCLUDE_RSRC_MYSQL
#define INCLUDE_RSRC_MYSQL

#include    "../../mysql/mysql.h"
#include    "../Surcouche/SurcoucheMultitache.h"
#include    "../Error/Error.h"
#include    <vector>

#define     MYSQL_HOST      256
#define     MYSQL_USER      32
#define     MYSQL_PASS      32
#define     MYSQL_BASE      32
#define     MYSQL_BUFFER    10240

//! Gestion base MySQL.
/*! Gestionnaire de base de données MySQL.
*/
class MySQL
{
private :
    char                    Host[MYSQL_HOST];   /*!< Serveur où ce trouve la base.                      */
    int                     Port;               /*!< Port utilisé par le serveur où ce trouve la base.  */
    char                    User[MYSQL_USER];   /*!< User pour ce connexter à la base.                  */
    char                    Pass[MYSQL_PASS];   /*!< Password pour ce connecter à la base.              */
    char                    Name[MYSQL_BASE];   /*!< Nom de la base sur le serveur.                     */
    MYSQL                   Base;               /*!< Manipulateur de la base mysql.                     */
    int                     Connected;          /*!< 1 si connecter, 0 sinon.                           */
    std::vector<MYSQL_ROW>  Datas;              /*!< Chaque lignes est une entrée.                      */
    static int              MySQLInstance;      /*!< Compte les instance de la class.                   */
    static MUTEX            MySQLMutex;         /*!< Utiliser des que l'on accede au fichier "DB.sys".  */

    //! Affiche une erreur mysql.
    /*! Affiche le détail d'une erreur mysql.
    */
    inline void MySQLError()
    {
        printf("MYSQL error %i : %s\n", mysql_errno(&Base), mysql_error(&Base));
    };

    //! Enregistre les données dans un tableau.
    /*! Enregistre les données d'une requette mysql dans un tableau dynamique.
    */
    int     SaveResult();

public  :
    /*! Charge la base en mémoire.
        \param pHost serveur où ce trouve la base.
        \param pUser user pour ce connexter à la base.
        \param pPass password pour ce connecter à la base.
        \param pBase nom de la base sur le serveur.
        \param iPort port utilisé par le serveur où ce trouve la base.
    */
    MySQL(char *pHost, char *pUser, char *pPass, char *pBase, int iPort = 0);

    /*! Libere proprement la mémoire, ne sauve pas la base dans les fichiers.
        \sa SaveBase().
    */
    ~MySQL();

    //! Se connecte à la base.
    /*! Se connecte à la base mysql.
        \return Code d'erreur.
        \sa Close().
    */
    int     Open();

    //! Se déconnecte de la base.
    /*! Se déconnecte de la base mysql.
        \return Code d'erreur.
        \sa Open().
    */
    int     Close();

    //! Envoie une requette.
    /*! Envoie une requette au serveur.
        \param pQuery requette au format printf
        \return Code d'erreur.
    */
    int     Query(char *pQuery, ...);

    //! Envoie une requette.
    /*! Envoie une requette binaire au serveur.
        \param pQuery requette
        \param iSize longeur de la requette
        \return Code d'erreur.
    */
    int     QueryBin(char *pQuery, int iSize);

    //! Retourne le nombre d'entrée.
    /*! Retourne le nombre d'entrée dans \a Datas.
        \return nombre d'entrée.
    */
    inline MYSQL_ROW    GetData(int iNo)
    {
        if(iNo < Datas.size())
            return Datas[iNo];
    };

    //! Retourne le nombre d'entrée.
    /*! Retourne le nombre d'entrée dans \a Datas.
        \return nombre d'entrée.
    */
    inline int      GetNbData()
    {
        return Datas.size();
    };

    //! Retourne le nombre d'instance.
    /*! Retourne le nombre d'instance de la class (pour multitache).
        \return nombre d'instance de la class.
    */
    inline int      GetNbInstance()
    {
        return MySQLInstance;
    };

    //! Retourne le nom de la base.
    /*! Retourne le nom \a Name de la base.
        \return pointeur sur \a Name.
    */
    inline char     *GetBaseName()
    {
        return Name;
    };
};

#endif

---