CKTIS / Java
SQLException – JDBC-Fehler diagnostizieren
SQLException beschreibt Fehler beim Datenbankzugriff mit JDBC. Die Ausnahme stellt eine Meldung, SQLState, einen herstellerspezifischen Code, eine Ursache und eine Kette weiterer Ausnahmen bereit.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)SQLException aus java.sql erweitert Exception: Sie ist eine geprüfte Ausnahme, die abgefangen oder mit throws deklariert werden muss. Sie kann zum Beispiel beim Herstellen einer Verbindung oder beim Ausführen einer JDBC-Abfrage auftreten, nicht nur bei ungültiger SQL-Syntax.
getMessage() liefert eine Beschreibung, getSQLState() einen Code gemäß den XOPEN- oder SQL:2003-Konventionen und getErrorCode() einen herstellerspezifischen Code. Diese beiden Codes dürfen nicht verwechselt werden. Der Konstruktor, der nur eine Meldung entgegennimmt, setzt SQLState auf null und den herstellerspezifischen Code auf 0.
getCause() beschreibt die Ursache; getNextException() stellt eine separate Diagnosekette bereit, die mit null endet. setNextException() hängt eine Ausnahme an das Ende dieser Kette an. Eine Iteration mit for (Throwable item : ex) umfasst auch Ursachen, nicht nur SQLException-Objekte.
Das Beispiel erzeugt und fängt absichtlich eine Ausnahme ohne Datenbank oder Treiber ab. Der Wert 101 ist ein beispielhafter herstellerspezifischer Code und kein portabler JDBC-Code.
Beispiele
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());
}
}
}
}Ergebnis
Demo failure | 42000 | 101 Extra detail | null | 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.