Java 實體類創建場景與工具輔助生成指南

何時需要創建實體類

實體類（Entity/POJO/Bean）是業務數據的載體，主要在以下場景創建：

• 數據庫表映射：每張業務表對應一個實體類，字段一一映射（JPA/MyBatis 必需）
• Service 層數據傳輸：封裝業務邏輯所需數據結構，替代散亂的 Map 或多參數
• Controller 接收參數：表單提交、JSON 請求體自動綁定
• 緩存存儲對象：Redis 等緩存中存儲的業務對象
• 異步任務/消息隊列載荷：線程間、服務間傳遞的數據結構

「一表一實體」是否繁瑣？

確實手寫屬性、Getter/Setter、toString 等樣板代碼耗時。但現代開發幾乎不手寫，均使用工具自動生成：

主流生成方式

1. IDE 插件：
   • IntelliJ IDEA：Generate → toString/Getter and Setter；安裝 MyBatisCodeHelperPro、Free MyBatis Plugin 一鍵生成 Entity/Mapper/XML
   • Eclipse：Source → Generate Getters and Setters
2. 官方/社區工具：
   • MyBatis Generator (MBG)：配置 generatorConfig.xml，連接數據庫逆向生成完整代碼
   • Hibernate Tools：支持 JPA 註解生成
3. 在線工具：如 bejson.com、jsontopojo.com 粘貼建表 SQL 或 JSON 即時生成
4. Lombok 註解：引入依賴，類上加 @Data 自動編譯期生成 Getter/Setter/toString/equals/hashCode，極大減少代碼量

最佳實踐建議

@Data
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class User {
    private Long id;
    private String username;
    private String email;
    private LocalDateTime createTime;
}

• 使用 Lombok @Data 替代手寫樣板代碼
• 配合 @Builder 實現鏈式構建，代碼更優雅
• 日期類型優先用 LocalDateTime，避免 Date 線程不安全問題
• 字段命名遵循駝峰規範，數據庫下劃線自動映射（MyBatis 開啟 mapUnderscoreToCamelCase）

總結

實體類創建是常規操作，非繁瑣痛點。善用 IDE 插件、代碼生成器與 Lombok，將精力集中在業務邏輯設計上。