CKTIS / Java
SQLException — diagnostika chýb JDBC
SQLException opisuje chyby pri prístupe k databáze cez JDBC. Sprístupňuje správu, SQLState, kód dodávateľa, príčinu a reťazec ďalších výnimiek.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)SQLException z balíka java.sql rozširuje Exception: ide o kontrolovanú výnimku, ktorú treba zachytiť alebo deklarovať pomocou throws. Môže nastať pri nadväzovaní spojenia alebo vykonávaní dotazu JDBC, nielen pri neplatnej syntaxi SQL.
getMessage() vracia opis, getSQLState() kód podľa konvencií XOPEN alebo SQL:2003 a getErrorCode() kód špecifický pre dodávateľa. Tieto dva kódy si nezamieňajte. Konštruktor, ktorý prijíma iba správu, nastaví SQLState na null a kód dodávateľa na 0.
getCause() opisuje príčinu; getNextException() sprístupňuje samostatný diagnostický reťazec končiaci hodnotou null. setNextException() pripojí výnimku na koniec tohto reťazca. Iterácia pomocou for (Throwable item : ex) zahŕňa aj príčiny, nielen objekty SQLException.
Príklad zámerne vytvorí a zachytí výnimku bez databázy alebo ovládača. Hodnota 101 je ukážkový kód dodávateľa, nie prenositeľný kód JDBC.
Príklady
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());
}
}
}
}Výsledok
Demo failure | 42000 | 101 Extra detail | null | 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.