ActiveMQ实战(四)--ActiveMQ的通信方式之request-response(请求响应模式)

一、简介

在前面的两种模式中都是一方负责发送消息而另外一方负责处理。而我们实际中的很多应用相当于一种一应一答的过程，需要双方都能给对方发送消息。于是请求-应答的这种通信方式也很重要。它也应用的很普遍。

请求-应答方式并不是JMS规范系统默认提供的一种通信方式，而是通过在现有通信方式的基础上稍微运用一点技巧实现的。

下图是典型的请求-应答方式的交互过程：



在JMS里面，如果要实现请求/应答的方式，可以利用JMSReplyTo和JMSCorrelationID消息头来将通信的双方关联起来。另外，QueueRequestor和TopicRequestor能够支持简单的请求/应答过程。

現在，如果我们要实现这么一个过程，在发送请求消息并且等待返回结果的client端的流程如下：

// client side
Destination tempDest = session.createTemporaryQueue();
MessageConsumer responseConsumer = session.createConsumer(tempDest);
...

// send a request..
message.setJMSReplyTo(tempDest)
message.setJMSCorrelationID(myCorrelationID);

producer.send(message);

client端创建一个临时队列并在发送的消息里指定了发送返回消息的destination以及correlationID。那么在处理消息的server端得到这个消息后就知道该发送给谁了。

Server端的大致流程如下：

public void onMessage(Message request) {

Message response = session.createMessage();
response.setJMSCorrelationID(request.getJMSCorrelationID())
producer.send(request.getJMSReplyTo(), response)
}

这里我们是用server端注册MessageListener，通过设置返回信息的CorrelationID和JMSReplyTo将信息返回。

以上就是发送和接收消息的双方的大致程序结构。

二、实战request-response(请求响应模式)通信

具体的实现代码如下：

Client:

package com.fendo.mq;

import org.apache.activemq.ActiveMQConnectionFactory;

import javax.jms.*;
import java.util.Random;

/**
* 客户端
* @author fendo
*
*/

public class Client implements MessageListener {
private static int ackMode;
private static String clientQueueName;

private boolean transacted = false;
private MessageProducer producer;

static {
clientQueueName = "client.messages";
ackMode = Session.AUTO_ACKNOWLEDGE;
}

public Client() {
ActiveMQConnectionFactory connectionFactory = new ActiveMQConnectionFactory("tcp://localhost:61616");
Connection connection;
try {
connection = connectionFactory.createConnection();
connection.start();
Session session = connection.createSession(transacted, ackMode);
Destination adminQueue = session.createQueue(clientQueueName);

//设置消息生成器将消息发送到服务器正在消耗的队列
this.producer = session.createProducer(adminQueue);
this.producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);
//创建一个临时队列，该客户端将侦听响应，
//然后创建一个从该临时队列消耗消息的消费者...对于真正的应用程序，
//客户端应该为服务器的每个消息重新使用相同的临时队列...一个临时队列 每个客户端
Destination tempDest = session.createTemporaryQueue();
MessageConsumer responseConsumer = session.createConsumer(tempDest);

//此类也将处理到临时队列的消息
responseConsumer.setMessageListener(this);

//现在创建您要发送的实际消息
TextMessage txtMessage = session.createTextMessage();
// 设置信息
txtMessage.setText("MyProtocolMessage");

//将回复字段设置为上面创建的临时队列，这是服务器应答的队列...
txtMessage.setJMSReplyTo(tempDest);

//设置相关ID，以便当您收到响应时，您知道响应是哪个发送消息
//如果没有多个未完成的消息给服务器，那么
//相同的相关ID可以用于所有的消息...如果有多个未完成
//消息到您可能想要将相关ID与此关联的服务器
//消息不知何故...一个地图很好
String correlationId = this.createRandomString();
txtMessage.setJMSCorrelationID(correlationId);
this.producer.send(txtMessage);
} catch (JMSException e) {
//妥善处理异常
}
}

private String createRandomString() {
Random random = new Random(System.currentTimeMillis());
long randomLong = random.nextLong();
return Long.toHexString(randomLong);
}

public void onMessage(Message message) {
String messageText = null;
try {
if (message instanceof TextMessage) {
TextMessage textMessage = (TextMessage) message;
messageText = textMessage.getText();
System.out.println("响应内容 = " + messageText);
}
} catch (JMSException e) {
//妥善处理异常
}
}

public static void main(String[] args) {
new Client();
}
}

这里的代码除了初始化构造函数里的参数还同时设置了两个destination，一个是自己要发送消息出去的destination，在session.createProducer(adminQueue);这一句设置。

另外一个是自己要接收的消息destination, 通过Destination tempDest = session.createTemporaryQueue(); responseConsumer = session.createConsumer(tempDest); 这两句指定了要接收消息的目的地。这里是用的一个临时队列。在前面指定了返回消息的通信队列之后，我们需要通知server端知道发送返回消息给哪个队列。于是txtMessage.setJMSReplyTo(tempDest);指定了这一部分，同时txtMessage.setJMSCorrelationID(correlationId);方法主要是为了保证每次发送回来请求的server端能够知道对应的是哪个请求。这里一个请求和一个应答是相当于对应一个相同的序列号一样。

同时，因为client端在发送消息之后还要接收server端返回的消息，所以它也要实现一个消息receiver的功能。这里采用实现MessageListener接口的方式：

public void onMessage(Message message) {
String messageText = null;
try {
if (message instanceof TextMessage) {
TextMessage textMessage = (TextMessage) message;
messageText = textMessage.getText();
System.out.println("messageText = " + messageText);
}
} catch (JMSException e) {
//Handle the exception appropriately
}
}

Server:

这里server端要执行的过程和client端相反，它是先接收消息，在接收到消息后根据提供的JMSCorelationID来发送返回的消息:

public void onMessage(Message message) {
try {
TextMessage response = this.session.createTextMessage();
if (message instanceof TextMessage) {
TextMessage txtMsg = (TextMessage) message;
String messageText = txtMsg.getText();
response.setText(this.messageProtocol.handleProtocolMessage(messageText));
}

//从接收到的消息中设置相关ID为响应消息的相关ID
//这可以让客户端识别该消息的响应
//向服务器发送的一个未完成的消息
response.setJMSCorrelationID(message.getJMSCorrelationID());

//将响应发送到接收消息的JMSReplyTo字段指定的目的地，
//这大概是客户创建的临时队列
this.replyProducer.send(message.getJMSReplyTo(), response);
} catch (JMSException e) {
//妥善处理异常
}
}

前面，在replyProducer.send()方法里，message.getJMSReplyTo()就得到了要发送消息回去的destination。

另外，设置这些发送返回信息的replyProducer的信息主要在构造函数相关的方法里实现了:

public Server() {
try {
//这个消息代理是嵌入的
BrokerService broker = new BrokerService();
broker.setPersistent(false);
broker.setUseJmx(false);
broker.addConnector(messageBrokerUrl);
broker.start();
} catch (Exception e) {
//妥善处理异常
}

//将消息的处理委托给另一个类，在设置JMS之前实例化它，这样它就可以处理消息了
this.messageProtocol = new MessageProtocol();
this.setupMessageQueueConsumer();
}

private void setupMessageQueueConsumer() {
ActiveMQConnectionFactory connectionFactory = new ActiveMQConnectionFactory(messageBrokerUrl);
Connection connection;
try {
connection = connectionFactory.createConnection();
connection.start();
this.session = connection.createSession(this.transacted, ackMode);
Destination adminQueue = this.session.createQueue(messageQueueName);

//设置一个消息生成器响应来自客户端的消息，我们将从一个消息发送到从jmsreplytoheader字段发送到的目的地
this.replyProducer = this.session.createProducer(null);
this.replyProducer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);

//设置消费者从管理队列中消费消息
MessageConsumer consumer = this.session.createConsumer(adminQueue);
consumer.setMessageListener(this);
} catch (JMSException e) {
//妥善处理异常
}
}

总体来说，整个的交互过程并不复杂，只是比较繁琐。对于请求/应答的方式来说，这种典型交互的过程就是Client端在设定正常发送请求的Queue同时也设定一个临时的Queue。同时在要发送的message里头指定要返回消息的destination以及CorelationID，这些就好比是一封信里面所带的回执。根据这个信息人家才知道怎么给你回信。对于Server端来说则要额外创建一个producer，在处理接收到消息的方法里再利用producer将消息发回去。这一系列的过程看起来很像http协议里面请求-应答的方式，都是一问一答。

MessageProtocol

package com.fendo.mq;

/**
* 此类需要运行上面的客户端/服务器示例。 将消息处理委托给单独的类仅仅是个人喜好。
* @author fendo
*
*/

public class MessageProtocol {
public String handleProtocolMessage(String messageText) {
String responseText;
// 判断是否是client传过来的信息，在这里就可以做些解析
if ("MyProtocolMessage".equalsIgnoreCase(messageText)) {
responseText = "我收到了信息";
} else {
responseText = "我不知道你传的是什么: " + messageText;
}

return responseText;
}
}

三、运行测试

先运行客户端(请求),在ActiveMQ控制台进行查看,会多出一个记录



"Number Of Pending Messages "等待消费的数量为"1",进入队列的消息为"1",然后运行服务端(响应),会收到信息



再查看控制面板信息会变成如下所示



"Number Of Consumers"消费者为"1","Messages Enqueued"入队数量为"1","Messages Dequeued"出队数量为"1"。

完整示例: http://download.csdn.net/detail/u011781521/9907835

参考:http://activemq.apache.org/how-should-i-implement-request-response-with-jms.html