我已经碰到过n次被人问到如何在Weblogic上把Hibernate配置到JNDI上的问题了,其实Hibernate的文档已经做出了解答,只不过给出的代码不全,也没有详细描述如何配置。我感觉到很多人对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");