Accès aux bases de données. Introduction à JDBC

Transcription

1 .doc Accès aux bases de données 1. QUELQUES DEFINITIONS LA CONNEXION EXECUTION ET CONTROLE D'UNE COMMANDE SQL Exécution des commandes SQL figées Exécution d'une requête préparée CONTROLE DE L'EXECUTION Contrôle des exceptions retournées par le serveur Contrôle du nombre de lignes modifiées Contrôle des valeurs nulles Ce support n'aborde pas la gestion des transactions; il utilise implicitement la validation par défaut des drivers JDBC (mode Autocommit).Quelques définitions Les APIs pour la persistance en base relationnelle 1 Page INJD.11

2 .doc JDBC la plus ancienne et actuellement la plus utilisée basée comme ODBC sur la norme CLI (Call level interface) SQLJ l'application à java de l'embedded SQL norme implémentée par Oracle et IBM-DB2 JDO la plus récente non limitée aux bases relationnelles Le JDK : package java.sql il comporte essentiellement des interfaces Driver, Connection Statement, PreparedStatement, ResultSet et quelques classes, dont DriverManager les exceptions SQLException, SQLWarning, DataTruncation Packages d implémentatio n : Par exemple classes111.zip ou classes12.zip d Oracle javax.sql Les principales classes: XxxDriver DriverManager getdriver() getconnection() Connection registerdriver() DriverManager.getConnection( ) Statement setautocommit(boolean) createstatement(): Statement commit() createstatement( ) executequery(string sql): ResultSet executeupdate(string sql): int rowcount 2 Page INJD.21 ResultSet next(): boolean existe getstring(): String donnée getint(): int donnée getdate(): Date donnée executequery( )

3 .doc 2. La connexion Il existe 4 types de drivers drivers "tout java" drivers natifs exemples JdbcThinTest.java et JdbcMySqlTest.java drivers three tiers ponts jdbc-odbc On utilise ici les drivers "tout java" Serveur de données protocole NetServeur du SGBD Coup d'œil à l'architecture éléments: socket TCP / IP classes JDBC 3 Page INJD.31 application Client

4 .doc - protocoles TCP/IP, HTTP - connexion socket - driver JDBC complet «tout java» Mise en place de la bibliothèque propriétaire Elle contient - l'implémentation des classes JDBC (Connection, Statement ) - et le driver La bibliothèque dépend du SGBD et varie avec la version par exemple classes12.zip pour Oracle mysql-connector-java stable-bin.jar pour mysql la bibliothèque doit être dans le classpath au moment de l'exécution Par exemple pour le driver thin d'oracle8 set classpath = c:\oracle\ora81\jdbc\lib\classes12.zip;%classpath% et pour mysql set classpath = c:\mysql\ mysql-connector-java stable-bin.jar;%classpath% Exemple d'utilisation try { // chargement du driver Class.forName ("oracle.jdbc.driver.oracledriver");... // connexion à la base Connection cnx = DriverManager.getConnection ("jdbc:oracle:thin:scott/tiger@serveur:1521:instance");... // création de la requête Statement stmt = cnx.createstatement ();... // exécution de la requête stmt.executeupdate ("create table Test(numero number(4))"); // traitement des exceptions retournées par le serveur catch (SQLException e) { System.out.println ("erreur accès base: " + e + " " + e.getmessage()); Gestion des transactions le fonctionnement par défaut des drivers JDBC est la validation des commandes SQL (commit) au fur et à mesure de leur exécution fonctionnement appelé mode AutoCommit 4 Page INJD.41

5 .doc il est inutile d'effectuer un commit() un rollback sera sans effet sur la base de données 3. Exécution et contrôle d'une commande SQL 3.1 Exécution des commandes SQL figées Exécution directe de commandes SQL-DML (insert, update ) ou SQL-DDL (create, drop ) Exemple InsertSelect Créer une table Connection cnx = DriverManager.getConnection ("jdbc:oracle:thin:scott/tiger@serveur:1521:instance"); Statement stmt = cnx.createstatement (); String requete = "create table Livre ( titre varchar2(200), anneeedition number(4))"; stmt.executeupdate(requete); Insérer des données dans la table requete = "insert into Livre (titre, auteur) values ('Tintin au tibet', 1960)"; try { stmt. executeupdate (requete); catch (SQLException ex) { System.out.println( erreur d exécution dans \n + requete + \n + ex.getmessage()) ; Lire les données présentes dans la table requete = "select titre, auteur from livre"; ResultSet rset = stmt.executequery (requete); while (rset.next ()) { // lecture de la colonne "titre" System.out.print (rset.getstring (1) + "\t"); // lecture de la colonne "anneeedition" System.out.println (rset.getint (2)); System.out.println ("fin de la table"); Le resultset est une collection de lignes retournées par le SELECT il faut se positionner sur le 1 er élément de la collection par next() avant de lire les données reçues 5 Page INJD.51

6 .doc 3.2 Exécution d'une requête préparée Exemple RequetePreparee but: optimisation des accès à la base, en évitant de recompiler (parsing) les requêtes SQL à chaqu exécution moyen. On remplace la classe Statement par la classe PreparedStatement Connection preparestatement(): PreparedStatement PreparedStatement clearparameters() setshort(int rangparam, short x) setstring(int rangparam, String x)... executequery(string sql): ResultSet executeupdate(string sql): int rowcount ResultSet next(): boolean existe getstring(): String donnée getint(): int donnée getdate(): Date donnée Définition, préparation et exécution: 1. création d'un preparedstatement, à la place du Statement: PreparedStatement pstmt = cnx.preparestatement ("select titre, anneeedition, prix from Scott.Livre where anneeedition >? or auteur =?"); 2. affectation des valeurs aux "place holders" pstmt.setint(1, 1965); pstmt.setstring(2, "Morris"); 3. exécution du preparedstatement ResultSet result = pstmt.executequery(); while(result.next()) { // exploitation du résultat System.out.println (result.getstring(1) ;... 6 Page INJD.61

7 .doc De même pour un insert, ou update, delete: PreparedStatement pstmt = cnx.preparestatement ("insert into Scott.Dept (deptno, dname, location) values (?,?,?)"); pstmt.setint (1, 12); pstmt.setstring (2, "Oracle"); pstmt.setstring (3, "USA"); 4. int rows = pstmt.executeupdate ();Contrôle de l'exécution 4.1 Contrôle des exceptions retournées par le serveur Exemple InsertSelect2 On peut intercepter et analyser les exceptions retournées par le serveur de données try { String requete= "insert into livre (?,?) values ('?,?"; PreparedStatement pstmt = cnx.preparestatement(requete); pstmt.setstring... pstmt.executeupdate(); catch(sqlexception ex) { System.out.println (ex.getmessage() ); Possibilité de sélection de certains codes d'erreur: on peut ne vouloir intercepter que certaines exceptions; par exemple try {... catch (SQLException ex) { if (ex.geterrorcode() == 955 ) { // exception "la table existe déjà" (pour Oracle) // traiter cette exception else throw ex; // propager les autres exceptions 4.2 Contrôle du nombre de lignes modifiées Contrôle du nombre de lignes modifiées par un insert, update ou delete une commande SQL insert / update / delete peut ne modifier aucune ligne de la table le serveur ne retourne pas d'exception dans ce cas on peut vouloir vérifier combien de lignes ont étyé modifiées: String requete = "update Livre set auteur =? where titre =?"; PreparedStatement pstmt = cnx.preparestaement(requete); 7 pstmt.setstring... Page INJD.71 int comptelignes = stmt.executeupdate(requete); System.out.println (comptelignes + " lignes modifiées");

8 .doc 4.3 Contrôle des valeurs nulles Les principes dans une base relationnelle, n'importe quelle cellule d'une table peut avoir une valeur nulle en SQL, une valeur nulle est testée par where une_colonne is null dans JDBC, la valeur relationnelle NULL est identifiée par java.sql.types.null avec java, n'importe quel pointeur vers un objet peut être nul par contre un type primitif (int, float, boolean ) ne peut pas être nul on peut cependant leur affecter des valeurs spéciales (Integer.MIN_VALUE, Float.NEGATIVE_INFINITY) Exemple d'utilisation dans un select int numero = 0; ResultSet rs = statement.executequery("select empno, ename from emp"); while (rs.next()) { numero = rs.getint(1); if (rs.wasnull()) numero = Integer.MIN_VALUE; et en insertion int numero = PreparedStatement ps = connecion.preparestatement("insert into emp (empno, ename) values (?,?)"); ps.setint(1, java.sql.types.null); =========================== 8 Page INJD.81