WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

RuntimeException(Throwable): eine Ausnahmeursache umschließen

Der Konstruktor RuntimeException(Throwable) erstellt eine ungeprüfte Ausnahme, bewahrt die ursprüngliche Ursache und leitet die Meldung aus dieser Ursache ab.

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

Syntax

new RuntimeException(Throwable cause)

RuntimeException(Throwable) erstellt eine Ausnahme, die die angegebene Ursache umschließt. RuntimeException ist ungeprüft: Der Compiler verlangt weder, dass sie abgefangen wird, noch dass sie in throws deklariert wird. new allein löst die erstellte Ausnahme nicht aus; dafür ist throw zuständig.

getCause() gibt das übergebene Objekt zurück. Die Meldung wird auf (cause==null ? null : cause.toString()) gesetzt, nicht lediglich auf cause.getMessage(). Der Wert null bedeutet, dass keine Ursache vorhanden oder sie unbekannt ist; dann ist auch die Meldung null.

Das Umschließen bewahrt die Ursachenkette für die Diagnose. Ersetze sie nicht nur durch Fehlertext, wenn die ursprüngliche Ausnahme erhalten bleiben soll. Um eigenen Kontext hinzuzufügen, verwende RuntimeException(String message, Throwable cause); diese Überladung fügt die Meldung der Ursache nicht automatisch hinzu.

Der Ausdruck new RuntimeException(null) ist mehrdeutig, da Überladungen mit String und Throwable existieren. Verwende new RuntimeException((Throwable) null), um diesen Konstruktor auszuwählen. Nach seinem Aufruf lässt sich die Ursache auch dann nicht mit initCause() zurücksetzen, wenn null übergeben wurde.

Beispiele

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

Ergebnis

java.lang.Exception: Input unavailable
true
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen