實體管理程式

EntityManager 介面是用來管理實體實例生命週期的 API。

實體無法將本身持續保存在關聯式資料庫上;註釋只能用來將 POJO 宣告為實體,或是定義其與關聯式資料庫上對應表格的對映和關係。

在 JPA 中,使用 EntityManager 介面可讓應用程式管理及搜尋關聯式資料庫中的實體。

EntityManager 是用來管理實體實例生命週期的 API。EntityManager 物件管理一組由持續性單元定義的實體。每個 EntityManager 實例都有相關聯的持續性環境定義。持續性環境定義會定義可透過 EntityManager 提供之 API 來建立、持續保存及移除的特定實體實例範圍。從某些角度來看,持續性環境定義在概念上與交易環境定義很相似。

實體管理程式會追蹤持續性環境定義中所有實體物件的變更和更新情況,並將這些變更沖寫至資料庫。一旦關閉持續性環境定義,所有受管理的實體物件實例就會與持續性環境定義及其相關聯的實體管理程式分離,而不再受管理。物件一旦與持續性環境定義分離,就無法再以實體管理程式來管理,而這個物件實例的任何狀態變更,都不會與資料庫同步化。

受管理和未受管理的實體

實體物件實例分為受實體管理程式管理(連接),以及未受管理(分離)。

當實體連接至實體管理程式時,管理程式會監視實體的任何變更,而每當實體管理程式決定沖寫其狀態時,就會將變更與資料庫同步化。

當實體分離,而不再與持續性環境定義相關聯時,即未受管理,而實體管理程式就不會追蹤其狀態變更。

當交易範圍或延伸的持續性環境定義結束時,實體實例就會變成未受管理並分離。這個事實會造成一個重要的結果,那就是分離的實體可以序列化,並透過網路傳送至遠端用戶端。用戶端可以從遠端變更這些已序列化的物件實例,並將其傳回伺服器,以併回資料庫並同步化。

註: 此行為不同於 EJB 2.1 實體模型,後者的實體一律由儲存器管理。在 EJB 3.0 中,您是使用 POJO 實體,如此可以簡化您設計 Java™ EE 應用程式的過程,因為這樣不會強制您在商業邏輯層 (Session Bean) 與持續層之間使用資料傳送物件 (DTO) 之類的型樣。

實體管理程式作業

實體管理程式可以執行的主要作業如下:
表 1. 實體管理程式作業. 此表格說明實體管理程式作業。
作業 說明
persist
  • 將新的實體實例插入資料庫中。
  • 儲存實體的持續性狀態,以及任何所擁有的關係參照。
  • 實體實例會變成受管理。
find 取得具有給定持續性身分(主要索引鍵)的受管理實體實例,如果找不到,則傳回空值。
remove 從資料庫刪除具有給定持續性身分的受管理實體。
merge 分離實體的狀態會合併至分離實體的受管理副本中。傳回的受管理實體的 Java 身分不同於分離實體。
refresh 從資料庫重新載入實體狀態。
lock 針對內含在持續性環境定義中的實體物件,設定鎖定模式。
flush 強制與資料庫同步化。
contains 判斷實體是否內含在目前的持續性環境定義中。
createQuery 使用動態的「Java 持續性查詢語言」來建立查詢實例。
createNamedQuery 建立預先定義的查詢實例。
createNativeQuery 建立 SQL 查詢的實例。

儲存器管理實體管理程式

在 Java EE 環境中使用實體管理程式的方式之一,就是搭配使用儲存器管理實體管理程式。在此模式中,是由儲存器負責開啟及關閉實體管理程式,因此,也就是負責持續性環境定義的生命週期(對應用程式而言是透通的方式)。儲存器管理實體管理程式也負責交易界限。

您可以透過相依關係注入,或透過 JNDI 查閱,在應用程式中取得儲存器管理實體管理程式,儲存器可以用對應用程式透通的方式,管理與實體管理程式 Factory 的互動。

儲存器管理實體管理程式需要使用 JTA 交易,因為其持續性環境定義會隨著現行的 JTA 交易自動傳播,而對映至相同持續性單元的實體管理程式參照,可供存取 JTA 交易中的這個相同持續性環境定義。Java EE 儲存器導致持續性環境定義這樣的傳播,代表應用程式不需要將實體管理程式實例的參照從一個元件傳遞至另一個元件。

儲存器管理的持續性環境定義可能定義為具有下列兩個不同範圍之一:
  • 交易持續性範圍
  • 延伸持續性範圍

應用程式管理實體管理程式

使用應用程式管理實體管理程式可讓您控制應用程式碼中的實體管理程式。

使用這樣的應用程式管理實體管理程式時,請注意下列事項:
  • 使用應用程式管理實體管理程式時,持續性環境定義不會傳播至應用程式元件,而且實體管理程式實例的生命週期是由應用程式管理。這表示持續性環境定義不是透過特定持續性單元中的實體管理程式實例,隨著 JTA 交易而傳播。
  • 實體管理程式及其相關聯的持續性環境定義是由應用程式明確地建立及毀損。
這種類型的實體管理程式會用在兩種不同的實務範例:
  • 在 Java SE 環境中,您想要存取獨立的持續性環境定義,而不是透過給定之持續性單元的實體管理程式參照,隨著 JTA 交易而傳播的持續性環境定義。
  • 在 Java EE 儲存器中,您想要針對實體管理程式生命週期,進行非常細部的控制。
Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: c_entity_manager.html