Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

SQLException — diagnostyka błędów JDBC

SQLException opisuje błędy dostępu do bazy danych w JDBC. Udostępnia komunikat, SQLState, kod dostawcy, przyczynę oraz łańcuch dodatkowych wyjątków.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)

SQLException z pakietu java.sql rozszerza Exception: jest wyjątkiem kontrolowanym, który należy przechwycić albo zadeklarować przez throws. Może wystąpić między innymi podczas nawiązywania połączenia lub wykonywania zapytania JDBC, nie tylko przy błędnej składni SQL.

getMessage() zwraca opis, getSQLState() — kod według konwencji XOPEN lub SQL:2003, a getErrorCode() — kod zależny od dostawcy. Nie należy utożsamiać tych dwóch kodów. Konstruktor przyjmujący sam komunikat ustawia SQLState na null, a kod dostawcy na 0.

getCause() opisuje przyczynę; getNextException() udostępnia osobny łańcuch diagnostyczny, zakończony przez null. setNextException() dopisuje wyjątek na jego końcu. Iteracja for (Throwable item : ex) obejmuje także przyczyny, nie tylko obiekty SQLException.

Przykład celowo tworzy i przechwytuje wyjątek bez bazy danych ani sterownika. Wartość 101 jest demonstracyjnym kodem dostawcy, a nie przenośnym kodem JDBC.

Przykłady

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());
            }
        }
    }
}

Wynik

Demo failure | 42000 | 101
Extra detail | null | 0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła