3.4.1 同步接收
通常 JMS
3.4.2 异步接收
Spring 还支持通过
@JmsListener
注解来配置监听器,这是目前为止设置异步接收器最方便的方式
和EJB世界的消息驱动的Bean(MDB)类似,消息驱动的POJO(MDP)也是JMS消息的接收者,而MDP的唯一的限制就是,它必须实现javax.jms.MessagListener
接口。要注意的是,这种情况下,我们的POJO会在多线程环境中接收消息,所以一定要确保我们的实现是线程安全的。
下面是一个简单的实现:
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.TextMessage;
public class ExampleListener implements MessageListener {
public void onMessage(Message message) {
if (message instanceof TextMessage) {
try {
System.out.println(((TextMessage) message).getText());
}
catch (JMSException ex) {
throw new RuntimeException(ex);
}
}
else {
throw new IllegalArgumentException("Message must be of type TextMessage");
}
}
}
一旦实现了我们自己的MessageListener
,就该创建一个消息监听器容器了。
下面就是一个使用Spring带给我们的众多消息监听器容器之一的示例(用的是DefaultMessageListenerContainer
):
要想了解各个消息监听器容器实现的完整功能描述,可以去参考 Spring 的 API 文档。
3.4.3 SessionAwareMessageListener
接口
SessionAwareMessageListener
接口是 Spring 特有的接口,它提供了和JMS的MessageListener
类似的功能,而且它还提供了对消息Session
的访问。
package org.springframework.jms.listener;
public interface SessionAwareMessageListener {
void onMessage(Message message, Session session) throws JMSException;
}
如果希望我们的MDP能够对任何收到的消息进行响应,可以选择实现这个接口。
Spring提供的所有消息监听器容器都支持实现了MessageListener
或SessionAwareMessageListener
的 MDP,实现SessionAwareMessageListener
接口的类的不利点就在于它和Spring绑定了,使不使用它完全看我们的实际使用情况。
要注意,SessionAwareMessageListener
的onMessage(..)
方法会抛出JMSException
,因此,使用者要负责处理它抛出的异常。
3.4.4 MesssageListenerAdapter
类
MesssageListenerAdapter
类是 Spring 对异步消息支持的最终杀器:一句话,它允许我们用几乎任何类作为一个MDP。
看看下面的这个接口定义,这个接口既没有继承MessageListener
也没有继承 SessionAwareMessageListener
,但它仍然能够通过MesssageListenerAdapter
类将其当成MDP来使用。
public interface MessageDelegate {
void handleMessage(String message);
void handleMessage(Map message);
void handleMessage(byte[] message);
void handleMessage(Serializable message);
}
public class DefaultMessageDelegate implements MessageDelegate {
// implementation elided for clarity...
}
上面这个类对于JMS完全没有依赖,就是一个POJO,通过如下配置将其作为MDP来使用:
下面的这个类只能接收TextMessage
类型的 JMS 消息。注意这个消息处理器的名称是receive
(而 MessageListenerAdapter
内的默认消息处理器名称是handleMessage
),这是可配置的。还要注意的是, receive(..)
方法强制了消息类型是 TextMessage
。
public interface TextMessageDelegate {
void receive(TextMessage message);
}
public class DefaultTextMessageDelegate implements TextMessageDelegate {
// implementation elided for clarity...
}
对应的MessageListenerAdapter
配置应该是这样:
如果上面这个messageListener
接收到一个不是TextMessage
类型的JMS Message
,会抛出 IllegalStateException
。 MessageListenerAdapter
的另一个能力是能够自动发送一个响应的Message
,只要处理方法返回一个非void类型的值。考虑下面的接口和类:
public interface ResponsiveTextMessageDelegate {
// 注意返回类型...
String receive(TextMessage message);
}
public class DefaultResponsiveTextMessageDelegate implements ResponsiveTextMessageDelegate {
// implementation elided for clarity...
}
如果上面的DefaultResponsiveTextMessageDelegate
和MessageListenerAdapter
配合使用,那么receive(..)
方法返回的任何非空值都会被转化为一个TextMessage
(默认配置),然后发送给原始Message
中的Reply-To属性定义的Destination
(如果有定义的话),或者是发送给MessageListenerAdapter
中设置的默认Destination
(如果有定义的话),如果找不到任何的Destination
,那么会抛出一个InvalidDestinationException
。