使用精靈來建立訊息驅動 Bean

您可以使用「建立 EJB 3.x 訊息驅動 Bean」精靈,來建立訊息驅動 Bean,並將它新增至專案。

開始之前

您必須在工作區中建立 Java™ 專案、EJB 專案或 Web 專案。

關於這項作業

訊息驅動 Bean 和 Session Bean 之間的主要差異,是訊息驅動 Bean 沒有本端或遠端介面。相反地,它只有一個 Bean 類別。

程序

  1. 在 Java EE 視景中,用滑鼠右鍵按一下您的專案,然後選取新建 > 訊息驅動 Bean。會開啟「建立 EJB 3.x 訊息驅動 Bean」精靈。
  2. 在來源資料夾欄位中,選取新 Bean 的來源資料夾。
  3. 在套件欄位中,輸入新 Bean 的套件名稱。
  4. 在名稱欄位中,輸入您要指派給訊息驅動 Bean 的名稱。依照慣例,Bean 名稱以大寫字母開頭。
  5. 在目的地名稱欄位中,輸入您想指派給目的地的名稱。
  6. 選取 JMS,以使用 Java 傳訊服務,或清除 JMS,使用另一項傳訊服務。
  7. 在目的地類型欄位中,選取佇列或主題目的地類型,並按下一步。
  8. 在訊息驅動 Bean 專用資訊頁面的交易類型欄位中,選取儲存器(若為儲存器管理的交易)或 Bean(若為 Bean 管理的交易)。
  9. 按一下完成。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 會提供傳訊系統專用的配置資訊。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcreatingmessdrivwiz.html