EntityManager常用API

JPA实体状态分析



实体状态详解


  • 瞬时状态:

 
   
  1. 实际上就是new了一个普通的JavaBean对象。

  • 托管状态:
 
  
  1. 1.1.瞬时对象调用了管理器的persist()后,即可将一般的JavaBean做为了持久Bean,该Bean的任何属性改动都会牵涉到数据库记录的改动。
  2. 2.一旦该记录flush到数据库之后,并且事务提交了,那么此对象不在持久化上下文中,即:变为了游离(没人管的孩子)状态了。
  3. 在游离状态的时候调用更新、刷新方法后,游离状态对象就变为了在持久化上下文的托管状态了。
  4. 3.通过管理器的find方法,将实体从数据库查询出来后,该实体也就变为了托管形态。
 
  • 持久化状态:

 
   
  1. 当处在托管状态的实体Bean被管理器flush了,那么就在极短暂的时间进入了持久化状态,事务提交之后,立刻变为了游离状态。
  2. 您可以把持久化状态当做实实在在的数据库记录。

 

  • 游离状态:

 
   
  1. 游离状态就是提交到数据库后,事务commit后实体的状态,因为事务已经提交了,此时实体的属性任你如何改变,也不会同步到数据库,
  2. 因为游离是没人管的孩子,不在持久化上下文中。

  • 销毁对象:

 
   
  1. 一般要删除一个持久化对象的时候都是先find出来,之后调用remove方法删之,此时这个对象就是销毁对象,实际上就是瞬时对象的另一种形态罢了。


EntityManager一些常用的API(包含query, insert, update, delete操作)

1)get entity —— find() or getReference()
 
  
  1. Person person = em.find(Person.class,1);
  • 当在数据库中没有找到记录时,getReference()和find()是有区别的,
    • find()方法会返回null,
    • 而getReference() 方法会抛出javax.persistence.EntityNotFoundException例外,
  • 调用getReference()方法,返回的其实并不是实例对象,而是一个代理。当你要使用实体时,才会真正的调用查询语句来查询实例对象
  • 另外getReference()方法不保证 entity Bean已被初始化。
  • 如果传递进getReference()或find()方法的参数不是实体Bean,都会引发 IllegalArgumentException

2)insert —— persist()
 
   
  1. Person person = new Person();
  2. person.setName(name);
  3. //把数据保存进数据库中
  4. em.persist(person);
  • persist方法的:使对象由临时状态变为持久化状态
  • 如果传递进persist()方法的参数不是实体Bean,会引发IllegalArgumentException
  • 和hibernate的save()方法有些不同:如果对象有id,则不能执行insert操作,会抛出异常

3)update —— 分2种情况
    情况1:当实体正在被容器管理时,你可以调用实体的set方法对数据进行修改,在容器决定flush时(这个由 Container 自行判断),更新的数据 才会同步到数据库,而不是在调用了set方法对数据进行修改后马上同步到数据库。如果你希望修改后的数据马上同步到数据库,你可以调用EntityManager.flush()方法
 
   
  1. public void updatePerson() {
  2. try {
  3. Person person = em.find(Person.class, 1);
  4. person.setName("lihuoming"); //方法执行完后即可更新数据
  5. } catch (Exception e) {
  6. e.printStackTrace();
  7. }
  8. }

       情况2:在实体Bean已经脱离了EntityManager的管理时,你调用实体的set方法对数据进行修改是无法同步更改到数据库的。你必须调用 EntityManager.merge()方法。调用之后,在容器决定flush时(这个由container自行判断),更新的数据才会同步到数据 库。如果你希望修改后的数据马上同步到数据库,你可以调用EntityManager.flush()方法
 
   
  1. public boolean updatePerson(Person person) {
  2. try {
  3. em.merge(person);
  4. } catch (Exception e) {
  5. e.printStackTrace();
  6. return false;
  7. }
  8. return true;
  9. }

    下面的代码会调用上面的方法。因为下面的第二行代码把实体Bean 返回到了客户端,这时的实体Bean已经脱离了容器的管理,在客户端对实体Bean进行修改,最后把他返回给EJB 容器进行更新操作:
 
   
  1. PersonDAO persondao = (PersonDAO) ctx.lookup("PersonDAOBean/remote");
  2. Person person = persondao.getPersonByID(1); //此时的person 已经脱离容器的管理
  3. person.setName("张小艳");
  4. persondao.updatePerson(person);

  • merge 情况1:传入的对象没有id
 
    
  1. 在这种情况下,调用merge方法,将返回一个新的对象(有id),并对这个新的对象执行insert操作。

  • merge 情况2:传入的对象有id,entityManager的缓存中没有该对象,数据库中没有该记录:
 
    
  1. 在这种情况下,调用merge方法,将返回一个新的对象,并对该对象执行insert操作。
  2. 新对象的id是数据库中这条记录的id(比如自增长的id,而不是我们自己传入的id。(其实和情况1的结果是一样的)

  • merge 情况3:传入的对象有id,entityManager的缓存没有该对象,数据库中有该记录
 
    
  1. 在这种情况下,调用merge方法,将会从数据库中查询对应的记录,生成新的对象,然后将我们传入的对象复制到新的对象,最后执行update操作。 
  2. 简单来说,就是更新操作

  • merge 情况4:传入的对象有id,entityManager的缓存有该对象
 
    
  1. 在这种情况下,调用merge方法,JPA会把传入的对象赋值到entityManager的缓存中的对象,然后对entityManager缓存中的对象执行update操作。
  2. (和情况3的结果一样)


4)Delete —— Remove()
 
   
  1. Person person = em.find(Person.class, 2);
  2. //如果级联关系cascade=CascadeType.ALL,在删除person 时候,也会把级联对象删除。
  3. //把cascade属性设为cascade=CascadeType.REMOVE 有同样的效果。
  4. em.remove (person);

  • 如果传递进remove ()方法的参数不是实体Bean,会引发一个IllegalArgumentException
  • remove()方法不能移除游离对象,只能移除持久化对象
     
         
    1. Order order = new Order();
    2. order.setId(140);
    3. entityManager.remove(order);

    上面这段代码会抛出异常,因为order是我们自己创建的对象,也就是游离对象必须这样写:

     
          
    1. Order order = new Order();
    2. order = entityManager.find(Order.class, 140);
    3. entityManager.remove(order);


  • 这段代码中的order是从数据库中获取的,也就是持久化对象

  • hibernate的delete()方法,只要对象有Id,就可以删除



5)HPQL query —— createQuery()

  • 除了使用find()或getReference()方法来获得Entity Bean之外,你还可以通过JPQL得到实体Bean。
  • 要执行JPQL语句,你必须通过EntityManager的createQuery()或createNamedQuery()方法创建一个Query 对象
  • // 执行查询语句
 
   
  1. Query query = em.createQuery("select p from Person p where p. name=’黎明’");
  2. List result = query.getResultList();
  3. Iterator iterator = result.iterator();
  4. while( iterator.hasNext() ){
  5. //处理Person
  6. }

  • // 执行更新语句
 
   
  1. Query query = em.createQuery("update Person as p set p.name =?1 where p. personid=?2");
  2. query.setParameter(1, “黎明”);
  3. query.setParameter(2, new Integer(1) );
  4. int result = query.executeUpdate(); //影响的记录数

  • // 执行删除语句
 
   
  1. Query query = em.createQuery("delete from Person");
  2. int result = query.executeUpdate(); //影响的记录数



6)SQL query —— createNaiveQuery()
  • 注意:该方法是针对SQL语句,而不是HPQL语句
 
   
  1. //我们可以让EJB3 Persistence 运行环境将列值直接填充入一个Entity 的实例,
  2. //并将实例作为结果返回.
  3. Query query = em.createNativeQuery("select * from person", Person.class);
  4. List result = query.getResultList();
  5. if (result!=null){
  6. Iterator iterator = result.iterator();
  7. while( iterator.hasNext() ){
  8. Person person= (Person)iterator.next();
  9.  ..
  10. }
  11. }

  • // 直接通过SQL 执行更新语句
 
   
  1. Query query = em.createNativeQuery("update person set age=age+2");
  2. query.executeUpdate();

7)Refresh entity —— refresh()
 
   
  1. Order order= entityManager.find(Order.class, 170);
  2. order= entityManager.find(Order.class, 170);
  • 运行以上代码,发现调用了两次find,但是只执行了一次select语句,这是缓存导致的。
 
    
  1. Order order= entityManager.find(Order.class, 170);
  2. entityManager.refresh(order);
  • 只调用了一次find方法,却执行了两次select语句,这是因为refresh方法会去查看缓存中的数据状态和数据库中是否一致,因此又执行了一次select语句

  • 如果你怀疑当前被管理的实体已经不是数据库中最新的数据,你可以通过refresh()方法刷新实体,容器会把数据库中的新值重写进实体。
  • 这种情况一般发 生在你获取了实体之后,有人更新了数据库中的记录,这时你需要得到最新的数据。
  • 当然你再次调用find()或getReference()方法也可以得到 最新数据,但这种做法并不优雅。
 
   
  1. Person person = em.find(Person.class, 2);
  2. //如果此时person 对应的记录在数据库中已经发生了改变,
  3. //可以通过refresh()方法得到最新数据。
  4. em.refresh (person);

8)Check entity是否在EntityManager管理当中 —— contains()
  • 判断一个实例是否属于当前持久上下文环境管理的实体
  • contains()方法使用一个实体作为参数,如果这个实体对象当前正被持久化内容管理,返回值为true,否则为false。
  • 如果传递的参数不是实体 Bean,将会引发一个IllegalArgumentException.
 
   
  1. Person person = em.find(Person.class, 2);
  2. 。。。
  3. if (em.contains(person)){
  4. //正在被持久化内容管理
  5. }else{
  6. //已经不受持久化内容管理
  7. }

9)分离所有当前正在被管理的实体 —— clear()

  • 清除持久上下文环境,断开所有关联的实体。如果这时还有未提交的更新则会被撤消。
  • 在处理大量实体的时候,如果你不把已经处理过的实体从EntityManager中分离出来,将会消耗你大量的内存。
  • 调用EntityManager 的clear()方法后,所有正在被管理的实体将会从持久化内容中分离出来。
  • 有一点需要说明下,在事务没有提交前(事务默认在调用堆栈的最后提交,如:方 法的返回),如果调用clear()方法,之前对实体所作的任何改变将会掉失,
  • 所以建议你在调用clear()方法之前先调用flush()方法保存更 改

10) 将实体的改变立刻刷新到数据库中 —— flush()
  • 当EntityManager对象在一个session bean 中使用时,它是和服务器的事务上下文绑定的。
  • EntityManager在事务提交时并且同步它的内容。
  • 在一个session bean 中,服务器的事务默认地会在调用堆栈的最后提交(如:方法的返回)。
 
   
  1. 例子1:在方法返回时才提交事务
  2. public void updatePerson(Person person) {
  3. try {
  4. Person person = em.find(Person.class, 2);
  5. person.setName("lihuoming");
  6. em.merge(person);
  7. //后面还有众多修改操作
  8. } catch (Exception e) {
  9. e.printStackTrace();
  10. }
  11. //更新将会在这个方法的末尾被提交和刷新到数据库中
  12. }
  • 为了只在当事务提交时才将改变更新到数据库中,容器将所有数据库操作集中到一个批处理中,这样就减少了代价昂贵的与数据库的交互。
  • 当你调用 persist( ), merge( )或remove( )这些方法时,更新并不会立刻同步到数据库中,直到容器决定刷新到数据库中时才会执行,
  • 默认情况下,容器决定刷新是在“相关查询”执行前或事务提交时发 生,
  • 当然“相关查询”除find()和getreference()之外,这两个方法是不会引起容器触发刷新动作的,默认的刷新模式是可以改变的。

如果你需要在事务提交之前将更新刷新到数据库中,你可以直接地调用EntityManager.flush()方法。
这种情况下,你可以手工地来刷新数据 库以获得对数据库操作的最大控制。
 
   
  1. public void updatePerson(Person person) {
  2. try {
  3. Person person = em.find(Person.class, 2);
  4. person.setName("lihuoming");
  5. em.merge(person);
  6. em.flush();//手动将更新立刻刷新进数据库
  7. //后面还有众多修改操作
  8. } catch (Exception e) {
  9. e.printStackTrace();
  10. }
  11. }

11) 改变实体管理器的Flush模式 —— setFlushMode()

  • setFlushMode()的Flush模式有2种类型:AUTO and COMMIT。AUTO为缺省模式。你可以改变他的值,如下:
 
   
  1. entityManager.setFlushMode(FlushModeType.COMMIT);

  • FlushModeType.AUTO:
 
   
  1. 刷新在查询语句执行前(除了find()和getreference()查询)或事务提交时才发生,
  2. 使用场合:在 大量更新数据的过程中没有任何查询语句(除了find()和getreference()查询)的执行。

  • FlushModeType.COMMIT:
 
   
  1. 刷新只有在事务提交时才发生,
  2. 使用场合:在大量更新数据的过程中存在查询语句(除了find()和 getreference()查询)的执行。

  • 其实上面两种模式最终反映的结果是:JDBC 驱动跟数据库交互的次数。
 
  
  1. JDBC 性能最大的增进是减少JDBC 驱动与数据库之间的网络通讯。
  2. FlushModeType.COMMIT模式使更新只在一次的网络交互中完成,而FlushModeType.AUTO 模式可能需要多次交互(触发了多少次Flush 就产生了多少次网络交互)

12) 获取持久化实现者的引用 —— getDelegate()

  • 用过getDelegate()方法,你可以获取EntityManager持久化实现者的引用,
  • 如Jboss EJB3的持久化产品采用Hibernate,可以通过getDelegate()方法获取对他的访问,如:
 
   
  1. HibernateEntityManager manager = (HibernateEntityManager)em.getDelegate();

  • 获得对Hibernate的引用后,可以直接面对Hibernate进行编码,不过这种方法并不可取,强烈建议不要使用。

13)判断当前的实体管理器是否是打开状态--isOpen ()
14)返回资源层的事务对象。EntityTransaction实例可以用于开始和提交多个事务--getTransaction ()
15)大量数据分批提交
 
    
  1. 有的时候我们需要循环保存数据,当保存大量数据的时候,
  2. 如果到最后才提交所有数据,那么数据库的负载可能会比较大。我们可以这样做,每30个记录就提交(flush)一次。
代码如下( 每到30条记录的时候就强制提交 ):
 
    
  1. public void updateBatch(List<Z> list) {
  2. for (int i = 0; i < list.size(); i++) {
  3. entityManager.merge(list.get(i)); //变成托管状态
  4. if (% 30 == 0) {
  5. entityManager.flush(); //变成持久化状态
  6. entityManager.clear(); //变成游离状态
  7. }
  8. }
  9. }
  10. public void saveBatch(List<Z> list) {
  11. for (int i = 0; i < list.size(); i++) {
  12. entityManager.persist(list.get(i)); //变成托管状态
  13. if (% 30 == 0) {
  14. entityManager.flush(); //变成持久化状态
  15. entityManager.clear(); //变成游离状态
  16. }
  17. }
  18. }
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值