CKTIS / Java
SQLException — diagnostika chyb JDBC
SQLException popisuje chyby při přístupu k databázi přes JDBC. Zpřístupňuje zprávu, SQLState, kód dodavatele, příčinu a řetězec dalších výjimek.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)SQLException z balíčku java.sql rozšiřuje Exception: jde o kontrolovanou výjimku, kterou je nutné zachytit nebo deklarovat pomocí throws. Může nastat při navazování spojení nebo provádění dotazu JDBC, nejen při neplatné syntaxi SQL.
getMessage() vrací popis, getSQLState() kód podle konvencí XOPEN nebo SQL:2003 a getErrorCode() kód specifický pro dodavatele. Tyto dva kódy nezaměňujte. Konstruktor, který přijímá pouze zprávu, nastaví SQLState na null a kód dodavatele na 0.
getCause() popisuje příčinu; getNextException() zpřístupňuje samostatný diagnostický řetězec končící hodnotou null. setNextException() připojí výjimku na konec tohoto řetězce. Iterace pomocí for (Throwable item : ex) zahrnuje i příčiny, nejen objekty SQLException.
Příklad záměrně vytvoří a zachytí výjimku bez databáze nebo ovladače. Hodnota 101 je ukázkový kód dodavatele, nikoli přenositelný kód JDBC.
Pří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ýsledek
Demo failure | 42000 | 101 Extra detail | null | 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.