CKTIS / Java
Throwable.getMessage() — het bericht van een exceptie uitlezen
`getMessage()` geeft het detailbericht van een exceptie terug, of `null` als er geen bericht is. De methodeaanroep zelf drukt niets af.
Versie: Java SE 21
Syntax
public String getMessage()Throwable.getMessage verwijst naar de methode die is gedeclareerd in java.lang.Throwable. De haakjes in Throwable.getMessage() geven aan dat de methode geen argumenten verwacht. Het is een instantiemethode, geen statische methode: roep haar aan op een object, bijvoorbeeld met e.getMessage() in een catch-blok.
De methode geeft het detailbericht van het object zelf terug als een String. In het voorbeeld stelt IllegalArgumentException(String) het bericht in. De constructor zonder argumenten maakt een exceptie zonder bericht, waardoor getMessage() null teruggeeft. null is niet hetzelfde als de lege tekenreeks "". Als je tekst nodig hebt, controleer dan het resultaat en gebruik een vervangend bericht als het null is.
getMessage() drukt niets af en geeft noch het object dat de oorzaak vertegenwoordigt, noch een stacktrace terug. getCause() geeft de oorzaak of null terug, terwijl printStackTrace() de stacktrace standaard naar de standaardfoutuitvoer schrijft. getLocalizedMessage() geeft standaard hetzelfde resultaat als getMessage(), maar een subklasse kan de methode overschrijven om tekst te geven die is afgestemd op de land- en taalinstellingen.
Behandel het bericht als diagnostische tekst, niet als een stabiele foutcode. Gebruik in de programmalogica exceptietypen of gedocumenteerde foutcodes in plaats van de tekst te ontleden. Toon gebruikers geen ongefilterde berichten als die gevoelige informatie kunnen prijsgeven.
Voorbeelden
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;
}
}Resultaat
Validation failed. No detail message.
De eerste regel komt uit het bericht dat aan de constructor van de opgevangen exceptie is meegegeven. De tweede is de vervangende tekst: de constructor zonder argumenten stelt geen bericht in, dus `getMessage()` geeft `null` terug.
Gerelateerde lessen
- Java · Les 50 · Basis · Versie: 2
- Java · Les 51 · Basis · Versie: 2
- Java · Les 52 · Basis · Versie: 2
- Java · Les 53 · Basis · Versie: 2
- Java · Les 50 · Gemiddeld · Versie: 2