CKTIS / Java
SQLException — диагностика на JDBC грешки
SQLException описва грешки при достъп до база данни чрез JDBC. Предоставя съобщение, SQLState, код на доставчика, причина и верига от допълнителни изключения.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
new SQLException(String reason, String sqlState, int vendorCode, Throwable cause)SQLException от пакета java.sql разширява Exception: това е проверявано изключение, което трябва да бъде обработено или декларирано с throws. Може да възникне при установяване на връзка или изпълнение на JDBC заявка, а не само при невалиден SQL синтаксис.
getMessage() връща описание, getSQLState() — код според конвенциите XOPEN или SQL:2003, а getErrorCode() — код, специфичен за доставчика. Не бъркайте тези два кода. Конструкторът, който приема само съобщение, задава SQLState на null, а кода на доставчика — на 0.
getCause() описва причината; getNextException() предоставя отделна диагностична верига, завършваща с null. setNextException() добавя изключение в края на тази верига. Итерацията с for (Throwable item : ex) включва и причините, а не само обекти SQLException.
Примерът умишлено създава и обработва изключение без база данни или драйвер. Стойността 101 е демонстрационен код на доставчик, а не преносим JDBC код.
Примери
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());
}
}
}
}Резултат
Demo failure | 42000 | 101 Extra detail | null | 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.