Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Throwable.getMessage(): čtení podrobné zprávy výjimky

Přečti zprávu konkrétní výjimky, ošetři chybějící text a rozliš hlavní výjimku, její příčiny a potlačené výjimky.

Verze: Java SE 21

Syntaxe

public String getMessage()

Throwable.getMessage() je instanční metoda bez parametrů. Volání e.getMessage() vrací podrobnou zprávu objektu e jako String, nebo null. null není prázdný řetězec "". Než s výsledkem začneš pracovat jako s řetězcem, zkontroluj ho. Pokud má hodnotu null samotná reference e, volání vyvolá NullPointerException.

new NullPointerException("name").getMessage() vrátí "name". Bez výslovně uvedené zprávy jiné než null může výsledek záviset na implementaci nebo být null. Java SE 21 nezaručuje přesné znění ani to, že se ve zprávě objeví název proměnné. Zachycená IllegalArgumentException dědí getMessage() a může tak vrátit text předaný konstruktoru.

getCause() vrací objekt představující příčinu, nebo null, pokud příčina neexistuje nebo není známá. V řetězci bez cyklů postupuj pomocí getCause() až k null a na každé příčině zavolej getMessage(). IllegalArgumentException(String, Throwable) ke zadanému textu nepřipojuje zprávu příčiny. Přetížený konstruktor IllegalArgumentException(Throwable) odvozuje zprávu z cause.toString(), nebo použije null, pokud je příčina null.

Pokud tělo příkazu try-with-resources i metoda close() vyvolají různé výjimky, hlavní zůstává výjimka z těla. Je-li potlačování povoleno, výjimka při zavírání se objeví v poli z getSuppressed(), nikoli v řetězci příčin. Zprávu každého prvku přečti zvlášť. Pole je prázdné, pokud nebyla potlačena žádná výjimka nebo je potlačování vypnuté.

getMessage() nevrací výpis zásobníku volání ani automaticky nepřidává název třídy. Výchozí implementace getLocalizedMessage() vrací totéž co getMessage(), ale podtřída může metodu přepsat. Text používej k diagnostice, ne jako chybový kód: neřiď podle něj logiku programu a nezobrazuj uživatelům nezkontrolované interní zprávy.

Příklady

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

Výsledek

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

Výstup odděluje zprávu zachycené výjimky `IllegalArgumentException` (`primary`), zprávu její příčiny (`name`) a zprávu potlačené výjimky z `close()` (`close fail`). Na posledním řádku program nahradí `null` textem `(absent)`.

Související lekce

  • Java · Lekce 28 · Středně pokročilá · Verze: 2
  • Java · Lekce 29 · Středně pokročilá · Verze: 2
  • Java · Lekce 30 · Středně pokročilá · Verze: 2
  • Java · Lekce 31 · Středně pokročilá · Verze: 2

Zdroje