<property name="hibernate.transaction.factory_class" value="org.hibernate.transaction.JTATransactionFactory"/>
<property name="hibernate.transaction.manager_lookup_class" value="org.hibernate.transaction.WeblogicTransactionManagerLookup"/>
<property name="hibernate.transaction.flush_before_completion" value="true"/>
<property name="hibernate.transaction.auto_close_session" value="true"/>
后,使用Hibernate进行端到端的测试
现在,我们专为Weblogic Server的JTA事务配置了Hibernate。这时运行测试没有出现错误,表明使用了正确的提供者,并为消息给定了一个正确的标识符。
$ ant -q -Dprovider=hibernate
[echo] =====================================================
[echo] Build Configuration for hibernate
[echo] =====================================================
[echo] Base directory : D:projectswitch
[echo] Deployed Target : D:projectswitch/JPAService.ear
[echo] EJB Module : D:projectswitch/tmp/hibernate-ejb.jar
[echo] Configuration : D:projectswitch/META-INF/hibernate/persistence.xml
[echo] Packaging EJB Module for hibernate at D:projectswitch/tmp/hibernate-ejb.jar
[echo] Packaging EAR Module for hibernate at D:projectswitch/JPAService.ear
[echo] Packaging D:projectswitch/tmp/test-JPAService.jar for running the tests
[echo] Undeploying JPAService from t3://localhost:7001 ...
[echo] Deploying JPAService to t3://localhost:7001 ...
[echo] Running JUnit Test: junit.TestJPAService ...
[junit] Logical Persistence Provider is [hibernate]
[junit] Actual Persistence Provider is [org.hibernate.impl.SessionImpl]
[junit] Persisted Message [id:1 timestamp:1182755464176 body:A message sent for logging on 1182755464166]
[junit] Time elapsed between the message to send and persisted is 10ms
重复测试表明已经用ID:2创建了新的消息。
我检查了MySQL数据库,发现当它的值配置为自动生成的时候,主键列标记为自动增加。
mysql> show create table message;
mysql>| message | CREATE TABLE `message` (
`id` bigint(20) NOT NULL auto_increment,
`body` varchar(255) default NULL,
`createdOn` datetime default NULL,
PRIMARY KEY (`id`)
The configuration that create the table definition for us is <property name="hibernate.hbm2ddl.auto" value="create"/>
关于Hibernate部署的摘要
总结起来,在Weblogic Server 10.0环境中安装和运行使用Hibernate的JPA应用程序步骤如下。
1. 在Weblogic Server 域中的共享库里添加Hibernate库
2. 配置JTA事务和自动的表定义属性
3. 封装、部署和运行测试进行验证
现在来看一下要采用Kodo运行完全相同的应用程序,我们需要做些什么。
为何不需要在weblogic Server 10.0中安装Kodo
Kodo是Weblogic Server 10.0整体的一部分。核心Kodo库随Weblogic Server安装一起提供,可以在${bea.home}/modules/com.bea.core.kodo_4.1.3.jar中获得。Kodo 4.1.3构建于OpenJPA之上, Weblogic Server安装后还在${bea.home}/modules/org.apache.openjpa_0.9.7.jar中提供OpenJPA库。Kodo和OpenJPA依赖于其他几个开源jar(其中的是用于字节码增强的serp)和规范jar,如jpa、jdo、jca或jta。所有这些必要的jar也可以从${bea.home}/modules/目录中获得。
为了使用Kodo运行完全相同的应用程序,只需一个不同的persistence.xml。
persistence.xml
01 <?xml version="1.0"?>
02
03 <persistence xmlns="http://java.sun.com/xml/ns/persistence"
04 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
05 xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
06 http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"
07 version="1.0">
08 <persistence-unit name="test" transaction-type="JTA">
09 <provider>kodo.persistence.PersistenceProviderImpl</provider>
10 <properties>
11 <property name="kodo.ConnectionURL" value="jdbc:mysql://localhost/kodoDB"/>
12 <property name="kodo.ConnectionDriverName" value="com.mysql.jdbc.Driver"/>
13 <property name="kodo.jdbc.SynchronizeMappings" value="buildSchema"/>
14 </properties>
15 </persistence-unit>
16 </persistence>
与使用Hibernate时的配置比较,惟一显著的变化是将提供者类名改为kodo.persistence.PersistenceProviderImpl。
现在属性名不一样了。例如,在Kodo中可以通过设置kodo.jdbc.SynchronizeMappings为buildSchema来配置自动模式创建。
经过小限度的改变,我再使用Kodo作为提供者运行测试。
$ ant -Dprovider=kodo
$ ant -q -Dprovider=kodo
[echo] =====================================================
[echo] Build Configuration for kodo
[echo] =====================================================
[echo] Base directory : D:projectswitch
[echo] Deployed Target : D:projectswitch/JPAService.ear
[echo] EJB Module : D:projectswitch/tmp/kodo-ejb.jar
[echo] Configuration : D:projectswitch/META-INF/kodo/persistence.xml
[echo] Enhancing persistent classes
[echo] Packaging EJB Module for kodo at D:projectswitch/tmp/kodo-ejb.jar
[echo] Packaging EAR Module for kodo at D:projectswitch/JPAService.ear
[echo] Packaging D:projectswitch/tmp/test-JPAService.jar for running the tests
[echo] Undeploying JPAService from t3://localhost:7001 ...
[echo] Deploying JPAService to t3://localhost:7001 ...
[echo] Running JUnit Test: junit.TestJPAService ...
[junit] Logical Persistence Provider is [kodo]
[junit] Actual Persistence Provider is [kodo.persistence.KodoEntityManagerImpl]
[junit] Persisted Message [id:251 timestamp:1182762774929 body:A message sent for logging on 1182762774918]
[junit] Time elapsed between the message to send and persisted is 11ms
一切顺利。先前部署的Hibernate单元撤除了。新的部署使用Kodo作为提供者,并返回了正确的提供者。
Kodo定义了什么模式呢?
mysql> use kododb;
mysql> show create table message;
| message | CREATE TABLE `message` (
`id` bigint(20) NOT NULL,
`body` varchar(255) default NULL,
`createdOn` datetime default NULL,
PRIMARY KEY (`id`)
)
注意,Kodo没有像 Hibernate那样标记auto-increment的id 。Kodo由自己指派自动生成的标识符。
这个bug是怎么回事?
到目前为止,一切似乎都运行良好。我们安装了Hibernate,然后使用Hibernate运行了一个应用程序。然来又将提供者切换为Kodo。您可以用OpenJPA进行类似的测试(它的提供者是org.apache.openjpa.persistence.PersistenceProviderImpl。但是,由于在Weblogic Server中这个提供者是默认的,所以您甚至可以省略它)。那么切换提供者产生的bug在哪儿呢?
如果您决定以不同的方式安装Hibernate,那么会出现bug。如果不把Hibernate库放在域的共享库中,Hibernate库还可以放在EAR里。如果这样进行部署封装,则应用程序不能再次进行部署和撤除(即便将同样的Hibernate作为提供者)。这是为什么呢?
答案在于JPA自身提供的一个javax.persistence.Persistence类。这个类用于引导。它搜索可用的提供者并要求每个提供者创建一个持久性单元,即EntityManagerFactory。然而,这个引导类javax.persistence.Persistence会将PersistenceProvider类缓存在一个内部静态Set中,并且不再对Set成员进行更新。
因此,如果用Web应用程序W封装了Hibernate,一旦用户应用程序直接调用或者由注入过程调用Persistence.createEntityManagerFactory(),则Hibernate持久性提供者X将被Web应用程序W的类装载器 L1加载,并且缓存在javax.persistence.Persistence的静态Set中。随后,Web应用程序W被撤除。L1便会离开作用域。Web应用程序W将被重新部署。这时的类装载器是L2。如果程序再次调用Persistence.createEntityManagerFactory(),则javax.persistence.Persistence中的代码将试图调用X的方法(由L1加载的,而L1已经不在了),而且代码将开始与ClassCastException和长的堆栈跟踪断开。
如何解决这一bug呢?
一个简单的解决方案是遵守这里所描述的封装模式。还有一个有难度的方案是修改javax.persistence.Persistence本身。这个方案有难度是因为这一过程中要升级/修补/重新分配一个按照规范定义的(提供的)实现类。
在另一篇文章中,我将讨论在如何对javax.persistence.Persistence类进行修改,从而允许在涉及多个(可能是不相干的)类装载器的环境中更加良好地运行。