Spring整合JMS的三种监听

在Spring整合JMS的应用中我们在定义消息监听器的时候一共可以定义三种类型的消息监听器，分别是MessageListener、SessionAwareMessageListener和MessageListenerAdapter。下面就分别来介绍一下这几种类型的区别。

1、MessageListener消息监听器

MessageListener是最原始的消息监听器，它是JMS规范中定义的一个接口。其中定义了一个用于处理接收到的消息的onMessage方法，该方法只接收一个Message参数。我们前面在讲配置消费者的时候用的消息监听器就是MessageListener，代码如下：


Java代码  收藏代码

    package cn.tzz.jms.activemq.spring; 
     
    import javax.jms.JMSException; 
    import javax.jms.Message; 
    import javax.jms.MessageListener; 
    import javax.jms.TextMessage; 
      
    public class ConsumerMessageListener implements MessageListener { 
      
        public void onMessage(Message message) { 
            //这里我们知道生产者发送的就是一个纯文本消息，所以这里可以直接进行强制转换 
            TextMessage textMsg = (TextMessage) message; 
            try { 
                System.out.println("\t\t接收到消息：" + textMsg.getText()); 
            } catch (JMSException e) { 
                e.printStackTrace(); 
            } 
        } 
    } 



2、SessionAwareMessageListener消息监听器

SessionAwareMessageListener是Spring为我们提供的，它不是标准的JMS MessageListener。MessageListener的设计只是纯粹用来接收消息的，假如我们在使用MessageListener处理接收到的消息时我们需要发送一个消息通知对方我们已经收到这个消息了，那么这个时候我们就需要在代码里面去重新获取一个Connection或Session。SessionAwareMessageListener的设计就是为了方便我们在接收到消息后发送一个回复的消息，它同样为我们提供了一个处理接收到的消息的onMessage方法，但是这个方法可以同时接收两个参数，一个是表示当前接收到的消息Message，另一个就是可以用来发送消息的Session对象。

实例：

Java代码  收藏代码

    package cn.tzz.jms.activemq.spring.listener; 
     
    import javax.jms.Destination; 
    import javax.jms.JMSException; 
    import javax.jms.Message; 
    import javax.jms.MessageProducer; 
    import javax.jms.Session; 
    import javax.jms.TextMessage; 
    import org.springframework.jms.listener.SessionAwareMessageListener; 
     
    public class ConsumerSessionAwareMessageListener implements SessionAwareMessageListener<TextMessage>{ 
     
        private Destination destination; 
         
        @Override 
        public void onMessage(TextMessage textMsg, Session session) throws JMSException { 
            System.out.println("接收到消息：" + textMsg.getText()); 
            //发送消息 
            MessageProducer producer = session.createProducer(destination); 
            Message message = session.createTextMessage("SessionAwareMessageListener........"); 
            producer.send(message); 
        } 
     
        public Destination getDestination() { 
            return destination; 
        } 
     
        public void setDestination(Destination destination) { 
            this.destination = destination; 
        } 
     
    } 



       在上面代码中我们定义了一个SessionAwareMessageListener，在这个Listener中我们在接收到了一个消息之后，利用对应的Session创建了一个到destination的生产者和对应的消息，然后利用创建好的生产者发送对应的消息。

       接着我们在Spring的配置文件中配置该消息监听器将处理来自一个叫sessionAwareQueue的目的地的消息，并且往该MessageListener中通过set方法注入其属性destination的值为queueDestination。这样当我们的SessionAwareMessageListener接收到消息之后就会往queueDestination发送一个消息。

Xml代码  收藏代码

    <!-- ActiveMQ --> 
        <!-- 真正可以产生Connection的ConnectionFactory，由对应的 JMS服务厂商提供--> 
        <bean id="targetConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory"> 
            <property name="brokerURL" value="tcp://localhost:61616"/> 
        </bean> 
        <bean id="pooledConnectionFactory" class="org.apache.activemq.pool.PooledConnectionFactory"> 
            <property name="connectionFactory" ref="targetConnectionFactory"/> 
            <property name="maxConnections" value="10"/> 
        </bean> 
        <bean id="connectionFactory" class="org.springframework.jms.connection.SingleConnectionFactory"> 
            <property name="targetConnectionFactory" ref="pooledConnectionFactory"/> 
        </bean> 
         
     
        <!-- Spring提供的JMS工具类，它可以进行消息发送、接收等 --> 
        <bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate"> 
            <!-- 这个connectionFactory对应的是我们定义的Spring提供的那个ConnectionFactory对象 --> 
            <property name="connectionFactory" ref="connectionFactory" /> 
        </bean> 
        <!--消息队列的目的地，点对点的 --> 
        <bean id="queueDestination" class="org.apache.activemq.command.ActiveMQQueue"> 
            <constructor-arg> 
                <value>queue</value> 
            </constructor-arg> 
        </bean> 
        <!--这个是主题目的地，一对多的 --> 
        <bean id="topicDestination" class="org.apache.activemq.command.ActiveMQTopic"> 
            <constructor-arg value="topic" /> 
        </bean> 
         
        <!-- 消息监听器 .1 MessageListener--> 
        <bean id="consumerMessageListener" class="cn.tzz.jms.activemq.spring.listener.ConsumerMessageListener"/>     
        <!-- 消息监听容器 --> 
        <bean id="jmsContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer"> 
            <property name="connectionFactory" ref="connectionFactory" /> 
            <property name="destination" ref="queueDestination" /> 
            <property name="messageListener" ref="consumerMessageListener" /> 
        </bean> 
         
         
        <!--sessionAwareQueue目的地-->   
        <bean id="sessionAwareQueue" class="org.apache.activemq.command.ActiveMQQueue">   
            <constructor-arg>   
                <value>sessionAwareQueue</value>   
            </constructor-arg>   
        </bean>   
         
        <!-- 消息监听器 .2 SessionAwareMessageListener-->   
        <bean id="consumerSessionAwareMessageListener" class="cn.tzz.jms.activemq.spring.listener.ConsumerSessionAwareMessageListener">   
            <property name="destination" ref="queueDestination"/>   
        </bean>   
         
        <bean id="sessionAwareListenerContainer"  class="org.springframework.jms.listener.DefaultMessageListenerContainer">   
            <property name="connectionFactory" ref="connectionFactory" />   
            <property name="destination" ref="sessionAwareQueue" />   
            <property name="messageListener" ref="consumerSessionAwareMessageListener" />   
        </bean>  



   测试代码如下：

Java代码  收藏代码

    import javax.jms.Destination; 
    import org.junit.Test; 
    import org.junit.runner.RunWith; 
    import org.springframework.beans.factory.annotation.Autowired; 
    import org.springframework.beans.factory.annotation.Qualifier; 
    import org.springframework.test.context.ContextConfiguration; 
    import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 
     
    import cn.tzz.jms.activemq.spring.service.ProducerService; 
     
    @RunWith(SpringJUnit4ClassRunner.class) 
    @ContextConfiguration("/applicationContext.xml") 
    public class ProducerConsumerTest2 { 
     
        @Autowired 
        private ProducerService producerService; 
        @Autowired   
        @Qualifier("sessionAwareQueue")   
        private Destination sessionAwareQueue;   
           
        @Test   
        public void testSessionAwareMessageListener() {   
            producerService.sendMessage(sessionAwareQueue, "测试SessionAwareMessageListener");   
        }   
    } 



程序运行之后控制台输出如下：



生产者发消息：测试SessionAwareMessageListener

接收到消息：测试SessionAwareMessageListener

                  接收到消息：SessionAwareMessageListener........





       这说明我们已经成功的往sessionAwareQueue发送了一条纯文本消息，消息会被ConsumerSessionAwareMessageListener的onMessage方法进行处理，在onMessage方法中ConsumerSessionAwareMessageListener就是简单的把接收到的纯文本信息的内容打印出来了，之后再往queueDestination发送了一个纯文本消息，消息内容是“ConsumerSessionAwareMessageListener…”，该消息随后就被ConsumerMessageListener处理了，根据我们的定义，在ConsumerMessageListener中也只是简单的打印了一下接收到的消息内容。

3、MessageListenerAdapter

MessageListenerAdapter类实现了MessageListener接口和SessionAwareMessageListener接口，它的主要作用是将接收到的消息进行类型转换，然后通过反射的形式把它交给一个普通的Java类进行处理。

       MessageListenerAdapter会把接收到的消息做如下转换：

       TextMessage转换为String对象；

       BytesMessage转换为byte数组；

       MapMessage转换为Map对象；

       ObjectMessage转换为对应的Serializable对象。

       既然前面说了MessageListenerAdapter会把接收到的消息做一个类型转换，然后利用反射把它交给真正的目标处理器——一个普通的Java类进行处理（如果真正的目标处理器是一个MessageListener或者是一个SessionAwareMessageListener，那么Spring将直接使用接收到的Message对象作为参数调用它们的onMessage方法，而不会再利用反射去进行调用），那么我们在定义一个MessageListenerAdapter的时候就需要为它指定这样一个目标类。这个目标类我们可以通过MessageListenerAdapter的构造方法参数指定，如：

Xml代码  收藏代码

    <bean id="messageListenerAdapter" class="org.springframework.jms.listener.adapter.MessageListenerAdapter"> 
            <property name="delegate"> 
                <bean class="cn.tzz.jms.activemq.spring.listener.ConsumerListener"/> 
            </property> 
    <!-- 也可以上述方式配置，也可通过它的delegate属性来指定，如下 --> 
    <!--         <constructor-arg> --> 
    <!--             <bean class="cn.tzz.jms.activemq.spring.listener.ConsumerListener"/> --> 
    <!--         </constructor-arg> --> 
            <property name="defaultListenerMethod" value="receiveMessage"/> 
        </bean> 


     前面说了如果我们指定的这个目标处理器是一个MessageListener或者是一个SessionAwareMessageListener的时候Spring将直接利用接收到的Message对象作为方法参数调用它们的onMessage方法。但是如果指定的目标处理器是一个普通的Java类时Spring将利用Message进行了类型转换之后的对象作为参数通过反射去调用真正的目标处理器的处理方法，那么Spring是如何知道该调用哪个方法呢？这是通过MessageListenerAdapter的defaultListenerMethod属性来决定的，当我们没有指定该属性时，Spring会默认调用目标处理器的handleMessage方法。

       接下来我们来看一个示例，假设我们有一个普通的Java类ConsumerListener，其对应有两个方法，handleMessage和receiveMessage，其代码如下：

Java代码  收藏代码

    package cn.tzz.jms.activemq.spring.listener; 
     
     
    public class ConsumerListener { 
      
        public void handleMessage(String message) { 
            System.out.println("ConsumerListener通过handleMessage接收到消息：" + message); 
        } 
        public void receiveMessage(String message) { 
            System.out.println("ConsumerListener通过receiveMessage接收到消息：" + message); 
        } 
         
    } 



       假设我们要把它作为一个消息监听器来监听发送到adapterQueue的消息，这个时候我们就可以定义一个对应的MessageListenerAdapter来把它当做一个MessageListener使用。
配置如下：
    
Xml代码  收藏代码

    <!-- 消息监听器 .3--> 
        <bean id="adapterQueue" class="org.apache.activemq.command.ActiveMQQueue">   
            <constructor-arg>   
                <value>adapterQueue</value>   
            </constructor-arg>   
        </bean>   
        <!-- 消息监听适配器 --> 
        <bean id="messageListenerAdapter" class="org.springframework.jms.listener.adapter.MessageListenerAdapter"> 
            <property name="delegate"> 
                <bean class="cn.tzz.jms.activemq.spring.listener.ConsumerListener"/> 
            </property> 
    <!-- 也可以上述方式配置，也可通过它的delegate属性来指定，如下 --> 
    <!--         <constructor-arg> --> 
    <!--             <bean class="cn.tzz.jms.activemq.spring.listener.ConsumerListener"/> --> 
    <!--         </constructor-arg> --> 
            <property name="defaultListenerMethod" value="receiveMessage"/> 
        </bean> 
         
            <!-- 消息监听适配器对应的监听容器 --> 
        <bean id="messageListenerAdapterContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer"> 
            <property name="connectionFactory" ref="connectionFactory"/> 
            <property name="destination" ref="adapterQueue"/> 
            <property name="messageListener" ref="messageListenerAdapter"/><!-- 使用MessageListenerAdapter来作为消息监听器 --> 
        </bean> 


     在上面的MessageListenerAdapter中我们指定了其defaultListenerMethod属性的值为receiveMessage，所以当MessageListenerAdapter接收到消息之后会自动的调用我们指定的ConsumerListener的receiveMessage方法。

测试代码如下：

Java代码  收藏代码

    import javax.jms.Destination; 
    import org.junit.Test; 
    import org.junit.runner.RunWith; 
    import org.springframework.beans.factory.annotation.Autowired; 
    import org.springframework.beans.factory.annotation.Qualifier; 
    import org.springframework.test.context.ContextConfiguration; 
    import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 
     
    import cn.tzz.jms.activemq.spring.service.ProducerService; 
     
    @RunWith(SpringJUnit4ClassRunner.class) 
    @ContextConfiguration("/applicationContext.xml") 
    public class ProducerConsumerTest3 { 
     
        @Autowired 
        private ProducerService producerService; 
        @Autowired   
        @Qualifier("adapterQueue")   
        private Destination adapterQueue;   
           
        @Test   
        public void testMessageListenerAdapter() {   
            producerService.sendMessage(adapterQueue, "测试MessageListenerAdapter");   
        }   
    } 



运行测试程序控制台输出如下：

生产者发消息：测试MessageListenerAdapter

ConsumerListener通过receiveMessage接收到消息：测试MessageListenerAdapter



       MessageListenerAdapter除了会自动的把一个普通Java类当做MessageListener来处理接收到的消息之外，其另外一个主要的功能是可以自动的发送返回消息。

     当我们用于处理接收到的消息的方法的返回值不为空的时候，Spring会自动将它封装为一个JMS Message，然后自动进行回复。那么这个时候这个回复消息将发送到哪里呢？这主要有两种方式可以指定。
       第一，可以通过发送的Message的setJMSReplyTo方法指定该消息对应的回复消息的目的地。这里我们把我们的生产者发送消息的代码做一下修改，在发送消息之前先指定该消息对应的回复目的地为一个叫responseQueue的队列目的地，具体代码如下所示：

Java代码  收藏代码

    package cn.tzz.jms.activemq.spring.service.impl; 
     
    import javax.jms.Destination; 
    import javax.jms.JMSException; 
    import javax.jms.Message; 
    import javax.jms.Session; 
    import javax.jms.TextMessage; 
     
    import org.springframework.beans.factory.annotation.Autowired; 
    import org.springframework.beans.factory.annotation.Qualifier; 
    import org.springframework.jms.core.JmsTemplate; 
    import org.springframework.jms.core.MessageCreator; 
    import org.springframework.stereotype.Service; 
     
    import cn.tzz.jms.activemq.spring.service.ProducerService; 
      
      
    @Service(value="producerService2") 
    public class ProducerServiceImpl2 implements ProducerService { 
      
        @Autowired 
        private JmsTemplate jmsTemplate; 
        @Autowired   
        @Qualifier("responseQueue")   
        private Destination responseDestination;   
           
        public void sendMessage(Destination destination, final String message) {   
            System.out.println("生产者发送消息：" + message);   
            jmsTemplate.send(destination, new MessageCreator() {   
                public Message createMessage(Session session) throws JMSException {   
                    TextMessage textMessage = session.createTextMessage(message);   
                    textMessage.setJMSReplyTo(responseDestination);   
                    return textMessage;   
                }   
            });   
        }   
    } 



       接着定义一个叫responseQueue的队列目的地及其对应的消息监听器和监听容器。

Html代码  收藏代码

    <!-- 用于测试消息回复的 --> 
       <bean id="responseQueue" class="org.apache.activemq.command.ActiveMQQueue"> 
           <constructor-arg> 
               <value>responseQueue</value> 
           </constructor-arg> 
       </bean> 
     
       <!-- responseQueue对应的监听器 --> 
       <bean id="responseQueueListener" class="cn.tzz.jms.activemq.spring.listener.ResponseQueueListener"/> 
     
       <!-- responseQueue对应的监听容器 --> 
       <bean id="responseQueueMessageListenerContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer"> 
           <property name="connectionFactory" ref="connectionFactory"/> 
           <property name="destination" ref="responseQueue"/> 
           <property name="messageListener" ref="responseQueueListener"/> 
       </bean> 



       ResponseQueueListener的定义如下所示：

Java代码  收藏代码

    package cn.tzz.jms.activemq.spring.listener; 
     
    import javax.jms.JMSException; 
    import javax.jms.Message; 
    import javax.jms.MessageListener; 
    import javax.jms.TextMessage; 
     
    public class ResponseQueueListener implements MessageListener { 
          
        public void onMessage(Message message) { 
            if (message instanceof TextMessage) { 
                TextMessage textMessage = (TextMessage) message; 
                try { 
                    System.out.println("接收到发送到responseQueue的一个消息" + textMessage.getText()); 
                } catch (JMSException e) { 
                    e.printStackTrace(); 
                } 
            } 
        } 
    } 


接着把我们接收消息的ConsumerListener的receiveMessage方法改为如下：

Java代码  收藏代码

    public String receiveMessage(String message) { 
        System.out.println("ConsumerListener通过receiveMessage接收到消息：" + message); 
        return "这是ConsumerListener对象的receiveMessage方法的返回值。";   
       } 


我们可以看到在上述负责接收消息的receiveMessage方法有一个非空的返回值。
测试代码如下所示：

Java代码  收藏代码

    package cn.tzz.jms.activemq.spring.test; 
     
    import javax.annotation.Resource; 
    import javax.jms.Destination; 
    import org.junit.Test; 
    import org.junit.runner.RunWith; 
    import org.springframework.beans.factory.annotation.Autowired; 
    import org.springframework.beans.factory.annotation.Qualifier; 
    import org.springframework.test.context.ContextConfiguration; 
    import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 
     
    import cn.tzz.jms.activemq.spring.service.ProducerService; 
     
    @RunWith(SpringJUnit4ClassRunner.class) 
    @ContextConfiguration("/applicationContext.xml") 
    public class ProducerConsumerTest4 { 
     
        @Resource(name="producerService2") 
        private ProducerService producerService; 
        @Autowired   
        @Qualifier("adapterQueue")   
        private Destination adapterQueue;   
           
        @Test   
        public void testMessageListenerAdapter() {   
            producerService.sendMessage(adapterQueue, "测试MessageListenerAdapter");   
        }   
    } 



运行上述测试代码之后，控制台输出如下：



生产者发送消息：测试MessageListenerAdapter

ConsumerListener通过receiveMessage接收到消息：测试MessageListenerAdapter

接收到发送到responseQueue的一个消息这是ConsumerListener对象的receiveMessage方法的返回值。


        这说明我们的生产者发送消息被MessageListenerAdapter处理之后，MessageListenerAdapter确实把监听器的返回内容封装成一个Message往原Message通过setJMSReplyTo方法指定的回复目的地发送了一个消息。对于MessageListenerAdapter对应的监听器处理方法返回的是一个null值或者返回类型是void的情况，MessageListenerAdapter是不会自动进行消息的回复的，有兴趣的网友可以自己测试一下。

       第二，通过MessageListenerAdapter的defaultResponseDestination属性来指定。这里我们也来做一个测试，首先维持生产者发送消息的代码不变，即发送消息前不通过Message的setJMSReplyTo方法指定消息的回复目的地；接着我们在定义MessageListenerAdapter的时候通过其defaultResponseDestination属性指定其默认的回复目的地是“defaultResponseQueue”，并定义defaultResponseQueue对应的消息监听器和消息监听容器。

Html代码  收藏代码

    <!-- 消息监听适配器 --> 
        <bean id="messageListenerAdapter" class="org.springframework.jms.listener.adapter.MessageListenerAdapter"> 
            <property name="delegate"> 
                <bean class="cn.tzz.jms.activemq.spring.listener.ConsumerListener"/> 
            </property> 
    <!-- 也可以上述方式配置，也可通过它的delegate属性来指定，如下 --> 
    <!--         <constructor-arg> --> 
    <!--             <bean class="cn.tzz.jms.activemq.spring.listener.ConsumerListener"/> --> 
    <!--         </constructor-arg> --> 
            <property name="defaultListenerMethod" value="receiveMessage"/> 
            <property name="defaultResponseDestination" ref="defaultResponseQueue"/>   
        </bean> 
         
            <!-- 消息监听适配器对应的监听容器 --> 
        <bean id="messageListenerAdapterContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer"> 
            <property name="connectionFactory" ref="connectionFactory"/> 
            <property name="destination" ref="adapterQueue"/> 
            <property name="messageListener" ref="messageListenerAdapter"/><!-- 使用MessageListenerAdapter来作为消息监听器 --> 
        </bean> 
    <!-- 默认的消息回复队列 -->   
        <bean id="defaultResponseQueue" class="org.apache.activemq.command.ActiveMQQueue">   
            <constructor-arg>   
                <value>defaultResponseQueue</value>   
            </constructor-arg>   
        </bean> 
         
        <!-- defaultResponseQueue对应的监听器 -->   
        <bean id="defaultResponseQueueListener" class="cn.tzz.jms.activemq.spring.listener.DefaultResponseQueueListener"/>   
           
        <!-- defaultResponseQueue对应的监听容器 -->   
        <bean id="defaultResponseQueueMessageListenerContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">   
            <property name="connectionFactory" ref="connectionFactory"/>   
            <property name="destination" ref="defaultResponseQueue"/>   
            <property name="messageListener" ref="defaultResponseQueueListener"/>   
        </bean>   

 


       DefaultResponseQueueListener的代码如下所示：

Java代码  收藏代码

    package cn.tzz.jms.activemq.spring.listener; 
     
    import javax.jms.JMSException; 
    import javax.jms.Message; 
    import javax.jms.MessageListener; 
    import javax.jms.TextMessage; 
     
    public class DefaultResponseQueueListener implements MessageListener {   
            
        public void onMessage(Message message) {   
            if (message instanceof TextMessage) {   
                TextMessage textMessage = (TextMessage) message;   
                try {   
                    System.out.println("DefaultResponseQueueListener接收到发送到defaultResponseQueue的一个息：" + textMessage.getText());   
                } catch (JMSException e) {   
                    e.printStackTrace();   
                }   
            }   
        }   
    } 

 


       这时候运行如下测试代码：

Java代码  收藏代码

    @Test 
    public void testMessageListenerAdapter() { 
        producerService.sendMessage(adapterQueue, "测试MessageListenerAdapter"); 
    } 



控制台将输出如下内容：

生产者发送消息：测试MessageListenerAdapter

ConsumerListener通过receiveMessage接收到消息：测试MessageListenerAdapter

DefaultResponseQueueListener接收到发送到defaultResponseQueue的一个息：这是ConsumerListener对象的receiveMessage方法的返回值。


        这说明MessageListenerAdapter会自动把真正的消息处理器返回的非空内容封装成一个Message发送回复消息到通过defaultResponseDestination属性指定的默认消息回复目的地。

       既然我们可以通过两种方式来指定MessageListenerAdapter自动发送回复消息的目的地，那么当我们两种方式都指定了而且它们的目的地还不一样的时候会怎么发送呢？是两个都发还是只发其中的一个呢？关于这部分的测试我这里就不赘述了，有兴趣的网友可以自己进行。这里我可以直接的告诉大家，当两种方式都指定了消息的回复目的地的时候使用发送消息的setJMSReplyTo方法指定的目的地将具有较高的优先级，MessageListenerAdapter将只往该方法指定的消息回复目的地发送回复消息。