Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

SQLException — diagnosticiranje napak JDBC

SQLException opisuje napake pri dostopu do podatkovne baze prek JDBC. Ponuja sporočilo, SQLState, kodo ponudnika, vzrok in verigo dodatnih izjem.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

SQLException iz paketa java.sql razširja Exception: gre za preverjeno izjemo, ki jo je treba ujeti ali deklarirati z throws. Pojavi se lahko pri vzpostavljanju povezave ali izvajanju poizvedbe JDBC, ne le ob neveljavni sintaksi SQL.

getMessage() vrne opis, getSQLState() kodo v skladu s konvencijami XOPEN ali SQL:2003, getErrorCode() pa kodo, značilno za ponudnika. Teh dveh kod ne zamenjujte. Konstruktor, ki prejme samo sporočilo, nastavi SQLState na null in kodo ponudnika na 0.

getCause() opisuje vzrok; getNextException() ponuja ločeno diagnostično verigo, ki se konča z null. setNextException() doda izjemo na konec te verige. Iteracija z for (Throwable item : ex) vključuje tudi vzroke, ne samo objektov SQLException.

Primer namenoma ustvari in ujame izjemo brez podatkovne baze ali gonilnika. Vrednost 101 je prikazna koda ponudnika, ne prenosljiva koda JDBC.

Primeri

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());
            }
        }
    }
}

Rezultat

Demo failure | 42000 | 101
Extra detail | null | 0

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri