JPA 教程（三）

最新推荐文章于 2024-09-03 08:16:34 发布

半缘君

最新推荐文章于 2024-09-03 08:16:34 发布

阅读量2.2k

点赞数

分类专栏： JPA 文章标签： jpa java query 数据库 sql 应用服务器

JPA 专栏收录该内容

5 篇文章 0 订阅

订阅专栏

JPA的编程结构及重要的API

JavaEE 5.0中所定义的JPA接口个数并不多，它们位于javax.persistence和javax.persistence.spi两个包中。 javax.persistence包中大部分API都是注解类，除此之外还包括EntityManager、Query等持久化操作接口。

而 javax.persistence.spi包中的4个API，是JPA的服务层接口。

下面，我们就来认识一下这些重要的接口

EntityManager的类型实体对象由实体管理器进行管理，JPA使用javax.persistence.EntityManager代表实体管理器。

实体管理器和持久化上下文关联，持久化上下文是一系列实体的管理环境，我们通过EntityManager和持久化上下文进行交互。

有两种类型的实体管理器：

容器型： 容器型的实体管理器由容器负责实体管理器之间的协作，在一个JTA事务中，一个实体管理器的持久化上下文的状态会自动广播到所有使用EntityManager的应用程序组件中。Java EE应用服务器提供的就是管理型的实体管理器；

应用程序型： 实体管理器的生命周期由应用程序控制，应用程序通过javax.persistence.EntityManagerFactory的createEntityManager创建EntityManager实例。

EntityManager的创建过程
javax.persistence.spi.PersistenceProvider接口由JPA的实现者提供，该接口由启动者调用，以便创建一个EntityManagerFactory实例。

它定义了创建一个EntityManagerFactory实例的方法：
EntityManagerFactorycreateContainerEntityManagerFactory(PersistenceUnitInfo info, Map map)
javax.persistence.spi.PersistenceUnitInfo入参提供了创建实体管理器所需要的所有信息，这些信息根据JPA的规范，必须放置在META-INF/persistence.xml文件中。

PersistenceUnitInfo接口拥有了一个void addTransformer(ClassTransformer transformer)方法，通过该方式可以添加一个javax.persistence.spi.ClassTransformer，并通过 PersistenceProvider开放给容器，以便容器在实体类文件加载到JVM之前进行代码的增强，使元数据生效。

JPA厂商负责提供 ClassTransformer接口的实现。

实体的状态
实体对象拥有以下4个状态，这些状态通过调用EntityManager接口方法发生迁移：
新建态： 新创建的实体对象，尚未拥有持久化主键，没有和一个持久化上下文关联起来。

受控态： 已经拥有持久化主键并和持久化上下文建立了联系；

游离态： 拥有持久化主键，但尚未和持久化上下文建立联系；

删除态： 拥有持久化主键，已经和持久化上下文建立联系，但已经被安排从数据库中删除。

EntityManager 的API

    Java代码   
    
 void persist(Object entity)

通过调用EntityManager的persist()方法，新实体实例将转换为受控状态。这意谓着当persist ()方法所在的事务提交时，实体的数据将保存到数据库中。如果实体已经被持久化，那么调用persist()操作不会发生任何事情。如果对一个已经删除的实体调用persist()操作，删除态的实体又转变为受控态。如果对游离状的实体执行persist()操作，将抛出 IllegalArgumentException。

在一个实体上调用persist()操作，将广播到和实体关联的实体上，执行相应的级联持久化操作；

    Java代码   
    
 void remove(Object entity)

通过调用remove()方法删除一个受控的实体。如果实体声明为级联删除(cascade=REMOVE 或者cascade=ALL )，被关联的实体也会被删除。在一个新建状态的实体上调用remove()操作，将被忽略。如果在游离实体上调用remove()操作，将抛出 IllegalArgumentException，相关的事务将回滚。如果在已经删除的实体上执行remove()操作，也会被忽略；

    Java代码   
    
 void flush()

将受控态的实体数据同步到数据库中；

    Java代码   
    
 T merge(T entity)

将一个游离态的实体持久化到数据库中，并转换为受控态的实体；

    Java代码   
    
 T find(Class entityClass, Object primaryKey)

以主键查询实体对象，entityClass是实体的类，primaryKey是主键值，如以下的代码查询Topic实体：

    Java代码   
    
  
 Topic t = em.find(Topic.class,1);  
 Query createQuery(String qlString)  

Query
JPA使用javax.persistence.Query接口代表一个查询实例，Query实例由EntityManager通过指定查询语句构建。该接口拥有众多执行数据查询的接口方法：
◆Object getSingleResult()：执行SELECT查询语句，并返回一个结果；

◆List getResultList() ：执行SELECT查询语句，并返回多个结果；

◆Query setParameter(int position, Object value)：通过参数位置号绑定查询语句中的参数，如果查询语句使用了命令参数，则可以使用Query setParameter(String name, Object value)方法绑定命名参数；

◆Query setMaxResults(int maxResult)：设置返回的最大结果数；

◆int executeUpdate()：如果查询语句是新增、删除或更改的语句，通过该方法执行更新操作；

JPA的查询语言
JPA的查询语言是面向对象而非面向数据库的，它以面向对象的自然语法构造查询语句 ，可以看成是Hibernate HQL的等价物。

    Sql代码   
    
 SELECT DISTINCT t FROM Topic t WHERE t.topicTitle = ?1

通过WHERE指定查询条件，?1表示用位置标识参数，尔后，我们可以通过Query的setParameter(1, "主题1")绑定参数。而DISTINCT表示过滤掉重复的数据。

如果需要以命名绑定绑定数据，可以改成以下的方式：

    Sql代码   
    
 SELECT DISTINCT t FROM Topic t WHERE t.topicTitle = :title

这时，需要通过Query的setParameter("title", "主题1")绑定参数。

关联查询：从One的一方关联到Many的一方

返回PollOptions对应的PollTopic对象，可以使用以下语句：

    Sql代码   
    
 SELECT DISTINCT p FROM PollTopic p, IN(p.options) o WHERE o.optionItem LIKE ?1

这个语法和SQL以及HQL都有很大的区别，它直接实体属性连接关联的实体，这里我们通过PollTopic的options属性关联到PollOption实体上，对应的SQL语句为：

    Sql代码   
    
  
 SELECT DISTINCT t0.TOPIC_ID, t0.TOPIC_TYPE, t0.TOPIC_TITLE,  
 t0.TOPIC_TIME, t0.TOPIC_VIEWS, t0.MULTIPLE, t0.MAX_CHOICES   
   
 FROM T_TOPIC t0,T_POLL_OPTION t1   
   
 WHERE (((t1.OPTION_ITEM LIKE ?) AND (t0.TOPIC_TYPE = ?))  
 AND (t1.TOPIC_ID = t0.TOPIC_ID))  

该查询语句的另外两种等价的写法分别是：

    Sql代码   
    
 SELECT DISTINCT p FROM PollTopic p JOIN p.options o WHERE o.optionItem LIKE ?1  
   
 和  
   
 SELECT DISTINCT p FROM PollTopic p WHERE p.options.optionItem LIKE ?1

关联查询：从Many的一方关联到One的一方

从Many一方关联到One一方的查询语句和前面所讲的也很相似。如我们希望查询某一个调查主题下的所示调查项，则可以编写以下的查询语句：

    Sql代码   
    
 SELECT p FROM PollOption p JOIN p.pollTopic t WHERE t.topicId = :topicId

小结

在不久的将来，Sun可能会将JPA作为一个单独的JSR对待，同时JPA还可能作为Java SE的一部分。不过这些都不太重要，重要的是，我们现在已经可以在脱离容器的情况下、在Java SE应用中使用JPA了。
JPA已经作为一项对象持久化的标准，不但可以获得Java EE应用服务器的支持，还可以直接在Java SE中使用。开发者将无需在现有多种ORM框架中艰难地选择, 这对开发人员来说是个福音。