| Documentation PostgreSQL 7.4.29 | ||||
|---|---|---|---|---|
| Précédent | Arrière rapide | Avance rapide | Suivant | |
ConnectionPoolDataSourceDataSourceJDBC est une API au cœur de Java 1.1 et ultérieur. Elle fournit un ensemble standard d'interfaces vers les bases de données compatibles SQL.
PostgreSQL fournit un pilote JDBC de type 4. Le type 4 indique que le pilote est écrit en pur Java et communique dans le propre protocole réseau du système des bases de données. De ce fait, le pilote est indépendant de la plate-forme. Une fois compilé, le pilote peut être utilisé sur tout système.
Ce chapitre n'a pas pour but d'être un guide complet de programmation JDBC mais devrait vous aider à commencer. Pour plus d'informations, référez-vous à la documentation standard de l'API JDBC. De même, jetez un œil sur les exemples inclus dans les sources.
Cette section décrit les étapes nécessaires avant de commencer à écrire ou exécuter des programmes utilisant l'interface JDBC.
Les versions pré compilées du pilote sont téléchargeables à partir du site web JDBC pour PostgreSQL.
Vous pouvez aussi construire le pilote à partir des sources mais vous n'avez réellement besoin de le faire que si vous modifiez le code source. Pour plus de détails, référez-vous aux instructions d'installation de PostgreSQL. Après installation, le pilote devrait se trouver dans PREFIX/share/java/postgresql.jar. Le pilote résultant sera construit pour la version de Java que vous utilisez. Si vous construisez avec un JDK, version 1.1, vous construirez une version qui supporte la spécification JDBC 1, si vous construisez avec un JDK 1.2 ou 1.3, vous construirez une version supportant la spécification JDBC 2, et enfin si vous construisez avec un JDK 1.4, vous construirez une version supportant la spécification JDBC 3.
Pour utiliser le pilote, l'archive JAR (nommée postgresql.jar si vous l'avez construite à partir des sources, sinon elle sera probablement nommée pg7.4jdbc1.jar, pg7.4jdbc2.jar ou pg7.4jdbc3.jar respectivement pour les versions JDBC 1, JDBC 2 et JDBC 3) a besoin d'être inclue dans le chemin des classes, soit en le plaçant dans la variable d'environnement CLASSPATH soit en utilisant des options sur la ligne de commande java.
Pour l'instant, supposons que nous avons une application qui utilise le pilote JDBC pour accéder à une base de données et que l'application est installée en tant que /usr/local/lib/myapp.jar. Le pilote JDBC de PostgreSQL est installé comme /usr/local/pgsql/share/java/postgresql.jar. Pour lancer l'application, nous pourrions utiliser :
export CLASSPATH=/usr/local/lib/myapp.jar:/usr/local/pgsql/share/java/postgresql.jar:. java MyApp
Charger le pilote dans l'application est traité dans Section 31.2.
Comme Java utilise uniquement les connexions TCP/IP, le serveur PostgreSQL doit être configuré pour accepter les connexions TCP/IP. Ceci se fait en configurant tcpip_socket = true dans le fichier postgresql.conf ou en fournissant l'option -i au lancement de postmaster.
De plus, la méthode d'authentification du client dans le fichier pg_hba.conf pourrait avoir besoin d'être configurée. Référez-vous à Chapitre 19 pour plus de détails. Le pilote JDBC supporte les méthodes d'accès trust, ident, password, md5, et crypt.
| Précédent | Sommaire | Suivant |
| Internes | Niveau supérieur | Initialiser le pilote |