CKTIS / Java
SQLException: diagnóstico de errores JDBC
SQLException describe errores de acceso a bases de datos en JDBC. Proporciona un mensaje, SQLState, un código específico del proveedor, una causa y una cadena de excepciones adicionales.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)SQLException, del paquete java.sql, extiende Exception: es una excepción comprobada que debe capturarse o declararse con throws. Puede producirse al establecer una conexión o ejecutar una consulta JDBC, no solo cuando la sintaxis SQL no es válida.
getMessage() devuelve una descripción, getSQLState() un código conforme a las convenciones XOPEN o SQL:2003 y getErrorCode() un código específico del proveedor. No confundas estos dos códigos. El constructor que recibe únicamente un mensaje establece SQLState en null y el código del proveedor en 0.
getCause() describe la causa; getNextException() expone una cadena de diagnóstico independiente que termina en null. setNextException() añade una excepción al final de esa cadena. La iteración con for (Throwable item : ex) también incluye las causas, no solo los objetos SQLException.
El ejemplo crea y captura deliberadamente una excepción sin base de datos ni controlador. El valor 101 es un código de proveedor ilustrativo, no un código JDBC portable.
Ejemplos
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());
}
}
}
}Resultado
Demo failure | 42000 | 101 Extra detail | null | 0
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.