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