Object.toString() 是 Java 物件轉字符串的統一協議。本文深度剖析默認實現、重寫規範、StringBuilder 內部調用、日誌框架集成、性能陷阱、Lombok/IDE 自動生成、現代 Record 自動實現。
public String toString() {
return getClass().getName() + "@" + Integer.toHexString(hashCode());
// 例: com.example.User@1a2b3c4d
}
Objects.toString()、String.valueOf()、System.out.println(obj)、log.info("{}", obj) 統一調用List.toString() 依賴元素toString()public class User {
private Long id;
private String name;
private String email;
private LocalDateTime createdAt;
// 手寫標準格式
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", email='" + email + '\'' +
", createdAt=" + createdAt +
'}';
}
}
// 輸出: User{id=1, name='Tom', email='tom@example.com', createdAt=2024-01-15T10:30}
| 工具 | 方式 | 優點 | 缺點 |
|---|---|---|---|
| IDE (IntelliJ/Eclipse) | 右鍵 Generate → toString() | 可選字段、模板自定義、一次性生成 | 字段變更需手動更新 |
Lombok @ToString | 註解自動生成 | 零樣板、字段變更自動同步、支援exclude/of | 需編譯器插件、調試見字節碼 |
Apache Commons Lang ToStringBuilder | 鏈式構建 | 可控格式、支援反射、多風格 | 運行時反射較慢 |
Java 14+ record | 記錄類自動實現 | 標準、不可變、完整包含所有分量 | 僅適用數據載體類 |
@ToString(exclude = {"password", "secretKey"}) // 排除敏感字段
@ToString(of = {"id", "name"}) // 僅包含指定字段
@ToString(callSuper = true) // 包含父類字段
public class User { ... }
// ❌ 字符串拼接 + (循環/高頻) → 大量臨時對象
public String toString() {
return "User{" + "id=" + id + ", name=" + name + "}"; // 每次調用創建多個StringBuilder+String
}
// ✅ StringBuilder 手寫 (編譯器優化後等效)
public String toString() {
StringBuilder sb = new StringBuilder(64); // 預估容量
sb.append("User{id=").append(id)
.append(", name='").append(name).append('\'')
.append("}");
return sb.toString();
}
// ✅ Java 17+ StringBuilder 增強: 虛線模板 (預覽特性)
public String toString() {
return STR."User{id=\{id}, name='\{name}'}"; // 編譯期優化
}
// SLF4J/Log4j2/Logback 佔位符 {} 延遲調用 toString()
log.info("用戶登入: {}", user); // 只有日誌級別啟用時才調用 user.toString()
// 錯誤寫法: 立即拼接字符串 (即使不打印日誌也消耗)
log.info("用戶登入: " + user.toString()); // ❌ 永遠執行 toString()
// 異常堆棧自動包含 toString()
throw new BusinessException("用戶不存在: " + user); // 異常消息含 toString()
String不可變,+拼接產生中間對象StringBuilder非線程安全,**單線程首選**,JIT優化極好StringBuffer線程安全,**同步開銷大**,極少用StringConcatFactory (invokedynamic) 使+拼接性能接近StringBuildertoString()@ToString (Lombok) 或 IDE 生成,字段變更同步更新id/主鍵便於追蹤ClassName{field=value, ...}{},禁止拼接assertThat(user.toString()).contains("id=1")