原帖地址：http://blog.csdn.net/bq_cui/archive/2007/03/21/1536706.aspx
開始學習seam的時候，有兩個問題：我會用Spring和Hibernate，但一點也不懂Seam 和EJB3的 EntityManager。我用了一些時間學習seam，但EntityManager 一直困擾我。
同時我也有了一些小收獲，愿意跟剛剛開始學習seam的朋友分享以下。別緊張，我不敢確信我寫的東西都正確 ;).
好了，關(guān)于EntityManager有何用處？它管理你的entities ;)。 那是一些簡單的java對象，通過getters and
setters具備一些屬性。這些屬性之一是id（一般是Long數(shù)據(jù)類型），并且這些class必須以@Entity注解(annotated
)。在seam的源碼中可以找到一大批這樣的例子，例如booking例子。在seam中，一件很重要的事情就是，每個Entity都有一個
@Name 注解(annotation)，這樣，它們才能被注入到其他seam部件(component)中。
假設我們有這樣一個entity class，叫做"Entity"。其生命周期內(nèi)包含以下功能：
增
查
刪
改
EntityManager 提供了這些功能。首先，如何把EntityManager 引入我的代碼？很簡單：
@PersistenceContext
private EntityManager em;
好了，我們看看一個Entity 進程如何產(chǎn)生：
Entity entity = new Entity();
這很簡單。現(xiàn)在，這entity 的狀態(tài)是NEW/TRANSIENT 。這意味著一個entity已經(jīng)存在于你的應用程序中，但并不具有id，也不存在于你的數(shù)據(jù)庫中。
由于我們要使它持久化（即它應被寫入數(shù)據(jù)庫），我們應把它的狀態(tài)轉(zhuǎn)換為MANAGED 。
em.persist(entity);
現(xiàn)在，此entity由EntityManager管理了。EntityManager控制entity寫入數(shù)據(jù)庫。這動作無須立刻發(fā)生，可能把你的entity放在cache，稍后寫入數(shù)據(jù)庫。你可以放心，寫動作肯定會發(fā)生。
Ok, what about reading an existing entity from the database? Therefore we use:
好，如何從數(shù)據(jù)庫中讀出已存在的entity呢？這樣：
Entity entity = em.find(Entity.class, Id);
每個entity 有一個id（我已經(jīng)說過，多數(shù)情況下是Long數(shù)據(jù)類型），通過id你可存取entity。這是這里的第二個參數(shù)。第一個參數(shù)代表你要存取的Entity class的進程。find操作之后，entity的狀態(tài)也是MANAGED 。
一旦entity數(shù)據(jù)有所改變，將反映到數(shù)據(jù)庫中。不能確認EntityManager何時會向數(shù)據(jù)庫寫入更新的數(shù)據(jù)。但是這一事件肯定會發(fā)生，一般是馬上，但不會晚于EntityManager消失;)。你可以控制觸發(fā)更新數(shù)據(jù)庫：
em.flush();
這將強制EntityManager 立刻將更新寫入數(shù)據(jù)庫。請記住，這條語句將影響所有狀態(tài)為MANAGED的entitie，而不是當前一個。不過，一般情況下不必這么做。
如果你想反其道而行之，也就是從數(shù)據(jù)庫載入一個entity （因為別人可能已經(jīng)修改其數(shù)據(jù)），這么寫：
em.refresh(entity);
怎樣刪除一個entity呢？很簡單：
em.remove(entity);
現(xiàn)在，entity的狀態(tài)成為REMOVED，表示其已經(jīng)被列入刪除計劃。你可以用flush()語句，讓刪除動作馬上發(fā)生，但沒必要這么干。
現(xiàn)在來點復雜的。當注入EntityManager 的時候，有一個事務范圍持久上下文（ Transaction Scoped Persistence Context）。當entitie處在MANAGED狀態(tài)時，其處在持久上下文（persistence context ）的“容器”中。“事務范圍”意味什么？首先，什么是“事務”？
EJB3Stateful 和 Stateless beans (依同名標注辨別)的每個方法調(diào)用都包裝到一個事務內(nèi)。（順便說一下，事務一旦發(fā)生RuntimeException，即發(fā)生會滾，對數(shù)據(jù)的改變將撤銷）。因此，持久上下文（persistence context）將在調(diào)用方式之前建立，方式調(diào)用結(jié)束后移除。然后，持久上下文中管理的所有entity的狀態(tài)成為 DETACHED。
假設在你的bean里頭有兩個method。第一個是load(), 它調(diào)用find函數(shù)取出數(shù)據(jù)庫中的一個實體。第二個是finish()，返回一個JSF輸出。調(diào)用這兩個函數(shù)中間修改了實體數(shù)據(jù)。這種修改持久到數(shù)據(jù)庫中嗎？回答是：NO。
load() 函數(shù)結(jié)束后，EntityManager'的持久上下文結(jié)束，它所有管理過的entity狀態(tài)成為DETACHED。一個后果是，與新entity相反-有一個ID，但他們的狀態(tài)并不是managed ，對這些detached entities 所作的更新并不影響數(shù)據(jù)庫。如果你想使一個entity 更新數(shù)據(jù)庫，需要將其重新attach到持久上下文。在這個例子中，在finish()方法中增加以下行：
em.merge(entity);
現(xiàn)在這個entity 已經(jīng)合并到finish()方法的持久上下文中(記住，每個方法是一個事務，每個事物有自己的持久上下文)，并且狀態(tài)是又變?yōu)閙anaged。
這樣做是可以的，但有兩個缺點：
-需要調(diào)用merge(->多了一些代碼)
-調(diào)用find()之前，如果某個entity未初始化，而你又要存取它的某些屬性，將會得到exception 錯誤。
有一個簡單的解決方案：擴展持久上下文的生命期，這樣，當調(diào)用多個事務/方法時，entity狀態(tài)始終保持為managed 。因此，我們改變EntityManager的注入方式：
@PersistenceContext(type=PersistenceContextType.EXTENDED
private EntityManager em;
現(xiàn)在，managed entities "生活在"一個擴展持久上下文中( Extended Persistence Context )。
你甚至無須呼叫merge()方法，因為eitities從未被DETACHED。你可能會問：普通事務范圍（ "normal" (transaction scoped) ）持久上下文的好處是什么？它一直依附于你做的事情（小崔：什么意思？）。擴展上下文需要更多的內(nèi)存，因為即使你不需要，它也一直存在于內(nèi)存。并且一旦entities被其他的bean改變（它們有自己的持久上下文），你需要顯式地調(diào)用refresh()方法（在overviews/list頁面）。當你需要普通EntityManager 時它就在那里，因其生命周期短，只能操作即時數(shù)據(jù);)
當談及列表：為取得不止一個實體，而是一個實體集合，使用：
List<Entity> entities = em.createQuery("from Entity").getResultList();
這不是“真正”SQL，而是類似sql的東西，稱之為EJBQL。你可以用它執(zhí)行某些條件查詢，排序等，如
..."from Entity where lastName=".nameToSearchFor." order by firstName"
僅使用entity屬性名稱即可。關(guān)于EJBQL 要說的太多了，但對于本篇介紹來說這已足夠。
好，基本介紹到此為止。希望對你來說，在如何使用EntityManager方面，這一個簡單易懂的介紹。
我已聲明過，不能保證百分百正確。并且肯定有許多英語語法錯誤(對不起，我是德國人，不要打我PP噢)。歡迎斧正。
2007.4.11翻譯自：
http://www.jboss.com/index.html?module=bb&op=viewtopic&t=88460