Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti