WebLogic 8.1 上配置 Hibernate 3.0 完整指南

從基礎部署到 JNDI/JTA/JCA/JMX 進階整合：Hibernate 3.0 on WebLogic 8.1

WebLogic 8.1 作為當時主流 J2EE 容器，與 Hibernate 3.0 整合涉及類載入隔離、事務管理、資源適配器等容器級服務。本文分兩階段說明：標準部署步驟與進階容器服務整合，附完整配置細節與避坑指南。

第一階段：標準部署 7 步驟

1. 建立域：建立 WebLogic Workshop (WLW) 域 (支援 Workshop 開發)
2. 解決 Antlr 衝突：
   方案 A：將 hibernate/lib/antlr-2.7.5H3.jar 加入 PRE_CLASSPATH
   方案 B：hibernate.cfg.xml 設定 query.factory_class=org.hibernate.hql.classic.ClassicQueryTranslatorFactory (使用 2.x 查詢工廠)
3. 配置資料源：使用 WLW 內建 PointBase 實例，建立新用戶/Schema 並匯入測試資料
4. 建立連線池與 DataSource：Console 中配置 JDBC Connection Pool → DataSource，記錄 JNDI 名稱 (如 jdbc/MyDataSource)
5. 建立應用模組：使用 WLW 建立
6. 庫檔放置關鍵：所有 Hibernate 相關 JAR 必須放在 APP-INF/lib/ (EAR 層級)，不可 放在 WEB-INF/lib/ (WAR 層級) 或 Server Classpath。包含：hibernate3.jar + 依賴第三方庫 (參考 Hibernate 文檔表 3-1)
7. 開發領域模型與配置：
   • Java 專案編寫領域類 → 編譯輸出 JAR 放入 APP-INF/lib/
   • 編寫 .hbm.xml 映射檔 + hibernate.cfg.xml (含 hibernate.connection.datasource = JNDI 名稱)
   • 複製 HibernateUtil 工具類 (單例 SessionFactory)
8. EJB 模組：建立 Session Bean 操作領域模型
9. Web/Web Service 模組：測試 Session Bean 互操作性

第二階段：進階容器服務整合

1. JNDI 整合：SessionFactory 綁定難題

問題：hibernate.cfg.xml 設定 session_factory_name 應自動綁定 JNDI，但 WebLogic JNDI 實作與 Hibernate 協作不佳，Context.lookup() 常回傳非序列化 Stub 導致 ClassCastException。

折衷方案：在 HibernateUtil 增加靜態存取器：

public class HibernateUtil {
    private static final SessionFactory sessionFactory = buildSessionFactory();
    public static SessionFactory getSessionFactory() { return sessionFactory; }
    // 啟動 Servlet/WebLogic Startup Class 中主動綁定 (可選)
    // ctx.bind("hibernate/SessionFactory", sessionFactory);
}

應用代碼統一呼叫 HibernateUtil.getSessionFactory()，繞過 JNDI 查找。

2. JTA 整合：容器管理交易 (CMT) 最佳實踐

hibernate.cfg.xml 關鍵配置：

<property name="transaction.factory_class">org.hibernate.transaction.JTATransactionFactory</property>
<property name="transaction.manager_lookup_class">org.hibernate.transaction.WeblogicTransactionManagerLookup</property>

• JTATransactionFactory：同時支援 BMT (Bean Managed) 與 CMT (Container Managed)，比 CMTTransactionFactory 更通用
• WeblogicTransactionManagerLookup：讓 Hibernate 透過 WebLogic 專有方式取得 TransactionManager，無需直接使用 Hibernate Transaction API
• EJB 以 @TransactionAttribute 或 ejb-jar.xml 宣告交易屬性，容器自動攔截

MyApp.ear
├── APP-INF/lib/
│   ├── hibernate3.jar
│   ├── antlr-2.7.5H3.jar
│   ├── commons-collections.jar
│   ├── dom4j.jar
│   ├── javassist.jar
│   ├── DomainModel.jar (含 .hbm.xml)
│   └── ...
├── DomainEJB.jar
│   └── Session Beans
├── WebModule.war
│   └── Controllers / Web Services
└── META-INF/
    ├── application.xml
    └── weblogic-application.xml