EJB-メッセージ駆動型Bean

メッセージ駆動型Beanは、エンタープライズBeanの一種であり、キューまたはトピックからメッセージを受信したときにEJBコンテナによって呼び出されます。メッセージ駆動型BeanはステートレスBeanであり、タスクを非同期的に実行するために使用されます。

メッセージ駆動型Beanの使用法を示すために、EJB永続性の章を使用し、次のタスクを実行する必要があります。

Step 1−データベースにテーブルを作成します（EJB-永続性の章を参照）。
Step 2−テーブルに対応するエンティティクラスを作成します（EJB-永続性の章を参照）。
Step 3−データソースと永続性ユニットを作成します（EJB-永続性の章を参照）。
Step 4− EntityManagerインスタンスを持つステートレスEJBを作成します（EJB-永続性の章を参照）。
Step 5−ステートレスejb.Addメソッドを更新して、エンティティマネージャを介してレコードを追加し、データベースからレコードを取得します（EJB-永続性の章を参照）。
Step 6 −という名前のキューを作成します BookQueue JBossで default アプリケーションディレクトリ。
Step 7 −コンソールベースのアプリケーションクライアントは、このキューにメッセージを送信します。
Step 8 −メッセージ駆動型Beanを作成します。これは、ステートレスBeanを使用してクライアントデータを永続化します。
Step 9 − jbossのEJBコンテナは、上記のメッセージ駆動型Beanを呼び出し、クライアントが送信するメッセージを渡します。

キューを作成

に存在しない場合は、jbossmq-destinations-service.xmlという名前のファイルを作成します <JBoss Installation Folder> > server > default > deploy フォルダ。

ここでは、BookQueueという名前のキューを作成しています-

jbossmq-destinations-service.xml

<mbean code="org.jboss.mq.server.jmx.Queue"  
   name="jboss.mq.destination:service=Queue,name=BookQueue">  
   <depends optional-attribute-name="DestinationManager">
      jboss.mq:service=DestinationManager
   </depends>  
</mbean>

JBossを起動すると、jbossログに同様のエントリが表示されます。

...
10:37:06,167 INFO  [QueueService] Queue[/queue/BookQueue] started, fullSize=200000, pageSize=2000, downCacheSize=2000
...

メッセージ駆動型Beanの作成

@MessageDriven(
   name = "BookMessageHandler",
   activationConfig = {
      @ActivationConfigProperty( propertyName = "destinationType", 
                                 propertyValue = "javax.jms.Queue"),
      @ActivationConfigProperty( propertyName = "destination", 
                                 propertyValue ="/queue/BookQueue")
   }
)
public class LibraryMessageBean implements MessageListener {
 
   @Resource
   private MessageDrivenContext mdctx;  
 
   @EJB
   LibraryPersistentBeanRemote libraryBean;
 
   public LibraryMessageBean() {        
   }
 
   public void onMessage(Message message) {
   }
}

LibraryMessageBeanには、@ MessageDrivenアノテーションが付けられ、メッセージ駆動型Beanとしてマークされます。
そのプロパティは、destinationType-キューおよびdestination- / queue / BookQueueとして定義されています。
onMessageメソッドを公開するMessageListenerインターフェースを実装します。
リソースとしてMessgeDrivenContextがあります。
LibraryPersistentBeanRemoteステートレスBeanは、永続化の目的でこのBeanに注入されます。

EjbComponentプロジェクトをビルドし、JBossにデプロイします。EJBモジュールをビルドしてデプロイした後、jbossキューにメッセージを送信するクライアントが必要です。

アプリケーション例

メッセージ駆動型BeanをテストするためのテストEJBアプリケーションを作成しましょう。

ステップ	説明
1	名前を持つプロジェクト作成はEJBComponentパッケージの下com.tutorialspoint.entityをで説明したようにEJB -アプリケーション作成の章を。この章でEJB-アプリケーションの作成の章で作成されたプロジェクトを使用して、EJBの永続性の概念を理解することもできます。
2	作成Book.javaをパッケージの下com.tutorialspoint.entityで作成されたとしてEJB-持続性の章を参照してください。
3	EJB-永続性の章で作成したLibraryPersistentBean.javaとLibraryPersistentBeanRemoteを作成します。
4	でjboss-ds.xmlを作成しますEjbComponent > setup フォルダおよびpersistence.xmlの中EjbComponent > src > conf フォルダ。これらのフォルダは、EJB-永続性の章で作成されたNetbeansの「ファイル」タブに表示されます。
5	作成LibraryMessageBean.javaをパッケージ下com.tutorialspoint.messagebeanと下図のように変更します。
6	上記のように、JbossでBookQueueキューを作成します。
7	アプリケーションをクリーンアップしてビルドし、ビジネスロジックが要件に従って機能していることを確認します。
8	最後に、アプリケーションをjarファイルの形式でJBoss ApplicationServerにデプロイします。JBoss Application Serverは、まだ起動されていない場合、自動的に起動されます。
9	次に、トピックの「EJB-アプリケーションの作成」の章で説明したのと同じ方法で、コンソールベースのアプリケーションであるEJBクライアントを作成します。Create Client to access EJB。以下のように変更してください。

EJBComponent（EJBモジュール）

LibraryMessageBean.java

package com.tutorialspoint.messagebean;
 
import com.tutorialspoint.entity.Book;
import com.tutorialspoint.stateless.LibraryPersistentBeanRemote;
import javax.annotation.Resource;
import javax.ejb.ActivationConfigProperty;
import javax.ejb.EJB;
import javax.ejb.MessageDriven;
import javax.ejb.MessageDrivenContext;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.ObjectMessage;
 
@MessageDriven(
   name = "BookMessageHandler",
   activationConfig = {
      @ActivationConfigProperty( propertyName = "destinationType", 
                                 propertyValue = "javax.jms.Queue"),
      @ActivationConfigProperty( propertyName = "destination", 
                                 propertyValue ="/queue/BookQueue")
   }
)
public class LibraryMessageBean implements MessageListener {
 
   @Resource
   private MessageDrivenContext mdctx;  
 
   @EJB
   LibraryPersistentBeanRemote libraryBean;
 
   public LibraryMessageBean() {        
   }
 
   public void onMessage(Message message) {
      ObjectMessage objectMessage = null;
      try {
         objectMessage = (ObjectMessage) message;
         Book book = (Book) objectMessage.getObject(); 
         libraryBean.addBook(book);
 
      } catch (JMSException ex) {
         mdctx.setRollbackOnly();
      }       
   }   
}

EJBTester（EJBクライアント）

EJBTester.java

package com.tutorialspoint.test;
   
import com.tutorialspoint.entity.Book;
import com.tutorialspoint.stateless.LibraryPersistentBeanRemote;
import java.io.BufferedReader;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.util.List;
import java.util.Properties;
import javax.jms.ObjectMessage;
import javax.jms.Queue;
import javax.jms.QueueConnection;
import javax.jms.QueueConnectionFactory;
import javax.jms.QueueSender;
import javax.jms.QueueSession;
import javax.naming.InitialContext;
import javax.naming.NamingException;
 
public class EJBTester {
 
   BufferedReader brConsoleReader = null; 
   Properties props;
   InitialContext ctx;
   {
      props = new Properties();
      try {
         props.load(new FileInputStream("jndi.properties"));
      } catch (IOException ex) {
         ex.printStackTrace();
      }
      try {
         ctx = new InitialContext(props);            
      } catch (NamingException ex) {
         ex.printStackTrace();
      }
      brConsoleReader = 
      new BufferedReader(new InputStreamReader(System.in));
   }
   
   public static void main(String[] args) {
 
      EJBTester ejbTester = new EJBTester();
 
      ejbTester.testMessageBeanEjb();
   }
   
   private void showGUI() {
      System.out.println("**********************");
      System.out.println("Welcome to Book Store");
      System.out.println("**********************");
      System.out.print("Options \n1. Add Book\n2. Exit \nEnter Choice: ");
   }
   
   private void testMessageBeanEjb() {
 
      try {
         int choice = 1; 
         Queue queue = (Queue) ctx.lookup("/queue/BookQueue");
         QueueConnectionFactory factory =
         (QueueConnectionFactory) ctx.lookup("ConnectionFactory");
         QueueConnection connection =  factory.createQueueConnection();
         QueueSession session = 
         connection.createQueueSession(false, QueueSession.AUTO_ACKNOWLEDGE);
         QueueSender sender = session.createSender(queue);
 
         while (choice != 2) {
            String bookName;
            showGUI();
            String strChoice = brConsoleReader.readLine();
            choice = Integer.parseInt(strChoice);
            if (choice == 1) {
               System.out.print("Enter book name: ");
               bookName = brConsoleReader.readLine();
               Book book = new Book();
               book.setName(bookName);
               ObjectMessage objectMessage = 
                  session.createObjectMessage(book);
               sender.send(objectMessage); 
            } else if (choice == 2) {
               break;
            }
         }
 
         LibraryPersistentBeanRemote libraryBean = 
         (LibraryPersistentBeanRemote)
         ctx.lookup("LibraryPersistentBean/remote");
 
         List<Book> booksList = libraryBean.getBooks();
 
         System.out.println("Book(s) entered so far: " + booksList.size());
         int i = 0;
         for (Book book:booksList) {
            System.out.println((i+1)+". " + book.getName());
            i++;
         }           
      } catch (Exception e) {
         System.out.println(e.getMessage());
         e.printStackTrace();
      }finally {
         try {
            if(brConsoleReader !=null) {
               brConsoleReader.close();
            }
         } catch (IOException ex) {
            System.out.println(ex.getMessage());
         }
      }
   }   
}

EJBTesterは次のタスクを実行します-

jndi.propertiesからプロパティをロードし、InitialContextオブジェクトを初期化します。
testStatefulEjb（）メソッドでは、jndiルックアップは「/ queue / BookQueue」という名前で実行され、Jbossで使用可能なキューの参照を取得します。次に、キューセッションを使用して送信者が作成されます。
次に、ユーザーにライブラリストアのユーザーインターフェイスが表示され、選択肢を入力するように求められます。
ユーザーが1を入力すると、システムは本の名前を要求し、送信者は本の名前をキューに送信します。JBossコンテナはこのメッセージをキューで受信すると、メッセージドリブンBeanのonMessageメソッドを呼び出します。次に、メッセージ駆動型Beanは、ステートフルセッションBeanのaddBook（）メソッドを使用して本を保存します。Session Beanは、EntityManager呼び出しを介して本をデータベースに永続化しています。
ユーザーが2を入力すると、「LibraryStatefulSessionBean / remote」という名前で別のjndiルックアップが実行され、リモートビジネスオブジェクト（ステートフルEJB）が再度取得され、書籍の一覧表示が行われます。

クライアントを実行してEJBにアクセスする

プロジェクトエクスプローラでEJBTester.javaを見つけます。EJBTesterクラスを右クリックして、run file。

Netbeansコンソールで次の出力を確認します-

run:
**********************
Welcome to Book Store
**********************
Options 
1. Add Book
2. Exit 
Enter Choice: 1
Enter book name: Learn EJB
**********************
Welcome to Book Store
**********************
Options 
1. Add Book
2. Exit 
Enter Choice: 2
Book(s) entered so far: 2
1. learn java
1. learn EJB
BUILD SUCCESSFUL (total time: 15 seconds)

上記の出力は、メッセージ駆動型Beanがメッセージを受信し、本を永続ストレージに保存しており、本がデータベースから取得されていることを示しています。