java - 如何在不获取 "SomeType@2f92e0f4"的情况下打印我的 Java 对象？

Question

我有一个类定义如下:

public class Person {
  private String name;

  // constructor and getter/setter omitted
}

我试图打印我类(class)的一个实例:

System.out.println(myPerson);

但我得到以下输出:com.foo.Person@2f92e0f4。

当我尝试打印 Person 对象数组时发生了类似的事情:

Person[] people = //...
System.out.println(people); 

我得到了输出:[Lcom.foo.Person;@28a418fc

这个输出是什么意思？如何更改此输出以使其包含我的人名？以及如何打印我的对象集合？

_{注意:这是关于此主题的规范问答。}

Answer 1

背景

所有 Java 对象都有一个 toString() 方法，当您尝试打印对象时会调用该方法。

System.out.println(myObject);  // invokes myObject.toString()

此方法在 Object 类(所有 Java 对象的父类(super class))中定义。 Object.toString() 方法返回一个看起来相当难看的字符串，由类的名称、一个 @ 符号和十六进制的对象的 hashcode 组成。代码如下:

// Code of Object.toString()
public String toString() {
    return getClass().getName() + "@" + Integer.toHexString(hashCode());
}

因此，com.foo.MyType@2f92e0f4 这样的结果可以解释为:

• com.foo.MyType - 类的名称，即包com.foo中的类是MyType。<
• @ - 将字符串连接在一起
• 2f92e0f4 对象的哈希码。

数组类的名称看起来有些不同，这在 Class.getName() 的 Javadocs 中有很好的解释。例如，[Ljava.lang.String 表示:

• [ - 一维数组(相对于 [[ 或 [[[ 等)
• L - 数组包含一个类或接口(interface)
• java.lang.String - 数组中对象的类型

---

自定义输出

要在调用 System.out.println(myObject) 时打印不同的内容，您必须在自己的类中 override toString() 方法。这是一个简单的例子:

public class Person {

  private String name;
  
  // constructors and other methods omitted
  
  @Override
  public String toString() {
    return name;
  }
}

现在如果我们打印一个Person，我们看到的是他们的名字而不是com.foo.Person@12345678。

请记住，toString() 只是将对象转换为字符串的一种 方式。通常，此输出应以清晰简洁的方式完整描述您的对象。对于我们的 Person 类，一个更好的 toString() 可能是:

@Override
public String toString() {
  return getClass().getSimpleName() + "[name=" + name + "]";
}

将打印的内容，例如 Person[name=Henry]。这对于调试/测试来说是非常有用的数据。

如果您只想专注于对象的一个​​方面或包含大量的格式，您可能会更好地定义一个单独的方法，例如String toElegantReport() {...}.

---

自动生成输出

许多 IDEs 支持基于类中的字段自动生成 toString() 方法。例如，请参阅 Eclipse 和 IntelliJ 的文档。

几个流行的 Java 库也提供此功能。一些例子包括:

• ToStringBuilder 来自 Apache Commons Lang

• MoreObjects.ToStringHelper 来自 Google Guava

• 来自@ToString 的Project Lombok 注释

---

打印对象组

所以你已经为你的类创建了一个不错的 toString()。如果将该类放入数组或集合中会发生什么？

数组

如果你有一个对象数组，你可以调用 Arrays.toString() 来生成数组内容的简单表示。例如，考虑这个 Person 对象数组:

Person[] people = { new Person("Fred"), new Person("Mike") };
System.out.println(Arrays.toString(people));

// Prints: [Fred, Mike]

注意:这是对 Arrays 类中名为 toString() 的 static 方法的调用，这与我们上面讨论的不同。

如果你有一个多维数组，你可以使用Arrays.deepToString()来实现同样的输出。

Collection

大多数集合将基于对每个元素调用 .toString() 生成漂亮的输出。

List<Person> people = new ArrayList<>();
people.add(new Person("Alice"));
people.add(new Person("Bob"));    
System.out.println(people);

// Prints [Alice, Bob]

所以你只需要确保你的列表元素定义了一个很好的 toString() 如上所述。