在前面的文章中給出的SessionBean的例子都是同步調用SessionBean方法的,也就是說,只有當方法中的代碼都執行完,才能返回到客戶端。但在某些情況下,由於SessionBean方法的執行時間比較長,這就需要異步地調用該方法,否則客戶端就需要等待比較長的時間。要實現異步調用,就需要使用本要講的消息驅動Bean。消息驅動Bean的基本原理是客戶端向消息服務器發送一條消息後,消息服務器會將該消息保存在消息隊列中。在這時消息服務器中的某個消費者(讀取並處理消息的對象)會讀取該消息,並進行處理。發送消息的客戶端被稱為消息生產者。
本文給出的消息驅動Bean的例子的基本功能是客戶端向消息服務器發送一條消息(該消息實際上是一個實體Bean的對象實例),然後消息消費者讀取這條消息後,將消息中的實體Bean持久化。實現消息驅動Bean的步驟如下:
一、實現實體Bean
- package entity;
- import Java.io.Serializable;
- import Java.util.Date;
- import Javax.persistence.Column;
- import Javax.persistence.Entity;
- import Javax.persistence.GeneratedValue;
- import Javax.persistence.GenerationType;
- import Javax.persistence.Id;
- import Javax.persistence.Table;
- @Entity
- @Table(name="t_date")
- public class DateBean implements Serializable
- {
- private int id;
- private Date myDate;
- @Id
- @GeneratedValue(strategy=GenerationType.IDENTITY)
- public int getId()
- {
- return id;
- }
- public void setId(int id)
- {
- this.id = id;
- }
- @Column(name="mydate")
- public Date getMyDate()
- {
- return myDate;
- }
- public void setMyDate(Date myDate)
- {
- this.myDate = myDate;
- }
- }
二、編寫消息驅動Bean
消息驅動Bean必須實現MessageListener接口,當該消息驅動Bean接收到一個消息後,EJB容器就會調用MessageListener接口的onMessage方法來理該消息。消息驅動Bean的代碼如下:
- package service;
- import Javax.ejb.ActivationConfigProperty;
- import Javax.ejb.EJBException;
- import Javax.ejb.MessageDriven;
- import Javax.jms.Message;
- import Javax.jms.MessageListener;
- import Javax.jms.ObjectMessage;
- import Javax.persistence.EntityManager;
- import Javax.persistence.PersistenceContext;
- import entity.DateBean;
- @MessageDriven( activationConfig = {
- @ActivationConfigProperty(propertyName = "destinationType", propertyValue = "Javax.jms.Queue"),
- @ActivationConfigProperty(propertyName = "destination", propertyValue = "queue/MDBQueue")
- })
- public class DateMessageBean implements MessageListener
- {
- @PersistenceContext(unitName = "myentity1")
- private EntityManager em;
- @Override
- public void onMessage(Message message)
- {
- try
- {
- if(message instanceof ObjectMessage)
- {
- ObjectMessage objmsg = (ObjectMessage) message;
- DateBean dateBean = (DateBean) objmsg.getObject();
- em.persist(dateBean);
- System.out.println("成功持久化DateBean對象!");
- }
- else
- {
- System.out.println("消息類型錯誤!");
- }
- }
- catch (Exception e)
- {
- throw new EJBException(e);
- }
- }
- }
消息驅動Bean需要使用@MessageDriven進行注釋。要注意的是destination屬性的值是queue/MDBQueue。JBoss不會自已建立一個Queue對象,因此,需要手工來配置Queue對象。讀者可以\server\default\deploy目錄中建立一個xxx-service.xml文件,其中xxx可以任意取值,但必須跟“-service”後綴,例如,abc-service.XML。該文件可以放在deploy或其子目錄(可以是多層子目錄)中。該文件的內容如下:
- < XML version="1.0" encoding="UTF-8"?>
- < server>
- < mbean code="org.jboss.mq.server.jmx.Queue" name="jboss.mq.destination:service=Queue,name=MDBQueue">
- < depends optional-attribute-name="DestinationManager">jboss.mq:service=DestinationManagerdepends>
- < mbean>
- < server>
要注意的是,元素的name屬性值中的name必須是MDBQueue,要與queue/MDBQueue中的/後面的部分一致。如果不進行上面的配置,在啟動JBOSS時就會拋出如下的異常:
Javax.naming.NameNotFoundException: MDBQueue not bound
也可以將元素放在deploy目錄中的其他以-service.XML結尾的文件中。
如果不設置destination屬性的值,在啟動JBoss是會拋出如下的異常:
- org.jboss.deployers.spi.DeploymentException: Required config property RequiredConfigPropertyMetaData@174098f[name=destination descriptions=[DescriptionMetaData@4ca30b[language=zh]]] for messagingType 'Javax.jms.MessageListener' not found in activation config [ActivationConfigProperty(destinationType=Javax.jms.Queue), ActivationConfigProperty(connectionFactoryJndiName=MyQueueConnectionFactory), ActivationConfigProperty(destinationName=MyRequestQueue)] ra=jboss.jca:service=RARDeployment,name='jms-ra.rar'
- ... ...
三、編寫調用消息驅動Bean的SessionBean
- package service;
- import Java.util.ArrayList;
- import Java.util.Date;
- import Java.util.List;
- import Javax.annotation.Resource;
- import Javax.ejb.Stateless;
- import Javax.jms.Connection;
- import Javax.jms.ConnectionFactory;
- import Javax.jms.MessageProducer;
- import Javax.jms.ObjectMessage;
- import Javax.jms.Queue;
- import Javax.jms.Session;
- import Javax.persistence.EntityManager;
- import entity.DateBean;
- import entity.Greeting;
- @Stateless
- public class GreeterBean implements Greeter
- {
- @Resource(mappedName = "ConnectionFactory")
- private ConnectionFactory cf;
- @Resource(mappedName = "queue/MDBQueue")
- private Queue queue;
- @Override
- public String greet(String message)
- {
- try
- {
- DateBean db = new DateBean();
- db.setMyDate(new Date());
- Connection connection = cf.createConnection();
- Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
- MessageProducer messageProducer = session.createProducer(queue);
- ObjectMessage objectMessage = session.createObjectMessage();
- objectMessage.setObject(db);
- messageProducer.send(objectMessage);
- connection.close();
- System.out.println("成功發送消息!");
- }
- catch (Exception e)
- {
- System.out.println("發送消息失敗!");
- }
- return "方法成功返回";
- }
- }
在上面的代碼中使用ObjectMessage對象來包裝要向消息服務器發送的實體Bean的對象實例。
除了可以在SessionBean中訪問消息驅動Bean外,還可以在不同的機器上通過jndi來查找並調用消息驅動Bean,代碼如下:
- package test;
- import Java.util.Date;
- import Javax.ejb.EJB;
- import Javax.jms.Destination;
- import Javax.jms.MessageProducer;
- import Javax.jms.ObjectMessage;
- import Javax.jms.Queue;
- import Javax.jms.QueueConnection;
- import Javax.jms.QueueConnectionFactory;
- import Javax.jms.QueueSession;
- import Javax.jms.TextMessage;
- import Javax.naming.InitialContext;
- import entity.DateBean;
- import service.Greeter;
- public class ClIEnt
- {
- public static void main(String[] args) throws Exception
- {
- InitialContext ctx = new InitialContext();
- QueueConnection connection = null;
- QueueSession session = null;
- QueueConnectionFactory factory = (QueueConnectionFactory) ctx.lookup("ConnectionFactory");
- connection = factory.createQueueConnection();
- session = connection.createQueueSession(false, QueueSession.AUTO_ACKNOWLEDGE);
- Destination destination = (Queue) ctx.lookup("queue/MDBQueue");
- MessageProducer messageProducer = session.createProducer(destination);
- ObjectMessage objectMessage = session.createObjectMessage();
- DateBean db = new DateBean();
- db.setMyDate(new Date());
- objectMessage.setObject(db);
- messageProducer.send(objectMessage);
- connection.close();
- System.out.println("成功發送消息!");
- }
- }