Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

SQLException — diagnóstico de erros JDBC

SQLException descreve erros de acesso a bases de dados em JDBC. Disponibiliza uma mensagem, SQLState, um código específico do fornecedor, uma causa e uma cadeia de exceções adicionais.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

SQLException do pacote java.sql estende Exception: é uma exceção verificada que tem de ser capturada ou declarada com throws. Pode ocorrer ao estabelecer uma ligação ou executar uma consulta JDBC, e não apenas quando a sintaxe SQL é inválida.

getMessage() devolve uma descrição, getSQLState() um código segundo as convenções XOPEN ou SQL:2003 e getErrorCode() um código específico do fornecedor. Não confunda estes dois códigos. O construtor que recebe apenas uma mensagem define SQLState como null e o código do fornecedor como 0.

getCause() descreve a causa; getNextException() disponibiliza uma cadeia de diagnóstico separada que termina em null. setNextException() acrescenta uma exceção ao fim dessa cadeia. A iteração com for (Throwable item : ex) inclui também as causas, e não apenas objetos SQLException.

O exemplo cria e captura intencionalmente uma exceção sem base de dados nem controlador. O valor 101 é um código do fornecedor para fins de demonstração, não um código JDBC portátil.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes