CKTIS / Java
Throwable.getMessage(): leer el mensaje detallado de una excepción
Lee el mensaje de una excepción concreta, gestiona su ausencia y distingue la excepción principal de sus causas y de las excepciones suprimidas.
Versión: Java SE 21
Sintaxis
public String getMessage()Throwable.getMessage() es un método de instancia sin parámetros. La llamada e.getMessage() devuelve el mensaje detallado del objeto e como un String, o null. null no es la cadena vacía "". Comprueba el resultado antes de usarlo como cadena. Si la propia referencia e es null, la llamada lanza una NullPointerException.
new NullPointerException("name").getMessage() devuelve "name". Si no se proporciona un mensaje explícito distinto de null, el resultado puede depender de la implementación o ser null. Java SE 21 no garantiza un texto exacto ni que aparezca el nombre de una variable. Una IllegalArgumentException capturada hereda getMessage() y puede devolver el texto pasado a su constructor.
getCause() devuelve el objeto que representa la causa, o null si no hay causa o esta se desconoce. Si la cadena no tiene ciclos, sigue llamando a getCause() hasta obtener null y llama a getMessage() en cada causa. IllegalArgumentException(String, Throwable) no añade el mensaje de la causa al texto proporcionado. La sobrecarga IllegalArgumentException(Throwable) obtiene su mensaje de cause.toString() o usa null si la causa es null.
Si el cuerpo de una instrucción try-with-resources y close() lanzan excepciones distintas, la del cuerpo sigue siendo la principal. Si la supresión está habilitada, la excepción del cierre se incluye en el array que devuelve getSuppressed(), no en la cadena de causas. Lee el mensaje de cada elemento por separado. El array está vacío si no se suprimió ninguna excepción o si la supresión está deshabilitada.
getMessage() no devuelve una traza de pila ni añade automáticamente el nombre de la clase. Por defecto, getLocalizedMessage() devuelve lo mismo que getMessage(), pero una subclase puede redefinirlo. Usa el texto para el diagnóstico, no como código de error: no bases en él el flujo del programa ni muestres a los usuarios mensajes internos sin revisar.
Ejemplos
public class Main {
static final class Resource implements AutoCloseable {
@Override
public void close() {
throw new IllegalStateException("close fail");
}
}
public static void main(String[] args) {
try (Resource resource = new Resource()) {
throw new IllegalArgumentException("primary", new NullPointerException("name"));
} catch (IllegalArgumentException e) {
System.out.println("Caught: " + e.getMessage());
for (Throwable cause = e.getCause(); cause != null; cause = cause.getCause()) {
System.out.println("Cause: " + cause.getMessage());
}
for (Throwable suppressed : e.getSuppressed()) {
System.out.println("Suppressed: " + suppressed.getMessage());
}
}
String message = new IllegalArgumentException().getMessage();
System.out.println("No message: " + (message == null ? "(absent)" : message));
}
}
Resultado
Caught: primary Cause: name Suppressed: close fail No message: (absent)
La salida separa el mensaje de la `IllegalArgumentException` capturada (`primary`), el de su causa (`name`) y el de la excepción suprimida de `close()` (`close fail`). En la última línea, el programa sustituye `null` por `(absent)`.
Lecciones relacionadas
- Java · Lección 28 · Intermedio · Versión: 2
- Java · Lección 29 · Intermedio · Versión: 2
- Java · Lección 30 · Intermedio · Versión: 2
- Java · Lección 31 · Intermedio · Versión: 2