Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes