J2EE 編程規範 (二)：Entity Bean 完整編寫規則與 Home Interface 規範

Entity Bean 特徵

• 代表持久化實體 (通常為資料庫記錄)
• 持久性：BMP (Bean-Managed) / CMP (Container-Managed)
• 允許共享存取
• 擁有主鍵

Bean 類別編寫規則

1. 實作 EntityBean 介面
2. 類別 public、非 abstract、非 final
3. 實作 ejbCreate、ejbPostCreate、ejbRemove、ejbLoad、ejbStore、ejbActivate、ejbPassivate、setEntityContext、unsetEntityContext
4. 僅 BMP 實作 ejbFind 等查詢方法
5. 實作業務方法
6. 含無參建構子
7. 不可實作 finalize()

ejbCreate 規則

• public
• 回傳主鍵類型 (僅 BMP)
• 參數為合法 Java RMI 型別
• 非 final/static
• 拋出 CreateException 及應用例外

ejbPostCreate 規則

• 每個 ejbCreate 對應一個 ejbPostCreate (通常為空)
• 參數數量/型別與對應 ejbCreate 相同
• public, 非 final/static
• 回傳 void
• 拋出 CreateException 及應用例外

ejbRemove / ejbLoad / ejbStore

• ejbRemove：刪除資料庫實體狀態
• ejbLoad：從資料庫刷新實例變數
• ejbStore：將實例變數寫入資料庫
• 兩者用於同步實體 Bean 狀態與資料庫

Finder 方法規則

• 必須實作 ejbFindByPrimaryKey
• 方法名以 ejbFind 開頭
• public, 非 final/static
• 參數為合法 Java RMI 型別
• 回傳主鍵或主鍵集合 (Collection/Enumeration)
• 拋出 FinderException 及應用例外

業務方法規則

• 方法名不可與 EJB 結構方法衝突
• public
• 非 final/static
• 參數為合法 Java RMI 型別

Home Interface 編寫規則

Create 方法

• 參數與 Bean 類別對應 ejbCreate 相同
• 回傳 Remote Interface 型別
• 拋出對應 ejbCreate/ejbPostCreate 例外

Finder 方法

• 每個方法與 Bean 類別對應 ejbFind 方法匹配
• 命名規則相同 (findBy...)
• 參數/回傳型別為合法 Java RMI 型別
• 拋出 RemoteException

Remote Interface 編寫規則

• 繼承 EJBObject
• 方法拋出 RemoteException
• 定義業務方法簽名