JPA基本API描述
JPA(Java Persistence API,Java持久化API),定义了对象-关系映射(ORM)以及实体对象持久化的标准接口。
JPA是JSR-220(EJB3.0)规范的一部分,在JSR-220中规定实体对象(EntityBean)由JPA进行支持。
所以JPA不局限于EJB3.0,而是作为POJO持久化的标准规范,可以脱离容器独立运行,开发和测试更加方便。
下面通过一张图来看一下JPA的基本概念。然后再做简要分析。
注:不是真正意义的UML图啊,只是画着方便就用rose了。
一、EntityManager,EntityManagerFactory,PersistenceContext三者的关系
1、EntityManager和EntityManagerFactory
EntityManager称为实体管理器,它由EntityManagerFactory所创建。EntityManagerFactory,作为EntityManager的工厂,包含有当前O-R映射的元数据信息,每个EntityManagerFactory,可称为一个持久化单元(PersistenceUnit),每个持久化单元可认为是一个数据源的映射(所谓数据源,可理解为一个数据库,我们可以在应用服务器中配置多个数据源,同时使用不同的PersistenceUnit来映射这些数据源,从而能够很方便的实现跨越多个数据库之间的事务操作!)
2、EntityManager和PersistenceContext
PersistenceContext,称为持久化上下文,它一般包含有当前事务范围内的,被管理的实体对象(Entity)的数据。每个EntityManager,都会跟一个PersistenceContext相关联。PersistenceContext中存储的是实体对象的数据,而关系数据库中存储的是记录。
EntityManager正是维护这种OR映射的中间者,它可以把数据从数据库中加载到PersistenceContext中,也可以把数据从PersistenceContext中持久化到数据库。
EntityManager是应用程序操纵持久化数据的接口,EntityManager的接口方法有:
Persist、merge、remove、refresh、flush,
通过这些接口操纵PersistenceContext中的实体对象与数据库数据之间的同步!
这里又牵扯到一个实体对象的生命周期的概念
(1)几种状态
New–即未有id值,尚未跟persistence context建立关联的对象
Managed–有id值,已跟persistence context建立了关联
Detached–有id值,但没有(或不再)跟persistence context建立关联
Removed–有id值,而且跟persistence context尚有关联,但已准备好要从数据库中把它删除。
(2)与EntityManager接口的关系
小小结:EntityManager的作用与hibernate session类似。为了能够在一个请求周期中使用同一个session对象,在hibernate的解决方案中,提出了currentSession的概念,hibernate中的current session,可以跟JTA事务绑定,也可以跟当前线程绑定。在hibernate中,session管理着所有的持久化对象的数据。而在EJB3中,EntityManager管理着PersistenceContext,PersistenceContext正是被管理的持久化对象的集合。
二、EntityManager的管理方式分为两种:
1、容器管理的EntityManager– 通过PersistenceContext注入EntityManager对象,或通过jndi查询到EntityManager
定义方式:
@PersistenceContext(name="test")
private EntityManager em;
容器管理的EntityManager ,它所管理的PersistenceContext的生命周期由PersistenceContextType来配置
(1)Transaction-Scoped PersistenceContext – 由容器创建,随着Transaction而传播,随着Transaction的完成而销毁,对应用程序本身来说,它对persitence context的创建、销毁一无所知,完全自动和透明。当entity manager的方法被调用的时候,如果在当前JTA事务中还没有persistence context,那么将启动一个新的persistence context,并将它跟当前的JTA事务关联。
定义方式:
@PersistenceContext(unitName="myunit", type=PersistenceContextType.TRANSACTION)
private EntityManager em;
如:在Java EE环境下,一个JTA事务通常会横跨多个组件的调用(比如多个EJB组件的方法调用)。这些组件需要能够在单个事务范围内访问到同样的Persistence Context。为了满足这种情况的需要,当EntityManager被注入或通过jndi被查询的时候,它的Persistence Context将会在当前事务范围内自动传播,引用到同一个Persistence unit的EntityManager将使用同样的Persistence Context。这可以避免在不同的组件之间传递EntityManager引用。
(2)Extended-Scoped PersistenceContext – 用于Stateful Session Bean,跨越多个Transaction,随着Stateful Session Bean的销毁而销毁,通常,这可以通过调用一个在stateful session bean中被注解定义为@Remove的方法来结束一个stateful session bean的生命周期。
@PersistenceContext(unitName="test", type=PersistenceContextType.EXTENDED)
private EntityManager em;
2、应用管理的EntityManager– 通过PersistenceUnit注入EntityManagerFactory对象
定义方式:
@PersistenceUnit(unitName="test")
private EntityManagerFactory factory;
应用程序自身需要独立访问Persistence Context。即每次创建一个EntityManager都会迫使创建一个新的Persistence Context。这些Persistence Context即使在同一个事务范围内也不会跟其它EntityManager共享!这个创建过程可以由EntityManagerFactory的createEntityManager方法来创建,通过entityManager.close() / isOpen()方法来管理entityManager及其对应的persistence context.。这被称为应用管理的实体管理器(application-managed entity manager)。
定义方式:
@PersistenceUnit(unitName="test")
private EntityManagerFactory factory;
public void addStudent(String name) {
EntityManager em = factory.createEntityManager();
三、事务实现
EntityManager底层的事务实现可以使用JTA或RESOURCE_LOCAL类型的事务控制策略。
1、JTA和RESOURCE_LOCAL的区别
(1)JTA一般在容器环境中使用,而RESOURCE_LOCAL一般在J2SE的环境下使用。
在J2SE的环境下,由应用程序自身来创建EntityManagerFactory,并由EntityManagerFactory创建EntityManager,通过EntityManager.getTransaction.begin()方法来开启事务,commit()方法提交事务等等,这种方式就是RESOURCE_LOCAL的基本使用方法。
Persistence.XML配置示例:
<persistence-unit name="test" transaction-type="JTA">
JTA常在容器环境下使用,也就是使用JTA类型的EntityManager,这样,EntityManager的调用都是在一个外部的JTA事务环境下进行的,不用手动开启,提交事务等
Persistence.XML配置示例:
<persistence-unit name="test" transaction-type="RESOURCE_LOCAL">
(2)Container-Managed EntityManager必须是JTA类型的EntityManager,而Application-Managed EntityManager则既可以是JTA类型的EntityManager,也可以是RESOURCE_LOCAL类型的EntityManager。
2、JTA事务与普通JDBC事务的区别
(1)JDBC事务,一般由数据库本身来执行提交或回滚操作(单阶段提交)。所有数据库都有自己的事务管理器,管理执行的日志,这些管理器只能处理其自身的事务,称为本地事务。
(2)JTA支持多个数据源,站在更高的角度上,提供一个“事务处理监听器(TPM)”来管理和协调这些数据源之间的事务操作,它必须执行两阶段提交协议(2PC)。
1)准备阶段-TPM向所有RM(资源管理器,即数据库)确认状态,是否可以提交或回滚。
2)提交阶段-TPM确认提交之后,向所有RM发出提交指令或回滚指令
TPM本身会维护事务日志,以保证持久性或灾难恢复等。