JPA: Java Persistence API
是从EJB3.0才有的新技术,开始于Java EE 5.0 它可以和EJB一起使用, 也可以独立使用, 比如在Web层,或者Java SE中使用。
JPA是一个接口.
不同的服务器提供不同的实现, JBoss用Hibernate, Websphere用OpenJPA
JPA包含三大功能
1.ORM映射元数据
JPA支持XML和JDK5.0注解两种元数据的形式,元数据描述对象和表之间的映射关系,框架据此将实体对象持久化到数据库表中;
简单来说就是,Class与数据库表一一映射。
2.JPA 的API
用来操作实体对象,执行CRUD操作,框架在后台替我们完成所有的事情,开发者从繁琐的JDBC和SQL代码中解脱出来。
EntityManager提供增删改查的方法,用这些就不用写SQL语句了。
persist()
merge()
remove()
refresh()
find()
getReference() .......
3. 查询语言
这是持久化操作中很重要的一个方面,通过面向对象而非面向数据库的查询语言查询数据,避免程序的SQL语句紧密耦合。
JPQL, 一种面向对象的查询语言,与Hibernate的HQL类似。 最后会转换成SQL
JPA的一大好处在于可以分离于容器运行, 就是不用EJB容器也能用。
Cascade是可以嵌套的, 就是说如果Object A对B是Cascade.REMOVE, B对C是Cascade.REMOVE, 那么在删除A的时候会删除对应的B, 也会删除对应的C
JPA中最重要的概念是EntityManager称为实体管理器,它由EntityManagerFactory所创建。EntityManagerFactory,作为EntityManager的工厂,包含有当前O-R映射的元数据信息,每个EntityManagerFactory,可称为一个持久化单元(PersistenceUnit),每个持久化单元可认为是一个数据源的映射(所谓数据源,可理解为一个数据库,我们可以在应用服务器中配置多个数据源,同时使用不同的PersistenceUnit来映射这些数据源,从而能够很方便的实现跨越多个数据库之间的事务操作!)PersistenceContext,称为持久化上下文,它一般包含有当前事务范围内的,被管理的实体对象(Entity)的数据。每个EntityManager,都会跟一个PersistenceContext相关联。PersistenceContext中存储的是实体对象的数据,而关系数据库中存储的是记录,EntityManager正是维护这种OR映射的中间者,它可以把数据从数据库中加载到PersistenceContext中,也可以把数据从PersistenceContext中持久化到数据库,EntityManager通过Persist、merge、remove、refresh、flush等操作来操纵PersistenceContext与数据库数据之间的同步!
在Java EE环境下,一个JTA事务通常会横跨多个组件的调用(比如多个EJB组件的方法调用)。这些组件需要能够在单个事务范围内访问到同样的Persistence Context。为了满足这种情况的需要,当EntityManager被注入或通过jndi被查询的时候,它的Persistence Context将会在当前事务范围内自动传播,引用到同一个Persistence unit的EntityManager将使用同样的Persistence Context。这可以避免在不同的组件之间传递EntityManager引用。
通过容器来传递PersistenceContext,而不是应用程序自己来传递EntityManager。这种方式(由容器管理着PersistenceContext,并负责传递到不同的EntityManager)称为容器管理的实体管理器(Container-Managed EntityManager),它的生命周期由容器负责管理。
有一种不常见的情况是,应用程序自身需要独立访问Persistence Context。即每次创建一个EntityManager都会迫使创建一个新的Persistence Context。这些Persistence Context即使在同一个事务范围内也不会跟其它EntityManager共享!这个创建过程可以由EntityManagerFactory的createEntityManager方法来创建。这被称为应用管理的实体管理器(application-managed entity manager)。
底层事务控制
EntityManager的底层可以使用JTA或RESOURCE_LOCAL类型的事务控制策略。JTA一般在容器环境中使用,而RESOURCE_LOCAL一般在J2SE的环境下使用。
比如,在J2SE的环境下,由应用程序自身来创建EntityManagerFactory,并由EntityManagerFactory创建EntityManager,通过EntityManager.getTransaction.begin()方法来开启事务,commit()方法提交事务等等,这种方式就是RESOURCE_LOCAL的基本使用方法。
最常用的就是在容器环境下使用。也就是使用JTA类型的EntityManager,这样,EntityManager的调用都是在一个外部的JTA事务环境下进行的。
Container-Managed EntityManager必须是JTA类型的EntityManager,而Application-Managed EntityManager则既可以是JTA类型的EntityManager,也可以是RESOURCE_LOCAL类型的EntityManager。
配置示例: in persistence.xml
<persistence-unit name="test" transaction-type="JTA">
Container-Managed Persistence ContextCode 示例:
@PersistenceContext(unitName="test")
private EntityManager em;
persistence context的生命周期对应用程序来说,总是被自动、透明的管理着的。也就是对应用程序本身来说,它对persitence context的创建、销毁一无所知,完全自动和透明。Persistence context随着JTA事务而传播。
Application-Managed Persistence Context
即当我们自己创建EntityManager的时候,我们通过entityManager.close() / isOpen()方法来管理entityManager及其对应的persistence context.
实体对象的生命周期
几种类型:New,managed,detached,removed
New – 即未有id值,尚未跟persistence context建立关联的对象
Managed – 有id值,已跟persistence context建立了关联
Detached – 有id值,但没有(或不再)跟persistence context建立关联
Removed – 有id值,而且跟persistence context尚有关联,但已准备好要从数据库中把它删除。
EntityManager的接口方法
添加:调用persist方法
* 将把一个对象持久化,如果对象的ID非空,则在调用persist方法时将抛出异常,无法持久化
删除:remove方法
不能直接new一个对象,然后给它的id赋值,然后删除。要删除一个对象,这个对象必须是处于持久化状态。
更新:merge方法
Find – 查找某个对象,如果查不到该对象,将返回null,相当于get
getReference – 查找某个对象,如果查找不到该对象,将抛出异常,相当于load
flush – 将实体对象由persistence context同步到底层的数据库
l FlushMode
n Auto – 即在同一个事务中,在查询发生前,将自动把数据从PersistenceContext持久化到数据库中。
n Commit – 只在提交的时候,把数据从PersistenceContext中持久化到数据库中。如果设置FlushMode为commit,那么在同一个事务中,在查询之前,如果有更新的数据,这些数据是否会影响到查询的结果,这种情况,EJB3未作说明。
Lock – 锁定某个实体对象
实际上就是定义事务的隔离级别。总共有两种形式:READ和WRITE,表示:
不管是READ还是WRITE,都应该能够避免脏读(读到另外一个事务未提交的数据)和不可重复读(同一查询在同一事务中多次进行,由于其他提交事务所做的修改或删除,每次返回不同的结果集,此时发生非重复读。)
而对于WRITE来说,还应该能够强迫版本号的增加(对那些标识了版本的对象而言)。因此,其它事务无法对其做任何更改操作!
Refresh – 将数据从数据库中加载到Persistenc Context。
Clear – 清除Persistence Context中缓存的实体对象数据
Contains – 测试当前Persistence Context中是否包含某实体对象
如何注入EntityManager对象?
1、首先要确保persistence.xml中已定义了相应的persistence-unit,比如:<?xml version="1.0" encoding="UTF-8"?>
<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="test" transaction-type="JTA">
<jta-data-source>java:/MySqlDS</jta-data-source>
<properties>
<property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>
<property name="hibernate.hbm2ddl.auto" value="create"/>
<property name="hibernate.show_sql" value="true"/>
</properties>
</persistence-unit>
</persistence>
2、在session bean中(如果用EJB),直接定义EntityManager,并使用@PersistenceContext注解注入即可:
如果用spring, 则是service
@Stateless(name="userManager")
public class UserManagerImpl implements UserManager {
/**
* 如果只定义了一个Persistence Unit,则无需指定unitName,但一旦定义了
* 多个,则必须指定unitName
*/
@PersistenceContext(unitName="test")
private EntityManager em;
如何由应用程序来管理EntityManager?
我们一般情况下,都不需要由应用程序自身来管理EntityManager,最好就是使用容器管理的EntityManager对象。但某些特殊情况下,我们可能想要由应用程序本身来管理它,那么,可以采取如下方法来办到这一点。
1、注入EntityManagerFactory对象
/**
* 也可以注入EntityManagerFactory,手工管理PersistenceContext
*/
@PersistenceUnit(unitName="test")
private EntityManagerFactory factory;
2、在程序中,用factory来创建和管理EntityManager对象
EntityManager em = factory.createEntityManager();
Student student = new Student();
student.setName("张三");
em.persist(student);
em.close();
更详细请参阅: http://www.cnblogs.com/-10086/archive/2012/09/16/2687550.html