Java持久性API（JPA）第8讲——实体管理器和实体管理器工厂

目标：掌握实体管理器和实体管理器工厂的使用。

主要内容：

u javax.persistence.Persistence类

u javax.persistence.EntityManagerFactory接口

u javax.persistence.EntityManager接口

u EntityManagerFactory对象的获取

u EntityManager对象的获取

u 用法

1、javax.persistence.Persistence类

该类用于获取EntityManagerFactory，主要有两个方法：

u createEntityManagerFactory(String persistenceUnitName)，创建并返回参数所指定的持久单元名字所对应的EntityManagerFactory。

u createEntityManagerFactory(String persistenceUnitName,Map properties)，创建并返回EntityManagerFactory，第一个参数是持久单元的名字，第二个参数是创建EntityManagerFactory所需要的属性，这些属性会覆盖其他地方设置的属性。

两个方法均为静态方法，直接通过类名访问即可。

2、实体管理器工厂EntityManagerFactory

实体管理器工厂用于管理实体管理器，是EntityManagerFactroy的对象。主要方法如下：

u createEntityManager()，创建实体管理器

u createEntityManager(Map map)，根据指定的属性创建实体管理器

u close()，关闭实体管理器工厂，释放资源

u isOpen()，判断实体管理器工厂是否关闭

接口的详细定义参加教材356页。

3、实体管理器EntityManager

对实体的操作由实体管理器完成。主要方法如下(接口详细定义参考书上357页)：

u persist(Object o)，持久化实体

u merge(T o)，合并实体状态

u remove(Object entity)，删除实体

u find(Class entityClass,Object primarykey)，根据主键查找实体

u flush()，同步到数据库

u setFlushMode(FlushModeType flushMode)，设置同步方式

u getFlushMode()，得到同步方式

u lock(Object entity,LockModeType lockMode)，锁定

u refresh(Object entity)，更新状态

u clear()，清除持久上下文

u contains(Object entity)，判断实体是否属于当前上下文环境

u createQuery(String sqlString)，创建查询

u createNamedQuery(String name)，创建命名查询

u createNativeQuery(String sqlString)，创建标准SQL查询

u createNativeQuery(String sqlString,Class resultClass)，创建标准SQL查询，并指定查询的结果

u createNativeQuery(String sqlString,String resultsetMapping)，创建标准SQL查询，并指定查询的结果如何映射

u getTransaction()，返回事务对象

4、实体管理器工厂的获取

实体管理工厂可以注入，也可以通过Persistence类获取。

4.1 通过注入获取实体管理器工厂

实体管理器工厂可以使用元注释注入，可以使用下面的元注释：

javax.persistence.PersistenceUnit

表示一个对EntityManagerFactory的依赖。属性如下：

u 属性name：在环境引用上下文中（in the environment referencing context,）访问EntityManagerFactory所使用的名字，如果使用依赖注入，就不需要了。默认值是空字符串。

u 属性unitName：在persistence.xml中定义的持久单元的名字。如果要指定，JNDI中使用的实体管理器工厂的持久单元应该和该名字相同。

例如：

@PersistenceUnit

EntityManagerFactory emf;

4.2 通过Persistence类获取

EntityManagerFactory emf = Persistence.createEntityManagerFactory(“OrderEM”);

5、实体管理器的获取

实体管理器的获取可以通过3种方式：

u 注入实体管理器；

u 查找实体管理器；

u 使用实体管理器工厂创建实体管理器。

下面分别介绍。

5.1 注入实体管理器

在应用中可以注入实体管理器，注入实体管理器可以使用下面的元注释：

javax.persistence.PersistenceContext

表示一个对EntityManager持久上下文的依赖。该元注释中的属性如下：

u 属性name：在环境引用上下文中（in the environment referencing context,）访问实体管理器所使用的名字，如果使用依赖注入，就不需要了。默认值是空字符串。

u 属性unitName：持久单元的名字，如果指定了unitName元素，必须与在JNDI中能够访问的实体管理器的持久单元的名字相同。默认值是空字符串。

u 属性type指定事务类型：事务类型包括EXTEDNED（扩展持久上下文）和TRANSACTION（和事务范围的持久上下文）。

n PersistenceContextType.EXTENDED

n 或者PersistenceContextType.TRANSACTION。

u 属性properties：为容器或者持久提供者指定属性。与特定持久性提供厂商相关的属性也可以包含在这组属性中。提供商不识别的属性将被忽略。默认值是{}。

例如：

@PersistenceContext

EntityManager em;

如果在当前应用中有多个持久单元，需要指出持久单元的名字。

5.2 查找实体管理器

通过简单查找查找实体管理器：

声明：@PersistenceContext(name=”orderEM”)

注入SessionContext：@Resource SessionContext ctx;

查找：EntityManager em = (EntityManager)ctx.lookup(“orderEM”);

5.3 通过实体管理器工厂创建实体管理器

实体管理器工厂是EntityManagerFactory的对象，假设实体管理器工厂的对象是emf，创建实体管理器的代码如下：

EntityManager em = emf.createEntityManager();

6、用法

如果在Java SE环境下，需要通过javax.persistence.Persistence创建EntityManagerFactory对象，然后通过EntityManagerFactory对象创建EntityManager对象，然后使用EntityManager对象。

如果在Java EE环境下，除了可以使用上面的方法外，还可以注入EntityManager对象和EntityManagerFactory对象。如果是注入EntityManagerFactory，然后创建EntityManager对象。

教材：《Java EE 5实用教程——基于WebLogic和Eclipse》