CKTIS / Java
Throwable.getMessage() : lire le message détaillé d’une exception
Lisez le message d’une exception précise, gérez son absence et distinguez l’exception principale de ses causes et des exceptions supprimées.
Version : Java SE 21
Syntaxe
public String getMessage()Throwable.getMessage() est une méthode d’instance sans paramètre. L’appel e.getMessage() renvoie le message détaillé de l’objet e sous forme de String, ou null. null n’est pas la chaîne vide "". Vérifiez le résultat avant de l’utiliser comme chaîne. Si la référence e elle-même vaut null, l’appel lève une NullPointerException.
new NullPointerException("name").getMessage() renvoie "name". Sans message explicite non nul, le résultat peut dépendre de l’implémentation ou valoir null. Java SE 21 ne garantit ni le libellé exact ni la présence d’un nom de variable. Une IllegalArgumentException interceptée hérite de getMessage() et peut ainsi renvoyer le texte fourni à son constructeur.
getCause() renvoie l’objet représentant la cause, ou null si la cause est absente ou inconnue. Pour une chaîne sans cycle, suivez les appels à getCause() jusqu’à null et appelez getMessage() sur chaque cause. IllegalArgumentException(String, Throwable) n’ajoute pas le message de la cause au texte fourni. La surcharge IllegalArgumentException(Throwable) construit son message à partir de cause.toString(), ou utilise null si la cause vaut null.
Si le corps d’une instruction try-with-resources et close() lèvent des exceptions distinctes, celle du corps reste l’exception principale. Si la suppression est activée, l’exception de fermeture figure dans le tableau renvoyé par getSuppressed(), pas dans la chaîne des causes. Lisez le message de chaque élément séparément. Le tableau est vide si aucune exception n’a été supprimée ou si la suppression est désactivée.
getMessage() ne renvoie pas de trace de pile et n’ajoute pas automatiquement le nom de la classe. Par défaut, getLocalizedMessage() renvoie le même résultat que getMessage(), mais une sous-classe peut la redéfinir. Le texte sert au diagnostic, pas de code d’erreur : ne vous en servez pas pour décider du déroulement du programme et ne montrez pas de messages internes non vérifiés aux utilisateurs.
Exemples
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));
}
}
Résultat
Caught: primary Cause: name Suppressed: close fail No message: (absent)
La sortie distingue le message de l’`IllegalArgumentException` interceptée (`primary`), celui de sa cause (`name`) et celui de l’exception supprimée provenant de `close()` (`close fail`). Sur la dernière ligne, le programme remplace `null` par `(absent)`.
Leçons associées
- Java · Leçon 28 · Intermédiaire · Version : 2
- Java · Leçon 29 · Intermédiaire · Version : 2
- Java · Leçon 30 · Intermédiaire · Version : 2
- Java · Leçon 31 · Intermédiaire · Version : 2