JPA的实体状态和API浅析

开发 后端
本文分析JPA中的实体状态的4个状态及相关API的使用。

实体对象拥有以下4个状态,这些状态通过调用EntityManager接口方法发生迁移:

新建态:新创建的实体对象,尚未拥有持久化主键,没有和一个持久化上下文关联起来。受控态:已经拥有持久化主键并和持久化上下文建立了联系; 游离态:拥有持久化主键,但尚未和持久化上下文建立联系; 删除态:拥有持久化主键,已经和持久化上下文建立联系,但已经被安排从数据库中删除。

EntityManager 的API

下面是EntityManager的一些主要的接口方法:

void persist(Object entity)

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

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

void remove(Object entity)

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

void flush()

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

T merge(T entity)

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

T find(Class entityClass, Object primaryKey)

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

Topic t = em.find(Topic.class,1);

Query createQuery(String qlString)

根据JPA的查询语句创建一个查询对象Query,如下面的代码:

Query q= em.createQuery(""SELECT t FROM Topic t
WHERE t.topicTitle LIKE :topicTitle")");
Query createNativeQuery(String sqlString)

使用本地数据库的SQL语句创建一个Query对象,Query通过getResultList()方法执行查询后,返回一个List结果集,每一行数据对应一个Vector。

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的实体状态和API浅析

【编辑推荐】

  1. Java Persistence API (JPA) 的陷阱
  2. 持久化规范JPA(JavapersistenceAPI)
  3. 9.3 从特定的API到混搭
责任编辑:张攀 来源: 百度空间
相关推荐

2009-06-01 14:54:50

jpaapiJava

2009-06-01 15:19:25

JPAHibenateSpring

2009-11-12 15:00:03

ADO.NET实体数据

2009-06-25 16:18:45

JPA规范

2022-11-24 13:17:43

2009-06-25 16:07:30

JPAJava EE

2009-09-10 10:09:46

LINQ to SQL

2009-07-08 10:02:41

Servlet 3.0

2018-01-04 15:50:44

深度学习自然语言机器学习

2009-07-22 15:21:00

iBATIS SQLM

2009-09-28 09:35:10

Hibernate实现实体对象延迟加载

2023-01-04 08:53:52

JPA实体类注解

2009-09-18 13:28:41

Mobile Sens

2009-06-01 15:44:18

2009-11-13 09:24:58

JPA 2.0Criteria AP

2009-07-22 09:07:01

iBATIS.NET

2009-06-01 15:12:05

JPA是什么对象持久化ORM

2009-08-10 14:48:39

ASP.NET组件设计

2011-04-01 15:49:13

路由器链路

2022-03-07 15:22:16

classHarmony鸿蒙
点赞
收藏

51CTO技术栈公众号