Apache ActiveMQ教程

1、特性及优点

一、实现JMS1.1规范，支持J2EE1.4以上
二、可运行于任何jvm和大部分web容器（ActiveMQ works great in any JVM）
三、支持多种语言客户端（java, C, C++, AJAX, ACTIONSCRIPT等等）
四、支持多种协议（stomp，openwire，REST）
五、良好的spring支持（ActiveMQ has great Spring Support）
六、速度很快，JBossMQ的十倍（ActiveMQ is very fast; often 10x faster than JBossMQ.）
七、与OpenJMS、JbossMQ等开源jms provider相比，ActiveMQ有Apache的支持，持续发展的优点明显。

2、下载部署

一、下载,

http://activemq.apache.org/activemq-510-release.html，下载5.1.0 Windows Distribution版本

二、安装, 直接解压至任意目录（如：d:\ apache-activemq-5.1.0）
三、启动ActiveMQ服务器
方法1：
直接运行bin\activemq.bat
方法2（在JVM中嵌套启动）：

1 2	cd example ant embedBroker

四、ActiveMQ消息管理后台系统：http://localhost:8161/admin

3、运行附带的示例程序

一、Queue消息示例：
* 启动Queue消息消费者

1 2	cd example ant consumer

* 启动Queue消息生产者

1 2	cd example ant producer

简要说明：生产者（producer）发消息，消费者（consumer）接消息，发送/接收2000个消息后自动关闭

二、Topic消息示例：
* 启动Topic消息消费者

1 2	cd example ant topic-listener

* 启动Topic消息生产者

1 2	cd example ant topic-publisher

简要说明：重复10轮，publisher每轮发送2000个消息，并等待获取listener的处理结果报告，而后进入下一轮发送，最后统计全局发送时间。

4、Queue与Topic的比较

一、JMS Queue执行load balancer语义：
一条消息仅能被一个consumer收到。若是在message发送的时候没有可用的consumer，那么它将被保存一直到能处理该message的consumer可用。若是一个consumer收到一条message后却不响应它，那么这条消息将被转到另外一个consumer那儿。一个Queue能够有不少consumer，而且在多个可用的consumer中负载均衡。

二、Topic实现publish和subscribe语义：
一条消息被publish时，它将发到全部感兴趣的订阅者，因此零到多个subscriber将接收到消息的一个拷贝。可是在消息代理接收到消息时，只有激活订阅的subscriber可以得到消息的一个拷贝。

三、分别对应两种消息模式：
Point-to-Point (点对点),Publisher/Subscriber Model (发布/订阅者)
其中在Publicher/Subscriber 模式下又有Nondurable subscription（非持久订阅）和durable subscription (持久化订阅)2种消息处理方式。

5、Point-to-Point (点对点)消息模式开发流程

一、生产者（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方法将消息发送出去。

二、消费者（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

1 2 3 4

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

6、Publisher/Subscriber(发布/订阅者)消息模式开发流程

一、订阅者（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对象将处理结果返回给发布者。

二、发布者（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反馈信息并解除线程堵塞，进入下一轮。
注：可同时运行多个订阅者测试查看此模式效果

7、ActiveMQ与Tomcat整合

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

一、准备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.1 修改Tomcat的conf/context.xml文件：
在节点中添加如下内容：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

<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端。

1 2 3 4 5 6 7

<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方式（索引文件方式）存储消息，据官网介绍是快速、稳定的。数据库存储方式可参照官网相关文档。

1 2 3

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39

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请替换成本地对应目录。

四、Publisher端（publish.jsp）实现：
在jms-test目录下新建publish.jsp文件：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

<%@ 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。固然用户可根据实际需求灵活地使用。

五、运行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