Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Ridefinire Object.toString()

Assegna a un oggetto una descrizione leggibile e scopri come `println(Object)` la stampa senza chiamare esplicitamente `toString()`.

Versione: Java SE 21

Sintassi

@Override
public String toString() {
    return "Readable object description";
}

Ridefinire Object.toString() permette a una classe di descrivere un’istanza con una stringa breve e leggibile. Dichiara il metodo pubblico di istanza public String toString() senza parametri e restituisci il testo invece di stamparlo. Usa @Override per rilevare gli errori in compilazione: toString(String prefix) è un overload, non un override.

L’implementazione di Object restituisce il nome della classe effettiva dell’oggetto, @ e il risultato di hashCode() in esadecimale senza segno. Non è un indirizzo di memoria né un identificatore univoco.

Se task è dichiarata di tipo Object, System.out.println(task) seleziona println(Object). Questo overload usa String.valueOf(Object), che per un argomento diverso da null chiama l’implementazione di toString() del tipo effettivo dell’oggetto. Se il riferimento è null, println(Object) stampa il testo null, mentre una chiamata diretta a task.toString() genera una NullPointerException.

Restituisci una stringa diversa da null che includa solo campi utili e non sensibili. Non modificare lo stato dell’oggetto e non esporre password o token: la descrizione potrebbe finire nei log. Non usarla come formato stabile per analizzare o memorizzare dati.

Esempi

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

Risultato

Task{title='Review notes', done=false}
Task{title='Review notes', done=false}
null

Le prime due righe coincidono: la chiamata diretta e `println(Object)` usano entrambe l’implementazione di `Task`. La terza mostra come viene gestito `null` senza chiamare `toString()`.

Lezioni correlate

  • Java · Lezione 26 · Intermedio · Versione: 2
  • Java · Lezione 27 · Intermedio · Versione: 2
  • Java · Lezione 32 · Intermedio · Versione: 2

Fonti