База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници