JPA 实体管理器工厂（EntityManagerFactory）

http://huangliangbao.iteye.com/blog/806531

通过上一节讲述，可以看到实体管理器工厂 EntityManagerFactory是获得实体管理器EntityManager对象的入口，而EntityManagerFactory对象是通过javax.persistenc.Persistence类中的静态方法createEntityManagerFactory来创建的。

例如下面代码所示。

EntityManagerFactory emf =

javax.persistence.Persistence.createEntityManagerFactory("jpaUnit");

EntityManager em = emf.createEntityManager();

下面首先详细了解一下javax.persistenc.Persistence类中的API。

11.2.1 javax.persistenc.Persistence API

javax.persistenc.Persistence类提供了两个手动创建EntityManagerFactory对象的方法，它们的定义如下所示。

package javax.persistence;

import java.util.*;

public class Persistence {

public static EntityManagerFactory createEntityManagerFactory(

String persistenceUnitName) {...}

public static EntityManagerFactory createEntityManagerFactory(

String persistenceUnitName, Map properties) {...}

}

其中，createEntityManagerFactory(String persistenceUnitName, Map properties)方法中properties的参数将覆盖persistence.xml文件配置的参数。

例如persistence.xml中的<property>元素中的配置如下所示。

<?xml version="1.0" encoding="UTF-8"?>

<persistence>

<persistence-unit name="jpaUnit" transaction-type="RESOURCE_LOCAL">

<provider>org.hibernate.ejb.HibernatePersistence</provider>

<properties>子

<property name = "hibernate.connection.driver_class" value = "com.mysql.
jdbc.Dr iver"/>

<property name = "hibernate.connection.url" value = "jdbc:mysql: //localhost:3306/jp
ademo"/>

<property name = "hibernate.connection.username" value = "root"/>

</properties>

<property name="hibernate.show_sql" value="true" />

</persistence-unit>

</persistence>

其中，属性 hibernate.show_sql的值为true，若创建EntityManagerFactory对象时采用以下的代码，则实际获得的 EntityManagerFactory对象属性hibernate.show_sql则为false，即为代码中所设置的将覆盖配置文件中所配置的，如下所示。

Map properties = new HashMap();

properties.put("hibernate.show_sql", "false");

EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpaUnit", properties);

11.2.2 EntityManagerFactory API

上一节创建了EntityManagerFactory对象，那么如何使用EntityManagerFactory对象创建EntityManager对象呢？下面来看EntityManagerFactory的定义，如下所示。

public interface javax.persistence.EntityManagerFactory {

public EntityManager createEntityManager();

public EntityManager createEntityManager(Map map);

public void close();

public boolean isOpen();

}

在创建EntityManagerFactory对象后，使用完后应该及时关闭。所以使用创建Entity ManagerFactory的代码如下所示。

EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpaUnit");

EntityManager entityManager = emf.createEntityManager();

entityManager.close();

emf.close();

11.2.3 实现自己的JPA

细心的读者可能会有疑问，为什么如下的简单代码就可以创建名称为“jpaUnit”的EntityManagerFactory对象呢？

EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpaUnit");

虽然这部分内容在使用JPA时并不需要了解，但如果读者想要自己实现JPA规范，这些内容是必须要了解的。

下面以笔者自己实现的简单例子，详细讲述其中的原理。通过这个完整的例子，读者可以对JPA的实现有更深刻的理解。

11.2.3.1 实现PersistenceProvider接口

首先编写一个类JPAPersistence并实现javax.persistence.spi.PersistenceProvider类，代码如下所示。

package com.fengmanfei.jpa;

import java.util.Map;

import javax.persistence.EntityManagerFactory;

import javax.persistence.spi.PersistenceProvider;

import javax.persistence.spi.PersistenceUnitInfo;

public class JPAPersistence implements PersistenceProvider {

public EntityManagerFactory createContainerEntityManagerFactory(

PersistenceUnitInfo persistenceunitinfo, Map map) {

System.out.println(this.getClass().getName()

+ ".createContainerEntityManagerFactory"

+ "(PersistenceUnitInfo persistenceunitinfo,Map
map)自己实现的方法");

return new EntityManagerFactoryImpl();

}

public EntityManagerFactory createEntityManagerFactory(String s, Map map) {

System.out.println(this.getClass().getName()

+ ".createContainerEntityManagerFactory"

+ "(String s, Map map)自己实现的方法");

return new EntityManagerFactoryImpl();

}

}

由于这里只是简单地说明如何初始化JPA的实现，所以只打印出调用方法的信息，并返回EntityManagerFactoryImpl对象。

11.2.3.2 实现EntityManagerFactory接口

然后编写一个简单的实现EntityManagerFactory接口的类EntityManagerFactoryImpl，代码如下所示。

package com.fengmanfei.jpa;

import java.util.Map;

import javax.persistence.EntityManager;

import javax.persistence.EntityManagerFactory;

public class EntityManagerFactoryImpl implements EntityManagerFactory {

public void close() {

}

public EntityManager createEntityManager() {

return null;

}

public EntityManager createEntityManager(Map map) {

return null;

}

public boolean isOpen() {

return false;

}

}

其中，这里接口中的方法笔者并没有编写自己的实现，读者如果需要可以自己添加代码。对于这里所实现的 javax.persistence.spi.PersistenceProvide类所在的包，可以通过JPA的官方网站下载，也可以从 “JBOSS_HOME\server\default\lib”目录下的ejb3-persistence.jar包中获得，在编译时要将这个类包添加到构建路径中。

11.2.3.3 定义自己的实现类

在META-INF文件目录下创建services\javax.persistence.spi.PersistenceProvider文件，在该文件中输入实现PersistenceProvider接口类的全名，如下所示。

com.fengmanfei.jpa.JPAPersistence

修改persistence.xml中的配置如下所示。

<?xml version="1.0" encoding="UTF-8"?>

<persistence >

<persistence-unit name="jpaUnit"

transaction-type="RESOURCE_LOCAL">

<provider>com.fengmanfei.jpa.JPAPersistence</provider>

</persistence-unit>

</persistence>

其中<provider>要配置为所实现的javax.persistence.spi.PersistenceProvider接口类。这样当客户端创建“jpaUnit”EntityManagerFactory对象时，就会调用自己实现的方法。

例如，客户端代码如下所示。

public class CustomerClient {

public static void main(String[] args) {

EntityManagerFactory emf = Persistence

.createEntityManagerFactory("jpaUnit");

}

}

程序运行后，控制台将输出如下所示的运行结果。

com.fengmanfei.jpa.JPAPersistence.createContainerEntityManagerFactory(String s, Map map)自己实现的方法

可以看到，当调用javax.persistenc.Persistence中的createEntityManagerFactory时，运行的是com.fengmanfei.jpa.JPAPersistence中的方法，并输出了相应的结果。

11.2.3.5 加载原理

当调用 javax.persistenc.Persistence中的createEntityManagerFactory方法时，程序会自动查找当前类加载器中所有的META-INF/services/javax.persistence.spi.PersistenceProvider文件中定义的
JPA实现类，如果还未初始化，则首先将这些实现类实例化。如果实现类已经实例化，则根据根据“unitName”来创建对应的实现类，直到返回的 EntityManagerFactory不为null为止。

如果读者想要更深入地了解JPA具体是如何实现的，建议读者研究一下Hibernate的源代码，这是一个很好的学习途径。