Développer en Java/Introduction à JDBC

Pré-requis

JDBC permet de se connecter à une base de données relationnelle pour y exécuter des requêtes SQL.

Dans la suite de ce chapitre, nous considérons une relation r dont les attributs a et b sont respectivement de type chaîne et entier.

create table r (a varchar2(42), b number)

Selon le système de bases de donnée (SGBD) que vous utilisez, vous devrez fournir un pilote adapté. Chaque pilote est spécifique à un SGBD.

Il existe des pilotes pour les SGBD suivants :

• Microsoft Access ;
• MySQL ;
• PostgreSQL ;
• Oracle ;
• Apache Derby.

Vous pourrez trouver le driver qui convient dans cette base de données : http://www.oracle.com/technetwork/database/features/jdbc/index-091264.html.

Se connecter au serveur

Utiliser la classe DriverManager.

Lancer une requête

Les requêtes (Statement)

// Une requête simple
String ma_requete = "select a, b from r";

// Requête en utilisant un Statement
Statement ma_requete = ma_connexion.createStatement();

// On récupère le résultat dans un ResultSet
ResultSet mon_resultat = ma_requete.executeQuery(ma_requete);

Les « Prepared Statement »

On utilise les Prepared Statement quand il y a des inconnues dans la requête à exécuter. Dans le requête (la chaîne), chaque inconnue est remplacée par « ? ». Les méthodes setInt, setString etc. permettent de modifier les paramètres.

// Une requête simple
String ma_requete = "insert into r values(?, ?)";

// Requête en utilisant un Statement
PreparedStatement mon_prepared_statement = ma_connexion.prepareStatement();

// Le premier paramètre est une chaîne de caractères
mon_prepared_statement.setString(1,"VALEUR 1");
// Le second paramètre est un entier
mon_prepared_statement.setInt(2,1337);

Les « Callable Statement »

Cette section est vide, pas assez détaillée ou incomplète.

Les « Callable Statement » permettent de faire appel à des fonctions ou à des procédures stockées (PL/SQL ou PL/pgSQL) dans la base de données.

Lequel utiliser ?

Cette section est vide, pas assez détaillée ou incomplète.

Bien qu'il soit possible d'exécuter des requêtes paramétrées avec un Statement simple (par un jeu de rechercher-remplacer ou de concaténations multiples pour former la chaîne de caractère), cela est déconseillé pour des raisons de sécurité et de fiabilité. En effet, l'utilisation d'un Prepared Statement génèrera un code SQL bien plus propre que ce qu'on peut faire à la main par concaténation.

Exemples

Microsoft Access

Cet exemple ne fonctionne que sur Windows à cause du pilote Microsoft Access :

Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
String path = "C:/example.mdb";
String dsn = "jdbc:odbc:Driver={Microsoft Access Driver (*.mdb)};DBQ=" + path + ";UID=admin";
accessConn = DriverManager.getConnection(dsn, "", "");

Remarque : les identifiants sont donnés dans le DSN plutôt que par getConnection.

MySQL

import java.sql.*;

public class ExempleJDBC {

    public static void main (String args[]) {

        try {
            Class.forName("com.mysql.jdbc.Driver");
        } catch (ClassNotFoundException e) {
            throw new Exception("impossible de charger le pilote MySQL, "
                                + "est-il bien dans le CLASSPATH ?", e);
        }

        try {
            // Création d'une connexion à la base
            Connection ma_connection = DriverManager.getConnection(
                     "jdbc:mysql://mon_serveur:3306/ma_base",
                     "mon_login",
                     "mon_mot_de_passe"
                    );

            // Une requête simple
            String ma_requete = "select a, b from r";

            // On prépare la requête avec un Statement
            Statement mon_statement = ma_connection.createStatement();

            // On exécute la requête
            ResultSet mon_resultset = mon_statement.executeQuery(ma_requete);
            
            // récupération et traitement du résultat
            System.out.println ("Dans ma relation :") ;
            while (mon_resultset.next()) {
                System.out.println(" | " + mon_resultset.getString("a")
                                 + " | " + mon_resultset.getInt("b"));
            }
            
            ma_connection.close();

        } catch (java.sql.SQLException e) {
            throw new Exception("erreur SQL", e);
        }
    }
}

Oracle Database

Ce script affiche la taille de la base :

import java.sql.*; 
import java.io.*; 
import oracle.jdbc.*; 
import oracle.sql.*; 

public class OracleDatabase {
  public static void main(String[] args) {
    try {
      DriverManager.registerDriver(new oracle.jdbc.OracleDriver());
      Connection conn = DriverManager.getConnection("jdbc:oracle:thin:@localhost:1521:MyDatabase", "MyAccount", "MyPassword"); 	
      conn.setAutoCommit(true);
      String sql = "SELECT sum(bytes) from dba_segments;";
      Statement stmt = conn.createStatement();
      stmt.execute(sql); 
      stmt.close();
      conn.close();   
    } catch(SQLException e) { e.printStackTrace(); }
  }
}

PostgreSQL

try {
   Class.forName("org.postgresql.Driver");
   Connection conn = DriverManager.getConnection("jdbc:postgresql:MyDatabase", "MyAccount", "MyPassword");
   conn.close();
} catch(SQLException e) { e.printStackTrace(); }

Erreurs connues

package oracle.jdbc does not exist

Si vous avez Oracle Database sur votre PC, ajouter au classpath les fichiers suivants :

• C:\oracle12\app\oracle\product\12.1.0\dbhome_1\jdbc\lib\ojdbc7.jar
• C:\oracle12\app\oracle\product\12.1.0\dbhome_1\sqlj\lib\runtime12.jar

Sinon, ojdbc7.jar peut être téléchargé depuis http://www.oracle.com/technetwork/database/features/jdbc/jdbc-drivers-12c-download-1958347.html, et ajouté à la compilation. Ex :

javac MyClass.java -classpath ojdbc7.jar

L'URL Oracle indiquée n'est pas valide

Reconstruire la ligne du getConnection() avec le code ci-dessus.

ORA-28009: connection as SYS should be as SYSDBA or SYSOPER

Ajouter " as sysdba" après le nom du compte Oracle, ex :

Connection conn = DriverManager.getConnection("jdbc:oracle:thin:@localhost:1521:MyDatabase", "MyAccount as sysdba",

ORA-00933: la commande SQL ne se termine pas correctement

Cette section est vide, pas assez détaillée ou incomplète.

Références

• La FAQ JDBC sur développez.com