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