Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

SQLException — diagnostiquer les erreurs JDBC

SQLException décrit les erreurs d’accès aux bases de données avec JDBC. Elle expose un message, un SQLState, un code propre au fournisseur, une cause et une chaîne d’exceptions supplémentaires.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)

SQLException du package java.sql étend Exception : c’est une exception vérifiée qui doit être interceptée ou déclarée avec throws. Elle peut se produire lors de l’établissement d’une connexion ou de l’exécution d’une requête JDBC, et pas seulement en cas de syntaxe SQL invalide.

getMessage() renvoie une description, getSQLState() un code conforme aux conventions XOPEN ou SQL:2003, et getErrorCode() un code propre au fournisseur. Ne confondez pas ces deux codes. Le constructeur qui ne reçoit qu’un message initialise SQLState à null et le code du fournisseur à 0.

getCause() décrit la cause ; getNextException() expose une chaîne de diagnostic distincte qui se termine par null. setNextException() ajoute une exception à la fin de cette chaîne. L’itération avec for (Throwable item : ex) inclut aussi les causes, et pas seulement les objets SQLException.

L’exemple crée et intercepte volontairement une exception sans base de données ni pilote. La valeur 101 est un code fournisseur donné à titre d’exemple, et non un code JDBC portable.

Exemples

import java.sql.SQLException;

public class Main {
    public static void main(String[] args) {
        SQLException first = new SQLException("Demo failure", "42000", 101);
        first.setNextException(new SQLException("Extra detail"));

        try {
            throw first;
        } catch (SQLException ex) {
            for (SQLException current = ex; current != null;
                    current = current.getNextException()) {
                System.out.println(current.getMessage() + " | "
                        + current.getSQLState() + " | "
                        + current.getErrorCode());
            }
        }
    }
}

Résultat

Demo failure | 42000 | 101
Extra detail | null | 0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources