JPA——JPA API

1.Persistence:

Persistence类是用于获取EntityManagerFactory实例。该类包含一个名为createEntityManagerFactory的静态方法。

createEntityManagerFactory方法有如下两个重载版本:

--带有一个参数的方法以JPA配置文件persistence.xml中的持久化单元名为参数

--带有两个参数的方法:前一个参数含义相同,后一个参数Map类型,用于设置JPA的相关属性,这时将忽略其他地方设置的属性。Map对象的属性名必须是JPA实现库提供商的名字空间约定的属性名。

2.EntityManagerFactory:

EntityManagerFactory接口主要用来创建EntityManager实例。该接口约定了如下4个方法:

--createEntityManager():用于创建实体管理器对象实例。

-createEntityManager(Map map):用于创建实体管理器对象实例的重载方法,Map参数用于提供EntityManager的属性。

--isOpen():检查EntityManagerFactory是否处于打开状态。实体管理器工厂创建后一直处于打开状态,除非调用close()方法将其关闭。

--close():关闭EntityManagerFactory。

EntityManagerFactory关闭后将释放所有资源,isOpen()测试将返回false,其他方法将不能调用,否则将导致IllegalStateException异常。

3.EntityManager:

find(Class<T> entityClass,Object primaryKey):EntityManager在调用find方法的同时就会发送SQL语句,返回的也是一个实体类。这个方法类似于Hibernate中Session的get方法,例如:

Customer customer = entityManager.find(Customer.class, 1);

getReference(Class<T> entityClass,Object primaryKey):与find类似,只不过他是在调用查询出来的结果的时候才会去发送SQL语句。类似于Hibernate中Session的load方法。这个方法可能会出现懒加载异常的问题,也就是在调用结果之前,可能EntityManager就已经关了。

persistence(Object entity):使得对象由临时状态变为持久化状态,但是和Hibernate中Session的save方法有些许不同,若对象有id,则不能执行insert操作,而会抛出异常。

remove(Object entity):把对象对应的记录从数据库中移除,但是该方法只能移除持久化对象。类似于Hibernate中Session的delete方法,但是delete方法实际上还可以移除游离对象。

merge(T entity):merge()用于处理Entity同步。即数据库的插入和更新操作,类似于Hibernate中Session的saveOrUpdate方法。

--若传入的是一个临时对象,会创建一个新的对象,把临时对象的属性复制到新的对象中,然后对新的对象执行持久化操作。所以新的对象中有id(主键),但以前的临时对象中没有id。

--若传入的是一个游离对象,即传入的对象有OID。若在EntityManager缓存中没有该对象,若在数据库中也没有对应的记录,JPA会创建一个新的对象,然后把当前游离对象的属性复制到新创建的对象中,对新创建的对象执行insert操作。

--若传入的是一个游离对象,即传入的对象有OID。若在EntityManager缓存中没有该对象,若在数据库中有对应的记录,JPA会查询对应的记录,然后返回该记录对应的对象,再然后会把游离对象的属性复制到查询到对象中,对查询到的对象执行update操作。

--若传入的是一个游离对象,即传入的对象有OID。若在EntityManager缓存中有对应对象,JPA会把游离对象的属性复制到查询到EntityManager缓存中的对象中,EntityManager缓存中的对象执行UPDATE。这种情况在Hibernate中的Session是不被允许的,因为Session不能和两个id相同的对象关联,虽然EntityManager也不允许,但是EntityManager是以另一个机制去实现的。

JPA中实体的状态分为一下几种:

--新建状态:新创建的对象,尚未拥有持久型主键。

--持久化状态:已经拥有持久化主键并和持久化建立了上下文环境。

--游离状态:拥有持久化主键,但是没有与持久化建立上下文环境。

--删除状态:拥有持久化主键,已经和持久化建立上下文环境,但是从数据库中删除。

flush():强制发送SQL语句,同步持久上下文环境,即将持久上下文环境的所有未保存实体的状态信息保存到数据库中。这一步一般会在事务提交的时候完成,flush完成的这一步与事务提交时差不多,但是完成flush方法的时候数据库里的数据还不会改变,因为事务还没有提交。

setFlushMode(FlushModeType flushMode):设置持久上下文环境的Flush模式。参数可以取2个枚举。

--FlushModeType.AUTO为自动更新数据库实体,

--FlushModeType.COMMIT为直到提交事务时才更新数据库记录。

getFlushMode():湖区持久上下文环境的Flush模式。返回FlushModeType类的枚举值。

refresh(Object entity):也是强制发送SQL语句,用数据库实体记录的值更新实体对象的状态,即更新实例的属性值。和Hibernate中Session的refresh方法相同。

clear():清除持久上下文环境,断开所有关联的实体。如果这时还有未提交的更新则会被撤销。

contains(Object entity):判断一个实例是否属于当前持久上下文环境管理的实体。

isOpen():判断当前的实体管理器是否是打开状态。

getTranscation():返回资源层的事务对象。EntityTranscation实例可以用于开始和提交多个事务。

close():关闭实体管理器。之后若调用实体管理器实例的方法或其派生的查询对象的方法都将抛出IllegalstateException异常,除了getTranscation和isOpen方法(返回false)。不过,当与实体管理器关联的事务处于活动状态时,调用close方法后持久上下文将仍处于被管理状态,知道事务完成。

createQuery(String qlString):创建一个查询对象。

createNamedQuery(String name):根据命名的查询语句块创建查询对象。参数为命名的查询语句。

createNativeQuery(String sqlString):使用标准SQL语句创建查询对象。参数为标准SQL语句字符串。

createNativeQuery(String sqls, String resultSetMapping):使用标准SQL语句创建查询对象,并指定返回结果集Map的名称。

4.EntityTransaction:

EntityTransaction接口用来管理资源层实体管理器的事务操作。通过调用实体管理器的getTransaction方法获得其实例。

begin():用于启动一个事务,此后的多个数据库操作将作为整体被提交或撤销。若这时事务以启动则会抛出IllegalStateException异常。

commit():用于提交当前事务。即将事务启动以后的所有数据库更新操作持久化至数据库中。

rollback():撤销(回滚)当前事务。即撤销事务启动后的所有数据库更新操作,从而不对数据库产生影响。

setRollbackOnly():使当前事务只能被撤销。

getRollbackOnly():查看当前事务是否设置了只能撤销标志。

isActive():查看当前事务是否是活动的。如果返回true则不能调用begin方法,否则将抛出IllegalStateException异常;如果返回false则不能调用commit、rollback、setRollbackOnly及getRollbackOnly方法,否则将抛出IllegalStateException异常。

猜你喜欢

转载自blog.csdn.net/qq_38386085/article/details/83585073
JPA