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.