CKTIS / Java
Throwable.getMessage() — získání zprávy výjimky
`getMessage()` vrací podrobnou zprávu výjimky, nebo `null`, pokud výjimka žádnou zprávu nemá. Samotné volání metody nic nevypisuje.
Verze: Java SE 21
Syntaxe
public String getMessage()Throwable.getMessage označuje metodu deklarovanou v třídě java.lang.Throwable. Závorky v zápisu Throwable.getMessage() ukazují, že metoda nepřijímá žádné argumenty. Jde o instanční, nikoli statickou metodu: volej ji na objektu, například jako e.getMessage() v bloku catch.
Metoda vrací podrobnou zprávu samotného objektu jako String. V příkladu IllegalArgumentException(String) nastaví zprávu, zatímco konstruktor bez argumentů vytvoří výjimku bez zprávy, takže getMessage() vrátí null. Hodnota null není prázdný řetězec "". Pokud potřebuješ text, zkontroluj výsledek a při hodnotě null použij náhradní zprávu.
getMessage() nic nevypisuje a nevrací ani objekt představující příčinu, ani výpis zásobníku volání. getCause() vrací příčinu nebo null, zatímco printStackTrace() vypisuje zásobník volání, ve výchozím nastavení na standardní chybový výstup. getLocalizedMessage() standardně vrací stejný výsledek jako getMessage(), ale podtřída ji může přepsat, aby vracela text odpovídající jazykovému a regionálnímu nastavení.
Zprávu ber jako diagnostický text, ne jako stabilní chybový kód. V logice programu používej typy výjimek nebo dokumentované chybové kódy, místo abys rozebíral znění zprávy. Nezobrazuj uživatelům neupravené zprávy, pokud by mohly prozradit citlivé informace.
Příklady
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;
}
}Výsledek
Validation failed. No detail message.
První řádek pochází ze zprávy předané konstruktoru zachycené výjimky. Druhý je náhradní text: konstruktor bez argumentů zprávu nenastaví, takže `getMessage()` vrátí `null`.
Související lekce
- Java · Lekce 50 · Základní · Verze: 2
- Java · Lekce 51 · Základní · Verze: 2
- Java · Lekce 52 · Základní · Verze: 2
- Java · Lekce 53 · Základní · Verze: 2
- Java · Lekce 50 · Středně pokročilá · Verze: 2