CKTIS / Java
Throwable.getCause(): causa de uma exceção
`getCause()` devolve a causa direta de uma exceção ou `null`. Usa este método numa `ExecutionException` para inspecionar a exceção lançada pela tarefa.
Versão: Java SE 21
Sintaxe
public Throwable getCause()Throwable.getCause() é um método de instância sem argumentos de java.lang.Throwable. Devolve a causa direta como Throwable, ou null se a causa não existir ou for desconhecida. A implementação predefinida lê a causa passada ao construtor ou definida através de initCause(Throwable).
Uma chamada avança apenas um elo na cadeia de causas, sem chegar necessariamente à causa original. getMessage() devolve a mensagem de detalhe do objeto atual, enquanto getSuppressed() fornece uma lista separada de exceções suprimidas. Antes de usares a causa, verifica se não é null; antes de converteres o tipo, verifica-o com instanceof.
Se uma tarefa falhar ao lançar uma exceção, Future.get() lança uma ExecutionException. No bloco catch, usa getCause() para inspecionar a exceção da tarefa. O cancelamento da tarefa (CancellationException) e a interrupção durante a espera (InterruptedException) são casos distintos.
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 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());
}
}
}
}
Resultado
ExecutionException IllegalStateException Missing input
`run()` executa a tarefa na thread atual. A chamada seguinte a `get()` lança uma `ExecutionException`; o programa apresenta o tipo da exceção que contém a causa, o tipo da causa e a respetiva mensagem.
Lições relacionadas
- Java · Lição 50 · Intermédio · Versão: 2