文章目录
1.介绍
1.1 JPA是什么?
Java Persistence API
:用于对象持久化的 API- Java EE 5.0 平台标准的 ORM 规范,使得应用程序以统一的方式访问持久层
- JPA本身是一种规范,它的本质是一种ORM规范(不是ORM框架,因为JPA并未提供ORM实现,只是制定了规范)因为JPA是一种规范,所以,只是提供了一些相关的接口,但是接口并不能直接使用,JPA底层需要某种JPA实现,JPA现在就是Hibernate功能的一个子集
1.2 JPA和Hibernate关系
- JPA 是 hibernate 的一个抽象(就像JDBC和JDBC驱动的关系):
- JPA 是规范:JPA 本质上就是一种 ORM 规范,不是ORM 框架 —— 因为 JPA 并未提供 ORM 实现,它只是制订了一些规范,提供了一些编程的 API 接口,但具体实现则由 ORM 厂商提供实现
- Hibernate 是实现:Hibernate 除了作为 ORM 框架之外,它也是一种 JPA 实现
- 从功能上来说, JPA 是 Hibernate 功能的一个子集
1.3 JPA优势
标准化
: 提供相同的 API,这保证了基于JPA 开发的企业应用能够经过少量的修改就能够在不同的 JPA 框架下运行。简单易用
,集成方便: JPA 的主要目标之一就是提供更加简单的编程模型,在 JPA 框架下创建实体和创建 Java 类一样简单,只需要使用 javax.persistence.Entity 进行注释;JPA 的框架和接口也都非常简单,可媲美JDBC的查询能力
: JPA的查询语言是面向对象的,JPA定义了独特的JPQL,而且能够支持批量更新和修改、JOIN、GROUP BY、HAVING 等通常只有 SQL 才能够提供的高级查询特性,甚至还能够支持子查询。支持面向对象的高级特性
: JPA 中能够支持面向对象的高级特性,如类之间的继承、多态和类之间的复杂关系,最大限度的使用面向对象的模型
换句话说,为啥只用JPA而不用Hibernate呢?这是因为hibernate对jpa的支持,不是另提供了一套专用于jpa的注解。一些重要的注解如Column, OneToMany等,hibernate没有提供,这说明jpa的注解已经是hibernate 的核心,hibernate只提供了一些补充,而不是两套注解。
hibernate不只实现了JPA的整套功能,还在此基础上增加了一些额外的功能,若JPA提供的功能够我们用了,我们就可以直接用JPA,而且以后切换到另外实现类也很方便,若用Hibernate的话,需要学习一写它的用法,增加了学习成本,而且不利于切换到JPA其他实现版本上去
2.使用
2.1 helloword
JPA的persistence.xml文件
JPA持久化persistence.xml配置文件及参数详解
3.注解
3.1 常用注解
@Entity
@Id
@Table
@Basic
@Column
@GeneratedValue
3.2 特殊注解
@Temporal
@Transient
4.常用API类
4.1 Persistence
Persistence
类是用于获取 EntityManagerFactory 实例。该类包含一个名为createEntityManagerFactory 的 静态方法 。
createEntityManagerFactory 方法有如下两个重载版本。
- 带有一个参数的方法以 JPA 配置文件 persistence.xml 中的持久化单元名为参数
- 带有两个参数的方法:前一个参数含义相同,后一个参数 Map类型,用于设置 JPA 的相关属性,这时将忽略其它地方设置的属性。Map 对象的属性名必须是 JPA 实现库提供商的名字空间约定的属性名。
4.2 EntityManagerFactory
EntityManagerFactory 接口主要用来创建 EntityManager 实例
。该接口约定了如下4个方法:
- createEntityManager():用于创建实体管理器对象实例。
- createEntityManager(Map map):用于创建实体管理器对象实例的重载方法,Map 参数用于提供 EntityManager 的属性。
- isOpen():检查 EntityManagerFactory 是否处于打开状态。实体管理器工厂创建后一直处于打开状态,除非调用close()方法将其关闭。
- close():关闭 EntityManagerFactory 。 EntityManagerFactory 关闭后将释放所有资源,isOpen()方法测试将返回 false,其它方法将不能调用,否则将导致IllegalStateException异常。
4.3 EntityManager
在 JPA 规范中, EntityManager 是完成持久化操作的核心对象。实体作为普通 Java 对象,只有在调用 EntityManager 将其持久化后才会变成持久化对象。
EntityManager 对象在一组实体类与底层数据源之间进行 O/R 映射的管理。它可以用来管理和更新 Entity Bean, 根椐主键查找 Entity Bean, 还可以通过JPQL语句查询实体。
实体的状态:
- 新建状态: 新创建的对象,
尚未拥有持久性主键
,还未和Persistence Context建立关联的对象。比如new一个对象 - 持久化状态:
有id值,已经和Persistence Context建立了关联
的对象。比如find查询出来的对象 - 游离状态:
有id值
,但没有和Persistence Context建立关联
的对象。比如new一个对象,然后给这个对象设置一个ID值 - 删除状态:
拥有持久化主键
,已经和持久化建立Persistence Context上下文环境
,但是从数据库中删除
。
主要方法:
find
(Class entityClass,Object primaryKey):返回指定的 OID 对应的实体类对象,如果这个实体存在于当前的持久化环境,则返回一个被缓存的对象;否则会创建一个新的 Entity, 并加载数据库中相关信息;若 OID 不存在于数据库中,则返回一个 null。第一个参数为被查询的实体类类型,第二个参数为待查找实体的主键值。getReference
(Class entityClass,Object primaryKey):与find()方法类似,不同的是:如果缓存中不存在指定的 Entity, EntityManager 会创建一个 Entity 类的代理,但是不会立即加载数据库中的信息,只有第一次真正使用此 Entity 的属性才加载,所以如果此 OID 在数据库不存在,getReference() 不会返回 null 值, 而是抛出EntityNotFoundExceptionpersist
(Object entity):用于将新创建的 Entity 纳入到 EntityManager 的管理。该方法执行后,传入 persist() 方法的 Entity 对象转换成持久化状态。
如果传入 persist() 方法的 Entity 对象已经处于持久化状态,则 persist() 方法什么都不做。
如果对删除状态的 Entity 进行 persist() 操作,会转换为持久化状态。
如果对游离状态的实体执行 persist() 操作,可能会在 persist() 方法抛出 EntityExistException(也有可能是在flush或事务提交后抛出)。remove
(Object entity):删除实例。如果实例是被管理的,即与数据库实体记录关联,则同时会删除关联的数据库记录。merge
(T entity):merge() 用于处理 Entity 的同步。即数据库的插入和更新操作flush ()
:同步持久上下文环境,即将持久上下文环境的所有未保存实体的状态信息保存到数据库中。setFlushMode
(FlushModeType flushMode):设置持久上下文环境的Flush模式。参数可以取2个枚举
FlushModeType.AUTO 为自动更新数据库实体,
FlushModeType.COMMIT 为直到提交事务时才更新数据库记录。getFlushMode ()
:获取持久上下文环境的Flush模式。返回FlushModeType类的枚举值。refresh (Object entity)
:用数据库实体记录的值更新实体对象的状态,即更新实例的属性值。clear ()
:清除持久上下文环境,断开所有关联的实体。如果这时还有未提交的更新则会被撤消。contains
(Object entity):判断一个实例是否属于当前持久上下文环境管理的实体。isOpen
():判断当前的实体管理器是否是打开状态。getTransaction
():返回资源层的事务对象。EntityTransaction实例可以用于开始和提交多个事务。close
():关闭实体管理器。之后若调用实体管理器实例的方法或其派生的查询对象的方法都将抛出 IllegalstateException 异常,除了getTransaction 和 isOpen方法(返回 false)。不过,当与实体管理器关联的事务处于活动状态时,调用 close 方法后持久上下文将仍处于被管理状态,直到事务完成。createQuery
(String qlString):创建一个查询对象。createNamedQuery
(String name):根据命名的查询语句块创建查询对象。参数为命名的查询语句。createNativeQuery
(String sqlString):使用标准 SQL语句创建查询对象。参数为标准SQL语句字符串。createNativeQuery
(String sqls, String resultSetMapping):使用标准SQL语句创建查询对象,并指定返回结果集 Map的 名称。
举例:
public class TestJpa2 {
private EntityManagerFactory entityManagerFactory;
private EntityManager entityManager;
private EntityTransaction transaction;
@Before
public void init(){
entityManagerFactory = Persistence.createEntityManagerFactory("myjpa");
entityManager = entityManagerFactory.createEntityManager();
transaction = entityManager.getTransaction();
transaction.begin();
}
@After
public void destroy(){
transaction.commit();
entityManager.close();
entityManagerFactory.close();
}
@Test
public void testXXXX() {
XXXXX
}
}
4.3.1 find
//类似于 hibernate 中 Session 的 get 方法.
@Test
public void testFind() {
Person person = entityManager.find(Person.class, 2);
System.out.println("person = " + person);
}
4.3.2 getReference
//类似于 hibernate 中 Session 的 load 方法
@Test
public void testGetReference(){
Person person = entityManager.getReference(Person.class, 2);
System.out.println("代理类:"+person.getClass().getName());
System.out.println("------------------使用的时候才执行sql再加载-------------------");
System.out.println(person);
}
4.3.3 persist
//类似于 hibernate 的 save 方法. 使对象由临时状态变为持久化状态.
//和 hibernate 的 save 方法的不同之处: 若对象有 id, 则不能执行 insert 操作, 而会抛出异常.
@Test
public void testPersistence(){
Person person = new Person();
person.setPname("saveOb");
// person.setPid(3); 若这里指定了主键ID,若数据库中有一样ID,就会报错
entityManager.persist(person);
//持久化后,这个类就有ID了
System.out.println(person.getPid());
}
4.3.4 remove
//类似于 hibernate 中 Session 的 delete 方法. 把对象对应的记录从数据库中移除
//但注意: 该方法只能移除 持久化 对象. 而 hibernate 的 delete 方法实际上还可以移除 游离对象.
@Test
public void testRemove(){
/*
Person person = new Person();
person.setPid(1);
entityManager.remove(person);
会报:Removing a detached instance com.zy.entity.Person#1
*/
//先查再删,就不会报错
Person person = entityManager.find(Person.class, 1);
entityManager.remove(person);
}
4.3.5 merge
//若传入的是一个游离对象, 即传入的对象有 OID.
//1. 若在 EntityManager 缓存中没有该对象
//2. 若在数据库中也没有对应的记录
//3. JPA 会创建一个新的对象, 然后把当前游离对象的属性复制到新创建的对象中
//4. 对新创建的对象执行 insert 操作.
@Test
public void testMerge2(){
Person person = new Person();
person.setPname("ffff");
//其实person1是一个新建的对象,用于和数据库中对应
Person person1 = entityManager.merge(person);
System.out.println("新建一个对象-person#id:" + person.getPid());
System.out.println("保存后的对象-person1#id:" + person1.getPid());
}
//若传入的是一个游离对象, 即传入的对象有 OID.
//1. 若在 EntityManager 缓存中没有该对象
//2. 若在数据库中也有对应的记录
//3. JPA 会查询对应的记录, 然后返回该记录对一个的对象, 再然后会把游离对象的属性复制到查询到的对象中.
//4. 对查询到的对象执行 update 操作.
@Test
public void testMerge3(){
//游离对象,这里会把pname属性www更新到数据库
Person person = new Person();
person.setPname("www");
person.setPid(4);
//查出来的持久对象
Person person1 = entityManager.merge(person);
System.out.println(person == person1); //false
}
//若传入的是一个游离对象, 即传入的对象有 OID.
//1. 若在 EntityManager 缓存中有对应的对象
//2. JPA 会把游离对象的属性复制到查询到EntityManager 缓存中的对象中.
//3. EntityManager 缓存中的对象执行 UPDATE.
@Test
public void testMerge4(){
Person person = new Person();
person.setPname("mmm");
person.setPid(4);
Person person1 = entityManager.find(Person.class, 4);
System.out.println("name1 = " + person1.getPname());
//用游离态person更新person1,然后再更新数据库
entityManager.merge(person);
System.out.println(person1 == person); //false
//这里会看到,数据库保存成mmm后,person1也都改了
System.out.println("name2 = " + person1.getPname());
}
4.3.6 flush
/**
* 同 hibernate 中 Session 的 flush 方法.
*/
@Test
public void testFlush(){
Person person = entityManager.find(Person.class, 4);
System.out.println(person);
person.setPname("flush");
//会触发sql执行
entityManager.flush();
System.out.println();
}
4.3.7 refresh
/**
* 同 hibernate 中 Session 的 refresh 方法.
*/
@Test
public void testRefresh(){
//虽然连续执行find方法2次,但sql查询实际只执行一次
Person person = entityManager.find(Person.class, 4);
person = entityManager.find(Person.class, 4);
//使用refresh,会强制再执行一遍查询sql,用于同步数据库数据到当前实体类里
entityManager.refresh(person);
}
4.3.8
4.4 EntityTransaction
EntityTransaction 接口 用来管理资源层实体管理器的事务操作。
通过调用实体管理器的getTransaction
方法 获得其实例。
- begin ()
用于启动一个事务,此后的多个数据库操作将作为整体被提交或撤消。若这时事务已启动则会抛出 IllegalStateException 异常。 - commit ()
用于提交当前事务。即将事务启动以后的所有数据库更新操作持久化至数据库中。 - rollback ()
撤消(回滚)当前事务。即撤消事务启动后的所有数据库更新操作,从而不对数据库产生影响。 - setRollbackOnly ()
使当前事务只能被撤消。 - getRollbackOnly ()
查看当前事务是否设置了只能撤消标志。 - isActive ()
查看当前事务是否是活动的。如果返回true则不能调用begin方法,否则将抛出 IllegalStateException 异常;如果返回 false 则不能调用 commit、rollback、setRollbackOnly 及 getRollbackOnly 方法,否则将抛出 IllegalStateException 异常。
transaction = entityManager.getTransaction();
transaction.begin();
transaction.commit();