Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Throwable.getCause(): causa di un’eccezione

`getCause()` restituisce la causa diretta di un’eccezione o `null`. Usalo su una `ExecutionException` per esaminare l’eccezione lanciata dal task.

Versione: Java SE 21

Sintassi

public Throwable getCause()

Throwable.getCause() è un metodo di istanza senza argomenti di java.lang.Throwable. Restituisce la causa diretta come Throwable, oppure null se la causa è assente o sconosciuta. L’implementazione predefinita legge la causa passata al costruttore o impostata con initCause(Throwable).

Una chiamata percorre un solo anello della catena delle cause e non arriva necessariamente alla causa originaria. getMessage() restituisce il messaggio di dettaglio dell’oggetto corrente, mentre getSuppressed() fornisce un elenco separato di eccezioni soppresse. Verifica che la causa non sia null prima di usarla e controllane il tipo con instanceof prima di eseguire un cast.

Se un task fallisce lanciando un’eccezione, Future.get() lancia una ExecutionException. Nel blocco catch, usa getCause() per esaminare l’eccezione del task. L’annullamento del task (CancellationException) e l’interruzione durante l’attesa (InterruptedException) sono casi distinti.

Esempi

import java.util.concurrent.ExecutionException;
import java.util.concurrent.FutureTask;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        FutureTask<Integer> task = new FutureTask<>(() -> {
            throw new IllegalStateException("Missing input");
        });
        task.run();

        try {
            task.get();
        } catch (ExecutionException failure) {
            Throwable cause = failure.getCause();
            System.out.println(failure.getClass().getSimpleName());
            if (cause != null) {
                System.out.println(cause.getClass().getSimpleName());
                System.out.println(cause.getMessage());
            }
        }
    }
}

Risultato

ExecutionException
IllegalStateException
Missing input

`run()` esegue il task nel thread corrente. La successiva chiamata a `get()` lancia una `ExecutionException`; il programma stampa il tipo dell’eccezione che racchiude la causa, il tipo della causa e il relativo messaggio.

Lezioni correlate

  • Java · Lezione 50 · Intermedio · Versione: 2

Fonti