Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje