CKTIS / Java
Throwable.getMessage() — čitanje poruke iznimke
`getMessage()` vraća detaljnu poruku iznimke ili `null` ako iznimka nema poruku. Sam poziv metode ne ispisuje ništa.
Verzija: Java SE 21
Sintaksa
public String getMessage()Throwable.getMessage označava metodu deklariranu u klasi java.lang.Throwable. Zagrade u zapisu Throwable.getMessage() pokazuju da metoda ne prima argumente. To je metoda instance, a ne statička metoda: pozovi je na objektu, primjerice izrazom e.getMessage() unutar bloka catch.
Metoda vraća detaljnu poruku samog objekta kao String. U primjeru IllegalArgumentException(String) postavlja poruku, a konstruktor bez argumenata stvara iznimku bez poruke, pa getMessage() vraća null. Vrijednost null nije prazan znakovni niz "". Ako ti treba tekst, provjeri rezultat i upotrijebi zamjensku poruku kada je rezultat null.
getMessage() ništa ne ispisuje i ne vraća ni objekt koji predstavlja uzrok ni trag stoga poziva. getCause() vraća uzrok ili null, dok printStackTrace() ispisuje trag stoga poziva, prema zadanim postavkama na standardni izlaz za pogreške. getLocalizedMessage() prema zadanim postavkama vraća isti rezultat kao getMessage(), no potklasa je može redefinirati kako bi vratila tekst prilagođen jezičnim i regionalnim postavkama.
Poruku smatraj dijagnostičkim tekstom, a ne stabilnim kodom pogreške. U programskoj logici koristi tipove iznimki ili dokumentirane kodove pogrešaka umjesto analiziranja teksta poruke. Nemoj korisnicima prikazivati neobrađene poruke ako bi mogle otkriti osjetljive podatke.
Primjeri
public class Main {
public static void main(String[] args) {
try {
throw new IllegalArgumentException("Validation failed.");
} catch (IllegalArgumentException e) {
System.out.println(messageOrFallback(e));
}
System.out.println(messageOrFallback(new IllegalArgumentException()));
}
private static String messageOrFallback(Throwable error) {
String message = error.getMessage();
return message == null ? "No detail message." : message;
}
}Rezultat
Validation failed. No detail message.
Prvi redak potječe iz poruke proslijeđene konstruktoru uhvaćene iznimke. Drugi je zamjenski tekst: konstruktor bez argumenata ne postavlja poruku, pa `getMessage()` vraća `null`.
Povezane lekcije
- Java · Lekcija 50 · Osnovno · Verzija: 2
- Java · Lekcija 51 · Osnovno · Verzija: 2
- Java · Lekcija 52 · Osnovno · Verzija: 2
- Java · Lekcija 53 · Osnovno · Verzija: 2
- Java · Lekcija 50 · Srednje · Verzija: 2