Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

SQLException — diagnosi degli errori JDBC

SQLException descrive gli errori di accesso al database in JDBC. Espone un messaggio, SQLState, un codice specifico del fornitore, una causa e una catena di eccezioni aggiuntive.

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

Sintassi

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

SQLException del package java.sql estende Exception: è un’eccezione controllata che deve essere intercettata o dichiarata con throws. Può verificarsi durante la creazione di una connessione o l’esecuzione di una query JDBC, non solo in presenza di una sintassi SQL non valida.

getMessage() restituisce una descrizione, getSQLState() un codice conforme alle convenzioni XOPEN o SQL:2003 e getErrorCode() un codice specifico del fornitore. Non confondere questi due codici. Il costruttore che riceve solo un messaggio imposta SQLState su null e il codice del fornitore su 0.

getCause() descrive la causa; getNextException() espone una catena diagnostica separata che termina con null. setNextException() aggiunge un’eccezione alla fine della catena. L’iterazione con for (Throwable item : ex) include anche le cause, non soltanto gli oggetti SQLException.

L’esempio crea e intercetta intenzionalmente un’eccezione senza database né driver. Il valore 101 è un codice del fornitore a scopo dimostrativo, non un codice JDBC portabile.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti