Hibernate Annotation 使用經驗總結與入門指南

從 XML 到註解的演進

早期 Hibernate 依賴外部 XML 映射文件（.hbm.xml）定義資料庫映射，啟動時載入。雖可透過工具自動生成，但專案增長會產生大量映射文件，維護成本高。Hibernate 3.2 引入基於 Java 5 註解的新機制，將映射元數據直接內嵌於實體類中，簡化配置，並獲得 IDE 自動完成與語法高亮支援。

核心優勢

• 配置集中化：映射與實體類同在一處，減少文件切換。
• 類型安全：編譯期檢查屬性名稱、類型，減少運行時錯誤。
• 支援 EJB 3 / JPA 標準：可無縫切換至標準持久化 API，同時保留 Hibernate 擴展功能。

環境需求與依賴

• JDK 5.0+
• Hibernate 3.2+
• Hibernate Annotations 庫（hibernate-annotations.jar）
• Java Persistence API（ejb3-persistence.jar 或 persistence-api.jar）

Maven 依賴配置範例

<dependency>
  <groupId>org.hibernate</groupId>
  <artifactId>hibernate</artifactId>
  <version>3.2.1.ga</version>
</dependency>
<dependency>
  <groupId>org.hibernate</groupId>
  <artifactId>hibernate-annotations</artifactId>
  <version>3.2.0.ga</version>
</dependency>
<dependency>
  <groupId>javax.persistence</groupId>
  <artifactId>persistence-api</artifactId>
  <version>1.0</version>
</dependency>

後續發展

隨著 JPA 2.0/2.1 普及，現代專案多直接使用 javax.persistence 標準註解（@Entity, @Table, @Column 等），Hibernate 專有註解（@org.hibernate.annotations.*）僅在需進階功能時使用。