新增 EJB 參照

EJB 參照是用戶端(或另一個 Bean)用來尋找 Enterprise Bean Home 介面的一個邏輯名稱。您可以定義一些參照來指向 EJB 模組、J2EE 應用程式用戶端模組和 J2EE 動態 Web 模組中的 Enterprise Bean。

它是針對您需要參照的任何 Enterprise Bean,使用 EJB 參照的最佳做法。 在使用 EJB 參照時, 您可以放心撰寫 Java™ 程式碼, 來查閱目標 Enterprise Bean 的 Home 介面,而不必擔心目標 Enterprise Bean 的連結會變更。 如果您需要在同一個伺服器,以不同的連結安裝同一個 EJB 模組,就必須用到它。

在部署時,EJB 參照會連結至目標作業環境中的 Enterprise Bean Home。 儲存器會將應用程式的 EJB 參照提供在 JNDI 命名環境定義中。

註:
  • EJB 1.1 Enterprise Bean 和應用程式用戶端模組無法參照 Enterprise Bean 的本端介面。它們必須參照遠端介面。
  • 如果要使模組或 Bean 參照 Enterprise Bean 的本端介面,所參照的 Bean 必須併入參照它的模組或 Bean 的相同企業應用程式 (EAR) 中。
  • 如果能夠使用本端或遠端參照,您應該使用本端參照,這樣執行時期效能會比較好。

您定義的每個 EJB 參照,在部署描述子中都會新增一個 ejb-ref 元素。

如果要定義 EJB 參照,請執行下列動作:

  1. 從 J2EE 模組的部署描述子編輯器中,開啟「新增參照」精靈
  2. 選取 EJB 參照,按下一步
  3. 選擇指定您要參照的 Enterprise Bean(所參照的 Bean)的下列選項之一:
    • 工作區中的 Enterprise Bean:請選取這個選項來從目前在工作區的專案中選擇一個 Enterprise Bean。樹狀結構會顯示工作區中的 EJB 模組,且會列出 EJB 模組中所能使用的 Enterprise Bean。
    • 不在工作區中的 Enterprise Bean:請選取這個選項來選擇在工作區之外的 Enterprise Bean。
  4. 如果您選取工作區中的 Enterprise Bean,請完成下列步驟:
    1. 展開專案樹,選取您要參照的 Enterprise Bean。
    2. 名稱欄位中,輸入參照的名稱,或接受精靈所提供的預設名稱(建議接受)。
    3. 如果您在參照 EJB 2.1 Bean,請在參照類型欄位中,指定您是參照 Enterprise Bean 的本端或遠端介面。
      記住:
      • EJB 1.1 Enterprise Bean 和應用程式用戶端模組不能參照 Enterprise Bean 的本端介面。它們必須參照遠端介面。
      • 如果要使模組或 Bean 參照 Enterprise Bean 的本端介面,所參照的 Bean 必須併入參照它的模組或 Bean 的相同企業應用程式 (EAR) 中。
      重要: 如果您參照另一個 EAR 中的 Enterprise Bean,且這個 Bean 的專案不包括 EJB 用戶端 JAR,工作台會自動建立所參照的 EJB 專案的 EJB 用戶端 JAR。 這會改進執行時期效能,且接受跨越不同 EAR 檔的可見性。
  5. 如果您選取不在工作區中的 Enterprise Bean,請完成下列步驟:
    1. 名稱欄位中,輸入參照的名稱。
    2. 類型欄位中,指定所參照的 Bean 是 Session Bean 或 Entity Bean。
    3. Home 欄位中,輸入 Enterprise Bean 遠端起始位置的完整路徑。 請利用選取類型對話框,按一下瀏覽來尋找遠端起始位置。
    4. 遠端欄位中,輸入 Enterprise Bean 遠端介面的完整路徑。 請利用選取類型對話框,按一下瀏覽來尋找遠端介面。
  6. 下一步,檢視您所做的選擇,並且輸入參照說明。
  7. 按一下完成
相關概念
用戶端部署描述子編輯器
相關工作
定義 J2EE 模組中的參照
新增訊息目的地參照
新增資源管理程式 Connection Factory 參照
新增資源環境參照
新增安全角色參照
新增 Web 服務參照
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.