Hibernate实战_笔记10

使用Hibernate EntityManager

      Hibernate EntityManager是围绕提供JPA编程接口的Hibernate Core的一个包装，支持JPA实体实例的生命周期，并允许你用标准的Java Persistence查询语言编写查询。由于JPA功能是Hibernate原生能力的一个子集。你给Hibernate EntityManager配置了项目，马上就会看到一种特殊的简化：你不再非得在配置文件中列出所有被注解的类（或者XML映射文件）了。

1、基本的JPA配置

      SessionFactory在Hibernate应用程序中表示一个特定的逻辑数据存储配置。EntityManagerFactory在JPA应用程序中扮演着同样的角色，你用配置文件或者在应用程序代码中配置EntityManagerFactory(EMF)，就像配置SessionFactory一样。EMF的配置，与一组映射元数据（通常是被注解的类）一起，被称作持久化单元（persistence unit）。

<persistence xmlns="http://java.sun.com/xml/ns/persistence"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
    http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"
    version="1.0">
    <persistence-unit name="helloworld">
    	<properties>
    		<property name="hibernate.ejb.cfgfile" value="/hibernate.cfg.xml" />
    	</properties>
    </persistence-unit>
</persistence>

      和一个持久化单元都需要一个名称，在这个例子中为helloworld。
      使用任意数量的属性对持久化单元进行进一步设置，这些属性全是特定于供应商的。前一个例子中的属性hibernate.ejb.cfgfile，就像是一个杂物箱。它引用包含着这个持久化单元所有设置的hibernate.cfg.xml文件（在类路径的根目录中）——你正在重用现有的Hibernate设置。随后，将把所有的配置细节移进persistence.xml文件，但是现在你更关注使用JPA运行“Hello World“。

<property name="src.etc.dir" value="etc" />
	<!--复制xml、properties后缀文件到bin目录-->
	<target name="copymetafiles">
		<copy todir="${build.dir}">
			<fileset dir="${src.java.dir}">
				<patternset refid="meta.files" />
			</fileset>
		</copy>
		<copy todir="${build.dir}">
			<fileset dir="${src.etc.dir}">
				<patternset refid="meta.files" />
			</fileset>
		</copy>
	</target>

      firstJta/etc目录下与meta.files模式相匹配的所有内容都被复制到构建输出目录，这是运行时classpath的一部分。

2、使用JPA的“Hello World”

Java Persistence中主要的编程接口：
1、javax.persistence.Persistence——给EntityManagerFactory的创建提供一种静态方法的一个启动类。
2、javax.persistence.EntityManagerFactory——等同于Hiberante Session。这个单线程、非共享的对象表示数据访问的一个特定工作单元。它提供方法去管理实体实例的生命周期并创建Query实例。
3、javax.persistence.Query——等同于Hibernate Query。这个对象是一种特定的JPA查询语言或者原生的SQL查询表示法，它允许参数的安全绑定，并给查询的执行提供各种各样的方法。
4、javax.persistence.EntityTransaction——等同于Hibernate Transaction，在Java SE环境中用于RESOURCE_LOCAL事务的划分。在Java EE中，依赖JTA标准的javax.transaction.UserTransaction接口进行编程式的事务划分。
要使用JPA接口，需要复制必要的库到firstJta/lib目录下
我使用的
Hibernate版本 Hibernate 3.2.5
Hibernate EntityManager 3.2.1.GA
Hibernate Annotations 3.2.1.GA
如果你的Hibernate是3.5之后，Hibernate Core、Hibernate EntityManager、Hibernate Annotations又集成了，就不会有Jar冲突等等问题。

package cn.jbit.jta.util;

import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.Persistence;

public final class JPAUtil {

	private static final EntityManagerFactory emf;
	
	static {
		try{
		emf = Persistence.createEntityManagerFactory("helloworld");
		}catch(Throwable ex){
			throw new ExceptionInInitializerError(ex);
		}
	}
	
	private JPAUtil(){
	}

	public static EntityManagerFactory getEmf() {
		return emf;
	}
	
	public static EntityManager getEntityManager(){
		return emf.createEntityManager();
	}
	
	public static void shutdown(){
		emf.close();
	}
}

package cn.jbit.jta.test;

import java.util.List;

import javax.persistence.EntityManager;
import javax.persistence.EntityTransaction;

import cn.jbit.jta.entity.Message;
import cn.jbit.jta.util.JPAUtil;

public class EntityManagerTest {
	
	@SuppressWarnings("unchecked")
	public static void main(String[] args) {
		// 第一个单元
		// createEntityMangaerFacoty参数"helloworld"是persistence.xml文件中持久化单元名称
		EntityManager em = JPAUtil.getEntityManager();
		EntityTransaction tx = em.getTransaction();
		tx.begin();

		Message message = new Message("Hello World");
		em.persist(message);

		tx.commit();
		em.close();

		// 第二个单元
		EntityManager secondEm = JPAUtil.getEntityManager();
		EntityTransaction secondTx = secondEm.getTransaction();
		secondTx.begin();
		
		List<Message> messages = secondEm.createQuery(
				"select m from Message m order by m.text asc").getResultList();
		System.out.println(messages.size() + "条消息记录");
		for (Message m : messages) {
			System.out.println(m.getText());
		}
		secondTx.commit();
		secondEm.close();
		
		JPAUtil.shutdown();
	}
}

      在这段代码中你可能注意到的第一点是不再有Hibernate导入，只有javax.persistence.*。用一个对persistence的静态调用和持久化单元的名称来创建EntityManagerFactory。其余代码应该是不言自明的——就像使用Hibernate一样使用JPA，虽然在API中有些小差别，并且方法的名称也略有不同。

3、元数据的自动侦测

      之前我们承诺过你将不一定要设置中列出所有被注解的类或者XML映射文件，但是它们仍然在hibernate.cfg.xml中。其实不只是从hibernate.cfg.xml中移除这个单独的不必要选项，而是要移除整个文件，并把所有的配置细节移到persistence.xml里面。
完整的持久化单元配置文件

<persistence xmlns="http://java.sun.com/xml/ns/persistence"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
    http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"
    version="1.0">
    <persistence-unit name="helloworld">
    	<provider>org.hibernate.ejb.HibernatePersistence</provider>
    	<!-- 
    	<class>cn.jbit.jta.entity.Message</class> -->
    	<properties>
    		<!-- 
    		<property name="hibernate.ejb.cfgfile" value="/hibernate.cfg.xml" /> -->
    		<property name="hibernate.archive.autodetection" value="class,hbm"/>
    		<property name="hibernate.show_sql" value="true"/>
    		<property name="hibernate.format_sql" value="true"/>
    		<property name="hibernate.connection.driver_class" value="oracle.jdbc.driver.OracleDriver"/>
    		<property name="hibernate.connection.url" value="jdbc:oracle:thin:@localhost:1521:orcl"/>
    		<property name="hibernate.connection.username" value="system"/>
    		<property name="hibernate.connection.password" value="bdqn"/>
    		<property name="hibernate.c3p0.min_size" value="5"/>
    		<property name="hibernate.c3p0.max_size" value="20"/>
    		<property name="hibernate.c3p0.timeout" value="300"/>
    		<property name="hibernate.c3p0.max_statements" value="50"/>
    		<property name="hibernate.c3p0.idle_test_period" value="3000"/>
    		<property name="hibernate.dialect" value="org.hibernate.dialect.OracleDialect"/>
    		<property name="hibernate.hbm2ddl.auto" value="create"/>
    	</properties>
    </persistence-unit>
</persistence>

      在这个配置文件中有3个值得关注的新元素，首先，你设置了应该为这个持久化单元所用的一个显式的<provider>。通常只在你在非Java EE的环境中部署，规范要求列出包含<class>元素的所有被注解的类——Hibernate处处支持映射元数据的自动侦测，使它变成可选。最后Hibernate配置设置hibernate.archive.autodetection告知Hibernate要自动扫描哪些元数据：被注解的类（class）和Hibernate XML映射文件（hbm）。默认情况下，Hibernate EntityManager对两者都进行扫描。
被注解的类和XML映射文件的自动侦测是JPA一个很棒的特性。通常只在有Java EE应用程序服务器中才可用；至少，这是EJB3.0规范保证的东西。但是，Hibernate作为一个      JPA提供程序，也在简单的Java SE中实现它，虽然你也许不能够使用与任何其他JPA提供程序完全相同的配置。
      所有的JPA配置设置都捆绑在persistence.xml中，所以的映射元数据都包括在Message类的Java源代码中，Hibernate在启动时自动扫描并找到元数据。相较于纯粹的Hibernate，现在你这些好处：
1）被部署元数据的自动扫描，这在大项目中是个重要的特性。如果几百个实体由一个大团队开发时，维护一系列被注解的类或者映射文件变得很困难。
2）标准的和简化的配置，配置文件有标准的位置，以及一个部署概念——持久化单元——在一个应用程序文档（EAR）中包有几个单元（JAR）的更大项目中，它有着更多的优势。
3）标准的数据访问代码、实体实例的生命周期和完全可移植的查询。应用程序中没有私有的导入。
这些仅仅是JPA的其中一些优势。如果你把它与完全的EJB3.0编程模型和其他的托管组件结合起来，就会看到它真正的威力。

代码提供下载

JPA项目链接