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

CKTIS / Java

Throwable.getCause(): percorrer a cadeia de causas

`Throwable.getCause()` devolve a causa imediata. Chama o método em cada objeto sucessivo para ir da exceção exterior até à última causa disponível.

Versão: Java SE 21

Sintaxe

public Throwable getCause()

Throwable cause = failure.getCause();

for (Throwable current = failure; current != null; current = current.getCause()) {
    // Process current.
}

Throwable.getCause() é um método de instância sem argumentos da classe java.lang.Throwable. Devolve a causa imediata como Throwable, ou null se a causa não existir ou for desconhecida. Ao encapsulares uma exceção noutra, passa a exceção original a um construtor que aceite uma causa para preservar a ligação.

Começa pela exceção exterior. Enquanto current != null, processa o objeto atual e avança com current = current.getCause(). A primeira iteração inclui a própria exceção exterior. O último objeto visitado não é necessariamente a verdadeira origem do problema: null apenas indica que não há mais nenhuma causa disponível.

As exceções suprimidas estão disponíveis separadamente através de getSuppressed(); o ciclo que percorre as causas não as visita. Uma cadeia de causas pode conter um ciclo. Se o teu código tiver de lidar com cadeias arbitrárias, regista os objetos visitados pela identidade das referências, por exemplo com um IdentityHashMap, e para quando encontrares novamente um objeto.

Exemplos

public class CauseChainDemo {
    public static void main(String[] args) {
        Exception input = new Exception("Invalid port");
        Exception config = new Exception("Cannot load configuration", input);
        Exception startup = new Exception("Cannot start application", config);

        for (Throwable current = startup; current != null; current = current.getCause()) {
            System.out.println(current.getMessage());
        }
    }
}

Resultado

Cannot start application
Cannot load configuration
Invalid port

Os construtores ligam três objetos; o programa não os lança. O ciclo imprime as mensagens de `startup`, `config` e `input`, por esta ordem. A causa de `input` é `null`, que termina o ciclo e não é impresso.

Lições relacionadas

  • Java · Lição 30 · Intermédio · Versão: 2

Fontes