Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Throwable.getMessage() — odczyt komunikatu wyjątku

Metoda `getMessage()` zwraca komunikat opisujący wyjątek lub `null`, gdy komunikatu nie ma. Samo wywołanie niczego nie wypisuje.

Wersja: Java SE 21

Składnia

public String getMessage()

Throwable.getMessage to nazwa metody zadeklarowanej w klasie java.lang.Throwable, a zapis Throwable.getMessage() podkreśla, że metoda nie przyjmuje argumentów. To metoda instancyjna, nie statyczna: wywołaj ją na obiekcie, np. e.getMessage() w bloku catch.

Metoda zwraca komunikat danego obiektu jako String. W przykładzie IllegalArgumentException(String) ustawia komunikat, a konstruktor bez argumentów tworzy wyjątek bez komunikatu, więc getMessage() zwraca null. Wartość null to nie pusty napis ""; jeśli potrzebujesz tekstu, sprawdź wynik i w razie null użyj komunikatu zastępczego.

getMessage() niczego nie wypisuje i nie zwraca ani obiektu przyczyny, ani śladu stosu. getCause() zwraca przyczynę lub null, a printStackTrace() wypisuje ślad stosu, domyślnie na standardowe wyjście błędów. Domyślnie getLocalizedMessage() zwraca to samo co getMessage(), ale podklasa może nadpisać tę metodę, aby zwracała komunikat zależny od ustawień regionalnych.

Traktuj komunikat jako tekst diagnostyczny, a nie stabilny kod błędu. W logice programu korzystaj z typów wyjątków lub udokumentowanych kodów błędów zamiast analizować treść komunikatu. Nie pokazuj użytkownikom surowych komunikatów, jeśli mogą ujawniać poufne informacje.

Przykłady

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

Wynik

Validation failed.
No detail message.

Pierwszy wiersz pochodzi z komunikatu przekazanego konstruktorowi przechwyconego wyjątku. Drugi to tekst zastępczy: konstruktor bez argumentów nie ustawia komunikatu, więc `getMessage()` zwraca `null`.

Powiązane lekcje

  • Java · Lekcja 50 · Podstawowy · Wersja: 2
  • Java · Lekcja 51 · Podstawowy · Wersja: 2
  • Java · Lekcja 52 · Podstawowy · Wersja: 2
  • Java · Lekcja 53 · Podstawowy · Wersja: 2
  • Java · Lekcja 50 · Średniozaawansowany · Wersja: 2

Źródła