Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

RuntimeException(Throwable): opakowanie przyczyny wyjątku

Konstruktor RuntimeException(Throwable) tworzy wyjątek niekontrolowany, zachowując pierwotną przyczynę i wyprowadzając z niej komunikat.

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

Składnia

new RuntimeException(Throwable cause)

RuntimeException(Throwable) tworzy wyjątek opakowujący wskazaną przyczynę. RuntimeException jest wyjątkiem niekontrolowanym: kompilator nie wymaga jego przechwycenia ani deklaracji w throws. Samo new nie zgłasza utworzonego wyjątku; służy do tego throw.

getCause() zwraca przekazany obiekt, a komunikat jest ustalany jako (cause==null ? null : cause.toString()), nie jako samo cause.getMessage(). Wartość null oznacza brak przyczyny lub przyczynę nieznaną; wtedy komunikat również wynosi null.

Opakowanie zachowuje łańcuch przyczyn potrzebny do diagnozy. Nie zastępuj go samym tekstem błędu, jeśli chcesz zachować pierwotny wyjątek. Aby dodać własny kontekst, użyj RuntimeException(String message, Throwable cause); ten wariant nie dołącza automatycznie komunikatu przyczyny.

Zapis new RuntimeException(null) jest niejednoznaczny ze względu na przeciążenia przyjmujące String i Throwable. Użyj new RuntimeException((Throwable) null), aby wybrać omawiany konstruktor. Po jego wywołaniu nie można ponownie ustawić przyczyny przez initCause(), nawet jeśli przekazano null.

Przykłady

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

Wynik

java.lang.Exception: Input unavailable
true
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła