使用精靈來建立訊息驅動 Bean
您可以使用「建立 EJB 3.x 訊息驅動 Bean」精靈,來建立訊息驅動 Bean,並將它新增至專案。
開始之前
關於這項作業
訊息驅動 Bean 和 Session Bean 之間的主要差異,是訊息驅動 Bean 沒有本端或遠端介面。相反地,它只有一個 Bean 類別。
程序
- 在 Java EE 視景中,用滑鼠右鍵按一下您的專案,然後選取新建 > 訊息驅動 Bean。會開啟「建立 EJB 3.x 訊息驅動 Bean」精靈。
- 在來源資料夾欄位中,選取新 Bean 的來源資料夾。
- 在套件欄位中,輸入新 Bean 的套件名稱。
- 在名稱欄位中,輸入您要指派給訊息驅動 Bean 的名稱。依照慣例,Bean 名稱以大寫字母開頭。
- 在目的地名稱欄位中,輸入您想指派給目的地的名稱。
- 選取 JMS,以使用 Java 傳訊服務,或清除 JMS,使用另一項傳訊服務。
- 在目的地類型欄位中,選取佇列或主題目的地類型,並按下一步。
- 在訊息驅動 Bean 專用資訊頁面的交易類型欄位中,選取儲存器(若為儲存器管理的交易)或 Bean(若為 Bean 管理的交易)。
- 按一下完成。Java 編輯器含有您訊息驅動 Bean 類別的預設程式碼:
package com.ibm.test; import javax.ejb.ActivationConfigProperty; import javax.ejb.MessageDriven; import javax.jms.Message; import javax.jms.MessageListener; /** * Message-Driven Bean implementation class for: TestMdb * */ @MessageDriven( activationConfig = { @ActivationConfigProperty( propertyName = "destinationType", propertyValue = "javax.jms.Queue" ) }) public class TestMdb implements MessageListener { /** * Default constructor. */ public TestMdb() { // TODO Auto-generated constructor stub } /** * @see MessageListener#onMessage(Message) */ public void onMessage(Message message) { // TODO Auto-generated method stub } }在這個預設訊息驅動 Bean 程式碼範例中,請注意下列要點:- 在 EJB 3.x 中,@MessageDriven 註釋指定一組啟動配置參數。這些參數專屬於用來驅動訊息驅動 Bean 之特定類型的 JCA 1.5 配接器。有些配接器會有配置參數,以讓您指定訊息驅動 Bean 的目的地佇列。如果配接器不支援這樣做,必須在 XML 連結檔中使用 <message-destination> 項目來指定目的地名稱。
- Bean 類別必須實作 MessageListener 介面,而它只會定義一個 onMessage 方法。當訊息送達這個 MDB 所監視的佇列時,儲存器會呼叫 Bean 類別的 onMessage 方法,並將送入訊息當成參數傳入。
- @MessageDriven 註釋的 ActivationConfigProperty 會提供傳訊系統專用的配置資訊。
上層主題: 使用精靈來建立 Enterprise Bean