WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Throwable.getMessage() — die Meldung einer Ausnahme auslesen

`getMessage()` gibt die Detailmeldung einer Ausnahme zurück oder `null`, wenn keine Meldung vorhanden ist. Der Aufruf selbst gibt nichts aus.

Version: Java SE 21

Syntax

public String getMessage()

Throwable.getMessage bezeichnet die in java.lang.Throwable deklarierte Methode. Die Klammern in Throwable.getMessage() zeigen, dass sie keine Argumente erwartet. Sie ist eine Instanzmethode, keine statische Methode: Rufe sie auf einem Objekt auf, etwa mit e.getMessage() in einem catch-Block.

Die Methode liefert die Detailmeldung des Objekts als String. Im Beispiel setzt IllegalArgumentException(String) die Meldung. Der parameterlose Konstruktor erzeugt dagegen eine Ausnahme ohne Meldung, sodass getMessage() den Wert null liefert. null ist nicht die leere Zeichenfolge "". Wenn du Text brauchst, prüfe den Rückgabewert und verwende bei null einen Ersatztext.

getMessage() gibt nichts aus und liefert weder das Ursachenobjekt noch einen Stacktrace. getCause() liefert die Ursache oder null. printStackTrace() gibt den Stacktrace standardmäßig auf der Standardfehlerausgabe aus. getLocalizedMessage() liefert standardmäßig dasselbe Ergebnis wie getMessage(), kann aber in einer Unterklasse überschrieben werden, um sprach- oder regionsspezifischen Text zu liefern.

Behandle die Meldung als Diagnosetext, nicht als stabilen Fehlercode. Verwende für die Programmlogik Ausnahmetypen oder dokumentierte Fehlercodes, statt den Wortlaut auszuwerten. Zeige Benutzern keine unveränderten Meldungen, wenn sie vertrauliche Informationen offenlegen könnten.

Beispiele

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;
    }
}

Ergebnis

Validation failed.
No detail message.

Die erste Zeile stammt aus der Meldung, die dem Konstruktor der abgefangenen Ausnahme übergeben wurde. Die zweite Zeile ist der Ersatztext: Der parameterlose Konstruktor setzt keine Meldung, daher liefert `getMessage()` den Wert `null`.

Zugehörige Lektionen

  • Java · Lektion 50 · Grundlagen · Version: 2
  • Java · Lektion 51 · Grundlagen · Version: 2
  • Java · Lektion 52 · Grundlagen · Version: 2
  • Java · Lektion 53 · Grundlagen · Version: 2
  • Java · Lektion 50 · Mittlere Stufe · Version: 2

Quellen