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.