新增訊息目的地參照

J2EE 1.4 規格提供一種方法,供 J2EE 元件利用稱為訊息目的地參照的「邏輯」名稱來參照訊息目的地物件。您可以利用部署描述子編輯器來定義訊息目的地參照。

訊息目的地參照指向 EJB 模組中的訊息驅動 Bean (MDB)。

在部署時,訊息目的地參照會連結於目標作業環境中接受管理的訊息目的地。

限制: 只有下列最低專案層次可以包括訊息目的地參照:
  • J2EE 1.4 應用程式用戶端
  • EJB 2.1 專案
  • 2.4 Web 應用程式

您定義的每個訊息目的地參照,在這個應用程式元件的部署描述子中都會新增一個 message-destination-ref 元素。訊息目的地參照以它們定義在其中的應用程式元件為範圍,因此,在執行時期,其他應用程式元件無法存取它們。 其他元件也可以定義同名的訊息目的地參照,不會發生名稱衝突。

如果要定義訊息目的地參照,請執行下列動作:

  1. 從 J2EE 模組的部署描述子編輯器中,開啟「新增參照」精靈
  2. 選取訊息目的地參照,按下一步
  3. 在專案樹中,選取提供您要參照的訊息目的地物件之訊息驅動 Enterprise Bean。
  4. 名稱欄位中,指定參照的名稱,或接受精靈所提供的預設名稱(建議接受)。 部署描述子中的 message-destination-ref-name 項目會使用在名稱欄位中輸入的值。

    訊息目的地參照的名稱是相對於 java:comp/env 環境定義。比方說,名稱應該是 jms/BidQueue,而不是 java:comp/env/jms/BidQueue

  5. 下一步
  6. 類型欄位中,選取所參照之目的地的預期類型。 比方說,如果是 JMS 目的地,類型可能是 javax.jms.Queue。 部署描述子中的 message-destination-ref-type 項目會使用在這個欄位中輸入的值。
  7. 用法欄位中,指示訊息目的地會耗用或產生訊息。 部署描述子中的 message-destination-ref-usage 項目會使用這裡指定的值。
  8. 說明文字區中,輸入參照的說明。
  9. 按一下完成
相關概念
用戶端部署描述子編輯器
相關工作
定義 J2EE 模組中的參照
新增 EJB 參照
新增資源管理程式 Connection Factory 參照
新增資源環境參照
新增安全角色參照
新增 Web 服務參照
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.