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

03-08-25 robbin
我已经碰到过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">



1
uu_snow
2003-08-25 14:52
在WebSphere下怎么配置呢?

muziq
2003-08-25 18:20
>
> Configuration conf = new
> = new Configuration().addClass(Cat.class);


这里,是不是系统里有多少Persistant Class,都必须在这里全部加进来呢?

robbin
2003-08-25 19:00
对。或者写到hibernate.cfg.xml里面也可以。

SunOne
2003-08-25 20:42
Hibernate的文档上说hibernate的JNDI在JBoss、WebSphere、Orion、Resin等服务器上能够很好的工作,这是不是说在这些服务器上不需要另外配置JNDI,而依靠hibernate自己的bind.
我想是不是因为这些服务器的JNDI实现是可写的,所以可以在运行期动态绑定,而Tomcat等的JNDI是只读的,所以hibernate的bind不起作用

robbin
2003-08-25 21:19
是这样的,在Weblogic上确实可以不需要像上面那种做法自己写程序来进行绑定,也可以由Hibernate自己在运行期进行动态绑定。但是如果使用Hibernate自己的运行期绑定的话,有一个悖论,就是只有在Hibernate被初次调用进行初始化的时候,才会将SessionFactory的实例绑定到JNDI上去,那么意味着,在首次调用Hibernate之前,JNDI上是没有SessionFactory实例的,所以你必须在所有的其它程序通过JNDI获得SessionFactory实例之前,运行某个程序对Hibernate进行初始化,把SessionFactory实例绑定到JNDI上。如果是纯Servlet/JSP应用的话,可以配置一个load-up=1的servlet进行Hibernate的初始化,如果是混合EJB,Servlet/JSP的应用,就无法保证在程序被调用前对Hibernate进行初始化,因此对于Weblogic来说,最保险的解决办法就是建立一个StartUp类,确保Weblogic一启动,就对Hibernate进行初始化。

xinxin2
2003-08-25 21:31
是啊o 有]有人f一f在WebSphere下怎么配置呢?

xx

robbin
2003-08-25 22:12
我看了一下Hibernate2.0.1的源代码,Hibernate的JNDI名称绑定是在net.sf.hibernate.impl.SessionFactoryObjectFactory程序里面实现的,这下就很清楚了,我来分析一下Hibernate的绑定JNDI的过程:
我们获得SessionFactory一般是这样写代码:

Configuration conf = new Configuration().addClass(Cat.class);
SessionFactory sf = conf.buildSessionFactory(); 
<p class="indent">

首先是new Configuration()创建一个Configuration,在这个构造器里面进行配置文件(hibernate.properties)的读取工作,然后保存到一个Properties对象里面去,和JNDI相关的是这个属性:

hibernate.session_factory_name hibernate/session_factory
<p class="indent">

接着调用buildSessionFactory()方法,该方法检查一下配置信息,然后调用SessionFactoryImpl的一个构造器。在构造器里面注意下面两行代码:

name = properties.getProperty(Environment.SESSION_FACTORY_NAME);
SessionFactoryObjectFactory.addInstance(uuid, name, this, properties);
<p class="indent">

调用了SessionFactoryObjectFactory的addInstance方法,并且把自身(SessionFactory的实例)作为参数传递。最后在addInstance方法可以看到如下代码:

Context ctx = NamingHelper.getInitialContext(properties);
NamingHelper.bind(ctx, name, instance);
<p class="indent">

instance就是SessionFactory的实例,通过读源代码,可以清楚的看到Hibernate是在conf.buildSessionFactory()的时候通过一系列类方法调用,把创建的SessionFactory实例绑定到配置文件(hibernate.properties)中hibernate.session_factory_name属性指定的名称上的,因此可见Hibernate自身是具有JNDI的动态绑定功能的。但是Hibernate需要获得一个SessionFactory实例用于绑定,而这个SessionFactory实例需要我们写代码进行预先创建,并且必须保证该过程要在所有其它要从JNDI上获得SessionFactory实例的程序之前完成。

因此对于任何App Server来说,我们都不必去管JNDI名称的绑定过程,只需要保证预先创建一个SessionFactory实例出来就够了,剩下的工作Hibernate会做的。那么如何确保预创建SessionFactory实例呢,如果是Servlet,可以配置一个初始化的Servlet,只要把

Configuration conf = new Configuration().addClass(Cat.class);
SessionFactory sf = conf.buildSessionFactory(); 
<p class="indent">

这样的代码加进去就可以了。如果是包含EJB的的复杂的J2EE应用,可能需要依靠App Server的功能来保证预创建SessionFactory实例。






robbin
2003-08-25 22:29
根据上面的分析结果,我们可以把Hibernate的JNDI配置过程进行简化,不必自己写代码进行JNDI的绑定过程,而是利用Hibernate自身进行JNDI的动态绑定,还是以Weblogic来说明:

1、把Hibernate的jar包,配置文件,相关类路径加入到Weblogic的CLASSPATH中去(参考楼顶贴)

2、配置hibernate.properites,以下几行是必须配置的:

hibernate.dialect net.sf.hibernate.dialect.OracleDialect
hibernate.connection.datasource mypool
hibernate.connection.provider_class net.sf.hibernate.connection.DatasourceConnectionProvider
hibernate.session_factory_name hibernate.session_factory
<p class="indent">

前3行上面帖子已经提到了,注意最后一行,这是使用Hibernate来绑定JNDI给JNDI起的名称,本来应该是hibernate/session_factory,但是Weblogic要求改为.号,不过在程序中lookup的时候还是要写hibernate/session_factory。

3、为了保证SessionFactory实例的预创建,使用Weblogic的T3StartUpDef接口创建一个StartUp类,在Weblogic启动的时候运行:

package com.fankai;

import java.util.Hashtable;
import weblogic.common.T3StartupDef;
import weblogic.common.T3ServicesDef;
import net.sf.hibernate.cfg.Configuration;
import net.sf.hibernate.SessionFactory;

public class HibernateStartUp implements T3StartupDef {

  public void setServices(T3ServicesDef services) {}

  public String startup(String name, Hashtable args) throws Exception {
    Configuration conf = new Configuration().addClass(Cat.class);
    SessionFactory sf = conf.buildSessionFactory(); 
    return "Hibernate Startup completed successfully";
  } 
}
<p class="indent">

代码非常简单,其实就是确保预先运行

Configuration conf = new Configuration().addClass(Cat.class);
SessionFactory sf = conf.buildSessionFactory(); 
<p class="indent">

,把sf创建出来,而Hibernate会自行调用一系列类方法,把sf绑定到Weblogic的的JNDI树下的hibernate/session_factory路径中。

4、编译HibernateStartUp.java,然后启动Weblogic,把com.fankai.HibernateStartUp在Console控制配置好。

5、重新启动Weblogic,已经可以在DOS窗口看到Hibernate的初始化信息了,在Consle中查看JNDI树,可以看到hibernate路径下的session_factory

总结:
在其它App Server上如何配置,本质上和Weblogic是一样的,只是你要确保在其它程序运行之前,先把

Configuration conf = new Configuration().addClass(Cat.class);
SessionFactory sf = conf.buildSessionFactory(); 
<p class="indent">

这两行代码运行一遍就OK了,聪明的你要是再说不知道怎么在Websphere上配置Hibernate的JNDI,我也只好无言了。


robbin
2003-08-25 22:46
在上面的例子中,由于在hibernate.properties中指定JNDI名称为:

hibernate.session_factory_name hibernate.session_factory
<p class="indent">

所以JNDI路径为hibernate/session_factory (在Weblogic中,配置文件中的JNDI路径不能写成/,要写成.)

然后在程序中调用JNDI,获得SessionFactory实例的代码为:

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



xinxin2
2003-08-26 02:19
Thanks Robbin!

I am kind of getting to know this, and I tried it with websphere, it seems like working properly. You are the right person!

getup
2003-10-03 18:23
我在启动Weblogic的时候,出了如下的错,哪里配置有问题啊?
<2003-10-3 下午06时30分38秒> <Info> <WebLogicServer> <000287> <Invoking startup
class: HibernateStartup.startup(null)>
java.lang.ExceptionInInitializerError: org.apache.commons.logging.LogConfigurati
onException: java.lang.reflect.InvocationTargetException
at org.apache.commons.logging.impl.LogFactoryImpl.newInstance(LogFactory
Impl.java:532)
at org.apache.commons.logging.impl.LogFactoryImpl.getInstance(LogFactory
Impl.java:272)
at org.apache.commons.logging.impl.LogFactoryImpl.getInstance(LogFactory
Impl.java:246)
at org.apache.commons.logging.LogFactory.getLog(LogFactory.java:395)
at net.sf.hibernate.cfg.Configuration.<clinit>(Configuration.java:86)
at HibernateStartup.doBind(HibernateStartup.java:47)
at HibernateStartup.startup(HibernateStartup.java:22)

robbin
2003-10-04 18:02
你没有正确配置log4j。

getup
2003-10-08 17:45
Robbin,我不太清楚Hibernate的环境里面需要对Log4J进行什么配置,有什么讲究吗?不宁赐教。谢谢

robbin
2003-10-09 03:17
没有什么讲究,下载log4j,放到CLASSPATH里面就可以了,我顶楼的帖子里面CLASSPTH里面就配置了log4j了。

hibernate里面src目录下有一个log4j的配置文件的例子,拿过来直接用。

猜你喜欢
2Go 1 2 下一页