Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

ExecutionException — falha de uma tarefa ao obter um resultado

ExecutionException é uma exceção verificada lançada ao obter o resultado de uma tarefa que terminou com uma exceção. Distingue a falha da tarefa do código que recebe o resultado; getCause() permite inspecionar a causa subjacente.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

ExecutionException, do pacote java.util.concurrent, estende Exception e é uma exceção verificada: tem de ser capturada ou declarada em throws. Ao obter um resultado através de Future.get(), indica que o cálculo terminou com uma exceção, em vez de produzir um resultado bem-sucedido.

Chame getCause() para inspecionar a causa; não tente identificá-la analisando o texto de getMessage(). Os construtores públicos são ExecutionException(Throwable cause) e ExecutionException(String message, Throwable cause). Uma instância criada manualmente pode ter a causa null, pelo que o código de utilização geral deve ter isso em conta.

Distinga a falha da tarefa dos outros resultados de Future.get(): InterruptedException significa que a thread que chamou foi interrompida enquanto aguardava, ao passo que CancellationException significa que a tarefa foi cancelada. A sobrecarga com limite de tempo também pode lançar TimeoutException; o simples fim desse limite não significa que a tarefa tenha falhado ou sido cancelada.

No exemplo, FutureTask.run() executa a tarefa na thread atual e regista a falha. Só task.get() lança ExecutionException, cuja causa é IllegalArgumentException. Não são necessárias outras threads nem esperas adicionais. O exemplo apresenta o tipo e a mensagem da causa; em código de produção, preserve a cadeia de causas ao propagar a falha.

Exemplos

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());
        }
    }
}

Resultado

ExecutionException
IllegalArgumentException: invalid input

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes