KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Throwable.getMessage(): de detailmelding van een uitzondering lezen

Lees de melding van een specifieke uitzondering, vang een ontbrekende melding op en onderscheid de primaire uitzondering van oorzaken en onderdrukte uitzonderingen.

Versie: Java SE 21

Syntax

public String getMessage()

Throwable.getMessage() is een instantiemethode zonder parameters. De aanroep e.getMessage() geeft de detailmelding van het object e terug als een String, of geeft null terug. null is niet hetzelfde als de lege tekenreeks "". Controleer het resultaat voordat je het als tekenreeks gebruikt. Als de referentie e zelf null is, veroorzaakt de aanroep een NullPointerException.

new NullPointerException("name").getMessage() geeft "name" terug. Zonder een expliciete melding die niet null is, kan het resultaat afhangen van de implementatie of null zijn. Java SE 21 garandeert geen vaste formulering en ook niet dat er een variabelenaam wordt genoemd. Een opgevangen IllegalArgumentException erft getMessage() en kan zo de tekst teruggeven die aan de constructor is doorgegeven.

getCause() geeft het object terug dat de oorzaak vertegenwoordigt, of null als er geen bekende oorzaak is. Volg in een keten zonder cycli de oorzaken met getCause() totdat je null krijgt en roep getMessage() aan op elke oorzaak. IllegalArgumentException(String, Throwable) voegt de melding van de oorzaak niet toe aan de opgegeven tekst. De overload IllegalArgumentException(Throwable) leidt de melding af uit cause.toString() of gebruikt null als de oorzaak null is.

Als het hoofdblok van een try-with-resources-instructie en close() verschillende uitzonderingen werpen, blijft de uitzondering uit het hoofdblok de primaire uitzondering. Als onderdrukking is ingeschakeld, komt de uitzondering uit close() terecht in de array van getSuppressed(), niet in de keten van oorzaken. Lees de melding van elk element afzonderlijk. De array is leeg als er niets is onderdrukt of onderdrukking is uitgeschakeld.

getMessage() geeft geen stacktrace terug en voegt niet automatisch de klassenaam toe. Standaard geeft getLocalizedMessage() hetzelfde resultaat als getMessage(), maar een subklasse kan die methode overschrijven. Gebruik de tekst voor diagnose, niet als foutcode: laat het programmaverloop er niet van afhangen en toon geen ongecontroleerde interne meldingen aan gebruikers.

Voorbeelden

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

Resultaat

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

De uitvoer toont apart de melding van de opgevangen `IllegalArgumentException` (`primary`), die van de oorzaak (`name`) en die van de onderdrukte uitzondering uit `close()` (`close fail`). Op de laatste regel vervangt het programma `null` door `(absent)`.

Gerelateerde lessen

  • Java · Les 28 · Gemiddeld · Versie: 2
  • Java · Les 29 · Gemiddeld · Versie: 2
  • Java · Les 30 · Gemiddeld · Versie: 2
  • Java · Les 31 · Gemiddeld · Versie: 2

Bronnen