九乡新闻网自私的基因txt完整版:JPA的实体状态和API浅析
来源：百度文库 编辑：九乡新闻网 时间：2024/07/07 14:22:09
实体对象拥有以下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()：如果查询语句是新增、删除或更改的语句，通过该方法执行更新操作。
新建态：新创建的实体对象，尚未拥有持久化主键，没有和一个持久化上下文关联起来。受控态：已经拥有持久化主键并和持久化上下文建立了联系；
游离态：拥有持久化主键，但尚未和持久化上下文建立联系； 删除态：拥有持久化主键，已经和持久化上下文建立联系，但已经被安排从数据库中删除。
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浅析
浅析AutoCAD中扩展实体数据的组织结构及存取方法
linux进程状态浅析
什么是JPA及与Hibernate的关系
关于Portlet和Portlet API
API
api
“海派”和“周立波”的文化浅析
API生成GUID的代码
API HOOK的实现原理
几个博客的api地址
JPA是什么
使用Java?API压缩和?解压缩数据
实体和虚拟经济的无奈：曾经坐在喷泉般钱堆上的股市？……
高中化学常见物质的颜色和状态
武汉和北京人民的签名状态
WinInet API 的异步方式使用 hh
利用hook截获进程的API调用
VB的API编程精粹20110819
基础类的DSP/BIOS API调用
关于圣骑士公共CD和一些换圣契宏的浅析
浅析开展中学生心理健康教育的意义和方法10
浅析加强国有企业党员队伍建设的特点和对策1
日本的国民个性和心理历程浅析