CKTIS / Java
Redéfinir Object.toString()
Donnez à un objet une description lisible et voyez comment `println(Object)` l’affiche sans appel explicite à `toString()`.
Version : Java SE 21
Syntaxe
@Override
public String toString() {
return "Readable object description";
}Redéfinir Object.toString() permet à une classe de décrire une instance par une chaîne courte et lisible. Déclarez la méthode d’instance publique public String toString(), sans paramètre, et renvoyez le texte au lieu de l’afficher. Utilisez @Override pour détecter les erreurs à la compilation : toString(String prefix) est une surcharge, pas une redéfinition.
L’implémentation de Object renvoie le nom de la classe réelle de l’objet, le caractère @ et le résultat de hashCode() en hexadécimal non signé. Ce n’est ni une adresse mémoire ni un identifiant unique.
Lorsque task est déclaré de type Object, System.out.println(task) sélectionne println(Object). Cette surcharge utilise String.valueOf(Object) qui, pour un argument non nul, appelle l’implémentation de toString() correspondant au type réel de l’objet. Si la référence vaut null, println(Object) affiche le texte null, tandis qu’un appel direct à task.toString() lève une NullPointerException.
Renvoyez une chaîne non nulle qui ne contient que des champs utiles et non sensibles. Ne modifiez pas l’état de l’objet et n’exposez ni mots de passe ni jetons : la description peut se retrouver dans les journaux. Ne comptez pas sur un format stable pour l’analyse ou le stockage des données.
Exemples
public class Main {
private static final class Task {
private final String title;
private final boolean done;
Task(String title, boolean done) {
this.title = title;
this.done = done;
}
@Override
public String toString() {
return "Task{title='" + title + "', done=" + done + "}";
}
}
public static void main(String[] args) {
Object task = new Task("Review notes", false);
System.out.println(task.toString());
System.out.println(task);
Object missing = null;
System.out.println(missing);
}
}Résultat
Task{title='Review notes', done=false}
Task{title='Review notes', done=false}
null
Les deux premières lignes sont identiques : l’appel direct et `println(Object)` utilisent l’implémentation de `Task`. La troisième montre le traitement de `null` sans appel à `toString()`.
Leçons associées
- Java · Leçon 26 · Intermédiaire · Version : 2
- Java · Leçon 27 · Intermédiaire · Version : 2
- Java · Leçon 32 · Intermédiaire · Version : 2