Apache ActiveMQ

Apache ActiveMQ教程




一、特性及優勢

1、實現JMS1.1規範，支持J2EE1.4以上
2、可運行於任何jvm和大部分web容器（ActiveMQ works great in any JVM）
3、支持多種語言客戶端（java, C, C++, AJAX, ACTIONSCRIPT等等）
4、支持多種協議（stomp，openwire，REST）
5、良好的spring支持（ActiveMQ has great Spring Support）
6、速度很快，JBossMQ的十倍（ActiveMQ is very fast; often 10x faster than JBossMQ.）
7、與OpenJMS、JbossMQ等開源jms provider相比，ActiveMQ有Apache的支持，持續發展的優勢明顯。

二、下載部署

1、下載,
http://activemq.apache.org/activemq-510-release.html，下載5.1.0 Windows Distribution版本
2、安裝, 直接解壓至任意目錄（如：d:\ apache-activemq-5.1.0）
3、啓動ActiveMQ服務器
方法1：
直接運行bin\activemq.bat
方法2（在JVM中嵌套啓動）：



12
cd example ant embedBroker

4、ActiveMQ消息管理後臺系統：http://localhost:8161/admin

三、運行附帶的示例程序

1、Queue消息示例：
* 啓動Queue消息消費者



12
cd exampleant consumer

* 啓動Queue消息生產者



12
cd exampleant producer

簡要說明：生產者（producer）發消息，消費者（consumer）接消息，發送/接收2000個消息後自動關閉

2、Topic消息示例：
* 啓動Topic消息消費者



12
cd exampleant topic-listener

* 啓動Topic消息生產者



12
cd exampleant topic-publisher

簡要說明：重複10輪，publisher每輪發送2000個消息，並等待獲取listener的處理結果報告，然後進入下一輪發送，最後統計全局發送時間。

四、Queue與Topic的比較

1、JMS Queue執行load balancer語義：
一條消息僅能被一個consumer收到。如果在message發送的時候沒有可用的consumer，那麼它將被保存一直到能處理該message的consumer可用。如果一個consumer收到一條message後卻不響應它，那麼這條消息將被轉到另一個consumer那兒。一個Queue可以有很多consumer，並且在多個可用的consumer中負載均衡。

2、Topic實現publish和subscribe語義：
一條消息被publish時，它將發到所有感興趣的訂閱者，所以零到多個subscriber將接收到消息的一個拷貝。但是在消息代理接收到消息時，只有激活訂閱的subscriber能夠獲得消息的一個拷貝。

3、分別對應兩種消息模式：
Point-to-Point (點對點),Publisher/Subscriber Model (發佈/訂閱者)
其中在Publicher/Subscriber 模式下又有Nondurable subscription（非持久訂閱）和durable subscription (持久化訂閱)2種消息處理方式。

五、Point-to-Point (點對點)消息模式開發流程

1、生產者（producer）開發流程（ProducerTool.java）：
1.1 創建Connection：根據url，user和password創建一個jms Connection。
1.2 創建Session：在connection的基礎上創建一個session，同時設置是否支持事務和ACKNOWLEDGE標識。
1.3 創建Destination對象：需指定其對應的主題（subject）名稱，producer和consumer將根據subject來發送/接收對應的消息。
1.4 創建MessageProducer：根據Destination創建MessageProducer對象，同時設置其持久模式。
1.5 發送消息到隊列（Queue）：封裝TextMessage消息，使用MessageProducer的send方法將消息發送出去。

2、消費者（consumer）開發流程（ConsumerTool.java）：
2.1 實現MessageListener接口：消費者類必須實現MessageListener接口，然後在onMessage()方法中監聽消息的到達並處理。
2.2 創建Connection：根據url，user和password創建一個jms Connection，如果是durable模式，還需要給connection設置一個clientId。
2.3 創建Session和Destination：與ProducerTool.java中的流程類似，不再贅述。
2.4創建replyProducer【可選】：可以用來將消息處理結果發送給producer。
2.5 創建MessageConsumer：根據Destination創建MessageConsumer對象。
2.6 消費message：在onMessage()方法中接收producer發送過來的消息進行處理，並可以通過replyProducer反饋信息給producer



1234
if (message.getJMSReplyTo() != null) { replyProducer.send(message.getJMSReplyTo(), session.createTextMessage("Reply: " + message.getJMSMessageID()));}

六、Publisher/Subscriber(發佈/訂閱者)消息模式開發流程

1、訂閱者（Subscriber）開發流程（TopicListener.java）：
1.1 實現MessageListener接口：在onMessage()方法中監聽發佈者發出的消息隊列，並做相應處理。
1.2 創建Connection：根據url，user和password創建一個jms Connection。
1.3 創建Session：在connection的基礎上創建一個session，同時設置是否支持事務和ACKNOWLEDGE標識。
1.4 創建Topic：創建2個Topic， topictest.messages用於接收發布者發出的消息，topictest.control用於向發佈者發送消息，實現雙方的交互。
1.5 創建consumer和producer對象：根據topictest.messages創建consumer，根據topictest.control創建producer。
1.6 接收處理消息：在onMessage()方法中，對收到的消息進行處理，可直接簡單在本地顯示消息，或者根據消息內容不同處理對應的業務邏輯（比如：數據庫更新、文件操作等等），並且可以使用producer對象將處理結果返回給發佈者。

2、發佈者（Publisher）開發流程（TopicPublisher.java）：
2.1 實現MessageListener接口：在onMessage()方法中接收訂閱者的反饋消息。
2.2 創建Connection：根據url，user和password創建一個jms Connection。
2.3 創建Session：在connection的基礎上創建一個session，同時設置是否支持事務和ACKNOWLEDGE標識。
2.4 創建Topic：創建2個Topic，topictest.messages用於向訂閱者發佈消息，topictest.control用於接收訂閱者反饋的消息。這2個topic與訂閱者開發流程中的topic是一一對應的。
2.5 創建consumer和producer對象：根據topictest.messages創建publisher；根據topictest.control創建consumer，同時監聽訂閱者反饋的消息。
2.6 給所有訂閱者發送消息，並接收反饋消息：示例代碼中，一共重複10輪操作。每輪先向所有訂閱者發送2000個消息；
然後堵塞線程，開始等待；最後通過onMessage()方法，接收到訂閱者反饋的“REPORT”類信息後，才print反饋信息並解除線程堵塞，進入下一輪。
注：可同時運行多個訂閱者測試查看此模式效果

七、ActiveMQ與Tomcat整合

說明：Tomcat示例版本6.0.14，其它版本在配置上可能有一些差異

1、準備jar包：將ActiveMQ lib目錄下的5個jar包複製到Tomcat lib目錄下：

activemq-core-5.1.0.jar
activemq-web-5.1.0.jar
geronimo-j2ee-management_1.0_spec-1.0.jar
geronimo-jms_1.1_spec-1.1.1.jar
geronimo-jta_1.0.1B_spec-1.0.1.jar

2、修改配置文件：
2.1 修改Tomcat的conf/context.xml文件：
在節點中添加以下內容：



1234567891011121314151617181920212223242526272829303132
<Resource name="jms/FailoverConnectionFactory" auth="Container" type="org.apache.activemq.ActiveMQConnectionFactory" description="JMS Connection Factory" factory="org.apache.activemq.jndi.JNDIReferenceFactory" brokerURL="failover:(tcp://localhost:61616)?initialReconnectDelay=100&maxReconnectAttempts=5" brokerName="localhost" useEmbeddedBroker="false"/> <Resource name="jms/NormalConnectionFactory" auth="Container" type="org.apache.activemq.ActiveMQConnectionFactory" description="JMS Connection Factory" factory="org.apache.activemq.jndi.JNDIReferenceFactory" brokerURL="tcp://localhost:61616" brokerName="localhost" useEmbeddedBroker="false"/> <Resource name="jms/topic/MyTopic" auth="Container" type="org.apache.activemq.command.ActiveMQTopic" factory="org.apache.activemq.jndi.JNDIReferenceFactory" physicalName="MY.TEST.FOO"/> <Resource name="jms/queue/MyQueue" auth="Container" type="org.apache.activemq.command.ActiveMQQueue" factory="org.apache.activemq.jndi.JNDIReferenceFactory" physicalName="MY.TEST.FOO.QUEUE"/> 配置說明：以JNDI的方式定義了ActiveMQ的broker連接url、Topic和Queue。

此處需加以注意的是Listener端的borkerURL使用了failover傳輸方式：



1
failover:(tcp://localhost:61616)?initialReconnectDelay=100&maxReconnectAttempts=5

客戶端使用普通傳輸方式：tcp://localhost:61616

failover transport是一種重新連接機制，用於建立可靠的傳輸。此處配置的是一旦ActiveMQ broker中斷，Listener端將每隔100ms自動嘗試連接，直至成功連接或重試5次連接失敗爲止。

failover還支持多個borker同時提供服務，實現負載均衡的同時可增加系統容錯性，格式：
failover:(uri1,…,uriN)?transportOptions

2.2 新建web應用(webapps/jms-test)，修改WEB-INF/web.xml文件：
增加一個自啓動Servlet，該Servlet實現了MessageListener接口，作爲Topic消息的Listener端。



1234567
<servlet> <servlet-name>jms-listener</servlet-name> <servlet-class> com.flvcd.servlet.JMSListener </servlet-class> <load-on-startup>1</load-on-startup></servlet>

2.3 修改activemq.xml文件：
爲了支持持久化消息，需修改ActiveMQ的配置文件如下，使用默認的AMQ Message Store方式（索引文件方式）存儲消息，據官網介紹是快速、穩定的。數據庫存儲方式可參照官網相關文檔。



123
<broker xmlns="http://activemq.apache.org/schema/core" brokerName="localhost" persistent="true" useShutdownHook="false"><persistenceAdapter><amqPersistenceAdapter class="MsoNormal">


123456789101112131415161718192021222324252627282930313233343536373839
connection.setClientID("MyClient"); Session jmsSession = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); //普通消息訂閱者，無法接收持久消息 //MessageConsumer consumer = jmsSession.createConsumer((Destination) envContext.lookup("jms/topic/MyTopic")); //基於Topic創建持久的消息訂閱者，前提：Connection必須指定一個唯一的clientId，當前爲MyClient TopicSubscriber consumer = jmsSession.createDurableSubscriber((Topic) envContext.lookup("jms/topic/MyTopic"), "MySub"); consumer.setMessageListener(this); connection.start(); } catch (NamingException e) { e.printStackTrace(); } catch (JMSException e) { e.printStackTrace(); } } /** 接收消息，做對應處理 */ public void onMessage(Message message) { if (checkText(message, "RefreshArticleId") != null) { String articleId = checkText(message, "RefreshArticleId"); System.out.println("接收刷新文章消息，開始刷新文章ID=" + articleId); } else if (checkText(message, "RefreshThreadId") != null) { String threadId = checkText(message, "RefreshThreadId"); System.out.println("接收刷新論壇帖子消息，開始刷新帖子ID=" + threadId); } else { System.out.println("接收普通消息，不做任何處理！"); } } private static String checkText(Message m, String s) { try { return m.getStringProperty(s); } catch (JMSException e) { e.printStackTrace(System.out); return null; } }}

編譯JMSListener.java至classes目錄：



1
javac -cp .;D:\apache-tomcat-6.0.14\lib\servlet-api.jar;D:\apache-tomcat-6.0.14\lib\geronimo-jms_1.1_spec-1.1.1.jar;D:\apache-tomcat-6.0.14\lib\activemq-core-5.1.0.jar -d . JMSListener.java

注：D:\apache-tomcat-6.0.14請替換成本地對應目錄。

4、Publisher端（publish.jsp）實現：
在jms-test目錄下新建publish.jsp文件：



123456789101112131415161718192021222324252627
<%@ page language="java" import="javax.jms.*" pageEncoding="GBK"%><%@ page language="java" import="javax.naming.*"%><%@ page language="java" import="org.apache.activemq.ActiveMQConnectionFactory"%> <% try { InitialContext initCtx = new InitialContext(); Context envContext = (Context) initCtx.lookup("java:comp/env"); ConnectionFactory connectionFactory = (ConnectionFactory) envContext.lookup("jms/NormalConnectionFactory"); Connection connection = connectionFactory.createConnection(); Session jmsSession = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); MessageProducer producer = jmsSession.createProducer((Destination) envContext.lookup("jms/topic/MyTopic")); //設置持久方式 producer.setDeliveryMode(DeliveryMode.PERSISTENT); Message testMessage = jmsSession.createMessage(); //發佈刷新文章消息 testMessage.setStringProperty("RefreshArticleId", "2046"); producer.send(testMessage); //發佈刷新帖子消息 testMessage.clearProperties(); testMessage.setStringProperty("RefreshThreadId", "331"); producer.send(testMessage); } catch (NamingException e) { e.printStackTrace(); } catch (JMSException e) { e.printStackTrace(); }%>

Publisher和Listner之間通過Message的setStringProperty和getStringProperty方法，實現對應的業務邏輯。
上述示例代碼中，RefreshArticleId代表刷新某篇文章，RefreshThreadId代表刷新某個帖子，property值保持對應的ID。當然用戶可根據實際需求靈活地使用。

5、運行Demo：
5.1 啓動ActiveMQ服務器
5.2 啓動Tomcat服務器：JMSListener將自動連接ActiveMQ broker，日誌信息:
Successfully connected to tcp://localhost:61616
5.3 訪問http://localhost:8080/jms-test/publish.jsp
Tomcat服務器日誌將提示：
接收刷新文章消息，開始刷新文章ID=2046
接收刷新論壇帖子消息，開始刷新帖子ID=331
5.4 訪問http://localhost:8161/admin/topics.jsp查看MY.TEST.FOO的消息日誌，分別發送和接收2條。
至此，已成功完成ActiveMQ與Tomcat的基本整合！
Publisher和Listener完全可以獨立部署到不同的Web服務器上，並通過ActiveMQ來進行消息傳遞，實現用戶所需的業務邏輯。
測試持久消息的具體步驟：
l 啓動Publisher所在Web服務器
l 啓動ActiveMQ
l 訪問publish.jsp發送消息，此時Listener還未啓動，消息將保存在ActiveMQ的bin\activemq-data目錄下，查看日誌可以看到發送2條，接收0條
l 啓動Listener所在Web服務器，將自動接收到ActiveMQ的持久消息並處理，查看日誌：發送2條，接收2條，表明持久消息應用成功

http://www.cnblogs.com/shuyangdehou/archive/2010/10/07/1845239.html

activeMQ相關：

http://baike.baidu.com/view/157103.htm jms百度百科
http://www.189works.com/article-57444-1.html ActiveMQ消息收發簡單例子
http://liyebing.iteye.com/blog/1044825 jms實現簡單的聊天
http://jinguo.iteye.com/blog/234311 一個生產者消費者實例
http://blog.csdn.net/linkyou/article/details/4101152 activema文檔
http://i-coding.iteye.com/blog/1018920 activemq實現QQ聊天
http://www.cnblogs.com/shuyangdehou/archive/2010/10/07/1845239.html activeMq教程
http://www.cnblogs.com/opaljc/archive/2012/03/25/2416545.html activeMQ使用
http://www.cnblogs.com/sjzzqy/archive/2012/05/29/activemq.html 例子

通訊

http://download.csdn.net/download/gaojie8273150/2290220
http://download.csdn.net/detail/gaoweipeng/1635506
http://download.csdn.net/download/qqq626/3081379