WebLogic 8.1 整合 Hibernate 完整部署指南：從 Classpath 到 JNDI 數據源

前言：WebLogic 8.1 的特殊類載入挑戰

WebLogic 8.1 (2004 年發布) 採用模組化類載入器架構，Hibernate 需要的大量第三方庫 (CGLIB, Commons Collections, Dom4j 等) 若放置不當，極易導致 ClassNotFoundException、NoClassDefFoundError 或 LinkageError。本文提供經實戰驗證的完整整合步驟，涵蓋啟動腳本配置、JDBC 數據源、Hibernate 配置、啟動類初始化 SessionFactory 等關鍵環節。

一、目錄結構規劃

D:\testprj\
├── lib\           # 所有 Hibernate 相關 JAR
├── classes\       # 編譯類、Hibernate 配置檔、映射檔
└── src\           # 源碼

二、修改 WebLogic 啟動腳本：註入 Classpath

編輯 D:\bea\user_projects\domains\mydomain\startWebLogic.cmd，在 set CLASSPATH=... 之後插入：

@rem ====== Hibernate Classpath 注入 START ======
set HIBERNATE_LIB=D:\testprj\lib
set HIBERNATE_CLASSES=D:\testprj\classes

set CLASSPATH=%HIBERNATE_LIB%\cglib-asm.jar;
%HIBERNATE_LIB%\cglib-full-2.0.1.jar;
%HIBERNATE_LIB%\ehcache-0.7.jar;
%HIBERNATE_LIB%\commons-beanutils.jar;
%HIBERNATE_LIB%\commons-logging-1.0.3.jar;
%HIBERNATE_LIB%\commons-collections-2.1.jar;
%HIBERNATE_LIB%\commons-lang.jar;
%HIBERNATE_LIB%\commons-logging.jar;
%HIBERNATE_LIB%\dom4j-full.jar;
%HIBERNATE_LIB%\jcs.jar;
%HIBERNATE_LIB%\log4j-1.2.8.jar;
%HIBERNATE_LIB%\odmg.jar;
%HIBERNATE_LIB%\dom4j-1.4.jar;
%HIBERNATE_LIB%\hibernate2.jar;
%HIBERNATE_CLASSES%;
%CLASSPATH%
@rem ====== Hibernate Classpath 注入 END ======

關鍵要求：set CLASSPATH= **必須寫在單行**，不能換行或有多餘空格，否則 WebLogic 啟動失敗或 WinRAR 解壓報錯。

三、配置 WebLogic JDBC 連線池與 DataSource

1. 進入 WebLogic Console (https://localhost:7001/console)。
2. 建立 JDBC Connection Pool：選擇 Sybase 驅動，配置 URL、用戶/密碼、驅動類。
3. 建立 JDBC DataSource (Tx DataSource)：關聯上述 Pool，JNDI 名稱設為 misdb。
4. 測試連線池可用性。

四、Hibernate 配置檔：綁定 JNDI DataSource

在 D:\testprj\classes\hibernate.properties 中配置 (或 hibernate.cfg.xml 二擇一)：

# 方言：Sybase
hibernate.dialect=net.sf.hibernate.dialect.SybaseDialect

# 核心：使用 JNDI DataSource，非 JDBC 直連
hibernate.connection.datasource=misdb
hibernate.connection.provider_class=net.sf.hibernate.connection.DatasourceConnectionProvider

# 將 SessionFactory 綁定到 JNDI (供其他組件查找)
hibernate.session_factory_name=java:hibernate/SessionFactory

# 效能優化
hibernate.jdbc.fetch_size=50
hibernate.jdbc.batch_size=25

# 關閉預設連接配置 (避免衝突)
# hibernate.connection.driver_class=...
# hibernate.connection.url=...
# hibernate.connection.username=...
# hibernate.connection.password=...

注意：註釋掉所有 JDBC 直連相關配置，確保唯一生效的是 JNDI DataSource 方案。

五、編寫 WebLogic 啟動類：初始化 SessionFactory

WebLogic JNDI 實作不完全支援 Referenceable，直接在 hibernate.cfg.xml 配置 <property name="session_factory_name"> 可能失效。需編寫啟動類在伺服器啟動時主動構建並綁定。

5.1 啟動類原始碼

package com.myapp.startup;

import net.sf.hibernate.Configuration;
import net.sf.hibernate.SessionFactory;
import weblogic.common.T3StartupDef;
import weblogic.common.T3ServicesDef;

public class HibernateStartup implements T3StartupDef {

    public void startup(String name, Hashtable args) throws Exception {
        System.out.println(">>> 初始化 Hibernate SessionFactory...");

        // 1. 載入配置 (自動讀取 classpath 下的 hibernate.properties)
        Configuration cfg = new Configuration(); 
        // 若用 hibernate.cfg.xml: new Configuration().configure();

        // 2. 構建 SessionFactory (此過程會解析映射、驗證、建立連線池)
        SessionFactory factory = cfg.buildSessionFactory();

        // 3. 手動綁定到 JNDI (可選，若 hibernate.session_factory_name 配置生效則可省略)
        // Context ctx = new InitialContext();
        // ctx.rebind("java:hibernate/SessionFactory", factory);

        System.out.println(">>> Hibernate SessionFactory 初始化完成並綁定至 JNDI。");
    }

    public void setServices(T3ServicesDef services) { }
}

5.2 部署啟動類

1. 編譯類別至 D:\testprj\classes。
2. Console → Domain → Startup & Shutdown → 新增 Startup Class：
   Name: HibernateInit, Class: com.myapp.startup.HibernateStartup, Deployment: 選目標 Server。
3. 重啟 WebLogic 驗證控制台輸出初始化日誌。

六、映射檔案與實體類部署

• 所有 *.hbm.xml 映射檔、**實體類 (.class)**、**配置檔** 均放在 D:\testprj\classes (已在 Classpath)。
• 若映射檔在 JAR 中，確保 JAR 也在上述 Classpath 列表中。

七、常見錯誤與排查

八、生產環境優化建議

1. 連線池調優：WebLogic Pool 設定 Max Capacity、Statement Cache Size、Test Connections On Reserve。
2. 二級快取：配置 hibernate.cache.provider_class=net.sf.hibernate.cache.EhCacheProvider，調優 ehcache.xml。
3. 日誌系統：統一用 Log4j，配置 log4j.properties 輸出至檔案，關閉 Console 輸出。
4. 遷移規劃：WebLogic 8.1 早已 EOL，規劃遷移至 WebLogic 12c/14c + Hibernate 5/6 + Spring Boot，享受現代化開發體驗與安全支援。

結語

WebLogic 8.1 整合 Hibernate 的核心難點在於類載入器隔離導致的依賴衝突與JNDI 綁定特殊性。通過啟動腳本前置註入完整 Hibernate Classpath、配置 JNDI DataSource 替代 JDBC 直連、編寫啟動類主動構建並綁定 SessionFactory，可穩定解決整合問題。此方案雖針對舊版本，但「Classpath 控制、JNDI 資源注入、啟動期初始化」的核心思想在現代 Java EE / Jakarta EE / Spring Boot 應用部署中依然普遍適用。

1. 上一篇文章： Java Servlet 伺服器端包含 (SSI) 技術實戰：模組化 Web 頁面構建
2. 下一篇文章： Java 並發編程核心組件自製：信號量與管道流深度實現

Java 程式設計入門

Java 多線程程式設計完整指南：生命週期、優先級、三種建立方式、Thread 方法與最佳實務

Java 多線程程式設計完整指南 Java 內建支援多線程，

Java 物件導向核心：類別與物件的完整實戰指南

Java 物件導向核心：類別與物件的完整實戰指南 Java

一分鐘掌握 Java 8 Lambda 表達式核心原理

從匿名內部類到 Lambda Java 8 前，排序列表需寫

Java 陣列完整指南：宣告、初始化、多維陣列與 Arrays 工具類

Java 陣列完整指南：宣告、初始化、多維陣列與 Array