EntityManager:seam新手必读

原帖地址：http://blog.csdn.net/bq_cui/archive/2007/03/21/1536706.aspx

开始学习seam的时候，有两个问题：我会用Spring和Hibernate，但一点也不懂Seam 和EJB3的 EntityManager。我用了一些时间学习seam，但EntityManager 一直困扰我。
    同时我也有了一些小收获，愿意跟刚刚开始学习seam的朋友分享以下。别紧张，我不敢确信我写的东西都正确 ;).
    好了，关于EntityManager有何用处？它管理你的entities ;)。 那是一些简单的java对象，通过getters and setters具备一些属性。这些属性之一是id（一般是Long数据类型），并且这些class必须以@Entity注解(annotated )。在seam的源码中可以找到一大批这样的例子，例如booking例子。在seam中，一件很重要的事情就是，每个Entity都有一个 @Name 注解(annotation)，这样，它们才能被注入到其他seam部件(component)中。
    假设我们有这样一个entity class，叫做"Entity"。其生命周期内包含以下功能：

增

查

删

改

EntityManager 提供了这些功能。首先，如何把EntityManager 引入我的代码？很简单：

@PersistenceContext
private  EntityManager em;    

    好了，我们看看一个Entity 进程如何产生：

Entity entity  =  new  Entity();    

    这很简单。现在，这entity 的状态是NEW/TRANSIENT 。这意味着一个entity已经存在于你的应用程序中，但并不具有id，也不存在于你的数据库中。

    由于我们要使它持久化（即它应被写入数据库），我们应把它的状态转换为MANAGED 。

em.persist(entity);    

    现在，此entity由EntityManager管理了。EntityManager控制entity写入数据库。这动作无须立刻发生，可能把你的entity放在cache，稍后写入数据库。你可以放心，写动作肯定会发生。

Ok, what about reading an existing entity from the database? Therefore we use:

好，如何从数据库中读出已存在的entity呢？这样：

Entity entity  =  em.find(Entity. class , Id);    

    每个entity 有一个id（我已经说过，多数情况下是Long数据类型），通过id你可存取entity。这是这里的第二个参数。第一个参数代表你要存取的Entity class的进程。find操作之后，entity的状态也是MANAGED 。

一旦entity数据有所改变，将反映到数据库中。不能确认EntityManager何时会向数据库写入更新的数据。但是这一事件肯定会发生，一般是马上，但不会晚于EntityManager消失;)。你可以控制触发更新数据库：

     这将强制EntityManager 立刻将更新写入数据库。请记住，这条语句将影响所有状态为MANAGED的entitie，而不是当前一个。不过，一般情况下不必这么做。
    如果你想反其道而行之，也就是从数据库载入一个entity （因为别人可能已经修改其数据），这么写：

em.refresh(entity);    

    怎样删除一个entity呢？很简单：

em.remove(entity);    

    现在，entity的状态成为 REMOVED，表示其已经被列入删除计划。你可以用flush()语句，让删除动作马上发生，但没必要这么干。

    现在来点复杂的。当注入EntityManager 的时候，有一个 事务范围持久上下文（ Transaction Scoped Persistence Context）。当entitie处在MANAGED状态时，其处在持久上下文（persistence context ）的“容器”中。“事务范围”意味什么？首先，什么是“事务”？

    EJB3Stateful 和 Stateless beans (依同名标注辨别)的每个方法调用都包装到一个事务内。（顺便说一下，事务一旦发生RuntimeException，即发生会滚，对数据的改变将撤销）。因此，持久上下文（persistence context）将在调用方式之前建立，方式调用结束后移除。然后，持久上下文中管理的所有entity的状态成为 DETACHED。

    假设在你的bean里头有两个method。第一个是load(), 它调用find函数取出数据库中的一个实体。第二个是finish()，返回一个JSF输出。调用这两个函数中间修改了实体数据。这种修改持久到数据库中吗？回答是：NO。

    load() 函数结束后，EntityManager'的持久上下文结束，它所有管理过的entity状态成为DETACHED。一个后果是，与新entity相反-有一个ID，但他们的状态并不是managed ，对这些detached entities 所作的更新并不影响数据库。如果你想使一个entity 更新数据库，需要将其重新attach到持久上下文。在这个例子中，在 finish()方法中增加以下行：

em.merge(entity);    

    现在这个entity 已经合并到finish()方法的持久上下文中(记住，每个方法是一个事务，每个事物有自己的持久上下文)，并且状态是又变为managed。

     这样做是可以的，但有两个缺点：
-需要调用merge(->多了一些代码)
-调用find()之前，如果某个entity未初始化，而你又要存取它的某些属性，将会得到exception 错误。

    有一个简单的解决方案：扩展持久上下文的生命期，这样，当调用多个事务/方法时，entity状态始终保持为managed 。因此，我们改变EntityManager的注入方式：

@PersistenceContext(type = PersistenceContextType.EXTENDED
private  EntityManager em;   

     现在，managed entities "生活在"一个扩展持久上下文中( Extended Persistence Context )。

    你甚至无须呼叫merge()方法，因为eitities从未被DETACHED。你可能会问：普通事务范围（ "normal" (transaction scoped) ）持久上下文的好处是什么？它一直依附于你做的事情（小崔：什么意思？）。扩展上下文需要更多的内存，因为即使你不需要，它也一直存在于内存。并且一旦entities被其他的bean改变（它们有自己的持久上下文），你需要显式地调用refresh()方法（在overviews/list页面）。当你需要普通EntityManager 时它就在那里，因其生命周期短，只能操作即时数据;)
   
    当谈及列表：为取得不止一个实体，而是一个实体集合，使用：

List < Entity >  entities  =  em.createQuery( " from Entity " ).getResultList();    

    这不是“真正”SQL，而是类似sql的东西，称之为 EJBQL。你可以用它执行某些条件查询，排序等，如

... " from Entity where lastName= " .nameToSearchFor. "  order by firstName "     

    仅使用entity属性名称即可。关于EJBQL 要说的太多了，但对于本篇介绍来说这已足够。

    好，基本介绍到此为止。希望对你来说，在如何使用EntityManager方面，这一个简单易懂的介绍。

    我已声明过，不能保证百分百正确。并且肯定有许多英语语法错误(对不起，我是德国人，不要打我PP噢)。欢迎斧正。


2007.4.11翻译自：
http://www.jboss.com/index.html?module=bb&op=viewtopic&t=88460

em.flush();