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.