EJB - Fasola sterowana wiadomościami

Komponent bean sterowany komunikatami to typ komponentu bean przedsiębiorstwa, który jest wywoływany przez kontener EJB po odebraniu komunikatu z kolejki lub tematu. Komponent bean sterowany komunikatami to bezstanowy komponent bean, który służy do wykonywania zadań asynchronicznie.

Aby zademonstrować użycie komponentu bean sterowanego komunikatami, wykorzystamy rozdział trwałości EJB i musimy wykonać następujące zadania -

  • Step 1- Utwórz tabelę w bazie danych (zobacz rozdział EJB-Trwałość ).

  • Step 2- Utwórz klasę Entity odpowiadającą tabeli (zobacz rozdział EJB-Trwałość ).

  • Step 3- Utwórz źródło danych i jednostkę trwałości (zobacz rozdział dotyczący trwałości EJB ).

  • Step 4- Utwórz bezstanowy EJB z instancją EntityManager (zobacz rozdział EJB-Persistence ).

  • Step 5- Zaktualizuj metody ejb.Add bezstanowe, aby dodać rekordy i pobrać rekordy z bazy danych za pośrednictwem menedżera encji (zobacz rozdział EJB-Persistence ).

  • Step 6 - Utwórz kolejkę o nazwie BookQueue w JBoss default katalog aplikacji.

  • Step 7 - Klient aplikacji oparty na konsoli wyśle ​​wiadomość do tej kolejki.

  • Step 8 - Utwórz komponent bean oparty na komunikatach, który będzie używał bezstanowego komponentu bean do utrwalania danych klienta.

  • Step 9 - EJB Container of jboss wywoła powyższy komponent bean sterowany komunikatem i przekaże mu wiadomość, do której klient będzie wysyłał.

Utwórz kolejkę

Utwórz plik o nazwie jbossmq-destination-service.xml, jeśli nie istnieje w <JBoss Installation Folder> > server > default > deploy teczka.

Tutaj tworzymy kolejkę o nazwie BookQueue -

jbossmq-destination-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>

Po uruchomieniu JBoss zobaczysz podobny wpis w dzienniku jboss.

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

Utwórz komponent Bean sterowany wiadomością

@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 jest opatrzona adnotacją @MessageDriven, aby oznaczyć ją jako komponent bean sterowany komunikatami.

  • Jego właściwości są zdefiniowane jako destinationType - Queue and destination - / queue / BookQueue.

  • Implementuje interfejs MessageListener, który uwidacznia metodę onMessage.

  • Ma MessgeDrivenContext jako zasób.

  • Bezstanowa fasola LibraryPersistentBeanRemote jest wstrzykiwana do tej fasoli w celu trwałości.

Zbuduj projekt EjbComponent i wdróż go na JBoss. Po zbudowaniu i wdrożeniu modułu EJB potrzebujemy klienta do wysłania wiadomości do kolejki jboss.

Przykładowa aplikacja

Stwórzmy testową aplikację EJB, aby przetestować Message Driven Bean.

Krok Opis
1

Utwórz projekt o nazwie EjbComponent w pakiecie com.tutorialspoint.entity, jak wyjaśniono w rozdziale EJB - Tworzenie aplikacji . Możesz również użyć projektu utworzonego w rozdziale EJB - Tworzenie aplikacji jako takiego w tym rozdziale, aby zrozumieć koncepcje trwałości EJB.

2

Utwórz Book.java w pakiecie com.tutorialspoint.entity, tak jak utworzono w rozdziale EJB-Persistence .

3

Utwórz LibraryPersistentBean.java i LibraryPersistentBeanRemote, tak jak utworzono w rozdziale EJB-Persistence .

4

Utwórz plik jboss-ds.xml w formacieEjbComponent > setup folder i persistence.xml wEjbComponent > src > conf teczka. Te foldery można zobaczyć na karcie plików w Netbeans, utworzonej w rozdziale EJB-Persistence .

5

Tworzenie LibraryMessageBean.java ramach pakietu com.tutorialspoint.messagebean i zmodyfikować go tak jak pokazano poniżej.

6

Utwórz kolejkę BookQueue w Jboss, jak opisano powyżej.

7

Wyczyść i skompiluj aplikację, aby upewnić się, że logika biznesowa działa zgodnie z wymaganiami.

8

Na koniec wdróż aplikację w postaci pliku jar na JBoss Application Server. Serwer aplikacji JBoss zostanie uruchomiony automatycznie, jeśli nie został jeszcze uruchomiony.

9

Teraz utwórz klienta EJB, aplikację opartą na konsoli w taki sam sposób, jak wyjaśniono w rozdziale EJB - Tworzenie aplikacji w temacieCreate Client to access EJB. Zmodyfikuj go, jak pokazano poniżej.

EJBComponent (moduł 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 (klient 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 wykonuje następujące zadania -

  • Załaduj właściwości z jndi.properties i zainicjuj obiekt InitialContext.

  • W metodzie testStatefulEjb () wyszukiwanie jndi odbywa się z nazwą - "/ queue / BookQueue" w celu uzyskania treference kolejki dostępnej w Jboss. Następnie nadawca jest tworzony za pomocą sesji kolejki.

  • Następnie użytkownik widzi interfejs użytkownika sklepu biblioteki i jest proszony o wpisanie wyboru.

  • Jeśli użytkownik wprowadzi 1, system zapyta o nazwę książki, a nadawca wyśle ​​nazwę książki do kolejki. Gdy kontener JBoss odbiera ten komunikat w kolejce, wywołuje metodę onMessage naszego komponentu bean sterowanego komunikatami. Następnie nasz komponent bean sterowany wiadomościami zapisuje książkę przy użyciu metody addBook () z wykorzystaniem stanowej sesji bean. Session Bean utrwala książkę w bazie danych za pośrednictwem wywołania EntityManager.

  • Jeśli użytkownik wprowadzi 2, wykonywane jest kolejne wyszukiwanie jndi z nazwą - „LibraryStatefulSessionBean / remote” w celu ponownego uzyskania zdalnego obiektu biznesowego (stanowy komponent EJB) i wykonanie listy książek.

Uruchom klienta, aby uzyskać dostęp do EJB

Znajdź EJBTester.java w eksploratorze projektów. Kliknij prawym przyciskiem myszy klasę EJBTester i wybierzrun file.

Sprawdź następujące dane wyjściowe w konsoli 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)

Dane wyjściowe pokazane powyżej wskazują, że nasz komponent bean sterowany wiadomościami odbiera wiadomość i przechowuje książkę w pamięci trwałej, a książki są pobierane z bazy danych.