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