JPA相关接口/类
Persistence
1. 作用:通过createEntityManagerFactory的静态方法,获取EntityManagerFactory(实体管理器工厂)实例。
1) 带有一个参数:以JPA配置文件presistence.xml中持久化单元名为参数。使用presistence.xml文件中设置的属性。
2) 带有两个参数:第一个参数同上,第二个参数是一个Map类型用于设置JPA的相关属性,这时将忽略其他地方设置的属性。
EntityManagerFactory
1. 作用:用来创建EntityManager实例。EntityManagerFactory使用如下方法获得EntityManager实例。
1) createEntityManager():用于创建实体管理器对象实例(常用)。
2) createEntityManager(Map map):用于创建实体管理器对象实例的重载方法,Map 参数用于提供 EntityManager的属性。
3) isOpen():检查 EntityManagerFactory 是否处于打开状态。实体管理器工厂创建后一直处于打开状态,除非调用close()方法将其关闭。
4) close():关闭 EntityManagerFactory 。 EntityManagerFactory 关闭后将释放所有资源,isOpen()方法测试将返回 false,其它方法将不能调用,否则将导致IllegalStateException异常
EntityManager
1. EntityManager:在一组实体类与底层数据源之间进行 O/R 映射的管理。
2. 作用:是完成持久化操作的核心,即java实体类对象经过EntityManager变为持久化对象。
3. 实体的状态
1) 新建状态: 新创建的对象,尚未拥有持久性主键。
2) 持久化状态:已经拥有持久性主键并和持久化建立了上下文环境
3) 游离状态:拥有持久化主键,但是没有与持久化建立上下文环境
4) 删除状态: 拥有持久化主键,已经和持久化建立上下文环境,但是从数据库中删除。
find(Class<T> entityClass,Object primaryKey)
1. 参数类型:
1) 被查询的实体类类型。
2) 代查找实体的主键。
2. 作用:获得指定ID的实体类对象,若不存在则返回null。
getReference (Class<T> entityClass,ObjectprimaryKey)
1. 作用:类似于懒加载,首先获得实体类的代理对象,只用在用到时才加载。所以如果此 OID在数据库不存在,getReference()不会返回 null 值, 而是抛出异常EntityNotFoundException
persist (Object entity)
1. 作用:使对象由临时状态变为持久化状态。
1) 如果传入 persist() 方法的 Entity 对象已经处于持久化状态,则persist() 方法什么都不做。
2) 如果对删除状态的 Entity 进行 persist() 操作,会转换为持久化状态。
3) 如果对游离状态的实体执行persist() 操作,可能会在 persist() 方法抛出 EntityExistException(也有可能是在flush或事务提交后抛出)。
remove (Object entity)
1. 作用:删除实例,同时会删除相关联的数据库记录。
merge (T entity)
1. 作用:merge() 用于处理 Entity 的同步。即数据库的插入和更新操作。
1) 若传入的是一个临时对象:会创建一个新的对象,把临时对象的属性复制到新的对象中,然后对新的对象执行持久化操作。故新对象有ID,但之前的临时对象没有ID。
2) 若传入的是一个游离对象(对象有ID):若在EntityManager缓存中没有该对象,且在数据库中也没有对应记录,JPA会创建一个新的对象,然后把当前游离对象属性复制到性创建的对象中,ID不会复制,在对新的对象执行insert操作。故新对象与之前对象的ID不同。
3) 若传入的是一个游离对象(对象有ID):若在EntityManager缓存中没有该对象,且在数据库中也有对应的记录,则JPA会查询对应的记录,然后返回该记录对象,再然后会把游离对象的属性复制到查询到的对象中。对查到的对象执行update操作。
4) 若传入的是一个游离对象(对象有ID):若在EntityManager缓存中有对应的对象,JPA会把游离对象的属性复制到查询EntityManager缓存中的对象中,EntityManager缓存中的对象执行UPDATE。
JPA的EntityManager与Hibernate的Session方法异同
功能 | JPA的EntityManager | Hibernate的Session | 区别 |
查找 | find | get |
|
查找(懒加载) | getReference | Load |
|
保存 | persist | save | persist:若对象有 id, 则不能执行 insert 操作, 而会抛出异常. |
删除 | remove | delete | Remove只能移除持久化对象,而Hibernate的delete方法还可以移除游离对象。 |
保存OR更新 | merge | saveOrUpdate |
|
刷新 | refresh flush | refresh flush |
|
EntityTransaction
begin()
用于启动一个事务,此后的多个数据库操作将作为整体被提交或撤消。若这时事务已启动则会抛出 IllegalStateException 异常。
commit()
用于提交当前事务。即将事务启动以后的所有数据库更新操作持久化至数据库中。