Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Przesłanianie metody Object.toString()

Zdefiniuj czytelną reprezentację obiektu i zobacz, jak `println(Object)` korzysta z niej bez jawnego wywołania `toString()`.

Wersja: Java SE 21

Składnia

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

Przesłonięcie Object.toString() pozwala klasie opisać instancję krótkim, czytelnym tekstem. Zadeklaruj publiczną metodę instancji public String toString() bez parametrów i zwróć napis zamiast go wypisywać. Adnotacja @Override pozwala kompilatorowi wykryć pomyłkę: toString(String prefix) jest przeciążeniem, a nie przesłonięciem.

Implementacja z Object zwraca nazwę klasy obiektu w czasie wykonania, znak @ i wynik hashCode() zapisany szesnastkowo bez znaku. Nie jest to adres w pamięci ani unikatowy identyfikator.

System.out.println(task) przy zmiennej task typu Object wybiera println(Object). To przeciążenie używa String.valueOf(Object), które dla argumentu innego niż null wywołuje toString() zgodnie z rzeczywistym typem obiektu. Jeśli referencja ma wartość null, println(Object) wypisuje tekst null, a bezpośrednie wywołanie task.toString() zgłasza NullPointerException.

Zwracaj napis inny niż null, który zawiera tylko przydatne, niewrażliwe pola. Nie zmieniaj stanu obiektu i nie ujawniaj haseł ani tokenów: opis może trafić do logów. Nie traktuj go jako stabilnego formatu danych do parsowania lub zapisu.

Przykłady

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

Wynik

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

Pierwsze dwa wiersze są identyczne: wywołanie bezpośrednie i `println(Object)` korzystają z implementacji w `Task`. Trzeci wiersz pokazuje obsługę `null` bez wywołania `toString()`.

Powiązane lekcje

  • Java · Lekcja 26 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 27 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 32 · Średniozaawansowany · Wersja: 2

Źródła