CKTIS / Java
SQLException — dijagnostika JDBC pogrešaka
SQLException opisuje pogreške pristupa bazi podataka u JDBC-ju. Omogućuje pristup poruci, SQLStateu, kodu dobavljača, uzroku i lancu dodatnih iznimki.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)SQLException iz paketa java.sql proširuje Exception: riječ je o provjeravanoj iznimci koju treba uhvatiti ili deklarirati pomoću throws. Može se pojaviti pri uspostavljanju veze ili izvršavanju JDBC upita, a ne samo zbog neispravne SQL sintakse.
getMessage() vraća opis, getSQLState() kod prema konvencijama XOPEN ili SQL:2003, a getErrorCode() kod specifičan za dobavljača. Nemojte miješati ta dva koda. Konstruktor koji prima samo poruku postavlja SQLState na null, a kod dobavljača na 0.
getCause() opisuje uzrok; getNextException() izlaže zaseban dijagnostički lanac koji završava s null. setNextException() dodaje iznimku na kraj tog lanca. Iteracija pomoću for (Throwable item : ex) obuhvaća i uzroke, a ne samo objekte SQLException.
Primjer namjerno stvara i hvata iznimku bez baze podataka ili upravljačkog programa. Vrijednost 101 demonstracijski je kod dobavljača, a ne prenosivi JDBC kod.
Primjeri
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());
}
}
}
}Rezultat
Demo failure | 42000 | 101 Extra detail | null | 0
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.