Object.toString(): примеры (JAVA)

Короткие примеры использования

Пример с реализацией по умолчанию в Object:

public class MainDefault {
    public static void main(String[] args) {
        Object o = new Object();
        System.out.println(o.toString());
    }
}

java.lang.Object@15db9742

Переопределение в пользовательском классе:

class Person {
    private final String name;
    private final int age;
    Person(String name, int age) { this.name = name; this.age = age; }
    @Override
    public String toString() {
        return name + " (" + age + ")";
    }
}

public class MainPerson {
    public static void main(String[] args) {
        Person p = new Person("Иван", 30);
        System.out.println(p.toString());
    }
}

Иван (30)

Использование вспомогательных утилит:

import java.util.Objects;

public class MainObjects {
    public static void main(String[] args) {
        Object n = null;
        System.out.println(String.valueOf(n));
        System.out.println(Objects.toString(n, ""));
    }
}

null
<null>

Автоматически сгенерированное toString для record (Java 16+):

record Point(int x, int y) {}

public class MainRecord {
    public static void main(String[] args) {
        Point p = new Point(1, 2);
        System.out.println(p.toString());
    }
}

Point[x=1, y=2]

Похожие средства в Java

Внутри самой экосистемы Java применяются несколько альтернатив и вспомогательных средств:

• String.valueOf(Object) - безопасный способ получить строку: возвращает "null" для null вместо выброса исключения.
• Objects.toString(Object, String) - позволяет задать значение по умолчанию при null.
• Arrays.toString(...) и Arrays.deepToString(...) - специализированные представления для массивов; рекомендуется вместо переопределения toString для массивов.
• Enum.toString() - по умолчанию возвращает имя константы, можно переопределить для другого поведения.
• Apache Commons Lang ToStringBuilder и Google Guava MoreObjects.toStringHelper - утилиты для создания стандартных удобочитаемых форматов; полезны при большом числе полей.
• Lombok (@ToString) - генерация метода во время компиляции; удобно для коротких DTO.

Выбор между ними зависит от требований: для простых классов достаточно собственных реализаций, для многочисленных полей и стандартных форматов предпочтительны библиотеки-утилиты, а для безопасного обращения с null удобны String.valueOf и Objects.toString.

Аналоги в других языках

Краткие соответствия и отличия по языкам:

• PHP: магический метод __toString(). Вызывается при касте в строку. Не допускается бросать произвольные исключения в старых версиях PHP.

class Person {
    private $name;
    function __construct($name) { $this->name = $name; }
    public function __toString() { return $this->name; }
}
echo new Person('Анна');

Анна

• JavaScript: метод toString() у объектов и у прототипов. Для примитивов реализация встроена. В отличие от Java, toString может возвращать различные типы, но обычно строку.

const obj = { a: 1, toString() { return `Obj(${this.a})`; } };
console.log(String(obj));

Obj(1)

• Python: специальные методы __str__ и __repr__. __str__ отвечает за читаемое представление, __repr__ - за точное или отладочное. Поведение отличает два уровня представления, в Java обычно используется один метод.

class Person:
    def __init__(self, name):
        self.name = name
    def __str__(self):
        return f"{self.name}"
print(str(Person('Олег')))

Олег

• C#: метод ToString() у System.Object. По умолчанию возвращает полное имя типа. Подобно Java, рекомендуется переопределять при необходимости.

class Person { public string Name; public override string ToString() => Name; }
Console.WriteLine(new Person { Name = "Маша" }.ToString());

Маша

• Go: интерфейс String() string (fmt.Stringer). Если тип реализует метод String(), fmt пакеты используют его для форматирования.

package main
import "fmt"

type Person struct{ Name string }
func (p Person) String() string { return p.Name }
func main() { fmt.Println(Person{"Ира"}) }

Ира

• Kotlin: метод toString() от Any. Для data-классов генерируется реализация автоматически с перечислением полей.

data class Point(val x: Int, val y: Int)
fun main() { println(Point(1,2).toString()) }

Point(x=1, y=2)

• Lua: глобальная функция tostring(), для пользовательских таблиц можно установить метаметод __tostring в метатаблице.

local t = setmetatable({}, { __tostring = function() return "tbl" end })
print(tostring(t))

tbl

• SQL: концептуально не применимо как метод на объекте; преобразование в строку делается функциями CAST/CONVERT в зависимости от СУБД.

В отличие от Java, многие языки разделяют уровень представлений (читаемое vs отладочное) или имеют встроенные интерфейсы/магические методы с иными ограничениями на поведение и ошибки.

Типичные ошибки и примеры

Распространённые проблемы при реализации или использовании toString():

• Вызов obj.toString() для null приводит к NullPointerException.
• Переопределение, возвращающее null, может привести к неожиданному поведению в библиотечном коде.
• Рекурсивный вывод составных структур без защиты от циклов вызывает StackOverflowError.
• Тяжелые вычисления или побочные эффекты в toString() замедляют логирование и могут влиять на состояние программы.
• Переопределение без аннотации @Override приводит к ошибкам, если сигнатура написана неправильно.

Пример NPE:

public class NullCall {
    public static void main(String[] args) {
        Object o = null;
        System.out.println(o.toString()); // NPE
    }
}

Exception in thread "main" java.lang.NullPointerException
    at NullCall.main(NullCall.java:4)

Пример рекурсии и StackOverflow:

class Node {
    Node next;
    @Override
    public String toString() {
        return "Node->" + next.toString();
    }
}

public class Main {
    public static void main(String[] args) {
        Node a = new Node();
        Node b = new Node();
        a.next = b; b.next = a; // цикл
        System.out.println(a.toString());
    }
}

Exception in thread "main" java.lang.StackOverflowError
    at Node.toString(Node.java:3)
    ...

Пример возвращения null в переопределении:

class Bad {
    @Override
    public String toString() { return null; }
}
public class TestBad {
    public static void main(String[] args) {
        Bad b = new Bad();
        System.out.println("X" + b); // конкатенация
    }
}

Xnull

Изменения в последних версиях Java

Сам метод Object.toString() в базовой библиотеке не претерпел изменений по сигнатуре. Основные заметные изменения косвенно связаны с генерацией методов:

• Запись record (Java 14–16) добавила автоматическую генерацию удобного строкового представления для record-классов.
• Класс Objects (доступен с Java 7) предоставляет вспомогательные методы Objects.toString(obj) и Objects.toString(obj, default), расширяя практики безопасного получения строк.
• Библиотеки и инструменты (Lombok, IDE-генераторы, Apache Commons) продолжают эволюционировать, упрощая создание реализаций toString().

Сигнатура и контракт метода остались прежними, изменения касаются больше автоматизации и вспомогательных средств.

Расширенные и редко используемые примеры

Рефлексивный toString для всех полей (упрощённый пример):

import java.lang.reflect.Field;

class ReflectiveToString {
    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder(getClass().getSimpleName()).append('{');
        Field[] fields = getClass().getDeclaredFields();
        for (int i = 0; i < fields.length; i++) {
            fields[i].setAccessible(true);
            try {
                sb.append(fields[i].getName()).append('=')
                  .append(String.valueOf(fields[i].get(this)));
            } catch (IllegalAccessException e) {
                sb.append(fields[i].getName()).append("=?");
            }
            if (i < fields.length - 1) sb.append(", ");
        }
        sb.append('}');
        return sb.toString();
    }
}

class User extends ReflectiveToString { private String name = "Катя"; private int id = 5; }

public class MainReflect {
    public static void main(String[] args) {
        System.out.println(new User());
    }
}

User{name=Катя, id=5}

Защита от циклов при печати графов или списков:

import java.util.IdentityHashMap;
import java.util.Map;

class NodeSafe {
    String name;
    NodeSafe next;
    NodeSafe(String name) { this.name = name; }
    private String toString(Map seen) {
        if (seen.put(this, Boolean.TRUE) != null) return "..."; // цикл
        return name + (next == null ? "" : " -> " + next.toString(seen));
    }
    @Override
    public String toString() { return toString(new IdentityHashMap<>()); }
}

public class MainSafe {
    public static void main(String[] args) {
        NodeSafe a = new NodeSafe("A");
        NodeSafe b = new NodeSafe("B");
        a.next = b; b.next = a;
        System.out.println(a);
    }
}

A -> B -> ...

Использование Apache Commons Lang ToStringBuilder для консистентного формата:

// Требуется зависимость commons-lang3
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;

class Product {
    String id; double price;
    Product(String id, double price) { this.id = id; this.price = price; }
    @Override
    public String toString() {
        return new ToStringBuilder(this, ToStringStyle.SHORT_PREFIX_STYLE)
            .append("id", id)
            .append("price", price)
            .toString();
    }
}

public class MainCommons {
    public static void main(String[] args) {
        System.out.println(new Product("p1", 12.5));
    }
}

Product[id=p1,price=12.5]

Ленивая генерация строки для тяжёлых объектов (кеширование):

class Heavy {
    private String cached;
    @Override
    public String toString() {
        if (cached == null) {
            // имитация дорогой операции
            cached = "computed:" + System.currentTimeMillis();
        }
        return cached;
    }
}

public class MainHeavy {
    public static void main(String[] args) {
        Heavy h = new Heavy();
        System.out.println(h);
        System.out.println(h);
    }
}

computed:1616161616161
computed:1616161616161

Подводя итог, расширенные реализации ориентированы на безопасность при циклах, консистентность форматов и минимизацию затрат при частом вызове.