Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

SQLException — dijagnostika JDBC pogrešaka

SQLException opisuje pogreške pristupa bazi podataka u JDBC-ju. Omogućuje pristup poruci, SQLStateu, kodu dobavljača, uzroku i lancu dodatnih iznimki.

Verzija: 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 proširuje Exception: riječ je o provjeravanoj iznimci koju treba uhvatiti ili deklarirati pomoću throws. Može se pojaviti pri uspostavljanju veze ili izvršavanju JDBC upita, a ne samo zbog neispravne SQL sintakse.

getMessage() vraća opis, getSQLState() kod prema konvencijama XOPEN ili SQL:2003, a getErrorCode() kod specifičan za dobavljača. Nemojte miješati ta dva koda. Konstruktor koji prima samo poruku postavlja SQLState na null, a kod dobavljača na 0.

getCause() opisuje uzrok; getNextException() izlaže zaseban dijagnostički lanac koji završava s null. setNextException() dodaje iznimku na kraj tog lanca. Iteracija pomoću for (Throwable item : ex) obuhvaća i uzroke, a ne samo objekte SQLException.

Primjer namjerno stvara i hvata iznimku bez baze podataka ili upravljačkog programa. Vrijednost 101 demonstracijski je kod dobavljača, a ne prenosivi JDBC kod.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori