Ce document a pour but de montrer comment exploiter une connection à une base de données mySQL, en utilisant uniquement l'API fournie avec mySQL.
Le code a été écrit et testé avec Borland C++ Builder 6.0 Enterprise anglais et mySQL version 4.0.4 beta.

Pour une description des fonctions de l'API, je vous renvoie a la documentaiton fournie avec mySQL sur http://www.mySQL.com

1.1. Création d'un nouveau projet▲

1.2. Création de la libraire d'importation ▲

1.3. Mise à jour des fichiers d'en-tête ▲

#ifdef __LCC__
#include <winsock.h> /* For windows */
#endif

#if ( defined(__LCC__) || defined(__WIN__) )
#include <winsock.h> /* For windows */
#endif

1.4. Mise à jour du projet▲

#define __WIN__
#include "mysql.h"

Avant tout chose il est nécessaire d'initialiser l'accès à la DLL.

MYSQL *mySQL;

mySQL = mysql_init(NULL);

Au retour, mySQL contient l'adresse de la structure permettant l'intefacage avec mySQL, ou NULL en cas d'erreur.
Il est tout à fait possible d'avoir plusieurs connections dans le même programme.

MYSQL *mySQL;

mysql_close(mySQL);

mysql_close ferme la connection à la base de données et libère les ressources allouées lors de la création de la connection.

MYSQL *mySQL;

if (!mysql_real_connect(mySQL, "127.0.0.1", "root", "root", "test", 0, NULL, 0)) {
    // la connection a échoué
} else {
    // la connection a réussi
}

mysql_real_connect ouvre la connection à la base données, et met à jour la structure mySQL en fonction de cette connection.
Les paramètres sont

• Le handle de Connection
• l'adresse du serveur où mySQL est installé
• le nom d'utilsiateur
• le mot de passe
• le nom de la base de données
• le n° de port (0 indique que l'on utilise le port par défaut)
• le nom du pipe ou le socket qui sera utilisé (habituellement NULL)
• des status permettant de configurer la connection (habituellement 0)

Une valeur de retour de 0 indique qu'une erreur s'est produite.
Une valeur autre indique que la conenction est ouverte

MYSQL *mySQL;
MYSQL_ROW myROW;
MYSQL_RES *myRES;
AnsiString aStr;

myRES = mysql_list_tables(mySQL, NULL);
if (myRES) {
    for(unsigned int i = 0; i < myRES->row_count; i++) {
        myROW = mysql_fetch_row(myRES);
        for(unsigned int j = 0; j < mysql_num_fields(myRES); j++) {
            aStr.sprintf("%s", myROW[j]);
            ListBox1->Items->Add(aStr);
        }
    }
    mysql_free_result(myRES);
}

mysql_list_tables permet de lire le noms de toutes les tables de la base de données associée à mySQL.
Ses paramètres sont :

• le handle de connection
• un masque permettant de filtrer les noms de tables à lire

La valeur de retour est une structre de type MYSQL_RES qui est un handle vers le résultat de la requête. Si la requête échoue, la valeur de retour est NULL.

La propriété row_count de myRES contient le nombre d'enregistrements contenus dans le résultat.

mysql_fetch_row renvoie l'enregistrement suivant du résultat de la requête, dans une structure de type MYSQL_ROW.

La fonction mysql_num_fields permet quant à elle de connaître le nombre de champs renvoyés par la requête.

Une fois que l'on n'a plus beosin du résultat de la requête, il ne faut pas oublier de libérer les ressources en appelant la fonction mysql_free_results.

MYSQL *mySQL;
MYSQL_RES *myRES;
MYSQL_ROW myROW;
AnsiString aStr;

if (!mysql_query(mySQL, "select * from testbcb")) {
    myRES = mysql_store_result(mySQL);
    if (myRES) {
        for(unsigned int i = 0; i < myRES->row_count; i++) {
            myROW = mysql_fetch_row(myRES);
            for(unsigned int j = 0; j < mysql_num_fields(myRES); j++) {
                aStr = myROW[j];
                ListBox1->Items->Add(aStr);
            }
        }
        mysql_free_result(myRES);
    }
}

La fonction mysql_query éxécute une requête.
Une valeur de retour à 0 indique que la requête a abouti. une valeur autre indique une erreur.

Pour accéder au résultat de la requête, il est nécessaire d'appeler la fonction mysql_store_results qui renvoie un pointeur de type MYSQL_RES.

mysql_fetch_row renvoie l'enregistrement suivant du résultat de la requête, dans une structure de type MYSQL_ROW

MYSQL *mySQL;
MYSQL_RES *myRES;
MYSQL_FIELD *myFields;
AnsiString aStr;
int CountFields;

if (!mysql_query(mySQL, "select * from testbcb")) {
    myRES = mysql_store_result(mySQL);
    if (myRES) {
        CountFields = mysql_num_fields(myRES);
        myFields = mysql_fetch_fields(myRES);
        for(unsigned int i = 0; i < CountFields; i++) {
            aStr.sprintf("Field %s is type %d",myFields[i].name, myFields[i].type);
            ListBox1->Items->Add(aStr);
        }
    }
    mysql_free_result(myRES);
}

La fonction mysql_fetch_fields remplit une structure de type MYSQL_FIELDS qui contient alors un tableau contenant toutes les informations des champs renvoyés par la requête.

8.1. Obtenir le code d'erreur▲

unsigned int myErrorCode;

myErrorCode = mysql_errno(mySQL);

8.2. Obtenir un message décrivant l'erreur▲

AnsiString myErrorMsg;

myErrorMsg = mysql_error(mySQL);

Dans la version 4, il y a la possibilité d'embarquer le serveur mySQL dans l'application. L'utilisation de cette version implique quelques modifications au projet et au fichier de configuration de mySQL.

9.1. Modification du fichier de configuration de mySQL ▲

[embedded]
basedir=e:/mysql
datadir=e:/mysql/data

9.2. Modification du projet▲

9.3. Démarrage du serveur▲

if (!mysql_server_init(0, NULL, NULL) {
    // le serveur est démarré
} else {
    // le serveur n'est pas démarré
}

9.4. Arrêt du serveur▲

mysql_server_end();