KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

SQLException — JDBC-fouten diagnosticeren

SQLException beschrijft fouten bij databasetoegang met JDBC. De uitzondering biedt een bericht, SQLState, een leverancierspecifieke code, een oorzaak en een keten van aanvullende uitzonderingen.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

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

SQLException uit java.sql breidt Exception uit: het is een gecontroleerde uitzondering die moet worden afgehandeld of met throws moet worden gedeclareerd. De uitzondering kan optreden bij het tot stand brengen van een verbinding of het uitvoeren van een JDBC-query, niet alleen bij ongeldige SQL-syntaxis.

getMessage() geeft een beschrijving terug, getSQLState() een code volgens de XOPEN- of SQL:2003-conventies en getErrorCode() een leverancierspecifieke code. Verwar deze twee codes niet. De constructor die alleen een bericht ontvangt, stelt SQLState in op null en de leverancierscode op 0.

getCause() beschrijft de oorzaak; getNextException() biedt een afzonderlijke diagnostische keten die eindigt op null. setNextException() voegt een uitzondering toe aan het einde van die keten. Iteratie met for (Throwable item : ex) omvat ook oorzaken, niet alleen SQLException-objecten.

Het voorbeeld maakt en vangt bewust een uitzondering zonder database of driver. De waarde 101 is een demonstratie van een leverancierscode, geen draagbare JDBC-code.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen