利用 EJB QL 將 finder 方法新增至 EJB 2.x Bean 中

您可以在 EJB 2.x CMP Bean 的 Home 介面中,新增 "find" 或 "ejbSelect" finder 方法。 這些 finder 方法使用 EJB 查詢語言。 精靈會帶您逐步將新的或現有的搜尋器新增至您的 Bean 中。

EJB 查詢語言 (EJB QL) 語法以 SQL 為基礎,可進行 Enterprise Bean 的持續性屬性及相關 Bean 屬性的查詢。 查詢語言與 Bean 至關聯式資料儲存庫的對映無關,它是可攜的。在部署時,會根據 Bean 的綱目對映將查詢語言編譯成 SQL。

如果需要 EJB QL 的詳細資料,請移至 WebSphere Application Server 資訊中心,搜尋關鍵字 "EJB QL"。

如果要新增 EJB QL 查詢至 EJB 2.x Enterprise Bean 中,請執行下列動作:

  1. 在 J2EE 視景的「專案瀏覽器」視圖中,用滑鼠右鍵按一下 EJB 專案的部署描述子,再選取開啟工具 > 部署描述子編輯器來開啟部署描述子編輯器。
  2. 在編輯器的 Bean 頁面中,選取要新增 finder 方法的 EJB 2.x CMP Entity Bean。
  3. 捲至「查詢」區段,按一下新增。這時會開啟「新增搜尋器描述子」精靈。
  4. 請選取下列選項之一:
    • 新建 - 建立新的 finder 方法。
    • 現有 - 使用現有的 finder 方法。
  5. 從下列選項中選取方法類型:
    • finder 方法 - finder 方法定義在 Entity Bean 的 Home 介面(本端、遠端,或本端與遠端)中。finder 方法的傳回值和結果會視其定義的位置而定。
    • ejbSelect 方法 - ejbSelect 方法是特殊查詢方法,它不會直接顯示在用戶端視圖中。ejbSelect 方法通常會用來選取實體的持續性狀態,或選取定義的查詢所要處理的 Entity Bean 之相關實體。
  6. 如果您是使用現有的搜尋器,請從找到的搜尋器清單中選取,再按一下完成
  7. 如果您定義了新的搜尋器,請完成下列步驟。
  8. 對於搜尋器類型,請選取下列中的至少一個勾選框:
    • 本端 - 請選取這個選項來將方法宣告新增至本端方法呼叫的本端 Home 介面中。
    • 遠端 - 請選取這個選項來將方法宣告新增至遠端方法呼叫的遠端 Home 介面中。
    您可以同時選取這兩個勾選框,將搜尋器同時併入遠端和本端介面中。您的 Bean 必須包括對應的介面,才能使用勾選框。
  9. 選擇性的: 如果您正在建立 ejbSelect 方法,您可以選取傳回遠端實體勾選框。這個選項表示您要傳回遠端參照。這個選項只適用於這個方法類型。
  10. 名稱欄位中,輸入新查詢的名稱。查詢方法名稱的開頭必須是表示所選類型的字母,如 findejbSelect
  11. 選擇性的: 按一下新增來新增方法參數。
  12. 傳回類型下拉清單中,選取 finder 方法將傳回的類型。
  13. 下一步Bean抽象綱目名稱查詢方法名稱欄位都是唯讀的。
  14. 選擇性的: 說明文字區中,輸入方法的說明。
  15. 選擇性的: 為了協助您產生 EJB 查詢,開始時,您可以從選取範例查詢下拉清單中選取範例查詢。
  16. 輸入或修改查詢陳述式文字區中的查詢。
  17. 按一下完成
這時會將 <query></query> 元素新增至 Bean 的部署描述子中。實際的查詢會新增至 <ejb-ql></ejb-ql> 元素中。方法宣告會新增至 Home 介面(本端、遠端,或本端與遠端,這會隨著您的選項而不同)中。
如果要編輯或移除查詢,請在「查詢」區段中選取查詢,再按一下編輯移除
相關概念
CMP Entity Bean 的 finder 方法
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.