Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Throwable.getMessage(): čítanie podrobnej správy výnimky

Prečítaj správu konkrétnej výnimky, ošetri chýbajúci text a rozlišuj hlavnú výnimku, jej príčiny a potlačené výnimky.

Verzia: Java SE 21

Syntax

public String getMessage()

Throwable.getMessage() je inštančná metóda bez parametrov. Volanie e.getMessage() vráti podrobnú správu objektu e ako String alebo vráti null. null nie je prázdny reťazec "". Pred použitím výsledku ako reťazca ho skontroluj. Ak je samotná referencia e rovná null, volanie vyvolá výnimku NullPointerException.

new NullPointerException("name").getMessage() vráti "name". Bez výslovne zadanej správy odlišnej od null môže výsledok závisieť od implementácie alebo byť null. Java SE 21 nezaručuje presné znenie ani to, že sa v správe objaví názov premennej. Zachytená výnimka IllegalArgumentException dedí getMessage() a môže tak vrátiť text odovzdaný konštruktoru.

getCause() vráti objekt predstavujúci príčinu alebo null, ak príčina neexistuje alebo nie je známa. V reťazci bez cyklov postupuj pomocou getCause() až po null a pre každú príčinu zavolaj getMessage(). IllegalArgumentException(String, Throwable) k zadanému textu nepripája správu príčiny. Preťažený konštruktor IllegalArgumentException(Throwable) odvodí správu z cause.toString() alebo použije null, ak je príčina null.

Ak telo príkazu try-with-resources aj metóda close() vyvolajú rôzne výnimky, hlavnou zostáva výnimka z tela. Ak je potláčanie povolené, výnimka zo zatvárania sa objaví v poli vrátenom metódou getSuppressed(), nie v reťazci príčin. Správu každého prvku prečítaj samostatne. Pole je prázdne, ak nebola potlačená žiadna výnimka alebo je potláčanie vypnuté.

getMessage() nevracia výpis zásobníka volaní ani automaticky nepridáva názov triedy. Predvolená implementácia getLocalizedMessage() vracia to isté ako getMessage(), ale podtrieda môže metódu prepísať. Text používaj na diagnostiku, nie ako chybový kód: neriadi ním tok programu a nezobrazuj používateľom neskontrolované interné správy.

Prí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ýsledok

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

Výstup odlišuje správu zachytenej výnimky `IllegalArgumentException` (`primary`), správu jej príčiny (`name`) a správu potlačenej výnimky z `close()` (`close fail`). Na poslednom riadku program nahradí `null` textom `(absent)`.

Súvisiace lekcie

  • Java · Lekcia 28 · Stredne pokročilá · Verzia: 2
  • Java · Lekcia 29 · Stredne pokročilá · Verzia: 2
  • Java · Lekcia 30 · Stredne pokročilá · Verzia: 2
  • Java · Lekcia 31 · Stredne pokročilá · Verzia: 2

Zdroje