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

CKTIS / Java

Throwable.getMessage() — ler a mensagem de uma exceção

`getMessage()` devolve a mensagem de detalhe de uma exceção, ou `null` se não houver mensagem. A chamada ao método não escreve nada.

Versão: Java SE 21

Sintaxe

public String getMessage()

Throwable.getMessage identifica o método declarado em java.lang.Throwable. Os parênteses em Throwable.getMessage() indicam que o método não recebe argumentos. É um método de instância, não um método estático: chama-o num objeto, por exemplo com e.getMessage() num bloco catch.

O método devolve a mensagem de detalhe do próprio objeto como String. No exemplo, IllegalArgumentException(String) define a mensagem, ao passo que o construtor sem argumentos cria uma exceção sem mensagem, pelo que getMessage() devolve null. O valor null não é a cadeia vazia "". Se precisares de texto, verifica o resultado e usa uma mensagem alternativa quando for null.

getMessage() não escreve nada nem devolve o objeto que representa a causa ou o rasto da pilha. getCause() devolve a causa ou null, enquanto printStackTrace() escreve o rasto da pilha, por predefinição no fluxo de erro padrão. Por predefinição, getLocalizedMessage() devolve o mesmo resultado que getMessage(), mas uma subclasse pode redefini-lo para fornecer texto adaptado às definições regionais.

Trata a mensagem como texto de diagnóstico, não como um código de erro estável. Na lógica do programa, usa tipos de exceção ou códigos de erro documentados, em vez de analisares o texto da mensagem. Não mostres mensagens sem filtragem aos utilizadores se puderem revelar informação sensível.

Exemplos

public class Main {
    public static void main(String[] args) {
        try {
            throw new IllegalArgumentException("Validation failed.");
        } catch (IllegalArgumentException e) {
            System.out.println(messageOrFallback(e));
        }

        System.out.println(messageOrFallback(new IllegalArgumentException()));
    }

    private static String messageOrFallback(Throwable error) {
        String message = error.getMessage();
        return message == null ? "No detail message." : message;
    }
}

Resultado

Validation failed.
No detail message.

A primeira linha vem da mensagem passada ao construtor da exceção capturada. A segunda é o texto alternativo: o construtor sem argumentos não define uma mensagem, por isso `getMessage()` devolve `null`.

Lições relacionadas

  • Java · Lição 50 · Básico · Versão: 2
  • Java · Lição 51 · Básico · Versão: 2
  • Java · Lição 52 · Básico · Versão: 2
  • Java · Lição 53 · Básico · Versão: 2
  • Java · Lição 50 · Intermédio · Versão: 2

Fontes