CKTIS / Java
Throwable.getMessage(): leggere il messaggio di dettaglio di un’eccezione
Leggi il messaggio di una specifica eccezione, gestiscine l’assenza e distingui l’eccezione principale dalle sue cause e dalle eccezioni soppresse.
Versione: Java SE 21
Sintassi
public String getMessage()Throwable.getMessage() è un metodo di istanza senza parametri. La chiamata e.getMessage() restituisce il messaggio di dettaglio dell’oggetto e come String, oppure null. null non è la stringa vuota "". Controlla il risultato prima di usarlo come stringa. Se è il riferimento e a essere null, la chiamata lancia una NullPointerException.
new NullPointerException("name").getMessage() restituisce "name". Senza un messaggio esplicito diverso da null, il risultato può dipendere dall’implementazione o essere null. Java SE 21 non garantisce né un testo preciso né la presenza del nome di una variabile. Un’IllegalArgumentException intercettata eredita getMessage() e può così restituire il testo passato al suo costruttore.
getCause() restituisce l’oggetto che rappresenta la causa, oppure null se la causa è assente o sconosciuta. In una catena senza cicli, segui le cause con getCause() fino a ottenere null e chiama getMessage() su ciascuna causa. IllegalArgumentException(String, Throwable) non aggiunge il messaggio della causa al testo fornito. L’overload IllegalArgumentException(Throwable) ricava il proprio messaggio da cause.toString() oppure usa null se la causa è null.
Se il corpo di un’istruzione try-with-resources e close() lanciano eccezioni distinte, quella del corpo resta l’eccezione principale. Se la soppressione è abilitata, l’eccezione di chiusura finisce nell’array restituito da getSuppressed(), non nella catena delle cause. Leggi il messaggio di ogni elemento separatamente. L’array è vuoto se non è stata soppressa alcuna eccezione o se la soppressione è disabilitata.
getMessage() non restituisce una traccia dello stack e non aggiunge automaticamente il nome della classe. Per impostazione predefinita, getLocalizedMessage() restituisce lo stesso risultato di getMessage(), ma una sottoclasse può ridefinirlo. Usa il testo come informazione diagnostica, non come codice di errore: non basare su di esso il flusso del programma e non mostrare agli utenti messaggi interni non controllati.
Esempi
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));
}
}
Risultato
Caught: primary Cause: name Suppressed: close fail No message: (absent)
L’output distingue il messaggio dell’`IllegalArgumentException` intercettata (`primary`), quello della sua causa (`name`) e quello dell’eccezione soppressa di `close()` (`close fail`). Nell’ultima riga il programma sostituisce `null` con `(absent)`.
Lezioni correlate
- Java · Lezione 28 · Intermedio · Versione: 2
- Java · Lezione 29 · Intermedio · Versione: 2
- Java · Lezione 30 · Intermedio · Versione: 2
- Java · Lezione 31 · Intermedio · Versione: 2