CKTIS / Java
RuntimeException(Throwable): ovijanje vzroka izjeme
Konstruktor RuntimeException(Throwable) ustvari nenadzorovano izjemo, ohrani prvotni vzrok in iz njega izpelje sporočilo.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
new RuntimeException(Throwable cause)RuntimeException(Throwable) ustvari izjemo, ki ovije podani vzrok. RuntimeException je nenadzorovana izjema: prevajalnik ne zahteva, da jo prestrežete ali navedete v throws. Sam new ustvarjene izjeme ne sproži; za to poskrbi throw.
getCause() vrne podani objekt, sporočilo pa se nastavi na (cause==null ? null : cause.toString()), ne zgolj na cause.getMessage(). Vrednost null pomeni, da vzrok manjka ali ni znan; takrat je tudi sporočilo null.
Ovijanje ohrani verigo vzrokov za diagnostiko. Če želite ohraniti prvotno izjemo, je ne nadomestite zgolj z besedilom napake. Za dodajanje lastnega konteksta uporabite RuntimeException(String message, Throwable cause); ta preobremenitev sporočila vzroka ne doda samodejno.
Izraz new RuntimeException(null) je dvoumen, ker obstajata preobremenitvi, ki sprejemata String in Throwable. Za izbiro tega konstruktorja uporabite new RuntimeException((Throwable) null). Po njegovem klicu vzroka ni mogoče znova nastaviti z initCause(), tudi če ste podali null.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.