Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Throwable.getMessage() — leer el mensaje de una excepción

`getMessage()` devuelve el mensaje detallado de una excepción, o `null` si no hay mensaje. La llamada por sí sola no imprime nada.

Versión: Java SE 21

Sintaxis

public String getMessage()

Throwable.getMessage identifica el método declarado en java.lang.Throwable. Los paréntesis de Throwable.getMessage() indican que no recibe argumentos. Es un método de instancia, no estático: llámalo sobre un objeto, por ejemplo con e.getMessage() en un bloque catch.

El método devuelve el mensaje detallado del propio objeto como String. En el ejemplo, IllegalArgumentException(String) establece el mensaje, mientras que el constructor sin argumentos crea una excepción sin mensaje, por lo que getMessage() devuelve null. El valor null no es la cadena vacía "". Si necesitas texto, comprueba el resultado y usa un mensaje alternativo cuando sea null.

getMessage() no imprime nada ni devuelve el objeto que representa la causa ni la traza de pila. getCause() devuelve la causa o null, mientras que printStackTrace() imprime la traza de pila, por defecto en la salida de error estándar. Por defecto, getLocalizedMessage() devuelve el mismo resultado que getMessage(), pero una subclase puede sobrescribirlo para ofrecer texto adaptado a la configuración regional.

Trata el mensaje como texto de diagnóstico, no como un código de error estable. Para la lógica del programa, usa tipos de excepción o códigos de error documentados en lugar de analizar el texto. No muestres mensajes sin filtrar a los usuarios si pueden revelar información sensible.

Ejemplos

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.

La primera línea procede del mensaje que se pasó al constructor de la excepción capturada. La segunda es el texto alternativo: el constructor sin argumentos no establece ningún mensaje, así que `getMessage()` devuelve `null`.

Lecciones relacionadas

  • Java · Lección 50 · Básico · Versión: 2
  • Java · Lección 51 · Básico · Versión: 2
  • Java · Lección 52 · Básico · Versión: 2
  • Java · Lección 53 · Básico · Versión: 2
  • Java · Lección 50 · Intermedio · Versión: 2

Fuentes