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