WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Object.toString — die textuelle Darstellung eines Objekts

Object.toString gibt die textuelle Darstellung eines Objekts zurück. Durch Überschreiben der Methode lässt sich eine gut lesbare Form bereitstellen, die für Diagnosezwecke nützlich ist.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

public String toString()

Object.toString ist eine öffentliche Instanzmethode ohne Parameter, die einen String zurückgibt. Ihr Ergebnis sollte das Objekt knapp und verständlich beschreiben.

Die Standardimplementierung gibt getClass().getName() + '@' + Integer.toHexString(hashCode()) zurück: den Klassennamen, @ und den Hashcode in Hexadezimaldarstellung. Das ist weder eine garantierte eindeutige Kennung noch eine Speicheradresse.

Überschreibe public String toString() mit der Annotation @Override, um relevante Zustandsdaten zu beschreiben. Im Beispiel verweist eine Variable vom Typ Object auf ein Point-Objekt, daher wird beim Aufruf die Implementierung Point.toString() ausgewählt.

Die Ausgabe muss weder im Zeitverlauf noch zwischen JVM-Läufen stabil bleiben. Verwende sie nicht als dauerhaftes Datenformat und vermeide es, Geheimnisse offenzulegen.

Beispiele

public class Main {
    static final class Point {
        private final int x;
        private final int y;

        Point(int x, int y) {
            this.x = x;
            this.y = y;
        }

        @Override
        public String toString() {
            return "Point[x=" + x + ", y=" + y + "]";
        }
    }

    public static void main(String[] args) {
        Object point = new Point(2, 3);
        System.out.println(point.toString());
    }
}

Ergebnis

Point[x=2, y=3]

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen