CKTIS / Java
Throwable.getMessage() — lire le message d’une exception
`getMessage()` renvoie le message détaillé d’une exception, ou `null` en l’absence de message. L’appel n’affiche rien par lui-même.
Version : Java SE 21
Syntaxe
public String getMessage()Throwable.getMessage désigne la méthode déclarée dans java.lang.Throwable. Les parenthèses de Throwable.getMessage() indiquent qu’elle ne prend aucun argument. C’est une méthode d’instance, et non une méthode statique : appelez-la sur un objet, par exemple avec e.getMessage() dans un bloc catch.
La méthode renvoie le message détaillé de l’objet sous la forme d’un String. Dans l’exemple, IllegalArgumentException(String) définit le message, tandis que le constructeur sans argument crée une exception sans message : getMessage() renvoie alors null. La valeur null n’est pas la chaîne vide "". Si vous avez besoin d’un texte, vérifiez le résultat et utilisez un message de remplacement s’il vaut null.
getMessage() n’affiche rien et ne renvoie ni l’objet représentant la cause ni la trace de la pile. getCause() renvoie la cause ou null, tandis que printStackTrace() affiche la trace de la pile, par défaut sur la sortie d’erreur standard. Par défaut, getLocalizedMessage() renvoie le même résultat que getMessage(), mais une sous-classe peut la redéfinir pour fournir un texte adapté aux paramètres régionaux.
Traitez le message comme un texte de diagnostic, et non comme un code d’erreur stable. Pour la logique du programme, utilisez les types d’exception ou des codes d’erreur documentés plutôt que d’analyser le libellé. N’affichez pas les messages bruts aux utilisateurs s’ils risquent de révéler des informations sensibles.
Exemples
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;
}
}Résultat
Validation failed. No detail message.
La première ligne correspond au message passé au constructeur de l’exception interceptée. La seconde est le texte de remplacement : le constructeur sans argument ne définit aucun message, donc `getMessage()` renvoie `null`.
Leçons associées
- Java · Leçon 50 · Débutant · Version : 2
- Java · Leçon 51 · Débutant · Version : 2
- Java · Leçon 52 · Débutant · Version : 2
- Java · Leçon 53 · Débutant · Version : 2
- Java · Leçon 50 · Intermédiaire · Version : 2