RESUME
C'est sûrement l'interface de programmation en C++ de PostgreSQL, la plus innovante. Elle constitue par rapport aux habituelles, l'une de la nouvelle génération. Son intérêt réside surtout avec son adéquation avec la bibliothèque STL (Standard Template Library). Comme le souligne son auteur, elle a été pensée «STL-compatible» 
. Le site de développement est http://thaiopensource.org/development/libpqxx/.
Autre point à signaler, libpqxx est basée sur le mode transactionnel de PostgreSQL. Elle sort donc du cadre purement basique de la programmation «Requêtes - Réponses» pour l'interfaçage client-serveur. La richesse de ses fonctionnalités est vraiment impressionnante, déroutante parfois au premier abord. Elle permet un code lisible, bien stylé, appréciable.
INSTALLATION SOUS UBUNTU DAPPER
En pré-requis, il faut avoir un serveur PostgreSQL sous la main. Libpqxx est basée sur libpq. Sous Windows, j'ai pu la compilé avec MinGW/Msys sans souci. Je livre ici mes notes pour une compilation sous Ubuntu Dapper (ou Debian). Je ne l'ai pas testé sous Visual C++.
Son installation se fait en faisant
wget http://thaiopensource.org/download/software/libpqxx/libpqxx-2.6.9.tar.gz
tar xvzf libpqxx-2.6.9.tar.gz
cd libpqxx-2.6.9
Chez moi PostgreSQL est installé Ã
/opt/pgsql/, je dois effectuer une modification du fichier
libpqxx.pc.in avant de continuer. Je fais celà surtout pour pouvoir compiler mes programmes par la suite. On ouvre donc le fichier et on effectue le remplacement suivant
prefix=@prefix@
exec_prefix=@exec_prefix@
libdir=@libdir@
includedir=@includedir@
Name: libpqxx
Description: a C++ API to the PostgreSQL database management system.
Version: @VERSION@
Libs: -L${libdir} -L@with_postgres_lib@ -lpq -lpqxx
Cflags: -I${includedir} -I@with_postgres_include@
On peut maintenant compiler.
export PATH=/opt/pgsql/bin/:$PATH
./configure
make
make install
En essayant d'utiliser
pqxx-config, j'ai eu l'erreur suivante
#pqxx-config --libs
pqxx-config is deprecated; please use "/usr/bin/pkg-config --libs libpqxx"
En fait c'est surtout sur la commande
pkg-config --libs libpqxx ou
pkg-config --cflags libpqxx qu'il faut se baser. Par exemple, pour l'une des deux j'obtiens
# pkg-config --libs libpqxx
-L/usr/local/lib -L/opt/pgsql/lib -lpq -lpqxx
TEST DE REGRESSION
Toujours dans les sources, il faut se rendre dans le sous-répertoire
test les sources et faire
cd test
chmod 777 -R .
su postgres
make check
UN PREMIER PROGRAMME
Pour la compilation de mon programme, je vais me doter du
Makefile suivant
PKGCONFIG=/usr/bin/pkg-config
CXXFLAGS = -g -Wall $(shell $(PKGCONFIG) --cflags libpqxx)
LDLIBS = $(shell $(PKGCONFIG) --libs libpqxx)
exes = test1
all: $(exes)
test1: test1.cc
clean:
rm -f $(exes)
Si l'utilisation d'un Makefile peut s'avérer déroutant, on pourra essayer
g++ -g -Wall -I/usr/local/include -I/opt/pgsql/include test1.cc -L/usr/local/lib -L/opt/pgsql/lib -lpq -lpqxx -o test1
Mon programme
test1.cc sera le suivant, juste un petit programme de connexion
/* test1.cc */
#include <stdlib.h> // Nécessaire pour exit(), EXIT_SUCCESS, et EXIT_FAILURE
#include <iostream> // requis pour cerr
#include <pqxx/pqxx> // définitions pour libpqxx
using namespace pqxx;
using namespace std;
int main( int argc, const char * argv[] )
{
try
{
connection myConnection( argc > 1 ? argv[1] : "" );
myConnection.activate();
if (myConnection.is_open())
{
string host = to_string( myConnection.server_version() );
host.replace(1,1,"."); host.replace(3,1,".");
cout<<" INFORMATIONS:"<<endl;
cout<<" Paramètres de connexion host="<<myConnection.hostname();
cout<<" dbname="<<myConnection.dbname()<<" user="<<myConnection.username()<<endl;
cout<<" Serveur - Version "<<host<<endl;
}
}
catch( runtime_error & e )
{
cerr << "Echec à la connexion avec erreur := " << e.what();
exit( EXIT_FAILURE );
}
catch( exception & e )
{
cerr << e.what();
exit( EXIT_FAILURE );
}
catch( ... )
{
cerr << "Erreur/exception inconnue !" << endl;
exit( EXIT_FAILURE );
}
exit( EXIT_SUCCESS );
}
Ensuite on tape
make
Pour une utilisation standard, je vais passer à test1 les paramètres de connexion
./test1 "host=localhost dbname=testgis user=postgres password=empr888"
qui me renverra
INFORMATIONS:
Paramètres de connexion host=localhost dbname=testgis user=postgres
Serveur - Version 8.2.3
On peut aussi utiliser des variables d'environnement de PostgreSQL, par exemple
# PGHOST=localhost PGUSER=postgres ./test1 "dbname=testgis password=empr888"
INFORMATIONS:
Paramètres de connexion host=localhost dbname=testgis user=postgres
Serveur - Version 8.2.3
Bien sûr, en cas d'échec de connexion, j'aurais par exemple sur un hôte distant
# PGHOST=192.168.0.5 PGUSER=postgres ./test1 "dbname=testgis password=empr888"
Echec à la connexion avec erreur := FATAL: authentification par mot de passe échouée pour l'utilisateur «postgres»
!!!
- vers 20h30, j'ai squatté le clic-clac de ma salle informatique, ma télécommande ATI Remote Wonder II en main. J'allume Tvtime et zou direction gulli pour regarder «Oggy et les cafards»
Récemment, je me suis aperçu que par rapport à 
Here I will try to show two examples of error with PostGIS and POLYGON.
