[关闭]
@boothsun 2017-09-22T10:06:27.000000Z 字数 8123 阅读 967

Spring整合ActiveMQ

消息队列

  1. 原文地址：Spring整合JMS 基于ActiveMQ

1. pom.xml 文件

  1. <dependency>  
  2.     <groupId>org.springframework</groupId>  
  3.     <artifactId>spring-jms</artifactId>  
  4.     <version>4.0.2.RELEASE/version>  
  5. </dependency>  
  6. <dependency>  
  7.     <groupId>org.apache.activemq</groupId>  
  8.     <artifactId>activemq-core</artifactId>  
  9.     <version>5.7.0</version>  
  10. </dependency> 
  11. <!-- https://mvnrepository.com/artifact/org.apache.activemq/activemq-pool -->
  12. <dependency>
  13.     <groupId>org.apache.activemq</groupId>
  14.     <artifactId>activemq-pool</artifactId>
  15.     <version>5.15.0</version>
  16. </dependency>

2. 配置ConnectionFactory

ConnectionFactory是用于产生到JMS服务器的链接的，Spring为我们提供了多个ConnectionFactory，有SingleConnectionFactory和CachingConnectionFactory。SingleConnectionFactory对于建立JMS服务器链接的请求会一直返回同一个链接，并且会忽略Connection的close方法调用。CachingConnectionFactory继承了SingleConnectionFactory，所以它拥有SingleConnectionFactory的所有功能，同时它还新增了缓存功能，它可以缓存Session、MessageProducer和MessageConsumer。这里我们使用SingleConnectionFactory来作为示例。

  1. <bean id="connectionFactory" class="org.springframework.jms.connection.SingleConnectionFactory"/>

这样就产生了到JMS服务器链接的ConnectionFactory了吗？答案是非也。Spring提供的ConnectionFactory只是Spring用于管理ConnectionFactory的，真正产生到JMS服务器链接的ConnectionFactory还得是由JMS服务厂商提供，并且需要把它注入到Spring提供的ConnectionFactory中。我们这里使用的是ActiveMQ实现的JMS，所以在我们这里真正的可以产生Connection的就应该是由ActiveMQ提供的ConnectionFactory。所以定义一个ConnectionFactory的完整代码应该如下所示：

  1. <!-- 真正可以产生Connection的ConnectionFactory，由对应的JMS服务厂商提供-->  
  2. <bean id="targetConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">  
  3.     <property name="brokerURL" value="tcp://localhost:61616"/>  
  4. </bean>  
  6. <!-- Spring用于管理真正的ConnectionFactory的ConnectionFactory -->  
  7. <bean id="connectionFactory" class="org.springframework.jms.connection.SingleConnectionFactory">  
  8.     <!-- 目标ConnectionFactory对应真实的可以产生JMS Connection的ConnectionFactory -->  
  9.     <property name="targetConnectionFactory" ref="targetConnectionFactory"/>  
  10. </bean>

ActiveMQ为我们提供了一个PooledConnectionFactory，通过往里面注入一个ActiveMQConnectionFactory可以用来将Connection、Session和MessageProducer池化，这样可以大大的减少我们的资源消耗。当使用PooledConnectionFactory时，我们在定义一个ConnectionFactory时应该是如下定义:

  1. <!-- 真正可以产生Connection的ConnectionFactory，由对应的 JMS服务厂商提供-->  
  2. <bean id="targetConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">  
  3.     <property name="brokerURL" value="tcp://localhost:61616"/>  
  4. </bean>  
  6. <bean id="pooledConnectionFactory" class="org.apache.activemq.pool.PooledConnectionFactory">  
  7.     <property name="connectionFactory" ref="targetConnectionFactory"/>  
  8.     <property name="maxConnections" value="10"/>  
  9. </bean>  
  11. <bean id="connectionFactory" class="org.springframework.jms.connection.SingleConnectionFactory">  
  12.     <property name="targetConnectionFactory" ref="pooledConnectionFactory"/>  
  13. </bean>

3. 配置生产者

配置好ConnectionFactory之后我们就需要配置生产者。生产者负责产生消息并发送到JMS服务器，这通常对应的是我们的一个业务逻辑服务实现类。但是我们的服务实现类是怎么进行消息的发送的呢？这通常是利用Spring为我们提供的JmsTemplate类来实现的，所以配置生产者其实最核心的就是配置进行消息发送的JmsTemplate。对于消息发送者而言，它在发送消息的时候要知道自己该往哪里发，为此，我们在定义JmsTemplate的时候需要往里面注入一个Spring提供的ConnectionFactory对象。

  1. <!-- Spring提供的JMS工具类，它可以进行消息发送、接收等 -->  
  2. <bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">  
  3.     <!-- 这个connectionFactory对应的是我们定义的Spring提供的那个ConnectionFactory对象 -->  
  4.     <property name="connectionFactory" ref="connectionFactory"/>  
  5. </bean>

在真正利用JmsTemplate进行消息发送的时候，我们需要知道消息发送的目的地，即destination。在Jms中有一个用来表示目的地的Destination接口，它里面没有任何方法定义，只是用来做一个标识而已。当我们在使用JmsTemplate进行消息发送时没有指定destination的时候将使用默认的Destination。默认Destination可以通过在定义jmsTemplate bean对象时通过属性defaultDestination或defaultDestinationName来进行注入，defaultDestinationName对应的就是一个普通字符串。在ActiveMQ中实现了两种类型的Destination，一个是点对点的ActiveMQQueue，另一个就是支持订阅/发布模式的ActiveMQTopic。在定义这两种类型的Destination时我们都可以通过一个name属性来进行构造，如：

  1. <!--这个是队列目的地，点对点的-->  
  2. <bean id="queueDestination" class="org.apache.activemq.command.ActiveMQQueue">  
  3.     <constructor-arg>  
  4.         <value>queue</value>  
  5.     </constructor-arg>  
  6. </bean>  
  7. <!--这个是主题目的地，一对多的-->  
  8. <bean id="topicDestination" class="org.apache.activemq.command.ActiveMQTopic">  
  9.     <constructor-arg value="topic"/>  
  10. </bean>

假设我们定义了一个ProducerService，里面有一个向Destination发送纯文本消息的方法sendMessage，那么我们的代码就大概是这个样子：

  1. @Component
  2. public class ProducerServiceImpl implements ProducerService {
  4.     @Resource
  5.     JmsTemplate jmsTemplate;
  7.     public void sendMessage(Destination destination, final String message) {
  8.         System.out.println("---------------生产者发了一个消息：" + message);
  9.         jmsTemplate.send(destination, session -> session.createTextMessage(message));
  10.     }
  11. }

我们可以看到在sendMessage方法体里面我们是通过jmsTemplate来发送消息到对应的Destination的。到此，我们生成一个简单的文本消息并把它发送到指定目的地Destination的生产者就配置好了。

4. 配置消费者

生产者往指定目的地Destination发送消息后，接下来就是消费者对指定目的地的消息进行消费了。那么消费者是如何知道有生产者发送消息到指定目的地Destination了呢？这是通过Spring为我们封装的消息监听容器MessageListenerContainer实现的，它负责接收信息，并把接收到的信息分发给真正的MessageListener进行处理。每个消费者对应每个目的地都需要有对应的MessageListenerContainer。对于消息监听容器而言，除了要知道监听哪个目的地之外，还需要知道到哪里去监听，也就是说它还需要知道去监听哪个JMS服务器，这是通过在配置MessageConnectionFactory的时候往里面注入一个ConnectionFactory来实现的。所以我们在配置一个MessageListenerContainer的时候有三个属性必须指定，一个是表示从哪里监听的ConnectionFactory；一个是表示监听什么的Destination；一个是接收到消息以后进行消息处理的MessageListener。Spring一共为我们提供了两种类型的MessageListenerContainer，SimpleMessageListenerContainer和DefaultMessageListenerContainer。

SimpleMessageListenerContainer会在一开始的时候就创建一个会话session和消费者Consumer，并且会使用标准的JMS MessageConsumer.setMessageListener()方法注册监听器让JMS提供者调用监听器的回调函数。它不会动态的适应运行时需要和参与外部的事务管理。兼容性方面，它非常接近于独立的JMS规范，但一般不兼容Java EE的JMS限制。

大多数情况下我们还是使用的DefaultMessageListenerContainer，跟SimpleMessageListenerContainer相比，DefaultMessageListenerContainer会动态的适应运行时需要，并且能够参与外部的事务管理。它很好的平衡了对JMS提供者要求低、先进功能如事务参与和兼容Java EE环境。

定义处理消息的MessageListener

要定义处理消息的MessageListener我们只需要实现JMS规范中的MessageListener接口就可以了。MessageListener接口中只有一个方法onMessage方法，当接收到消息的时候会自动调用该方法。

  1. public class ConsumerMessageListener implements MessageListener {  
  3.     public void onMessage(Message message) {  
  4.         //这里我们知道生产者发送的就是一个纯文本消息，所以这里可以直接进行强制转换  
  5.         TextMessage textMsg = (TextMessage) message;  
  6.         System.out.println("接收到一个纯文本消息。");  
  7.         try {  
  8.             System.out.println("消息内容是：" + textMsg.getText());  
  9.         } catch (JMSException e) {  
  10.             e.printStackTrace();  
  11.         }  
  12.     }  
  14. }

有了MessageListener之后我们就可以在Spring的配置文件中配置一个消息监听容器了。

  1. <!--这个是队列目的地-->  
  2. <bean id="queueDestination" class="org.apache.activemq.command.ActiveMQQueue">  
  3.     <constructor-arg>  
  4.         <value>queue</value>  
  5.     </constructor-arg>  
  6. </bean>  
  7. <!-- 消息监听器 -->  
  8. <bean id="consumerMessageListener" class="com.tiantian.springintejms.listener.ConsumerMessageListener"/>      
  10. <!-- 消息监听容器 -->  
  11. <bean id="jmsContainer"        class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
  12.     <property name="connectionFactory" ref="connectionFactory" />  
  13.     <property name="destination" ref="queueDestination" />  
  14.     <property name="messageListener" ref="consumerMessageListener" />  
  15. </bean>

我们可以看到我们定义了一个名叫queue的ActiveMQQueue目的地，我们的监听器就是监听了发送到这个目的地的消息。

至此我们的生成者和消费者都配置完成了，这也就意味着我们的整合已经完成了。这个时候完整的Spring的配置文件应该是这样的。

  1. <!-- 真正可以产生Connection的ConnectionFactory，由对应的 JMS服务厂商提供-->
  2. <bean id="targetConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">
  3.     <property name="brokerURL" value="${brokerURL}?wireFormat.maxInactivityDuration=0"/>
  4. </bean>
  6. <bean id="pooledConnectionFactory" class="org.apache.activemq.pool.PooledConnectionFactory">
  7.     <property name="connectionFactory" ref="targetConnectionFactory"/>
  8.     <property name="maxConnections" value="10"/>
  9. </bean>
  11. <bean id="connectionFactory" class="org.springframework.jms.connection.SingleConnectionFactory">
  12.     <property name="targetConnectionFactory" ref="pooledConnectionFactory"/>
  13. </bean>
  15. <!-- Spring提供的JMS工具类，它可以进行消息发送、接收等 -->
  16. <bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">
  17.     <property name="connectionFactory" ref="connectionFactory"/>
  18. </bean>
  20. <!--queue -->
  21. <bean id="salaryDestination" class="org.apache.activemq.command.ActiveMQQueue">
  22.     <constructor-arg>
  23.         <value>zfpt.salary</value>
  24.     </constructor-arg>
  25. </bean>
  27. <!-- topic -->
  28. <bean id="topicDestination" class="org.apache.activemq.command.ActiveMQTopic">
  29.     <constructor-arg value="topic"/>
  30. </bean>
  32. <!-- 消息监听器 -->
  33. <bean id="consumerMessageListener" class="com.boothsun.mq.impl.ConsumerMessageListener"/>
  35. <!-- 消息监听容器 -->
  36. <bean id="salaryContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
  37.     <property name="connectionFactory" ref="connectionFactory" />
  38.     <property name="destination" ref="salaryDestination" />
  39.     <property name="messageListener" ref="consumerMessageListener" />
  40. </bean>
  42. <!-- 消息监听容器 -->
  43. <bean id="topicContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
  44.     <property name="connectionFactory" ref="connectionFactory" />
  45.     <property name="destination" ref="topicDestination" />
  46.     <property name="messageListener" ref="consumerMessageListener" />
  47. </bean>
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注