ActiveMQ5.0实战

**

*作者:andyao,email:andyaoy@gmail.com

*http://andyao.javaeye.com/blog/154092

*/

ActiveMQ5.0实战一: 安装配置ActiveMQ5.0

ActiveMQ5.0实战三:使用Spring发送,消费topic和queue消息

简介

上一篇http://www.javaeye.com/topic/15317介绍了ActiveMQ5.0的安装，这一篇将介绍的配置。ActiveMQ包含了很多features（详见http://activemq.apache.org/features.html ），  
不同的需求，不同的环境，需要不同的features，当然需要不同的配置。在这里我只写了最基本的配置，算是抛砖了，希望引出更多关于ActiveMQ的高级配置。
假设已经正确安装ActiveMQ5.0，同时及其IP地址为192.168.1.148，具体使用时可以改为自己的IP。下面讲解的配置实现的features如下：

1. 客户端可以通过tcp://192.168.1.148连接ActiveMQ。
2. 消息持久化保存，重启服务器不会丢失消息。
3. 可以通过http://192.168.1.148:8161/admin监控ActiveMQ服务器

配置

ActiveMQ默认使用的是XML格式配置，从4.0版本开始用MBean的方式实现XML配置，配置文件在${activemq.home}/conf目录下，文件名为activemq.xml。最新的默认配置见
http://svn.apache.org/repos/asf/activemq/trunk/assembly/src/release/conf/activemq.xml 。下面为本篇文章使用的配置，及重要部分的解释。

 

Xml代码

1. <beans  
2.   xmlns="http://www.springframework.org/schema/beans"  
3.   xmlns:amq="http://activemq.org/config/1.0"  
4.   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd   
5.   http://activemq.org/config/1.0 http://activemq.apache.org/schema/activemq-core.xsd   
6.   http://activemq.apache.org/camel/schema/spring>  
7.     
8.   <!-- persistent="true"表示要持久化存储消息，和子元素persistenceAdapter结合使用 -->  
9.   <!-- dataDirectory默认的存储持久化数据的目录 -->  
10.   <!-- brokerName 设置broker的name，在注意在网络上必须是唯一的-->  
11.   <!-- 更多参考http://activemq.apache.org/xbean-xml-reference-50.html#XBeanXMLReference5.0-brokerelement -->  
12.   <broker xmlns="http://activemq.org/config/1.0" brokerName="192.168.1.148" persistent ="true" dataDirectory="${activemq.base}/data" useShutdownHook="false">  
13.     
14.     <!-- Destination specific policies using destination names or wildcards -->  
15.     <!-- wildcards意义见http://activemq.apache.org/wildcards.html -->  
16.     <destinationPolicy>  
17.       <policyMap>  
18.         <policyEntries>  
19.        <!-- 这里使用了wildcards，表示所有以EUCITA开头的topic -->  
20.           <policyEntry topic="EUCITA.>" producerFlowControl="false" memoryLimit="10mb">  
21.             <!-- 分发策略 -->  
22.         <dispatchPolicy>  
23.           <!-- 按顺序分发 -->  
24.               <strictOrderDispatchPolicy/>  
25.             </dispatchPolicy>  
26.         <!--  恢复策略-->  
27.             <subscriptionRecoveryPolicy>  
28.           <!-- 只恢复最后一个message -->  
29.               <lastImageSubscriptionRecoveryPolicy/>  
30.             </subscriptionRecoveryPolicy>  
31.           </policyEntry>  
32.         </policyEntries>  
33.       </policyMap>  
34.     </destinationPolicy>  
35.   
36.     <!-- The transport connectors ActiveMQ will listen to -->  
37.     <transportConnectors>  
38.        <transportConnector name="openwire" uri="tcp://192.168.1.148:61616" discoveryUri="multicast://default"/>  
39.        <transportConnector name="ssl"     uri="ssl://192.168.1.148:61617"/>  
40.        <transportConnector name="stomp"   uri="stomp://192.168.1.148:61613"/>  
41.        <transportConnector name="xmpp"    uri="xmpp://192.168.1.148:61222"/>  
42.     </transportConnectors>  
43.       
44.     <!-- 消息持久化方式 -->  
45.     <persistenceAdapter>  
46.       <amqPersistenceAdapter directory="${activemq.base}/data"/>  
47.     </persistenceAdapter>  
48. </broker>  
49.   
50.   <!-- lets create a command agent to respond to message based admin commands on the ActiveMQ.Agent topic -->  
51.     <commandAgent xmlns="http://activemq.org/config/1.0"/>  
52.      
53.   <!-- An embedded servlet engine for serving up the Admin console -->  
54.   <jetty xmlns="http://mortbay.com/schemas/jetty/1.0">  
55.     <connectors>  
56.       <nioConnector port="8161" />  
57.     </connectors>  
58.   
59.     <handlers>  
60.       <webAppContext contextPath="/admin" resourceBase="${activemq.base}/webapps/admin" logUrlOnStart="true" />        
61.       <webAppContext contextPath="/demo" resourceBase="${activemq.base}/webapps/demo" logUrlOnStart="true" />          
62.     </handlers>  
63.   </jetty>    
64. </beans>  

<beans
  xmlns="http://www.springframework.org/schema/beans"
  xmlns:amq="http://activemq.org/config/1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
  http://activemq.org/config/1.0 http://activemq.apache.org/schema/activemq-core.xsd
  http://activemq.apache.org/camel/schema/spring>
 
  <!-- persistent="true"表示要持久化存储消息，和子元素persistenceAdapter结合使用 -->
  <!-- dataDirectory默认的存储持久化数据的目录 -->
  <!-- brokerName 设置broker的name，在注意在网络上必须是唯一的-->
  <!-- 更多参考http://activemq.apache.org/xbean-xml-reference-50.html#XBeanXMLReference5.0-brokerelement -->
  <broker xmlns="http://activemq.org/config/1.0" brokerName="192.168.1.148" persistent ="true" dataDirectory="${activemq.base}/data" useShutdownHook="false">
 
    <!-- Destination specific policies using destination names or wildcards -->
    <!-- wildcards意义见http://activemq.apache.org/wildcards.html -->
    <destinationPolicy>
      <policyMap>
        <policyEntries>
       <!-- 这里使用了wildcards，表示所有以EUCITA开头的topic -->
          <policyEntry topic="EUCITA.>" producerFlowControl="false" memoryLimit="10mb">
            <!-- 分发策略 -->
        <dispatchPolicy>
          <!-- 按顺序分发 -->
              <strictOrderDispatchPolicy/>
            </dispatchPolicy>
        <!--  恢复策略-->
            <subscriptionRecoveryPolicy>
          <!-- 只恢复最后一个message -->
              <lastImageSubscriptionRecoveryPolicy/>
            </subscriptionRecoveryPolicy>
          </policyEntry>
        </policyEntries>
      </policyMap>
    </destinationPolicy>

    <!-- The transport connectors ActiveMQ will listen to -->
    <transportConnectors>
       <transportConnector name="openwire" uri="tcp://192.168.1.148:61616" discoveryUri="multicast://default"/>
       <transportConnector name="ssl"     uri="ssl://192.168.1.148:61617"/>
       <transportConnector name="stomp"   uri="stomp://192.168.1.148:61613"/>
       <transportConnector name="xmpp"    uri="xmpp://192.168.1.148:61222"/>
    </transportConnectors>
   
    <!-- 消息持久化方式 -->
    <persistenceAdapter>
      <amqPersistenceAdapter directory="${activemq.base}/data"/>
    </persistenceAdapter>
</broker>

  <!-- lets create a command agent to respond to message based admin commands on the ActiveMQ.Agent topic -->
    <commandAgent xmlns="http://activemq.org/config/1.0"/>
  
  <!-- An embedded servlet engine for serving up the Admin console -->
  <jetty xmlns="http://mortbay.com/schemas/jetty/1.0">
    <connectors>
      <nioConnector port="8161" />
    </connectors>

    <handlers>
      <webAppContext contextPath="/admin" resourceBase="${activemq.base}/webapps/admin" logUrlOnStart="true" />     
      <webAppContext contextPath="/demo" resourceBase="${activemq.base}/webapps/demo" logUrlOnStart="true" />       
    </handlers>
  </jetty> 
</beans>

注释

关于XML配置中元素的具体信息可以参考http://activemq.apache.org/xbean-xml-reference-50.html 下面介绍本篇配置使用的一些重要元素。

DispathPolicy

ActiveMQ支持3中不同的分发策略（避免翻译了以后误解，这里用原文）：

1. <roundRobinDispatchPolicy>：Simple dispatch policy that sends a message to every subscription that matches the message.
2. <simpleDispatchPolicy>：Simple dispatch policy that sends a message to every subscription that matches the message.
3. <strictOrderDispatchPolicy>：Dispatch policy that causes every subscription to see messages in the same order.

SubscriptionRecoveryPolicy

ActiveMQ支持6种恢复策略，可以自行选择使用不同的策略

1. <fixedCountSubscriptionRecoveryPolicy>： keep a fixed count of last messages.
2. <fixedSizedSubscriptionRecoveryPolicy>： keep a fixed amount of memory available in RAM for message history which is evicted in time order.
3. <lastImageSubscriptionRecoveryPolicy>：only keep the last message.
4. <noSubscriptionRecoveryPolicy>：disable recovery of messages.
5. <queryBasedSubscriptionRecoveryPolicy>：perform a user specific query mechanism to load any messages they may have missed.
6. <timedSubscriptionRecoveryPolicy>：keep a timed buffer of messages around in memory and use that to recover new subscriptions.

PersistenceAdapter

http://activemq.apache.org/persistence 讲解了关于persistence的信息。ActiveMQ5.0使用AMQ Message Store 持久化消息，这种方式提供了很好的性能（The AMQ Message Store is an embeddable transactional message storage solution that is extremely fast and reliable.） 默认使用该存储方式即可，如果想使用JDBC来存储，可以查找文档配置。 

Summary

本篇文章只提供了基本配置信息。如果需要更多的文章，可以查看ActiveMQ的文档。

讲了安装和简单的配置，下一篇将介绍和Sping的整合，以及多个queue，多个topic，多个producer，多个consumer的配置，使用。

ActiveMQ5.0实战一: 安装配置ActiveMQ5.0

ActiveMQ5.0实战二: 基本配置

简介

实战一 , 实战二介绍了ActiveMQ的基本概念和配置方式.

本篇将通过一个实例介绍使用spring发送,消费topic, queue类型消息的方法. 不懂topic和queue的google 之.

 

如图示, TOPIC和QUEUE分别代表一个topic和一个queue消息通道.

1. TopicMessageProducer向topic发送消息, TopicConsumerA和TopicConsumerB则从topic消费消息.
2. QueueMessageProducer向Queue发送消息, QueueConsumer从Queue中消费消息

Spring整合JMS

就像对orm, web的支持一样, spring同样支持jms, 为整合jms到已有的项目提供了很多便利的方法. 本篇主要讲实战, 是所以先从配置开始, spring配置jms基本上需要8个部分.

1. ConnectionFactory. 和jms服务器的连接, 可以是外部的jms server, 也可以使用embedded ActiveMQ Broker.
2. Destination. 有topic和queue两种方式.
3. JmsTemplate. spring提供的jms模板.
4. MessageConverter. 消息转换器.
5. MessageProducer. 消息生产者.
6. MessageConsumer. 消息消费者.
7. MessageListener. 消息监听器
8. MessageListenerContainer. 消息监听容器

下面以实例的方式介绍上面8个部分.

1. ConnectionFactory

Xml代码

1. <amq:connectionFactory id="jmsConnectionFactory" brokerURL="vm://localhost" />  

<amq:connectionFactory id="jmsConnectionFactory" brokerURL="vm://localhost" />

 brokerURL是指要连接的activeMQ server的地址, activeMQ提供了多种brokerURL, 集体可参见文档.一般我们使用嵌套的ActiveMQ server. 配置如下, 这个配置使用消息的存储机制, 服务器重启也不会丢失消息.

Xml代码

1. <!--  embedded ActiveMQ Broker -->  
2.     <amq:broker useJmx="false" persistent="true">  
3.         <amq:persistenceAdapter>  
4.             <amq:amqPersistenceAdapter directory="d:/amq"/>  
5.         </amq:persistenceAdapter>  
6.         <amq:transportConnectors>  
7.             <amq:transportConnector uri="tcp://localhost:61616" />  
8.                        <amq:transportConnector uri="vm://localhost:0" />  
9.         </amq:transportConnectors>  
10.     </amq:broker>  

<!--  embedded ActiveMQ Broker -->
	<amq:broker useJmx="false" persistent="true">
		<amq:persistenceAdapter>
			<amq:amqPersistenceAdapter directory="d:/amq"/>
		</amq:persistenceAdapter>
		<amq:transportConnectors>
			<amq:transportConnector uri="tcp://localhost:61616" />
                       <amq:transportConnector uri="vm://localhost:0" />
		</amq:transportConnectors>
	</amq:broker>

 2. Destination

 在实例中我们使用了两种destination

Xml代码

1. <!--  ActiveMQ destinations  -->  
2. <!--  使用topic方式-->  
3. <amq:topic name="TOPIC" physicalName="JMS-TEST-TOPIC" />  
4. <!--  使用Queue方式-->  
5. <amq:queue name="QUEUE" physicalName="JMS-TEST-QUEUE" />  

<!--  ActiveMQ destinations  -->
<!--  使用topic方式-->
<amq:topic name="TOPIC" physicalName="JMS-TEST-TOPIC" />
<!--  使用Queue方式-->
<amq:queue name="QUEUE" physicalName="JMS-TEST-QUEUE" />

 3. JmsTemplate

Xml代码

1. <!--  Spring JmsTemplate config -->  
2.     <bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">  
3.         <property name="connectionFactory">  
4.             <!--  lets wrap in a pool to avoid creating a connection per send -->  
5.             <bean class="org.springframework.jms.connection.SingleConnectionFactory">  
6.                 <property name="targetConnectionFactory" ref="jmsConnectionFactory" />  
7.             </bean>  
8.         </property>  
9.         <!-- custom MessageConverter -->  
10.         <property name="messageConverter" ref="defaultMessageConverter" />  
11.     </bean>  

<!--  Spring JmsTemplate config -->
	<bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">
		<property name="connectionFactory">
			<!--  lets wrap in a pool to avoid creating a connection per send -->
			<bean class="org.springframework.jms.connection.SingleConnectionFactory">
				<property name="targetConnectionFactory" ref="jmsConnectionFactory" />
			</bean>
		</property>
		<!-- custom MessageConverter -->
		<property name="messageConverter" ref="defaultMessageConverter" />
	</bean>

  4. MessageConverter

   MessageConverter实现的是org.springframework.jms.support.converter.MessageConverter接口, 提供消息的转换功能. DefaultMessageConverter的实现见附件.

Xml代码

1. <bean id="defaultMessageConverter" class="com.andyao.activemq.DefaultMessageConverter" />  

<bean id="defaultMessageConverter" class="com.andyao.activemq.DefaultMessageConverter" />

  5. MessageProducer

   实例拥有两个消息生产者, 消息生产者都是POJO, 实现见附件.

Xml代码

1. <!-- POJO which send Message uses  Spring JmsTemplate -->  
2.     <bean id="topicMessageProducer" class="com.andyao.activemq.TopicMessageProducer">  
3.         <property name="template" ref="jmsTemplate" />  
4.         <property name="destination" ref="TOPIC" />  
5.     </bean>  
6.     <bean id="queueMessageProducer" class="com.andyao.activemq.QueuMessageProducer">  
7.         <property name="template" ref="jmsTemplate" />  
8.         <property name="destination" ref="QUEUE" />  
9.     </bean>  

<!-- POJO which send Message uses  Spring JmsTemplate -->
	<bean id="topicMessageProducer" class="com.andyao.activemq.TopicMessageProducer">
		<property name="template" ref="jmsTemplate" />
		<property name="destination" ref="TOPIC" />
	</bean>
	<bean id="queueMessageProducer" class="com.andyao.activemq.QueuMessageProducer">
		<property name="template" ref="jmsTemplate" />
		<property name="destination" ref="QUEUE" />
	</bean>

 6. MessageConsumer

 TOPIC通道有两个消息消费者, QUEUE有一个消息消费者

Xml代码

1. <!--  Message Driven POJO (MDP) -->  
2.     <!-- consumer1 for topic a -->  
3.     <bean id="topicConsumerA" class="com.andyao.activemq.TopicConsumerA" />  
4.     <!-- consumer2 for topic a -->  
5.     <bean id="topicConsumerB" class="com.andyao.activemq.TopicConsumerB" />  
6.     <!-- consumer for queue -->  
7.     <bean id="queueConsumer" class="com.andyao.activemq.QueueConsumer" />  

<!--  Message Driven POJO (MDP) -->
    <!-- consumer1 for topic a -->
    <bean id="topicConsumerA" class="com.andyao.activemq.TopicConsumerA" />
    <!-- consumer2 for topic a -->
    <bean id="topicConsumerB" class="com.andyao.activemq.TopicConsumerB" />
    <!-- consumer for queue -->
    <bean id="queueConsumer" class="com.andyao.activemq.QueueConsumer" />

  7. MessageListener

每一个消息消费者都对应一个MessageListener

Xml代码

1. <bean id="topicListenerA" class="org.springframework.jms.listener.adapter.MessageListenerAdapter">  
2.         <constructor-arg ref="topicConsumerA" />  
3.         <!--  may be other method -->  
4.         <property name="defaultListenerMethod" value="receive" />  
5.         <!-- custom MessageConverter define -->  
6.         <property name="messageConverter" ref="defaultMessageConverter" />  
7.     </bean>  
8.   
9.     <bean id="topicListenerB" class="org.springframework.jms.listener.adapter.MessageListenerAdapter">  
10.         <constructor-arg ref="topicConsumerB" />  
11.         <!--  may be other method -->  
12.         <property name="defaultListenerMethod" value="receive" />  
13.         <!-- custom MessageConverter define -->  
14.         <property name="messageConverter" ref="defaultMessageConverter" />  
15.     </bean>  
16.   
17.     <bean id="queueListener" class="org.springframework.jms.listener.adapter.MessageListenerAdapter">  
18.         <constructor-arg ref="queueConsumer" />  
19.         <!--  may be other method -->  
20.         <property name="defaultListenerMethod" value="receive" />  
21.         <!-- custom MessageConverter define -->  
22.         <property name="messageConverter" ref="defaultMessageConverter" />  
23.     </bean>  

<bean id="topicListenerA" class="org.springframework.jms.listener.adapter.MessageListenerAdapter">
		<constructor-arg ref="topicConsumerA" />
		<!--  may be other method -->
		<property name="defaultListenerMethod" value="receive" />
		<!-- custom MessageConverter define -->
		<property name="messageConverter" ref="defaultMessageConverter" />
	</bean>

	<bean id="topicListenerB" class="org.springframework.jms.listener.adapter.MessageListenerAdapter">
		<constructor-arg ref="topicConsumerB" />
		<!--  may be other method -->
		<property name="defaultListenerMethod" value="receive" />
		<!-- custom MessageConverter define -->
		<property name="messageConverter" ref="defaultMessageConverter" />
	</bean>

    <bean id="queueListener" class="org.springframework.jms.listener.adapter.MessageListenerAdapter">
		<constructor-arg ref="queueConsumer" />
		<!--  may be other method -->
		<property name="defaultListenerMethod" value="receive" />
		<!-- custom MessageConverter define -->
		<property name="messageConverter" ref="defaultMessageConverter" />
	</bean>

 8. MessageListenerContainer

 有几个MessageListener既有几个MessageListenerContainer

Xml代码

1. <bean id="topicListenerContainerA" class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
2.         <property name="connectionFactory" ref="jmsConnectionFactory" />  
3.         <property name="destination" ref="TOPIC" />  
4.         <property name="messageListener" ref="topicListenerA" />  
5.     </bean>  
6.   
7.     <bean id="topicListenerContainerB" class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
8.         <property name="connectionFactory" ref="jmsConnectionFactory" />  
9.         <property name="destination" ref="TOPIC" />  
10.         <property name="messageListener" ref="topicListenerB" />  
11.     </bean>  
12.        
13.     <bean id="queueListenerContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
14.         <property name="connectionFactory" ref="jmsConnectionFactory" />  
15.         <property name="destination" ref="QUEUE" />  
16.         <property name="messageListener" ref="queueListener" />  
17.     </bean>  

<bean id="topicListenerContainerA" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
		<property name="connectionFactory" ref="jmsConnectionFactory" />
		<property name="destination" ref="TOPIC" />
		<property name="messageListener" ref="topicListenerA" />
	</bean>

    <bean id="topicListenerContainerB" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
		<property name="connectionFactory" ref="jmsConnectionFactory" />
		<property name="destination" ref="TOPIC" />
		<property name="messageListener" ref="topicListenerB" />
	</bean>
    
    <bean id="queueListenerContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
		<property name="connectionFactory" ref="jmsConnectionFactory" />
		<property name="destination" ref="QUEUE" />
		<property name="messageListener" ref="queueListener" />
	</bean>

  Summary

写spring配置文件的时候, 要把MessageProducer, MessageConsumer,MessageListener,MessageListenerContainer几个地方弄清楚:

1. 可以有一个或者多个消息生产者向同一个destination发送消息.
2. queue类型的只能有一个消息消费者.
3. topic类型的可以有多个消息消费者.
4. 每个消费者对应一个MessageListener和一个MessageListenerContainer.