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

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

Fontes