CKTIS / Java
RuntimeException(Throwable): zabalenie príčiny výnimky
Konštruktor RuntimeException(Throwable) vytvára nekontrolovanú výnimku, zachováva pôvodnú príčinu a odvodzuje z nej správu.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
new RuntimeException(Throwable cause)RuntimeException(Throwable) vytvorí výnimku, ktorá zabalí zadanú príčinu. RuntimeException je nekontrolovaná výnimka: kompilátor nevyžaduje, aby bola zachytená alebo deklarovaná v throws. Samotné použitie new vytvorenú výnimku nevyhodí; na to slúži throw.
getCause() vráti odovzdaný objekt a správa sa nastaví na (cause==null ? null : cause.toString()), nie iba na cause.getMessage(). Hodnota null znamená, že príčina chýba alebo nie je známa; správa je potom tiež null.
Zabalenie zachováva reťazec príčin na diagnostiku. Ak chcete zachovať pôvodnú výnimku, nenahrádzajte ho iba textom chyby. Vlastný kontext pridáte pomocou RuntimeException(String message, Throwable cause); tento preťažený variant automaticky nepripojí správu príčiny.
Výraz new RuntimeException(null) je nejednoznačný, pretože existujú preťažené varianty prijímajúce String a Throwable. Tento konštruktor vyberiete pomocou new RuntimeException((Throwable) null). Po jeho zavolaní už nemožno príčinu znova nastaviť pomocou initCause(), ani keď ste odovzdali null.
Prí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ýsledok
java.lang.Exception: Input unavailable true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.