Eclipse 整合 Hibernate Sync 外掛快速開發 Hibernate 應用程式

前言

Eclipse 以其開放擴充架構深受開發者喜愛，Hibernate 則是 ORM 領域的佼佼者 (EJB 3 普及前更是首選)。本文示範如何在 Eclipse 3.0.1 中安裝與使用 Hibernate Synchronizer 外掛，從資料庫逆向生成映射檔、POJO 及 DAO 類，大幅提升開發效率。

外掛安裝步驟

1. 選單 Help → Software Updates → Find and Install
2. 選擇 Search for new features to install
3. 點選 New Remote Site，名稱填 Hibernate plugin，URL 填 https://www.binamics.com/hibernatesync
4. 在安裝畫面勾選該站點，一路 Next 完成下載安裝，Eclipse 自動重啟即可

建立範例專案：單表操作

1. 準備資料庫

使用 MySQL，建立 user_info 表：

CREATE TABLE `user_info` (
 `id` int(11) NOT NULL auto_increment,
 `name` varchar(100) NOT NULL default '',
 `password` varchar(100) NOT NULL default '',
 PRIMARY KEY (`id`)
);

2. 建立 Java 專案並加入依賴

• 新建普通 Java 專案
• 加入 Hibernate 所有 lib 檔案與 MySQL JDBC 驅動

3. 產生 Hibernate 設定檔

• 在 src 目錄右鍵 New → Other → Hibernate → Hibernate Configuration File
• 指定資料庫類型 (MySQL)、連線 URL、帳號密碼
• 完成後自動生成 hibernate.cfg.xml

4. 逆向生成映射檔與 POJO

• 新建套件 org.bromon.zizz.pojo
• 右鍵 New → Other → Hibernate → Hibernate Mapping File
• 點 Refresh 列出資料表，選取 user_info，指定 POJO 套件
• Properties 分頁可調整檔案副檔名、ID 產生策略等
• 完成生成 UserInfo.hbm.xml

5. 同步生成 DAO 類別

• 在 UserInfo.hbm.xml 右鍵選擇 Hibernate Synchronizer → Synchronize files
• 自動生成三個套件共八個類，封裝 Hibernate 底層操作

6. 將映射檔加入設定檔

• UserInfo.hbm.xml 右鍵 Synchronizer → Add Mapping Reference
• hibernate.cfg.xml 自動新增 <mapping resource="..."/>

7. 撰寫業務邏輯測試

在 org.bromon.zizz.pojo.dao.UserInfoDAO 中加入 main 方法 (此類不會被外掛覆寫)：

public static void main(String args[]) {
 try {
     _RootDAO.initialize();
     UserInfoDAO uid = new UserInfoDAO();
     org.bromon.zizz.pojo.UserInfo ui = new org.bromon.zizz.pojo.UserInfo();
     ui.setName("bromon");
     ui.setPassword("123");
     uid.save(ui);
 } catch (Exception e) {
     e.printStackTrace();
 }
}

8. 調整 ID 產生策略與事務設定

• 使用 Hibernate Editor 開啟 UserInfo.hbm.xml，將 ID generator 改為 identity (對應 MySQL auto_increment)
• 重要：編輯 hibernate.cfg.xml 必須使用 Eclipse 內建文字編輯器，外部工具可能導致不同步錯誤
• 註解掉 JTA 事務設定 (非 JTA 環境)：

<!--
<property name="hibernate.transaction.factory_class">
 net.sf.hibernate.transaction.JTATransactionFactory
</property>
<property name="jta.UserTransaction">
 java:comp/UserTransaction
</property>
-->

9. 執行驗證

Run 專案，資料成功寫入資料庫。

進階功能：Schema 變更時的重新生成

當資料表結構變更時，只需修改 .hbm.xml 檔案，再執行 Synchronize and Overwrite，外掛重新生成存根檔，開發者僅需調整業務邏輯即可。

總結

Hibernate Synchronizer 將 Session 管理、事務處理等樣板代碼自動化，配合視覺化編輯器，讓開發者專注於業務邏輯，極大提升開發效率與程式碼品質。