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

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

Fontes