CKTIS / Java
RuntimeException(Throwable): zabalení příčiny výjimky
Konstruktor RuntimeException(Throwable) vytváří nekontrolovanou výjimku, zachovává původní příčinu a odvozuje z ní zprávu.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
new RuntimeException(Throwable cause)RuntimeException(Throwable) vytvoří výjimku, která zabalí zadanou příčinu. RuntimeException je nekontrolovaná výjimka: kompilátor nevyžaduje, aby byla zachycena nebo deklarována v throws. Samotné použití new vytvořenou výjimku nevyvolá; k tomu slouží throw.
getCause() vrací předaný objekt a zpráva se nastaví na (cause==null ? null : cause.toString()), nikoli pouze na cause.getMessage(). Hodnota null znamená, že příčina chybí nebo není známa; zpráva je pak také null.
Zabalení zachovává řetězec příčin pro diagnostiku. Pokud chcete zachovat původní výjimku, nenahrazujte jej pouze textem chyby. Vlastní kontext přidáte pomocí RuntimeException(String message, Throwable cause); tato přetížená varianta automaticky nepřipojuje zprávu příčiny.
Výraz new RuntimeException(null) je nejednoznačný, protože existují přetížené varianty přijímající String a Throwable. Tento konstruktor vyberete pomocí new RuntimeException((Throwable) null). Po jeho zavolání už nelze příčinu znovu nastavit pomocí initCause(), ani když jste předali null.
Příklady
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);
}
}Výsledek
java.lang.Exception: Input unavailable true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.