Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Throwable.getMessage(): čitanje detaljne poruke iznimke

Pročitaj poruku određene iznimke, obradi slučaj u kojem poruka nedostaje i razlikuj glavnu iznimku od njezinih uzroka i potisnutih iznimaka.

Verzija: Java SE 21

Sintaksa

public String getMessage()

Throwable.getMessage() je instancijska metoda bez parametara. Poziv e.getMessage() vraća detaljnu poruku objekta e kao String ili vraća null. null nije prazan niz znakova "". Provjeri rezultat prije nego što ga upotrijebiš kao niz znakova. Ako je sama referenca e jednaka null, poziv izaziva NullPointerException.

new NullPointerException("name").getMessage() vraća "name". Bez izričito zadane poruke različite od null rezultat može ovisiti o implementaciji ili biti null. Java SE 21 ne jamči točan tekst ni to da će se u njemu pojaviti naziv varijable. Uhvaćena iznimka IllegalArgumentException nasljeđuje getMessage() i tako može vratiti tekst proslijeđen konstruktoru.

getCause() vraća objekt koji predstavlja uzrok ili null ako uzrok ne postoji ili je nepoznat. U lancu bez ciklusa slijedi uzroke pozivima getCause() sve do vrijednosti null i na svakom uzroku pozovi getMessage(). IllegalArgumentException(String, Throwable) ne dodaje poruku uzroka zadanom tekstu. Preopterećena varijanta IllegalArgumentException(Throwable) izvodi poruku iz cause.toString() ili upotrebljava null ako je uzrok null.

Ako tijelo naredbe try-with-resources i metoda close() bace različite iznimke, iznimka iz tijela ostaje glavna. Ako je potiskivanje omogućeno, iznimka pri zatvaranju nalazi se u polju koje vraća getSuppressed(), a ne u lancu uzroka. Pročitaj poruku svakog elementa zasebno. Polje je prazno ako nijedna iznimka nije potisnuta ili je potiskivanje onemogućeno.

getMessage() ne vraća trag stoga poziva niti automatski dodaje naziv klase. Prema zadanim postavkama getLocalizedMessage() vraća isto što i getMessage(), ali podklasa može redefinirati tu metodu. Tekst služi dijagnostici, a ne kao kod pogreške: nemoj na njemu temeljiti tijek programa niti korisnicima prikazivati neprovjerene interne poruke.

Primjeri

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

Rezultat

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

Ispis razdvaja poruku uhvaćene iznimke `IllegalArgumentException` (`primary`), poruku njezina uzroka (`name`) i poruku potisnute iznimke iz `close()` (`close fail`). U posljednjem retku program zamjenjuje `null` tekstom `(absent)`.

Povezane lekcije

  • Java · Lekcija 28 · Srednje · Verzija: 2
  • Java · Lekcija 29 · Srednje · Verzija: 2
  • Java · Lekcija 30 · Srednje · Verzija: 2
  • Java · Lekcija 31 · Srednje · Verzija: 2

Izvori