WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Throwable.getMessage(): die Detailmeldung einer Ausnahme lesen

Lies die Meldung einer bestimmten Ausnahme, behandle fehlenden Text und unterscheide die primäre Ausnahme von ihren Ursachen und unterdrückten Ausnahmen.

Version: Java SE 21

Syntax

public String getMessage()

Throwable.getMessage() ist eine parameterlose Instanzmethode. Der Aufruf e.getMessage() liefert die Detailmeldung des Objekts e als String oder null. null ist nicht die leere Zeichenkette "". Prüfe das Ergebnis, bevor du es als Zeichenkette verwendest. Ist die Referenz e selbst null, löst der Aufruf eine NullPointerException aus.

new NullPointerException("name").getMessage() liefert "name". Ohne eine explizit angegebene Meldung ungleich null kann das Ergebnis von der Implementierung abhängen oder null sein. Java SE 21 garantiert weder einen bestimmten Wortlaut noch die Angabe eines Variablennamens. Eine abgefangene IllegalArgumentException erbt getMessage() und kann damit den an ihren Konstruktor übergebenen Text zurückgeben.

getCause() liefert das Ursachenobjekt oder null, wenn keine Ursache vorhanden oder bekannt ist. Folge bei einer Kette ohne Zyklen den Aufrufen von getCause() bis zu null und rufe für jede Ursache getMessage() auf. IllegalArgumentException(String, Throwable) hängt die Meldung der Ursache nicht an den übergebenen Text an. Die Überladung IllegalArgumentException(Throwable) leitet ihre Meldung aus cause.toString() ab; bei einer Ursache von null lautet sie null.

Lösen der Rumpf einer try-with-resources-Anweisung und close() unterschiedliche Ausnahmen aus, bleibt die Ausnahme aus dem Rumpf die primäre Ausnahme. Ist die Unterdrückung aktiviert, erscheint die Ausnahme aus close() im Array von getSuppressed(), nicht in der Ursachenkette. Lies die Meldung jedes Elements einzeln. Das Array ist leer, wenn nichts unterdrückt wurde oder die Unterdrückung deaktiviert ist.

getMessage() liefert weder einen Stacktrace noch fügt die Methode automatisch den Klassennamen hinzu. Standardmäßig liefert getLocalizedMessage() dasselbe Ergebnis wie getMessage(), kann aber in einer Unterklasse überschrieben werden. Meldungstext dient der Diagnose, nicht als Fehlercode: Steuere damit nicht den Programmablauf und zeige Benutzern keine ungeprüften internen Meldungen.

Beispiele

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

Ergebnis

Caught: primary
Cause: name
Suppressed: close fail
No message: (absent)

Die Ausgabe trennt die Meldung der abgefangenen `IllegalArgumentException` (`primary`), die Meldung ihrer Ursache (`name`) und die der unterdrückten Ausnahme aus `close()` (`close fail`). In der letzten Zeile setzt das Programm `(absent)` anstelle von `null` ein.

Zugehörige Lektionen

  • Java · Lektion 28 · Mittlere Stufe · Version: 2
  • Java · Lektion 29 · Mittlere Stufe · Version: 2
  • Java · Lektion 30 · Mittlere Stufe · Version: 2
  • Java · Lektion 31 · Mittlere Stufe · Version: 2

Quellen