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

一、首先需要把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");