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.