CKTIS / Java
Throwable.getSuppressed() — exceções suprimidas
Chama `getSuppressed()` na exceção principal para consultar as exceções associadas, como uma falha ao fechar um recurso depois de uma falha no bloco `try`.
Versão: Java SE 21
Sintaxe
public final Throwable[] getSuppressed()getSuppressed() é um método de instância sem argumentos de java.lang.Throwable. Devolve um vetor Throwable[] com as exceções suprimidas associadas diretamente ao objeto sobre o qual é chamado. Se não houver nenhuma ou se a supressão estiver desativada para esse objeto, devolve um vetor vazio, não null. Alterar o vetor devolvido não altera a lista guardada.
Se o bloco try lançar uma exceção e a chamada automática a close() lançar outra, o try com recursos propaga a exceção do bloco e, se a supressão estiver ativada, associa-lhe a exceção de close(). Chama getSuppressed() na exceção principal capturada, não na exceção de close(): esta não se suprime a si própria.
Se o bloco terminar normalmente e apenas um fecho lançar uma exceção, essa exceção é propagada como principal. Os recursos são fechados pela ordem inversa à da inicialização. Se vários fechos lançarem exceções distintas após o fim normal do bloco, a primeira pela ordem de fecho é a principal e as restantes são-lhe associadas se a supressão estiver ativada.
getCause() devolve a causa da exceção (ou null), não um vetor de falhas adicionais. O mesmo objeto pode ter tanto uma causa como exceções suprimidas.
Exemplos
public class Main {
public static void main(String[] args) {
try (AutoCloseable resource = () -> {
throw new IllegalStateException("close failed");
}) {
throw new IllegalStateException("body failed");
} catch (Exception primary) {
System.out.println("Primary: " + primary.getMessage());
Throwable[] suppressed = primary.getSuppressed();
System.out.println("Suppressed count: " + suppressed.length);
for (Throwable secondary : suppressed) {
System.out.println("Suppressed: " + secondary.getMessage());
System.out.println("Its suppressed count: " + secondary.getSuppressed().length);
}
}
}
}Resultado
Primary: body failed Suppressed count: 1 Suppressed: close failed Its suppressed count: 0
As três primeiras linhas mostram a exceção principal e uma exceção de `close()` que lhe está associada. A última linha mostra que, neste exemplo, a exceção de `close()` não tem exceções suprimidas próprias.
Lições relacionadas
- Java · Lição 31 · Intermédio · Versão: 2