CKTIS / Java
SQLException — JDBC-fouten diagnosticeren
SQLException beschrijft fouten bij databasetoegang met JDBC. De uitzondering biedt een bericht, SQLState, een leverancierspecifieke code, een oorzaak en een keten van aanvullende uitzonderingen.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)SQLException uit java.sql breidt Exception uit: het is een gecontroleerde uitzondering die moet worden afgehandeld of met throws moet worden gedeclareerd. De uitzondering kan optreden bij het tot stand brengen van een verbinding of het uitvoeren van een JDBC-query, niet alleen bij ongeldige SQL-syntaxis.
getMessage() geeft een beschrijving terug, getSQLState() een code volgens de XOPEN- of SQL:2003-conventies en getErrorCode() een leverancierspecifieke code. Verwar deze twee codes niet. De constructor die alleen een bericht ontvangt, stelt SQLState in op null en de leverancierscode op 0.
getCause() beschrijft de oorzaak; getNextException() biedt een afzonderlijke diagnostische keten die eindigt op null. setNextException() voegt een uitzondering toe aan het einde van die keten. Iteratie met for (Throwable item : ex) omvat ook oorzaken, niet alleen SQLException-objecten.
Het voorbeeld maakt en vangt bewust een uitzondering zonder database of driver. De waarde 101 is een demonstratie van een leverancierscode, geen draagbare JDBC-code.
Voorbeelden
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());
}
}
}
}Resultaat
Demo failure | 42000 | 101 Extra detail | null | 0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.