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中嵌套启动）：

cd example

ant embedBroker

4、ActiveMQ消息管理后台系统：

http://localhost:8161/admin

三、运行附带的示例程序

1、Queue消息示例：

* 启动Queue消息消费者

cd example

ant consumer

* 启动Queue消息生产者

cd example

ant producer

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

2、Topic消息示例：

* 启动Topic消息消费者

cd example

ant topic-listener

* 启动Topic消息生产者

cd example

ant 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

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反馈信息并解除线程堵塞，进入下一轮。

说明：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文件：

在<context></context>节点中添加以下内容：

<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&amp;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传输方式：

failover:(tcp://localhost:61616)?initialReconnectDelay=100&amp;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端。

<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方式（索引文件方式）存储消息，据官网介绍是快速、稳定的。数据库存储方式可参照官网相关文档。
<broker xmlns="http://activemq.apache.org/schema/core" brokerName="localhost" persistent="true" useShutdownHook="false">
<persistenceAdapter>
<amqPersistenceAdapter directory="activemq-data" maxFileLength="32mb"/>
</persistenceAdapter>
</broker>

3.1 Listener端配置

<listener>
<listener-class>JMSServletListener</listener-class>
</listener>

3.2 Listener端（JMSListener.java）完整实现：

import java.io.Serializable;
import javax.jms.Connection;
import javax.jms.ConnectionFactory;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.Session;
import javax.jms.TextMessage;
import javax.jms.Topic;
import javax.jms.TopicSubscriber;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;

public class JMSServletListener implements ServletContextListener,
Serializable, MessageListener {

public JMSServletListener() {
super();
}

public void contextDestroyed(ServletContextEvent arg0) {
}

public void contextInitialized(ServletContextEvent arg0) {

try {
InitialContext initctx = new InitialContext();
Context envContext = (Context) initctx.lookup("java:comp/env");
ConnectionFactory connectionFactory = (ConnectionFactory) envContext
.lookup("jms/FailoverConnectionFactory");
Connection connection = connectionFactory.createConnection();
connection.setClientID("jerry");
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");
/*
* TopicSubscriber consumer = jmsSession.createDurableSubscriber(
* (Topic) (envContext.lookup("jms/topic/MyTopic")), "Sub");
*/
consumer.setMessageListener(this);
connection.start();
} catch (Exception e) {
e.printStackTrace();
}
}

/*private static boolean checkText(Message m, String s) {
try {
return m instanceof TextMessage
&& ((TextMessage) m).getText().equals(s);
} catch (JMSException e) {
e.printStackTrace(System.out);
return false;
}
}*/
private static String checkText(Message m, String s) {
try {
return m.getStringProperty(s);

} catch (JMSException e) {
e.printStackTrace();
return null;
}
}

public void onMessage(Message message) {

if (checkText(message, "RefreshArticleId") != null) {
String articleId = checkText(message, "RefreshArticleId");
System.out.println("接收刷新文章消息，开始刷新文章ID=" + articleId);
}
if (checkText(message, "RefreshThreadId") != null) {
String articleId = checkText(message, "RefreshThreadId");
System.out.println("接收刷新文章消息，开始刷新文章ID=" + articleId);
}

}

}

编译JMSListener.java至classes目录：

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

------------------------------------------------------------------------------------------------------

发送端servlet(web.xml配置)：

<!-- servlet start -->
<servlet>
<servlet-name>TestServlet</servlet-name>
<servlet-class>TestServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>TestServlet</servlet-name>
<url-pattern>/servlet/TestServlet</url-pattern>
</servlet-mapping>
<!-- servlet end -->

发送端servlet(代码):

import java.io.*;
import java.util.Date;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.zip.*;

import javax.jms.Connection;
import javax.jms.ConnectionFactory;
import javax.jms.DeliveryMode;
import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageProducer;
import javax.jms.Session;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class TestServlet extends HttpServlet {

public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {

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();
}

String arg1=request.getParameter("arg1");
response.setContentType("text/xml;charset=utf-8");
response.setHeader("Cache-Control", "no-cache");
Date responseTimestamp = new Date();
response.getWriter().write("<response><r><d id='a'><e id='a'>"+1+"</e></d></r>"