將Hibernate配置到Weblogic JNDI上的詳細步驟

robbin發表於2003-08-25
Web
我已經碰到過n次被人問到如何在Weblogic上把Hibernate配置到JNDI上的問題了，其實Hibernate的文件已經做出瞭解答(http://hibernate.bluemars.net/74.html)，只不過給出的程式碼不全，也沒有詳細描述如何配置。我感覺到很多人對Weblogic本身的配置都不熟悉，所以還是不停的問我，我把詳細步驟介紹一下，我的環境是Weblogic7.0，Oracle8.1.7，Hibernate2.0.1：

一、首先需要把Hibernate用到的jar包和配置檔案都放到Weblogic能夠搜尋到的CLASSPATH路徑上。單單這一步就有很多人很迷茫，其實去仔細看看Weblogic的啟動指令碼檔案startWeblogic.cmd和startWLS.cmd，我想大部分人都知道該怎麼配置了。

我機器上的有個Hibernate的專案，在D:\test\oracle目錄下，該目錄下的結構是：
D:\test\oracle\lib 放置hibernate的所有jar包
D:\test\oracle\src 放置原始碼
D:\test\oracle\classes 編譯好的程式碼和hibernate的配置檔案(hibernate.properties, log4j.properties, cache.ccf)

現在需要把D:\test\oracle\lib目錄下那些jar檔案和D:\test\oracle\classes目錄都放置到Weblogic的CLASSPATH裡面去，所以修改mydomain裡面的Weblogic啟動指令碼startWeblogic.cmd，在啟動Weblogic之前，插入設定CLASSPATH的命令，如下：

@rem set hibernate classpath
set HIBERNATE_LIB=D:\test\oracle\lib
set HIBERNATE_CLASSES=D:\test\oracle\classes
set CLASSPATH=%CLASSPATH%;%HIBERNATE_LIB%\cglib-asm.jar;%HIBERNATE_LIB%\commons-beanutils.jar;%HIBERNATE_LIB%\commons-collections.jar;%HIBERNATE_LIB%\commons-lang.jar;%HIBERNATE_LIB%\commons-logging.jar;%HIBERNATE_LIB%\dom4j-full.jar;%HIBERNATE_LIB%\hibernate2.jar;%HIBERNATE_LIB%\jcs.jar;%HIBERNATE_LIB%\log4j-1.2.8.jar;%HIBERNATE_LIB%\odmg.jar;%HIBERNATE_CLASSES%

下面一行，就是本來指令碼里面的啟動命令：
@rem Call Weblogic Server
call "C:\bea\weblogic700\server\bin\startWLS.cmd"

二、在Weblogic上配置Oracle資料庫的連線池。這一步本來和Hibernate無關，但是如果你想要使用EJB，想要使用JTA，那麼必須使用Weblogic提供的連線池，而不能使用Hibernate自帶的連線池，或者其它第三方連線池，否則容器將無法管理資料庫事務。這一步很簡單，就是在Weblogic Console裡面配置Connection Pool和TxData Source，我的Tx DataSource取名稱為“mypool”

三、修改hibernate.properties。使用Weblogic的連線池，而不是自帶的連線池。我修改的是D:\test\oracle\classes\hibernate.properties，增加如下行：
hibernate.dialect net.sf.hibernate.dialect.OracleDialect
hibernate.connection.datasource mypool
把
hibernate.connection.pool_size 1
hibernate.statement_cache.size 25
註釋掉
然後
hibernate.connection.provider_class net.sf.hibernate.connection.DatasourceConnectionProvider
去掉註釋，這樣就修改好了。

另外提到一點的是
hibernate.jdbc.fetch_size 50
hibernate.jdbc.batch_size 25
分別對資料庫查詢和插入有很大的效能影響，調節這兩個選項可以得到最好的效能。

四、自己寫一個StartUp類，這個類要實現weblogic.common.T3StartupDef介面。Hibernate給出了這個類的程式碼片斷，但是不全，我把它補全了，並且做了一些修改。程式碼如下：

package com.fankai;

import java.util.*;
import javax.naming.*;
import weblogic.common.T3StartupDef;
import weblogic.common.T3ServicesDef;
import org.apache.log4j.Logger;
import net.sf.hibernate.cfg.Configuration;
import net.sf.hibernate.SessionFactory;

public class WLSStartup implements T3StartupDef {

  public static final String SESSION_FACTORY_JNDI = "hibernate";
  public static final String URL = "t3://localhost:7001";
  private static final Logger log = Logger.getLogger(WLSStartup.class);

  public void setServices(T3ServicesDef services) {}

  public String startup(String name, Hashtable args) throws Exception {
      String METHOD_NAME = "startup ";
      try {
        log.info(METHOD_NAME + " Going to bind Hibernate object. ");
        doBind( );
        log.info (METHOD_NAME + " Bound Hibernate object!");
      } catch (Exception e) {
        log.info (METHOD_NAME + " Exception while binding Hibernate Object to Weblogic JNDI" );
        e.printStackTrace( );
      }
      return "WLS Startup completed successfully";
  }

  private static void doBind( ) throws Exception {
    Properties  environment  = null;
    InitialContext  context  = null;

    try {
      environment = new Properties( );
      environment.put(Context.INITIAL_CONTEXT_FACTORY,"weblogic.jndi.WLInitialContextFactory");
      environment.put(Context.PROVIDER_URL,URL);
      log.info( "Constructing an Initial Directory Context object" );
      context = new InitialContext( environment );

      Configuration conf = new Configuration().addClass(Cat.class);
      SessionFactory sf = conf.buildSessionFactory();
      if (sf == null) throw new Exception("SessionFactory cannot be built!");

      try {
        if(context.lookup(SESSION_FACTORY_JNDI ) != null )
          context.rebind(SESSION_FACTORY_JNDI, sf);
        else
          context.bind(SESSION_FACTORY_JNDI, sf);
      } catch (NamingException nameEx ) {
        context.bind(SESSION_FACTORY_JNDI, sf);
      }

    } catch ( NamingException nameExp ) {
      throw new Exception("NamingException: " + nameExp.getMessage());
    } catch( Exception excp ) {
      throw excp;
    } finally {
      if(context != null) {
        try {
          context.close( );
          context = null;
        } catch ( NamingException nameExp ) {
          throw new Exception("NamingException for context close: " + nameExp.getMessage());
        }
      }
      environment = null;
    }
  }
}
<p class="indent">


編譯這個原始碼的時候需要注意的是，要把weblogic.jar包和Hibernate所有的相關包和配置檔案匯入。我是把這個原始碼放到D:\test\oracle\src目錄下的，用早已編寫好的ant指令碼執行一下就編譯好了，並且編譯好的class檔案被放置到D:\test\oracle\classes目錄下，該目錄已經被加入到Weblogic的CLASSPATH裡面，因此很省事。

五、配置StartUp類
啟動Weblogic，開啟Console控制檯，在左邊的Applet樹上找到StartUp & Shutdown，然後在右邊點選“Configure a new Startup Class...”，在Name框裡面隨便填寫，在ClassName裡面填寫你編寫的StartUp類，我填寫的是com.fankai.WLSStartup，然後點選“Apply”。然後切換到Target這選項卡，在Target-Server左邊的Avaiable框裡面選擇“myserver”，點選右箭頭，把它挪到右邊的“Chosen”框裡面去，最後再點選一下“Apply"按鈕。如果此時Weblogic的DOS視窗裡面沒有出錯資訊，那麼應該已經配置成功了。

六、現在關閉Weblogic，再重新執行startWelogic.cmd，啟動Weblogic，觀察DOS視窗的輸出資訊，可以看到Hibernate的初始化資訊一屏屏的滾動輸出，證明已經配置成功。現在再開啟Console控制檯，點選左邊Applet樹中的Servers|myserver，然後可以在右邊最下面找到“View JNDI tree ”，點選它，會開啟一個瀏覽器視窗，顯示JNDI樹，這時你可以看到一個名稱為hibernate的JNDI物件，在左邊的Applet樹中點選它，看右邊的詳細資訊，我的機器上的資訊如下：
Bind Name: hibernate
Object Class: net.sf.hibernate.impl.SessionFactoryImpl
Object Hash Code: 454492
Object To String: net.sf.hibernate.impl.SessionFactoryImpl@6ef5c
完全正確！
最後你可以隨意在EJB或者Servlet/JSP裡面使用JND查詢來獲得SessionFactory了。

例如：

Context ctx = new InitialContext();
SessionFactory sf = (SessionFactory) ctx.lookup("hibernate");
<p class="indent">



相關文章