KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

RuntimeException(Throwable): een uitzonderingsoorzaak omwikkelen

De constructor RuntimeException(Throwable) maakt een ongecontroleerde uitzondering, bewaart de oorspronkelijke oorzaak en leidt daaruit het bericht af.

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

Syntax

new RuntimeException(Throwable cause)

RuntimeException(Throwable) maakt een uitzondering die de opgegeven oorzaak omwikkelt. RuntimeException is ongecontroleerd: de compiler vereist niet dat je deze uitzondering opvangt of in throws declareert. Alleen new gebruiken gooit de gemaakte uitzondering niet; daarvoor dient throw.

getCause() retourneert het opgegeven object en het bericht wordt ingesteld op (cause==null ? null : cause.toString()), niet alleen op cause.getMessage(). De waarde null betekent dat de oorzaak ontbreekt of onbekend is; het bericht is dan ook null.

Het omwikkelen bewaart de oorzaakketen voor diagnose. Vervang die niet door alleen fouttekst als je de oorspronkelijke uitzondering wilt behouden. Gebruik RuntimeException(String message, Throwable cause) om je eigen context toe te voegen; deze overload voegt het bericht van de oorzaak niet automatisch toe.

De expressie new RuntimeException(null) is ambigu, omdat er overloads zijn die String en Throwable accepteren. Gebruik new RuntimeException((Throwable) null) om deze constructor te selecteren. Na de aanroep kun je de oorzaak niet opnieuw instellen met initCause(), zelfs niet als je null hebt opgegeven.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        Exception cause = new Exception("Input unavailable");
        RuntimeException wrapped = new RuntimeException(cause);

        System.out.println(wrapped.getMessage());
        System.out.println(wrapped.getCause() == cause);

        RuntimeException empty = new RuntimeException((Throwable) null);
        System.out.println(empty.getMessage() == null);
        System.out.println(empty.getCause() == null);
    }
}

Resultaat

java.lang.Exception: Input unavailable
true
true
true

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