CKTIS / Java
RuntimeException(Throwable): omatanje uzroka iznimke
Konstruktor RuntimeException(Throwable) stvara nekontroliranu iznimku, čuva izvorni uzrok i iz njega izvodi poruku.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
new RuntimeException(Throwable cause)RuntimeException(Throwable) stvara iznimku koja omata navedeni uzrok. RuntimeException je nekontrolirana iznimka: prevoditelj ne zahtijeva da je uhvatite ni da je navedete u throws. Sam new ne izbacuje stvorenu iznimku; za to služi throw.
getCause() vraća navedeni objekt, a poruka se postavlja na (cause==null ? null : cause.toString()), a ne samo na cause.getMessage(). Vrijednost null znači da uzrok ne postoji ili je nepoznat; tada je i poruka null.
Omatanje čuva lanac uzroka radi dijagnostike. Nemojte ga zamijeniti samo tekstom pogreške ako želite sačuvati izvornu iznimku. Za dodavanje vlastitog konteksta upotrijebite RuntimeException(String message, Throwable cause); to preopterećenje automatski ne uključuje poruku uzroka.
Izraz new RuntimeException(null) dvosmislen je jer postoje preopterećenja koja prihvaćaju String i Throwable. Upotrijebite new RuntimeException((Throwable) null) da biste odabrali ovaj konstruktor. Nakon njegova poziva uzrok ne možete ponovno postaviti pomoću initCause(), čak ni ako ste naveli null.
Primjeri
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);
}
}Rezultat
java.lang.Exception: Input unavailable true true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.