JPA的核心API

  本文主要关注几个重要的JPA 相关接口和类。

  (1)  Persistence类

        用于获取EntityManagerFactory的实例，包含一个createEntityManagerFactory的静态方法。该方法有两个重载版本

        a. 带一个参数， 参数是JPA配置文件persistence.xml中的持久化单元名;

        b.带两个参数，前一个参数与a同，后一个参数为Map型，用于设置JPA的相关属性，这时将忽略其他地方设置的属性，且属性名与JPA实现提供商的名字空间约定的属性名相同。

  (2)  EntityManagerFactory 接口

        用于创建EntityManager实例，约定4个方法：

        a. createEntityManager（）   创建实体管理器对象实例；

        b. createEntityManager（Map map）   创建实体管理器对象实例重载方法，map用于提供EntityManager的属性

        c. isOpen()   检查EntityManagerFactory是否处于open state

        d. close()   close EntityManagerFactory， 将释放所有资源，isOpen（）返回false，其他方法不能调用，否则IllegalStateException。

  (3)  EntityManager

       是JPA中完成持久化操作的核心对象，对一组实体类和底层数据源之间进行O/R映射的管理。

       声明的实体通常为POJO对象，只有在调用EntityManager将其持久化后才会变成持久化对象，可以管理Entity Bean，根据主键查找，以及JPQL查询。

       实体的几种状态：

            新建实体：  新创建的对象，尚未拥有持久化主键；

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

            游离态：      已经拥有持久化主键并但没有和持久化建立了上下文环境

            删除状态：   已经拥有持久化主键并和持久化建立了上下文环境，但已经从数据库中删除。

      对实体类的管理：

           find（Class<T> entityClass, Object pk ）     //若实体存在当前持久化环境，则返回被缓存的对象；若不存在，则创建一个新的Entity,并加载数据库中相关信息，若不存在数据库中，return null 。

           getReference（Class<T> entityClass, Object pk ）  //与find方法类似， 但不存在Entity会创建Entity类的proxy，不会立即加载数据库信息，如果在数据库中不存在OID，不返回NUll， 抛出异常。

           persist（Object entity）   //entity对象转化为持久态

           remove（Object entity）   //delete 

           merge（T entity）   //save and update

           flush()    //同步持久上下文环境   

           setFlushMode(FlushModeType flushMode)   //设置持久化上下文的Flush模式

           getFlushMode()      //获取持久化上下文环境的Flush模式

           refresh(Object entity)    //数据库尸体记录的值更新实体对象的状态

           clear()  contains(Object entity) isOpen()  close()  等， 使用频率较低

           与JPQL相关的方法：

           createQuery(String jpql)   //创建一个查询对象

           createNamedQuery(String name)  //根据命名的查询语句块创建查询对象

           createNativeQuery(String jpql)    //使用标准SQL语句创建查询对象

           createNativeQuery(String jpql， String resultSetMapping)  //使用标准SQL语句创建查询对象，指定返回结果集Map的名称

  (4)  EntityTransaction   

        该接口用来管理资源层实体管理器的事务操作，通过调用实体管理器getTransaction()的方法 获得实例

        常用方法：

           begin()     //启动事务

           commit()   //提交当前事务

           rollback()   //回滚当前事务

           isActive()    //查看当前事务的状态，true 则不可调用begin(),false 则不可调用其他方法，否者均会抛出 IllegalStateException异常。