Partie III
Langages et outils
316
© Éditions Eyrolles
Instructions paramétrées (PreparedStatement)
L’interface PreparedStatement hérite de l’interface Statement, et la spécialise en
permettant de paramétrer des objets (états préparés) représentant des instructions SQL
précompilées. Ces états sont créés par la méthode prepareStatement de l’interface
Connection décrite ci-après. La chaîne de caractères contient l’ordre SQL dont les paramètres, s’il en possède, doivent être indiqués par le symbole « ? ».
PreparedStatement prepareStatement(String)
Une fois créés, ces objets peuvent être aisément réutilisés pour exécuter à la demande
l’instruction SQL, en modifiant éventuellement les valeurs des paramètres d’entrée à l’aide
des méthodes setxxx (setter methods). Le tableau suivant décrit les principales méthodes de
l’interface preparedStatement :
Décrivons à présent un exemple d’appel pour chaque méthode de compilation d’un ordre paramétré. On suppose la connexion cx créée :
Extraction de données (executeQuery)
Le code suivant (PrepareSELECT.java) illustre l’utilisation de la méthode executeQuery pour extraire les enregistrements de la table Avion :
Tableau 8-34 Méthodes de l’interface PreparedStatement
Méthode
Description
ResultSet executeQuery()
Exécute la requête et retourne un curseur ni navigable, ni
modifiable par défaut.
int executeUpdate()
Exécute une instruction LMD (INSERT, UPDATE ou DELETE) et
retourne le nombre de lignes traitées, ou 0 pour les instructions
SQL ne retournant aucun résultat (LDD).
boolean execute()
Exécute une instruction SQL et renvoie true, si c’est une instruction SELECT, false sinon.
void setNull(int, int)
Affecte la valeur NULL au paramètre de numéro et de type (classification java.sql.Types) spécifiés.
void close()
Ferme l’état.
Langages et outils
316
© Éditions Eyrolles
Instructions paramétrées (PreparedStatement)
L’interface PreparedStatement hérite de l’interface Statement, et la spécialise en
permettant de paramétrer des objets (états préparés) représentant des instructions SQL
précompilées. Ces états sont créés par la méthode prepareStatement de l’interface
Connection décrite ci-après. La chaîne de caractères contient l’ordre SQL dont les paramètres, s’il en possède, doivent être indiqués par le symbole « ? ».
PreparedStatement prepareStatement(String)
Une fois créés, ces objets peuvent être aisément réutilisés pour exécuter à la demande
l’instruction SQL, en modifiant éventuellement les valeurs des paramètres d’entrée à l’aide
des méthodes setxxx (setter methods). Le tableau suivant décrit les principales méthodes de
l’interface preparedStatement :
Décrivons à présent un exemple d’appel pour chaque méthode de compilation d’un ordre paramétré. On suppose la connexion cx créée :
Extraction de données (executeQuery)
Le code suivant (PrepareSELECT.java) illustre l’utilisation de la méthode executeQuery pour extraire les enregistrements de la table Avion :
Tableau 8-34 Méthodes de l’interface PreparedStatement
Méthode
Description
ResultSet executeQuery()
Exécute la requête et retourne un curseur ni navigable, ni
modifiable par défaut.
int executeUpdate()
Exécute une instruction LMD (INSERT, UPDATE ou DELETE) et
retourne le nombre de lignes traitées, ou 0 pour les instructions
SQL ne retournant aucun résultat (LDD).
boolean execute()
Exécute une instruction SQL et renvoie true, si c’est une instruction SELECT, false sinon.
void setNull(int, int)
Affecte la valeur NULL au paramètre de numéro et de type (classification java.sql.Types) spécifiés.
void close()
Ferme l’état.