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

CKTIS / Java

Throwable: mensagem, causa e exceções suprimidas

java.lang.Throwable é a base da hierarquia de exceções e erros. Distingue a mensagem, a causa e as exceções suprimidas.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

String getMessage();
Throwable getCause();
final Throwable[] getSuppressed();

java.lang.Throwable é a classe base de Exception e Error. Os seus objetos representam problemas que podem ser lançados com throw e capturados com catch.

Throwable.getMessage() devolve uma mensagem do tipo String, que pode ser null. Throwable.getCause() devolve a causa como Throwable, ou null se estiver ausente ou for desconhecida. Verifica se não é null antes de chamar métodos sobre a causa.

Throwable.getSuppressed() devolve um Throwable[], vazio se não tiverem sido suprimidas exceções ou se a supressão estiver desativada. A causa explica por que motivo ocorreu uma falha; uma exceção suprimida descreve uma falha separada, como o fecho de um recurso com try-with-resources. Um objeto pode conter ambos os tipos de informação.

Exemplos

public class Main {
    public static void main(String[] args) {
        Throwable cause = new IllegalArgumentException("invalid input");
        Throwable failure = new Exception("operation failed", cause);
        failure.addSuppressed(new Exception("cleanup failed"));

        System.out.println(failure.getMessage());
        System.out.println(failure.getCause().getMessage());
        for (Throwable suppressed : failure.getSuppressed()) {
            System.out.println(suppressed.getMessage());
        }
    }
}

Resultado

operation failed
invalid input
cleanup failed

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes