Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ExecutionException — errore di un’attività durante il recupero del risultato

ExecutionException è un’eccezione controllata che viene lanciata quando si recupera il risultato di un’attività terminata con un’eccezione. Distingue l’errore dell’attività dal codice che riceve il risultato; getCause() consente di esaminare la causa sottostante.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

try { task.get(); } catch (ExecutionException e) { Throwable cause = e.getCause(); }

ExecutionException, nel package java.util.concurrent, estende Exception ed è un’eccezione controllata: deve essere gestita oppure dichiarata con throws. Quando si recupera un risultato tramite Future.get(), segnala che il calcolo è terminato con un’eccezione invece che con un risultato corretto.

Chiama getCause() per esaminare la causa; non cercare di identificarla analizzando il testo di getMessage(). I costruttori pubblici sono ExecutionException(Throwable cause) e ExecutionException(String message, Throwable cause). Un’istanza creata manualmente può avere una causa null, quindi il codice di uso generale dovrebbe tenerne conto.

Distingui l’errore dell’attività dagli altri esiti di Future.get(): InterruptedException significa che il thread chiamante è stato interrotto durante l’attesa, mentre CancellationException significa che l’attività è stata annullata. Anche la versione con timeout può lanciare TimeoutException; il semplice scadere del timeout non significa che l’attività sia fallita o sia stata annullata.

Nell’esempio, FutureTask.run() esegue l’attività nel thread corrente e ne registra l’errore. Solo task.get() lancia ExecutionException, la cui causa è IllegalArgumentException. Non servono altri thread né attese aggiuntive. L’esempio stampa il tipo e il messaggio della causa; nel codice di produzione, conserva la catena delle cause quando propaghi l’errore.

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 IllegalArgumentException("invalid input");
        });
        task.run();

        try {
            task.get();
        } catch (ExecutionException e) {
            Throwable cause = e.getCause();
            System.out.println(e.getClass().getSimpleName());
            System.out.println(cause.getClass().getSimpleName() + ": " + cause.getMessage());
        }
    }
}

Risultato

ExecutionException
IllegalArgumentException: invalid input

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