CKTIS / Java
RuntimeException(Throwable): avvolgere una causa di eccezione
Il costruttore RuntimeException(Throwable) crea un’eccezione non verificata, conserva la causa originale e ricava da essa il messaggio.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
new RuntimeException(Throwable cause)RuntimeException(Throwable) crea un’eccezione che avvolge la causa fornita. RuntimeException è un’eccezione non verificata: il compilatore non richiede che venga intercettata o dichiarata in throws. Il solo new non lancia l’eccezione creata; a farlo è throw.
getCause() restituisce l’oggetto fornito e il messaggio viene impostato a (cause==null ? null : cause.toString()), non semplicemente a cause.getMessage(). Un valore null significa che la causa è assente o sconosciuta; in tal caso, anche il messaggio è null.
L’avvolgimento conserva la catena delle cause per la diagnosi. Non sostituirla con il solo testo dell’errore se vuoi mantenere l’eccezione originale. Per aggiungere un contesto personalizzato, usa RuntimeException(String message, Throwable cause); questo overload non include automaticamente il messaggio della causa.
L’espressione new RuntimeException(null) è ambigua perché esistono overload che accettano String e Throwable. Usa new RuntimeException((Throwable) null) per selezionare questo costruttore. Dopo averlo chiamato, non puoi reimpostare la causa tramite initCause(), anche se hai passato null.
Esempi
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);
}
}Risultato
java.lang.Exception: Input unavailable true true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.