關(guān)于實體 Bean

實體 Bean
實體?Bean?特征
實體?Bean?在許多方面不同于會話?Bean。實體?Bean?是持久的，可以同時由多個客戶端訪問，具有主鍵，而且可以參加與其他實體?Bean?的關(guān)系。?

實體?Bean?具有以下特征：?


提供數(shù)據(jù)庫中數(shù)據(jù)的對象視圖。?

允許多個用戶進(jìn)行共享訪問。?

利用?Bean?管理持久性或容器管理持久性，可以持續(xù)所有客戶端所需要的時間長度。?

透明地幸免于服務(wù)器崩潰而不丟失信息。?

表現(xiàn)數(shù)據(jù)庫中的共享數(shù)據(jù)。?
采用實體?Bean?的一個良好情形包括與數(shù)據(jù)庫、文檔和其他業(yè)務(wù)對象進(jìn)行封裝嚴(yán)密的事務(wù)性持久交互。

容器
實體?Bean?依靠?Enterprise?Bean?管理安全性、并發(fā)性、事務(wù)處理以及實體?Bean?管理的實體對象的其他容器特有服務(wù)。多個客戶端可以并發(fā)訪問一個實體對象，而容器可以通過事務(wù)處理透明地處理并發(fā)訪問。?

每個實體都有一個唯一對象標(biāo)識符。例如，客戶實體?Bean?可能按客戶編號識別。此唯一標(biāo)識符或主鍵使客戶端能夠查找某個實體?Bean。

與會話?Bean?一樣，實體?Bean?可以通過使用部署描述符設(shè)置其事務(wù)處理屬性的方法內(nèi)的?JDBC?調(diào)用訪問數(shù)據(jù)庫。容器支持下節(jié)講述的?Bean?管理和容器管理持久性。

持久性
由于實體?Bean?的狀態(tài)存儲在一個有點可持續(xù)的存儲區(qū)中，因而實體?Bean?是持久的。持久性指實體?Bean?的狀態(tài)存在時間超過應(yīng)用程序或服務(wù)器進(jìn)程的壽命。?

實體?Bean?的持久性可由?Bean?明確執(zhí)行，并由?Bean?開發(fā)者進(jìn)行編程。這稱為?Bean?管理持久性?(BMP)。?

也可以利用?Sun?Java?System?應(yīng)用服務(wù)器和?Enterprise?Bean?的持久性管理把持久性管理委托給容器。此方法稱為容器管理持久性?(CMP)。在?CMP?機制中，需要使用與?Sun?Java?System?應(yīng)用服務(wù)器集成的持久性管理器來確保可靠的持久性。有關(guān)容器管理持久性的其他信息，請參閱“將容器管理持久性用于實體?Bean”。

下圖顯示持久性在?Sun?Java?System?應(yīng)用服務(wù)器環(huán)境中的工作方式。


?


有關(guān)如何為您的應(yīng)用程序選擇最適當(dāng)持久性方法的準(zhǔn)則，請參閱“確定實體?Bean?使用”。?

本節(jié)介紹以下主題：


Bean?管理持久性?

容器管理持久性?
Bean?管理持久性
在?Bean?管理持久性中,Bean?負(fù)責(zé)自己的持久性。您所編寫的實體?Bean?代碼包含訪問數(shù)據(jù)庫的調(diào)用。

您通過直接在?Bean?類方法中提供數(shù)據(jù)庫訪問調(diào)用?－?通過?JDBC?和?SQL，對?Bean?管理實體?Bean?進(jìn)行編碼。數(shù)據(jù)庫訪問調(diào)用必須在?ejbCreate、ejbRemove、ejbFindXXX、ejbLoad?和?ejbStore?方法中。此方法的優(yōu)點是可以毫不費盡地把這些?Bean?部署到應(yīng)用服務(wù)器。缺點是數(shù)據(jù)庫訪問非常昂貴，而且在某些情況下，應(yīng)用服務(wù)器能夠比應(yīng)用編程人員更好地優(yōu)化數(shù)據(jù)庫訪問。另外，Bean?管理持久性需要開發(fā)人員編寫?JDBC?代碼。

有關(guān)使用?JDBC?操作數(shù)據(jù)的詳細(xì)信息，請參閱?Sun?Java?System?應(yīng)用服務(wù)器J2EE?特性和服務(wù)開發(fā)者指南。

容器管理持久性
在容器管理持久性方面，Enterprise?Bean?容器通過利用持久性管理器進(jìn)行交互，處理實體?Bean?所需的一切數(shù)據(jù)庫訪問。Bean?代碼不包含任何數(shù)據(jù)庫訪問?(JCBC)?調(diào)用。因此，Bean?代碼沒有捆綁到特定持久性存儲機制（數(shù)據(jù)庫）。由于具有此靈活性，即使在不同數(shù)據(jù)庫上重新部署同一實體?Bean，也不需要修改?Bean?代碼。簡言之，實體?Bean?更具可移植性。?

Bean?開發(fā)人員提供抽象?Bean?類。一般來說，容器管理持久性運行時生成知道如何（在?ejbLoad?和?ejbStore?方法中）加載和保存?Bean?狀態(tài)的具體實施類。?

要生成數(shù)據(jù)訪問調(diào)用，容器需要您在實體?Bean?的抽象架構(gòu)中提供的信息。有關(guān)抽象架構(gòu)的其他信息，請參閱“抽象架構(gòu)”。

只讀?Bean
只讀?bean?是一個從不會被?EJB?客戶端修改的實體?Bean。只讀?Bean?表示的數(shù)據(jù)可能由其他?Enterprise?Bean?或通過其他手段（如直接數(shù)據(jù)庫更新）從外部進(jìn)行更新。





--------------------------------------------------------------------------------
注意??就?Sun?Java?System?應(yīng)用服務(wù)器的這個版本而言，只能把使用?Bean?管理持久性的實體?Bean?指定為只讀。
?

--------------------------------------------------------------------------------



只讀?Bean?最適合于基本數(shù)據(jù)從不變化或極少變化的情形。有關(guān)創(chuàng)建只讀?Bean?的說明，請參閱“使用只讀?Bean”。

開發(fā)實體?Bean?

--------------------------------------------------------------------------------

創(chuàng)建實體?Bean?時，必須提供許多類文件。下列主題中將討論所需執(zhí)行的任務(wù)：


確定實體?Bean?使用?

Bean?開發(fā)人員的責(zé)任?

定義主鍵類?

定義遠(yuǎn)程接口?

定義本地接口?

創(chuàng)建?Bean?類定義（適用于“Bean?管理持久性）?
確定實體?Bean?使用
如果　Bean?表示一個業(yè)務(wù)實體，而不是一個過程，而且?Bean?的狀態(tài)必須是持久的（如果關(guān)閉服務(wù)器，數(shù)據(jù)庫中仍然存在?Bean?的狀態(tài)），很可能就應(yīng)使用實體?Bean。

與會話?Bean?不同的是，實體?Bean?實例可同時由多個客戶端進(jìn)行訪問。容器負(fù)責(zé)同步使用事務(wù)處理的實例狀態(tài)。由于此責(zé)任是委托給容器執(zhí)行的，因而您不需要考慮來自多個事務(wù)的并發(fā)訪問方法。?

您所選擇的持久性方法也有影響：


Bean?管理持久性?－?當(dāng)您實施一個實體?Bean?管理其自己的持久性時，您直接在?EJB?類方法中實施持久性代碼（例如?JDBC?調(diào)用）。缺點是會喪失移植性（即將?Bean?與特定數(shù)據(jù)庫關(guān)聯(lián)的風(fēng)險）。?

容器管理持久性?－?如果實體?Bean?持久性是由容器管理的，容器就透明地管理持久性狀態(tài)。不需要在?Bean?方法中實施任何數(shù)據(jù)訪問代碼。此方法不僅更容易實施，而且可以把?Bean?移植到到不同數(shù)據(jù)庫。有關(guān)實施準(zhǔn)則，請參閱“將容器管理持久性用于實體?Bean”。?
Bean?開發(fā)人員的責(zé)任
本節(jié)講述您需要做什么工作才能確?？梢园丫哂?Bean?管理持久性的實體?Bean?部署在?Sun?Java?System?應(yīng)用服務(wù)器上。?

實體?Bean?開發(fā)人員負(fù)責(zé)提供以下類文件：?


主鍵類?

實體?Bean?遠(yuǎn)程接口和遠(yuǎn)程home接口?－?如果實體?Bean?提供一個遠(yuǎn)程客戶端視圖的話?

實體?Bean?本地接口和本地home接口?－?如果實體?Bean?提供一個本地客戶端視圖的話?

實體?Bean?類?
定義主鍵類?
EJB?體系架構(gòu)使主鍵類可以成為屬于?RMI - IIOP?中合法“值類型”的任何類。此類必須能夠適當(dāng)實施?hashCode?和相等（其他對象）方法。?主鍵類可以是實體?Bean?所特有，即每個實體?Bean?類可以為其主鍵定義一個不同的類，但是，多個實體?Bean?可以使用同一主鍵類。

您必須在部署描述符中指定一個主鍵類。?

定義遠(yuǎn)程接口
本節(jié)討論以下主題：


創(chuàng)建遠(yuǎn)程home接口?

創(chuàng)建遠(yuǎn)程接口?
創(chuàng)建遠(yuǎn)程home接口
作為一個?Bean?開發(fā)者，您必須提供?Bean?的遠(yuǎn)程home接口（如果適用的話）。home接口定義使一個訪問應(yīng)用程序的客戶端能夠創(chuàng)建、查找和刪除實體對象方法。您創(chuàng)建的遠(yuǎn)程home接口必須符合以下要求：?


接口必須擴(kuò)展?javax.ejb.EJBHome?接口。?

此接口中定義的方法必須遵循?RMI - IIOP?的規(guī)則。這就意味著這些方法的參數(shù)和返回類型必須具有?RMI - IIOP?的有效類型，而且其? throws ?子句包括?java.rmi.RemoteException。?

遠(yuǎn)程home接口中定義的每個方法都必須屬于以下情況之一：?


創(chuàng)建方法。?



遠(yuǎn)程home接口必須始終包括?findByPrimaryKey?方法，該方法始終是單對象查找程序。此方法必須把主鍵類聲明為方法參數(shù)。?


查找程序方法。?


主方法。假定主方法與創(chuàng)建、查找和刪除方法名稱不一致，主方法就可以具有任意名稱。實體?Bean?類中指定的匹配?ejbHome?方法必須具有同樣的參數(shù)數(shù)目和類型，并且必須返回與主方法在?Bean?的遠(yuǎn)程home接口中指定的主方法相同的類型。?
遠(yuǎn)程創(chuàng)建方法

必須把每個創(chuàng)建方法命名為?createXXX，其中?XXX?為匹配?Enteprise?Bean?類中定義的?ejbCreateXXX?方法之一的唯一方法名稱擴(kuò)展。例如，createEmployee(),?createLargeOrder(.)。?

Bean?中的匹配?ejbCreateXXX?必須具有同樣參數(shù)數(shù)目和類型。但是，返回類型是不同的。?

createXXX?方法的返回類型必須是實體?Bean?遠(yuǎn)程接口類型。?

必須把?Enterprise?Bean?類的匹配?ejbCreateXXX?和?ejbPostCreateXXX?方法的? throws ?子句中定義的所有異常包括在遠(yuǎn)程home接口的匹配創(chuàng)建方法的? throws ?子句中（即，為創(chuàng)建方法定義的異常集必須是為?ejbCreateXXX?和?ejbPostCreateXXX?方法定義的異常集合的超集）。?

創(chuàng)建方法的? throws ?子句必須包括?javax.ejb.CreateException。?
遠(yuǎn)程查找方法

一個home接口可以定義一個或多個查找方法。必須把每個方法命名為?findXXX，其中?XXX?為唯一方法名稱擴(kuò)展。例如，findApplesAndOranges。?

每個查找程序方法必須與實體?Bean?類定義中定義的其中一個查找程序方法相對應(yīng)。?

數(shù)目和參數(shù)類型也必須與?Bean?類中的查找程序方法定義相對應(yīng)。?

查找? < METHOD > ?方法的返回類型必須是實體?Bean?的遠(yuǎn)程接口類型（適用于單對象查找程序）或其中一個集合（適用于多對象查找程序）。?

必須把實體?Bean?類的?ejbFind?方法的? throws ?子句中定義的所有異常包括在遠(yuǎn)程home接口的匹配查找方法的? throws ?子句中。?

查找程序方法的? throws ?子句必須包括?javax.ejb.FinderException。?
findByPrimaryKey?方法?

每個遠(yuǎn)程home接口必須始終包括?findByPrimaryKey?方法，該方法始終是一個單對象查找程序。?

該方法必須把主鍵類聲明為方法參數(shù)。?

必須把實體?Bean?類的?ejbFindByPrimaryKey?方法的? throws ?子句中定義的所有異常都包括在遠(yuǎn)程home接口的匹配查找方法的? throws ?子句中。?

findByPrimaryKey?方法的? throws ?子句必須包括?javax.ejb.FinderException。?
遠(yuǎn)程刪除方法
所有home接口都自動（通過擴(kuò)展?javax.ejb.EJBHome）定義兩個?remove?方法，用來毀壞不再需要的?Enterprise?Bean：

public ? void ?remove(java.lang.Object?primaryKey)?
throws ?java.rmi.RemoteException,?RemoveException?

public ? void ?remove(Handle?handle)?
throws ?java.rmi.RemoteException,?RemoveException?





--------------------------------------------------------------------------------
注意??不要覆蓋這些?remove?方法。
?

--------------------------------------------------------------------------------



遠(yuǎn)程home接口示例?

import ?javax.ejb. * ;?
import ?java.rmi. * ;


public ? interface ?MyEntityBeanLocalHome?
??? extends ?EJBHome
{
??? /**?*/ /**
??????*?Create?an?Employee
??????*? @param ?empName?Employee?name
??????*? @exception ?CreateException?If?the?employee?cannot?be?
?????????created?
?????????*? @return ?The?remote?interface?of?the?bean?
?????? */ ?
??? public ?MyEntity?create(String?empName)?
?????? throws ?CreateException;?
??? /**?*/ /** ?
??????*?Find?an?Employee?
??????*? @param ?empName?Employee?name?
??????*? @exception ?FinderException?if?the?empName?is?not?found?
??????*? @return ?The?remote?interface?of?the?bean?
?????? */ ?
??? public ?MyEntity?findByPrimaryKey(String?empName)?
?????? throws ?FinderException;?
} ?

定義本地接口
要構(gòu)建一個允許本地方法的?Enterprise?Bean，您必須對本地接口和本地home接口進(jìn)行編碼。本地接口定義?Bean?的業(yè)務(wù)方法；本地home接口定義其生命周期（創(chuàng)建 / 刪除）和查找程序方法。

本節(jié)介紹以下主題：


創(chuàng)建本地home接口?

創(chuàng)建本地接口?
創(chuàng)建本地home接口?
home接口定義使使用應(yīng)用程序的客戶端能夠創(chuàng)建和刪除實體?Bean?的方法。一個?Bean?的本地home接口定義使本地客戶端可以創(chuàng)建、查找和刪除?EJB?對象以及不是?Bean?實例特有的主業(yè)務(wù)方法（會話?Bean?不具有查找程序和主業(yè)務(wù)方法）。本地home接口由您定義，并由容器進(jìn)行實施。客戶端使用?JNDI?查找一個?Bean?的?home。?

本地home接口使客戶端可以：


在home內(nèi)創(chuàng)建新的實體對象?

在home內(nèi)查找現(xiàn)有實體對象?

從home刪除實體對象?

執(zhí)行主業(yè)務(wù)方法?
本地home接口始終擴(kuò)展?javax.ejb.EJBLocalHome。例如：?

??? import ?javax.ejb. * ;?
??? public ? interface ?MyEntityLocalBeanHome? extends ?EJBLocalHome? {?
??????MyEntityLocalBean?create()? throws ?CreateException;?
???} ?

創(chuàng)建本地接口
如果某個實體?Bean?是一種容器管理關(guān)系的目標(biāo)，該實體?Bean?必須具有本地接口。關(guān)系的方向確定某個?Bean?是否是一個目標(biāo)。由于實體?Bean?需要本地訪問，因此，參加容器管理關(guān)系的實體?Bean?必須駐留在同一?EJB?JAR?文件中。此本地性的主要優(yōu)點是提高了性能?－?本地調(diào)用比遠(yuǎn)程調(diào)用快。

由于本地接口遵循?pass?by?reference?語義，您必須明白可以共享通過本地接口傳遞的對象。尤其是，注意不要把一個?Enterprise?Bean?的狀態(tài)指定為另一個?Enterprise?Bean?的狀態(tài)。您還必須小心確定在本地接口之間傳遞哪些對象，尤其是在交易或安全內(nèi)容發(fā)生變化的情況下。?


接口必須擴(kuò)展?javax.ejb.EJBLocalHome?接口。?

本地home接口上的方法的?? throws ?子句不得包括?java.rmi.RemoteException。?

本地home接口中定義的每個方法必須是以下方法之一：??


創(chuàng)建方法?



查找程序方法?


home方法?
（本地）創(chuàng)建方法?

必須將每個創(chuàng)建方法命名為?createXXX，其中?XXX?是一個唯一方法名稱的附加部分，而且必須匹配?Enteprise?Bean?類中定義的?ejbCreateXXX?方法之一。例如，createEmployee(),?createLargeOrder(.)。?

Bean?中的匹配?ejbCreateXXX?必須具有其參數(shù)的同樣數(shù)目和類型（請注意，返回類型是不同的。）?

createXXX?方法的返回類型必須是實體?Bean?的本地接口類型。?

必須在遠(yuǎn)程接口的匹配?create?方法的? throws ?子句中定義?Enterprise?Bean?類匹配?ejbCreateXXX?和?ejbPostCreateXXX?方法? throws ?子句中定義的所有異常（即，為創(chuàng)建方法定義的異常集必須是為?ejbCreateXXX?和?ejbPostCreateXXX?方法定義的異常集合的超集）。?

創(chuàng)建方法的? throws ?子句必須包括?javax.ejb.CreateException。?
（本地）查找方法?

home接口可以定義一個或多個查找方法。必須將每個方法命名為?findXXX，其中?XXX?是唯一方法名稱擴(kuò)展。例如，findApplesAndOranges。?

每個查找程序方法必須與實體?Bean?類定義中定義的其中一個查找程序方法相對應(yīng)。?

數(shù)目和參數(shù)類型也必須與?Bean?類中的查找程序方法定義相對應(yīng)。?

查找? < METHOD > ?方法的返回類型必須是實體?Bean?的本地接口類型（適用于單對象查找程序）或其中的一個集合（適用于多對象查找程序）。?

必須將實體?Bean?類的?ejbFind?方法的? throws ?子句中定義的所有異常包括在遠(yuǎn)程home接口的匹配查找方法的? throws ?子句中。?

查找程序方法的? throws ?子句必須包括?javax.ejb.FinderException。?
findByPrimaryKey?方法?

每個本地home接口必須始終包括?findByPrimaryKey?方法，該方法始終是一個單對象查找程序。?

方法必須把主鍵類聲明為方法參數(shù)。?

必須把實體?Bean?類的?ejbFindByPrimaryKey?方法的? throws ?子句中定義的所有異常包括在遠(yuǎn)程home接口的匹配查找方法的? throws ?子句中。?

findByPrimaryKey?方法的? throws ?子句必須包括?javax.ejb.FinderException。?
（本地）home方法?

假如主方法與創(chuàng)建、查找和刪除方法名稱不一致，主方法就可以具有任意名稱。?

實體?Bean?類中指定的匹配?ejbHome?方法必須具有同樣的參數(shù)數(shù)目和類型，并且必須返回像?Bean?的本地home接口中指定的主方法一樣的類型。?
創(chuàng)建遠(yuǎn)程接口?
除了您在遠(yuǎn)程接口中定義的業(yè)務(wù)方法之外，EJBObject?接口定義使您能夠執(zhí)行以下操作的多種抽象方法：?


檢索?Bean?的home接口?

檢索?Bean?的句柄?－?檢索?Bean?的主鍵，該主鍵唯一識別?Bean?的實例?

將該?Bean?與另一個?Bean?進(jìn)行對比，看是否相同?

刪除不再需要的?Bean?
有關(guān)這些內(nèi)置方法以及如何使用這些方法的詳細(xì)信息，請參閱?Enterprise?JavaBeans?Specification? 2.0 。?





--------------------------------------------------------------------------------
注意??Enterprise?JavaBeans?Specification? 2.0 ?允許?Bean?類實施遠(yuǎn)程接口的方法，但是建議不要這樣做，以免無意中通過此方法將一個直接引用傳遞給客戶端，因而破壞??Enterprise?JavaBeans?Specification? 2.0 ?所要求的客戶端 - 容器 - EJB?協(xié)議。
?

--------------------------------------------------------------------------------




實體?Bean?的遠(yuǎn)程接口定義一個用戶對于?Bean?的方法的訪問權(quán)限。?

接口必須擴(kuò)展?javax.ejb.EJBObject?接口。?

遠(yuǎn)程接口中定義的方法必須遵循?RMI - IIOP?的規(guī)則。?

這意味著其參數(shù)和返回值類型必須是?RMI - IIOP?的有效類型，而且其? throws ?子句必須包括?java.rmi.RemoteException。?

至于遠(yuǎn)程接口中定義的每個方法，實例?Bean?的類中必須有一個匹配的方法。此匹配方法必須具有同一名稱、同樣的參數(shù)數(shù)目和類型以及同一返回類型。?

必須在遠(yuǎn)程接口方法? throws ?子句中定義?Enterprise?Bean?類匹配方法? throws ?子句中定義的異常。?

遠(yuǎn)程接口方法不得公開本地接口類型、本地home接口類型或作為參數(shù)或結(jié)果用于具有容器管理持久性的托管集合類。?
遠(yuǎn)程接口示例?
以下片段是一個遠(yuǎn)程接口示例：

import ?javax.ejb. * ;?
import ?java.rmi. * ;?

public ? interface ?MyEntity?
??? extends ?EJBObject?
??? {?
??? public ?String?getAddress()? throws ?RemoteException;
??? public ? void ?setAddress(String?addr)? throws ?RemoteException;
} ?

創(chuàng)建?Bean?類定義（適用于?Bean?管理持久性）
對于使用?Bean?管理持久性的實體?Bean，必須把?Bean?類定義為? public ，而且不能是? abstract 。Bean?類必須實施?javax.ejb.EntityBean?接口。例如：

import ?java.rmi. * ;
import ?java.util. * ;
import ?javax.ejb. * ;
public ? class ?MyEntityBean? implements ?EntityBean? {
??? // ????Entity?Bean?implementation.?These?methods?must?always?be?
???included.
??? public ? void ?ejbActivate()? {
???}
??? public ? void ?ejbLoad()? {
???}
??? public ? void ?ejbPassivate()? {
???}
??? public ? void ?ejbRemove()? {
???}
??? public ? void ?ejbStore()?t {
???}
??? public ? void ?setEntityContext(EntityContext?ctx)? {
???}
??? public ? void ?unsetEntityContext()? {
???}
??? // ?other?code?omitted?here.
???} ?

除了這些方法之外，實體?Bean?類還必須定義一個或多個?ejbCreate?方法和?ejbFindByPrimaryKey?查找程序方法。實體?Bean?類可以隨意為每個?ejbCreate?方法定義一個?ejbPostCreate。實體?Bean?類可以提供開發(fā)人員定義的額外的查找程序方法，這些方法形式為?ejbFindXXX，其中?XXX?表示一個唯一的方法名稱擴(kuò)展（例如，ejbFindApplesAndOranges），該擴(kuò)展與任何其他方法名稱不相重復(fù)。

實體?Bean?一般實施一個或多個業(yè)務(wù)方法。這些方法通常對于每個?Bean?都是唯一的，并且代表其特定功能。業(yè)務(wù)方法名稱可以是任何事情，但不得與?EJB?體系架構(gòu)中使用的方法名稱相沖突。必須將業(yè)務(wù)方法聲明為? public 。方法參數(shù)和返回值類型必須是合法?Java?RMI。 throws ?子句可以定義應(yīng)用程序特有的異常，并且可以包括?java.rmi.RemoteException。

有兩種在實體?Bean?中實施的業(yè)務(wù)方法類型：?


內(nèi)部方法?－?由其他業(yè)務(wù)方法在?Bean?中使用，但從不在?Bean?本身的外部訪問。?

外部方法?－?由實體?Bean?的遠(yuǎn)程接口引用。?
以下各節(jié)介紹實體?Bean?類定義中的各種方法：?


使用?ejbCreate?

使用?ejbActivate?和?ejbPassivate?

使用?ejbLoad?和?ejbStore?

使用?setEntityContext?和?unsetEntityContext?

使用?ejbRemove?

使用查找程序方法?
使用?ejbCreate
實體?Bean?必須實施一個或多個?ejbCreate?方法。針對允許客戶端調(diào)用?Bean?的每種方式，都必須有一個方法。例如：

public ?String?ejbCreate(String?orderId,?String?customerId,
???String?status,? double ?totalPrice)
??? throws ?CreateException? {
?????? try ? {
??????InitialContext?ic? = ? new ?InitialContext();
??????DataSource?ds? = ?(DataSource)?ic.lookup(dbName);
??????con? = ?ds.getConnection();
??????String?insertStatement? =
????????? " insert?into?orders?values?(???,???,???,???) " ;
??????PreparedStatement?prepStmt? =
?????????con.prepareStatement(insertStatement);
??????prepStmt.setString( 1 ,?orderId);
??????prepStmt.setString( 2 ,?customerId);
??????prepStmt.setDouble( 3 ,?totalPrice);
??????prepStmt.setString( 4 ,?status);
??????prepStmt.executeUpdate();
??????prepStmt.close();
???} ? catch ?(Exception?ex)? {
?????? throw ? new ?CreateException( " ejbCreate:? " ?
????????? + ex.getMessage());
???}
} ?

public ?String?ejbPostCreate(String?orderId,?String?customerId,String
status,? double ?totalPrice)?
??? throws ?CreateException?

{?
?
?
} ?

必須將每個?ejbCreate?方法聲明為? public ，?每個?ejbCreate?方法必須返回主鍵類型，而且必須命名為?ejbCreate。返回類型可以是出于鍵的目的轉(zhuǎn)換為一個數(shù)字的任何合法?Java?RMI?類型。所有參數(shù)都必須是合法?Java?RMI?類型。 throws ?子句可以定義應(yīng)用程序特有的異常，并且可以包括?java.ejb.CreateException。

這是用以建立關(guān)系的方法。對于每個?ejbCreate?方法，實體?Bean?類可以定義一個相應(yīng)?ejbPostCreate?方法來處理立即跟蹤創(chuàng)建的實體服務(wù)。必須將每個?ejbPostCreate?方法聲明為? public ，每個?ejbPostCreate?方法必須返回空白，并且命名為?ejbPostCreate。方法參數(shù)（如果有的話）必須在數(shù)目和參數(shù)類型方面匹配其相應(yīng)的?ejbCreate?方法。 throws ?子句可以定義應(yīng)用程序特有的異常，而且可以包括?java.ejb.CreateException。

使用?ejbActivate?和?ejbPassivate
當(dāng)一個服務(wù)器應(yīng)用程序需要每個實體?Bean?實例時，該?Bean?的容器調(diào)用?ejbActivate?準(zhǔn)備好一個要使用的?Bean?實例。同樣地，如果不再需要某個實例，該?Bean?的容器就調(diào)用?ejbPassivate，取消該?Bean?與應(yīng)用程序之間的關(guān)聯(lián)。?

如果在首次將一個?Bean?準(zhǔn)備好供某個應(yīng)用程序使用時或不再需要某個?Bean?時，需要執(zhí)行特定應(yīng)用程序任務(wù)，您應(yīng)在?ejbActivate?和?ejbPassivate?方法內(nèi)編寫這些操作的程序。例如，您可以在?ejbPassivate?期間發(fā)布對數(shù)據(jù)庫和后臺資源的應(yīng)用，以及在?ejbActivate?期間重新獲得它們。

使用?ejbLoad?和?ejbStore
實體?Bean?可以與容器協(xié)作，把?Bean?狀態(tài)信息存儲在一個數(shù)據(jù)庫中，以便于執(zhí)行同步操作。如果是?Bean?管理持久性，您負(fù)責(zé)對?ejbLoad?和?ejbStore?進(jìn)行編碼。容器通過在一項事務(wù)開始時調(diào)用?ejbLoad?以及在事務(wù)成功完成時調(diào)用?ejbStore，確保?Bean?的狀態(tài)與數(shù)據(jù)庫同步。?

使用您的?ejbStore?實施將數(shù)據(jù)信息存儲在數(shù)據(jù)庫中，并使用您的?ejbLoad?實施從數(shù)據(jù)庫中檢索狀態(tài)信息。?

以下示例顯示存儲和檢索活動數(shù)據(jù)的?ejbLoad?和?ejbStore?方法定義。?

public ? void ?ejbLoad()
?????? throws ?java.rmi.RemoteException
{
???String?itemId;
???javax.sql.Connection?dc? = ? null ;
???java.sql.Statement?stmt? = ? null ;
???java.sql.ResultSet?rs? = ? null ;

???itemId? = ?(String)?m_ctx.getPrimaryKey();

???System.out.println( " myBean:?Loading?state?for?item? " ? + ?itemId);

???String?query? =
?????? " SELECT?s.totalSold,?s.quantity? " ? +
?????? " ?FROM?Item?s? " ? +
?????? " ?WHERE?s.item_id?=? " ? + ?itemId;

???dc? = ? new ?DatabaseConnection();
???dc.createConnection(DatabaseConnection.GLOBALTX);
???stmt? = ?dc.createStatement();
???rs? = ?stmt.executeQuery(query);

??? if ?(rs? != ? null )? {
??????rs.next();
??????m_totalSold? = ?rs.getInt( 1 );
??????m_quantity? = ?rs.getInt( 2 );
???}
} ?

public ? void ?ejbStore()
?????? throws ?java.rmi.RemoteException
{
???String?itemId;
???itemId? = ?(String)?m_ctx.getPrimaryKey();
???DatabaseConnection?dc? = ? null ;
???java.sql.Statement?stmt1? = ? null ;
???java.sql.Statement?stmt2? = ? null ;

???System.out.println( " myBean:?Saving?state?for?item?=? " ? + ?itemId);

???String?upd1? =
?????? " UPDATE?Item? " ? +
?????? " ?SET?quantity?=? " ? + ?m_quantity? +
?????? " ?WHERE?item_id?=? " ? + ?itemId;

???String?upd2? =
?????? " UPDATE?Item? " ? +
?????? " ?SET?totalSold?=? " ? + ?m_totalSold? +
?????? " ?WHERE?item_id?=? " ? + ?itemId;

???dc? = ? new ?DatabaseConnection();
???dc.createConnection(DatabaseConnection.GLOBALTX);
???stmt1? = ?dc.createStatement();
???stmt1.executeUpdate(upd1);
???stmt1.close();
???stmt2? = ?dc.createStatement();

???stmt2.executeUpdate(upd2);
???stmt2.close();
} ?

有關(guān)訪問與其他?Bean?并發(fā)的事務(wù)的?Bean?隔離級別的詳細(xì)信息，請參閱?

使用?setEntityContext?和?unsetEntityContext
容器在其創(chuàng)建一個實體?Bean?實例（該實例為?Bean?提供一個連接容器的接口）之后，調(diào)用?setEntityContext。實施此方法存儲容器傳遞的實體上下文。隨后，您可以使用此引用獲取該實例的主鍵，等等。?

??? public ? void ?setEntityContext(javax.ejb.EntityContext?ctx)
??? {
???m_ctx? = ?ctx;
???} ?

同樣地，容器調(diào)用?unsetEntityContext?從實例中刪除容器引用。這是?Bean?實例成為要刪除的對象之前容器調(diào)用的最后一個?Bean?類方法。執(zhí)行此調(diào)用之后，Java?垃圾收集機制最終調(diào)用實例上的?finalize?將其清除，并加以處置。

??? public ? void ?unsetEntityContext()
??? {
???m_ctx? = ? null ;
???} ?

使用?ejbRemove
客戶端可以調(diào)用實體?Bean?的home接口或組件接口上的刪除方法，從數(shù)據(jù)庫中刪除相關(guān)記錄。容器調(diào)用某個實體?Bean?實例上的?ejbRemove?方法，響應(yīng)實體?Bean?的home接口或組件接口上的客戶端調(diào)用，或者作為?cascade - delete?操作的結(jié)果。?

使用查找程序方法
由于實體?Bean?具有持久性、可在客戶端之間共享，可擁有不只一個同時實例化的實例，因此，一個實體?Bean?必須實施至少一個?ejbFindByPrimaryKey?方法。這使客戶端和容器能夠查找特定?Bean?實例。所有實體?Bean?必須提供一個唯一主鍵，作為一個識別簽名。在?Bean?的類中實施?ejbFindByPrimaryKey?方法，使一個?Bean?能夠?qū)⑵渲麈I返回到容器。?

下面的示例顯示?FindByPrimaryKey?的一個定義：?

public ?String?ejbFindByPrimaryKey(String?key)
?????? throws ?java.rmi.RemoteException,
?????????javax.ejb.FinderException?

在某些情況下，您根據(jù)?Enterprise?Bean?的作用、根據(jù)實例所使用的某些值或根據(jù)其他條件，查找特定實體?Bean?實例。這些針對實施的查找程序方法名稱的形式為?ejbFindXXX，其中?XXX?表示一個不重復(fù)任何其他方法名稱（例如，ejbFindApplesAndOranges）的方法名稱的唯一擴(kuò)展。?

必須將查找程序方法聲明為? public ?，而且其參數(shù)以及返回值必須為合法?Java?RMI?類型。每個查找程序方法返回類型必須是實體?Bean?的主鍵類型或具有同一主鍵類型的對象的集合。如果返回類型為一個集合，返回類型必須是以下兩項之一：


JDK? 1.1 ?java.util.Enumeration?接口?

Java? 2 ?java.util.Collection?接口?
查找程序方法的? throws ?子句是一個應(yīng)用程序特有的異常，而且可能包括?java.rmi.RemoteException?和 / 或?java.ejb.FinderException。

使用只讀?Bean?

--------------------------------------------------------------------------------

只讀?Bean?是一種?EJB?客戶端從不修改的實體?Bean。只讀?Bean?表現(xiàn)的數(shù)據(jù)可以由其他?Enterprise?Bean?從外部進(jìn)行更新，也可以通過其他手段更新，如直接數(shù)據(jù)庫更新。





--------------------------------------------------------------------------------
注意??對于此版?Sun?Java?System?應(yīng)用服務(wù)器，只能把使用?Bean?管理持久性的實體?Bean?指定為只讀。

只讀?Bean?為?Sun?Java?System?應(yīng)用服務(wù)器所特有，而且不是?Enterprise?JavaBeans?Specification? 2.0 ?的組成部分。
?

--------------------------------------------------------------------------------



本節(jié)介紹以下主題：


只讀?Bean?特征和生命周期?

只讀?Bean?良好做法?

刷新只讀?Bean?

部署只讀?Bean?
只讀?Bean?特征和生命周期
只讀?Bean?最適合于基本數(shù)據(jù)從不變化或極少變化的情形。例如，只讀?Bean?可用來表示某個公司的股票價格（外部更新）。在此情況下，使用常規(guī)實體?Bean?可能會增加調(diào)用?ejbStore?的負(fù)擔(dān)，使用只讀?Bean?就可以避免這種情況。

只讀?Bean?具有以下特征：


只有實體?Bean?可以是只讀?Bean。?

僅允許?Bean?管理持久性。?

僅允許容器管理事務(wù)；只讀?Bean?無法啟動其自己的事務(wù)。?

只讀?Bean?不更新任何?Bean?狀態(tài)。?

ejbStore?從不由容器調(diào)用。?

只有在調(diào)用事務(wù)方法時，或最初（在緩存）中創(chuàng)建?Bean?時，或在?Bean?的?refresh - period - in - seconds?控制的定期間隔時，才調(diào)用?ejbLoad。?

home接口可以擁有任意數(shù)目的查找方法。查找方法的返回類型必須是同一?Bean?類型的主鍵（或一個主鍵集合）。?

如果?Bean?代表的數(shù)據(jù)可以更改，則必須將?refresh - period - in - seconds?設(shè)置為按定期間隔刷新。ejbLoad?是按定期間隔調(diào)用的。?
只讀?Bean?使用適當(dāng)查找方法而存在。?

只讀?Bean?被緩存起來，并具有與實體?Bean?相同的緩存屬性。當(dāng)選擇只讀?Bean?作為在緩存中騰出空間的犧牲者時，就調(diào)用?ejbPassivate，并將?Bean?返回到自由池。在自由池時，Bean?不具有任何標(biāo)識，并將僅用于作為任何查找程序請求。?

只讀?Bean?被捆綁到像讀寫實體?Bean?這樣的命名服務(wù)，而且客戶端可以用查找讀寫實體?Bean?一樣的方法查找只讀?Bean。?

只讀?Bean?良好做法

避免home接口中有任何?create?或?remove?方法?

將任何有效的?EJB? 2.0 ?事務(wù)屬性用于方法事務(wù)屬性?
擁有?TX_SUPPORTED?的理由是可以在同一事務(wù)中讀取未授權(quán)的數(shù)據(jù)。而且，TX?屬性可用于強制?ejbLoad。?

刷新只讀?Bean
刷新只讀?Bean?的方法有多種，它們在以下各節(jié)中進(jìn)行討論：


調(diào)用事務(wù)方法?

定期刷新?

已編程方式刷新?
調(diào)用事務(wù)方法?
調(diào)用任何事務(wù)方法將會調(diào)用?ejbLoad。?

定期刷新?
通過在?Sun?Java?System?應(yīng)用服務(wù)器特有的?XML?文件中指定?refresh - period - in - seconds?元素，可以定期刷新只讀?Bean。?


如果在?refresh - period - in - seconds?中指定的值為零，就從不刷新?Bean（除非訪問某個事務(wù)方法）。?

如果值大于零，則按指定頻率刷新?Bean。?




--------------------------------------------------------------------------------
注意??如果可在?Sun?Java?System?應(yīng)用服務(wù)器之外修改數(shù)據(jù)，這就是刷新?Bean?狀態(tài)的唯一方法。?
?

--------------------------------------------------------------------------------



以編程方式刷新?
一般情況下，更新只讀?Bean?緩存的任何數(shù)據(jù)的?Bean?需要通知只讀?Bean?刷新其狀態(tài)。您可以使用?ReadOnlyBeanNotifier?來強制刷新只讀?Bean。為此，在?ReadOnlyBeanNotifier?Bean?上調(diào)用以下方法：

??? public ? interface ?ReadOnlyBeanNotifier?
?????? extends ?java.rmi.Remote?
??? {?
??????refresh(Object?PrimaryKey)?
????????? throws ?RemoteException;?
???} ?

容器提供對?ReadOnlyBeanNotifier?接口的實施。用戶可以使用以下代碼片段查找?ReadOnlyBeanNotifier：?

com.sun.ejb.ReadOnlyBeanNotifier?notifier? = ?com.sun.ejb.containers.ReadOnlyBeanHelper.getReadOnlyBeanNotifier
???( < ejb - name - of? - the - target > );?
???notifier.refresh( < PrimaryKey > );?

更新只讀?Bean?緩存的任何數(shù)據(jù)的?Bean?需要調(diào)用?refresh?方法。下一次調(diào)用只讀?Bean?的（非事務(wù)性）調(diào)用時，就會調(diào)用?ejbLoad。?

部署只讀?Bean?
只讀?Bean?是用與其他實體?Bean?相同的方式部署的。但是，在?Sun?Java?System?應(yīng)用服務(wù)器特有的?XML?文件中的?Bean?的輸入中，必須把?is - read - only - bean?元素設(shè)置為?True（真）。也就是：

< is - read - only - bean > true </ is - read - only - bean >

另外，可以把?refresh - period - in - seconds?元素設(shè)置為指定刷新?Bean?的頻率的某些值。如果丟失此元素，就假定?? 600 （秒）默認(rèn)值。?

具有相同事務(wù)上下文的所有請求都被路由到同一只讀?Bean?實例。部署者可以通過將?allow - concurrent - access?元素設(shè)置為真（允許同時方法）或?False（假）（將并發(fā)訪問序列化為同一只讀?Bean），指定是否必須序列化這么多請求。?

有關(guān)這些元素的詳細(xì)信息，請參閱?Sun?Java?System?應(yīng)用服務(wù)器管理員配置文件參考。

處理并發(fā)訪問的同步?

--------------------------------------------------------------------------------

作為一名實體?Bean?開發(fā)者，您一般不需要考慮從多個事務(wù)并發(fā)訪問一個實體?Bean。在這些情況下，該?Bean?的容器自動提供同步。在?Sun?Java?System?應(yīng)用服務(wù)器中，容器針對每個同時發(fā)生并使用?Bean?的事務(wù)，激活一個實體?Bean。?

事務(wù)同步是由基本數(shù)據(jù)庫在數(shù)據(jù)庫訪問調(diào)用期間自動執(zhí)行的。您一般與基本數(shù)據(jù)庫或資源一起執(zhí)行此同步。一種方法是在?ejbLoad?方法中獲得相應(yīng)數(shù)據(jù)庫鎖定，例如通過選擇適當(dāng)隔離級別或通過使用一個用于?update?子句的?select。具體情況取決于所使用的數(shù)據(jù)庫。?

有關(guān)詳細(xì)信息，請參閱?Enterprise?JavaBeans?Specification? 2.0 ，因為該規(guī)范與并發(fā)訪問相關(guān)

posted on 2007-01-18 17:51 youngturk 閱讀(288) 評論(0)  編輯  收藏 所屬分類: 關(guān)于EJB學(xué)習(xí)