消息驱动Bean(MDB)

  消息驱动Bean(MDB)是设计用来专门处理基于消息请求的组件。一个MDB类必须实现MessageListener 接口。当
容器检测到bean守候的队列一条消息时，就调用onMessage()方法，将消息作为参数传入。MDB在OnMessage()
中决定如何处理该消息。你可以用注释来配置MDB 监听哪一条队列。当MDB 部署时，容器将会用到其中的注
释信息。
当一个业务执行的时间很长，而执行结果无需实时向用户反馈时，很适合使用消息驱动Bean。如订单成功后给用
户发送一封电子邮件或发送一条短信等。下面的例子在用户下订单完成后，打印一份配送单。好让配送员根据地
址把商品送到客人手中。代码如下：
PrintBean.java
//author:lihuoming
package com.foshanshop.ejb3.impl;
import javax.ejb.ActivationConfigProperty;
import javax.ejb.MessageDriven;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.TextMessage;
@MessageDriven(activationConfig =
{
@ActivationConfigProperty(propertyName="destinationType",
propertyValue="javax.jms.Queue"),
@ActivationConfigProperty(propertyName="destination",
propertyValue="queue/foshanshop")
})
public class PrintBean implements MessageListener {
public void onMessage(Message msg) {
try {
TextMessage tmsg = (TextMessage) msg;
this.print(tmsg.getText());
} catch (Exception e){
e.printStackTrace();
}
}
private void print(String content){
System.out.println(content);
}
}
上面通过@MessageDriven 注释指明这是一个消息驱动Bean，并使用@ActivationConfigProperty注释配置消息的
各种属性，其中destinationType 属性指定消息的类型，消息有两种类型topics 和queues，下面是这两种消息
类型的介绍：
Jboss EJB3.0实例教程
版权所有：黎活明
Topics 可以有多个客户端。用topic 发布允许一对多，或多对多通讯通道。消息的产生者被叫做publisher, 消
息接受者叫做subscriber。destinationType 属性对应值：javax.jms.Topic
Queue 仅仅允许一个消息传送给一个客户。一个发送者将消息放入消息队列，接受者从队列中抽取并得到消息，
消息就会在队列中消失。第一个接受者抽取并得到消息后，其他人就不能再得到它。destinationType属性对应
值：javax.jms.Queue
destination属性用作指定消息路径，消息驱动Bean在发布时，如果路径不存在，容器会自动创建该路径，当容
器关闭时该路径会自动被删除。
运行本例子，当一个消息到达queue/foshanshop 队列时，就会触发onMessage 方法，消息作为一个参数传入，
在onMessage 方法里面得到消息体并调用print 方法把消息内容打印到控制台上。
MessageDrivenBeanTest.jsp
<%@ page contentType="text/html; charset=GBK"%>
<%@ page import="javax.naming.*, java.text.*, javax.jms.*, java.util.Properties"%>
<%
QueueConnection cnn = null;
QueueSender sender = null;
QueueSession sess = null;
Queue queue = null;
try {
Properties props = new Properties();
props.setProperty("java.naming.factory.initial",
"org.jnp.interfaces.NamingContextFactory");
props.setProperty("java.naming.provider.url", "localhost:1099");
props.setProperty("java.naming.factory.url.pkgs", "org.jboss.naming");
InitialContext ctx = new InitialContext(props);
QueueConnectionFactory factory = (QueueConnectionFactory) ctx.lookup("ConnectionFactory");
cnn = factory.createQueueConnection();
sess = cnn.createQueueSession(false, QueueSession.AUTO_ACKNOWLEDGE);
queue = (Queue) ctx.lookup("queue/foshanshop");
} catch (Exception e) {
out.println(e.getMessage());
}
TextMessage msg = sess.createTextMessage("佛山人您好，这是我的第一个消息驱动Bean");
sender = sess.createSender(queue);
sender.send(msg);
sess.close ();
out.println("消息已经发送出去了，你可以到JBoss控制台查看Bean的输出");
%>
上面的JSP客户端用来向queue/foshanshop消息队列发送一条消息。客户端发送消息一般有以下步骤：
(1) 得到一个JNDI初始化上下文(Context)；
例子对应代码：
Properties props = new Properties();
Jboss EJB3.0实例教程
版权所有：黎活明
props.setProperty("java.naming.factory.initial", "org.jnp.interfaces.NamingContextFactory");
props.setProperty("java.naming.provider.url", "localhost:1099");
props.setProperty("java.naming.factory.url.pkgs", "org.jboss.naming");
InitialContext ctx = new InitialContext(props);
(2) 根据上下文来查找一个连接工厂TopicConnectFactory/ QueueConnectionFactory (有两种连接工厂，根据是
topic/queue来使用相应的类型)；
例子对应代码：
QueueConnectionFactory factory = (QueueConnectionFactory) ctx.lookup("ConnectionFactory");
(3) 从连接工厂得到一个连接(Connect 有两种[TopicConnection/ QueueConnection]);
例子对应代码：cnn = factory.createQueueConnection();
(4) 通过连接来建立一个会话(Session);
例子对应代码：sess = cnn.createQueueSession(false, QueueSession.AUTO_ACKNOWLEDGE);
这句代码意思是：建立不需要事务的并且能自动接收消息收条的会话，在非事务Session 中，消息传递的方
式有三种：
Session.AUTO_ACKNOWLEDGE ：当客户机调用的receive方法成功返回，或当MessageListenser 成功处理
了消息，session将会自动接收消息的收条。
Session.CLIENT_ACKNOWLEDGE ：客户机通过调用消息的acknowledge方法来接收消息。接收发生在
session层。接收到一个被消费的消息时，将自动接收该session已经消费的所有消息。例如：如果消息的消
费者消费了10 条消息，然后接收15 个被传递的消息，则前面的10 个消息的收据都会在这15 个消息中被接
收。
Session.DUPS_ACKNOWLEDGE ：指示session缓慢接收消息。
(5) 查找目的地(Topic/ Queue);
例子对应代码：queue = (Queue) ctx.lookup("queue/foshanshop");
(6) 根据会话以及目的地来建立消息制造者(TopicPublisher/QueueSender)和消费者(TopicSubscriber/
QueueReceiver).
例子对应代码：
TextMessage msg = sess.createTextMessage("佛山人您好，这是我的第一个消息驱动Bean");
sender = sess.createSender(queue);
sender.send(msg);