Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Throwable.getMessage() — leggere il messaggio di un’eccezione

`getMessage()` restituisce il messaggio di dettaglio di un’eccezione oppure `null` se il messaggio manca. La chiamata non stampa nulla.

Versione: Java SE 21

Sintassi

public String getMessage()

Throwable.getMessage identifica il metodo dichiarato in java.lang.Throwable. Le parentesi di Throwable.getMessage() indicano che il metodo non accetta argomenti. È un metodo di istanza, non statico: chiamalo su un oggetto, per esempio con e.getMessage() in un blocco catch.

Il metodo restituisce il messaggio di dettaglio dell’oggetto come String. Nell’esempio, IllegalArgumentException(String) imposta il messaggio, mentre il costruttore senza argomenti crea un’eccezione senza messaggio, quindi getMessage() restituisce null. Il valore null non è la stringa vuota "". Se ti serve un testo, controlla il risultato e usa un messaggio sostitutivo quando vale null.

getMessage() non stampa nulla e non restituisce né l’oggetto che rappresenta la causa né la traccia dello stack. getCause() restituisce la causa oppure null, mentre printStackTrace() stampa la traccia dello stack, per impostazione predefinita sul flusso di errore standard. Per impostazione predefinita, getLocalizedMessage() restituisce lo stesso risultato di getMessage(), ma una sottoclasse può ridefinirlo per fornire testo adatto alle impostazioni locali.

Considera il messaggio un testo diagnostico, non un codice di errore stabile. Per la logica del programma, usa tipi di eccezione o codici di errore documentati invece di analizzare il testo. Non mostrare agli utenti messaggi non filtrati se potrebbero rivelare informazioni sensibili.

Esempi

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

Risultato

Validation failed.
No detail message.

La prima riga proviene dal messaggio passato al costruttore dell’eccezione intercettata. La seconda è il testo sostitutivo: il costruttore senza argomenti non imposta un messaggio, quindi `getMessage()` restituisce `null`.

Lezioni correlate

  • Java · Lezione 50 · Base · Versione: 2
  • Java · Lezione 51 · Base · Versione: 2
  • Java · Lezione 52 · Base · Versione: 2
  • Java · Lezione 53 · Base · Versione: 2
  • Java · Lezione 50 · Intermedio · Versione: 2

Fonti