将Hibernate配置到Weblogic JNDI上的详细步骤

我已经碰到过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;
    }
  }
}

编译这个源代码的时候需要注意的是，要把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");