最近,在 bartsandbox 上,有人问我在 WebLogic 上配置 Hibernate 的具体步骤。您可能知道, Hibernate 是一个非常流行的开源对象关系映射 (Object Relational Mapping , ORM) 工具。下面是在 WebLogic 8.1 上配置 Hibernate 的具体步骤:
? 首先要创建一个域。我创建了一个 WebLogic Workshop (WLW) 域,因为我打算使用 WLW 来创建和实现应用程序。
? 将 hibernate...\lib\antlr-2.7.5H3.jar 添加到 PRE_CLASSPATH ,或者在 hibernate.cfg.xml 文件中将 query.factory_class 属性设为 user 2.x's query factory 。
? WLW 域还启动了一个 PointBase 数据库实例。我将使用这个内置实例。我创建了一个新的用户和模式。并为该模式填充了一些示例数据。
? 在服务器实例中配置连接池和数据源。
? 创建应用程序。我打算使用 WebLogic Workshop 创建。
? 应该将库( jar 文件)(它们是成功运行 Hibernate 所必需的)放在哪里呢?放在应用程序的 APP-INF/lib 文件夹中。库包括 hibernate.jar 和附加的第三方库。引用 Hibernate Reference 的表格 3-1 。
? 在 WLW 中创建一个 Java 项目。该 Java 项目包括映射到数据库的域类。 WLW 编译该项目,并将生成的 jar 文件放到 APP-INF/lib 目录下。在 Java 项目中编码域类。创建 Hibernate 映射文件和 Hibernate 配置文件。此外,从 Hibernate Reference 复制实现,创建 HibenateUtil 类。 Hibernate 配置文件包括数据源的 JNDI 名。
? 创建一个 EJB 对象(例如,一个模块)。该项目包含了会话 bean 。编写一个操纵域类的会话 bean 。
? 创建一个 Web 或 Web Service 项目(例如,一个模块)。该项目包含了可互操作性地测试会话 bean 的组件。
完整、有效、自包含的示例应用程序 在此 。其中包括了模式和所有的 Hibernate 配置文件。(注:需要有 bartsandbox 的免费会员资格。)
接下来的文章中,我将增强这一基本配置。
我的 前一篇文章 描述了在 WebLogic 8.1 上配置 Hibernate 3.0 的具体步骤。文章引起了巨大的反响。在本文中,我将介绍高级配置,其中 Hibernate 使用了 WebLogic 的 Java 命名和目录接口 (Java Naming and Directory Interface , JNDI) 、 Java 事务 API (Java Transaction API , JTA) 、 Java 连接器架构 (Java Connector Architecture , JCA) 和 Java 管理扩展 (Java Management extension , JMX) 实现。
我们先从 JNDI 开始。通过在 hibernate.cfg.xml 文件中命名 SessionFactory , Hibernate 使 SessionFactory 在 JNDI 中可用。呀!这在 WebLogic 中不起作用。正如 此处 所描述的, WebLogic JNDI 与 Hibernate 配合得不是很好。有多个工作区。工作区手动将 SessionFactory 绑定到 JNDI 中,方法是通过 WebLogic startup 类或者启动 servlet 。但是,我不能使 SessionFactory 实例从 JNDI 安全返回。因此,折衷一下,为 SessionFactory 向 HibernateUtil 实用类添加一个存取器。
为了配置 Hibernate 使用 JTA ,我在 hibernate.cfg.xml 文件中配置了 transaction.factory_class 。有两个选项: org.hibernate.transaction.JTATransactionFactory 和 org.hibernate.transaction.CMTTransactionFactory 。说明文档建议,对 Bean 托管事务界定 (Bean Managed Transaction Demarcation , BMTD) bean 使用 JTATransactionFactory ,而对容器托管事务界定 (Container Managed Transaction Demarcation , CMTD) bean 使用 CMTTransactionFactory 。 JTATransactionFactory 似乎更通用些,它既支持 BMTD bean 又支持 CMTD bean 。因此,我配置的是 JTATransactionFactory 。此外,为了以特定于容器的方式查找事务,我在 hibernate.cfg.xml 文件中配置了 transaction.manager_lookup_class 。借助于这个配置,我完全不需要使用 Hibernate Transaction API 。
对 Hibernate 的 JCA 支持是实验性质的,目前还没有全面应用于 WebLogic 。我可以设想,以后 Hibernate 会被打包为 Resource ARchive (RAR) 文件。 Hibernate RAR 文件作为资源适配器部署。适配器使 Session 在 JNDI 中可用。所有的配置元素都是通过资源适配器( xml 文件)配置的,而不是通过 hibernate.cfg.xml 文件或采用其他方法配置。为什么在 WebLogic 中要配置 Hibernate 使用 JCA ? JCA 旨在封装传统系统的连接、事务等等,并使它们在 J2EE 中可用。但是,由于 Hibernate ,传统的资源适配器的优势不能全面体现。一旦 Hibernate 被配置为资源适配器,特定的应用程序与 Hibernate 的耦合就被削弱了。多个不同的应用程序可以使用同一个 Hibernate 资源适配器。由于当前正在开发的 EJB 3.0 ,这种配置在 EJB 的持久性 API 、 Hibernate 和 Java 数据对象 (Java Data Object , JDO) 的标准化方面的优势更为明显。从理论上讲,可以热部署(或重部署)适配器和改变持久性实现。
Hibernate 附带 JMX Management Bean (MBean) 实现。我不知道如何使用 JMX 将 Hibernate 部署到 WebLogic 上。 Hibernate 和 WebLogic 使用 JMX 有什么好处?至少有两条。一条是部署和重部署。更重要的一条是,可以监控 Hibernate 和获得的统计信息。从 JMX 控制台进行运行时监控是所部署的应用程序运行良好的基本保障。
我更新了示例应用程序,可 在此 获取。(注:需要有 bartsandbox 的免费会员资格。)