ActiveMQ学习教程

背景：ActiveMQ 是Apache出品，最流行的，能力强劲的开源消息总线。
选择ActiveMQ作为JMS的入门学习中间件，是因为其拥有以下优点

1.多种语言和协议编写客户端。语言: Java, C, C++, C#, Ruby, Perl, Python, PHP。应用协议: OpenWire,Stomp REST,WS Notification,XMPP,AMQP
2.完全支持JMS1.1和J2EE 1.4规范 (持久化,XA消息,事务)
3.对Spring的支持,ActiveMQ可以很容易内嵌到使用Spring的系统里面去,而且也支持Spring2.0的特性
4.完全支持JMS1.1和J2EE 1.4规范 (持久化,XA消息,事务)
5.通过了常见J2EE服务器(如 Geronimo,JBoss 4, GlassFish,WebLogic)的测试,其中通过JCA 1.5 resource adaptors的配置,可以让ActiveMQ可以自动的部署到任何兼容J2EE 1.4 商业服务器上
6.支持多种传送协议:in-VM,TCP,SSL,NIO,UDP,JGroups,JXTA
7.从设计上保证了高性能的集群,客户端-服务器,点对点
8.支持Ajax
9.支持与Axis的整合
10.可以很容易得调用内嵌JMS provider,进行测试

学会了ActiveMQ之后，其它供应商的MQ也可以在短时间内快速上手。

安装：
ActiveMQ（本文简称MQ）要求JDK1.5以上，推荐1.6以上版本。还没安装JDK的朋友，请先安装，在此不赘诉了。
安装完JDK后，从 http://activemq.apache.org/download.html下载MQ的最新版本，本教程使用版本为5.5。
解压后，可以看到MQ目录下有以下文件和目录

activemq-all-5.5.0.jar:所有MQ JAR包的集合，用于用户系统调用
bin:其中包含MQ的启动脚本
conf:包含MQ的所有配置文件
data:日志文件及持久性消息数据
example:MQ的示例
lib:MQ运行所需的所有Lib
webapps:MQ的Web控制台及一些相关的DEMO

启动MQ：
双击bin目录下的activemq.bat文件即可启动MQ


第一个示例：

新建一个JAVA工程，引用activemq-all-5.5.0.jar，SLFAPI其及对应版本LOG4J的JAR包（懒的上网找的到附件里下载）

import java.util.Hashtable;import java.util.Map;import javax.jms.Connection;import javax.jms.ConnectionFactory;import javax.jms.Destination;import javax.jms.JMSException;import javax.jms.MapMessage;import javax.jms.Message;import javax.jms.MessageProducer;import javax.jms.Session;import org.apache.activemq.ActiveMQConnectionFactory;import org.apache.activemq.command.ActiveMQMapMessage;public class Publisher {    protected int MAX_DELTA_PERCENT = 1;    protected Map<String, Double> LAST_PRICES = new Hashtable<String, Double>();    protected static int count = 10;    protected static int total;        protected static String brokerURL = "tcp://localhost:61616";    protected static transient ConnectionFactory factory;    protected transient Connection connection;    protected transient Session session;    protected transient MessageProducer producer;        public Publisher() throws JMSException {    factory = new ActiveMQConnectionFactory(brokerURL);    connection = factory.createConnection();    try {        connection.start();    } catch (JMSException jmse) {    connection.close();    throw jmse;    }        session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);        producer = session.createProducer(null);    }        public void close() throws JMSException {        if (connection != null) {            connection.close();        }    }        public static void main(String[] args) throws JMSException {        Publisher publisher = new Publisher();        while (total < 1000) {            for (int i = 0; i < count; i++) {                publisher.sendMessage(args);            }            total += count;            System.out.println("Published '" + count + "' of '" + total + "' price messages");            try {              Thread.sleep(1000);            } catch (InterruptedException x) {            }        }        publisher.close();    }    protected void sendMessage(String[] stocks) throws JMSException {        int idx = 0;        while (true) {            idx = (int)Math.round(stocks.length * Math.random());            if (idx < stocks.length) {                break;            }        }        String stock = stocks[idx];        Destination destination = session.createTopic("STOCKS." + stock);        Message message = createStockMessage(stock, session);        System.out.println("Sending: " + ((ActiveMQMapMessage)message).getContentMap() + " on destination: " + destination);        producer.send(destination, message);    }    protected Message createStockMessage(String stock, Session session) throws JMSException {        Double value = LAST_PRICES.get(stock);        if (value == null) {            value = new Double(Math.random() * 100);        }        // lets mutate the value by some percentage        double oldPrice = value.doubleValue();        value = new Double(mutatePrice(oldPrice));        LAST_PRICES.put(stock, value);        double price = value.doubleValue();        double offer = price * 1.001;        boolean up = (price > oldPrice);MapMessage message = session.createMapMessage();message.setString("stock", stock);message.setDouble("price", price);message.setDouble("offer", offer);message.setBoolean("up", up);return message;    }    protected double mutatePrice(double price) {        double percentChange = (2 * Math.random() * MAX_DELTA_PERCENT) - MAX_DELTA_PERCENT;        return price * (100 + percentChange) / 100;    }}

Consumer.java

Java代码  

import javax.jms.Connection;import javax.jms.ConnectionFactory;import javax.jms.Destination;import javax.jms.JMSException;import javax.jms.MessageConsumer;import javax.jms.Session;import org.apache.activemq.ActiveMQConnectionFactory;public class Consumer {    private static String brokerURL = "tcp://localhost:61616";    private static transient ConnectionFactory factory;    private transient Connection connection;    private transient Session session;        public Consumer() throws JMSException {    factory = new ActiveMQConnectionFactory(brokerURL);    connection = factory.createConnection();        connection.start();        session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);    }        public void close() throws JMSException {        if (connection != null) {            connection.close();        }    }            public static void main(String[] args) throws JMSException {    Consumer consumer = new Consumer();    for (String stock : args) {    Destination destination = consumer.getSession().createTopic("STOCKS." + stock);    MessageConsumer messageConsumer = consumer.getSession().createConsumer(destination);    messageConsumer.setMessageListener(new Listener());    }    }public Session getSession() {return session;}}

Listener.java

Java代码  

import java.text.DecimalFormat;import javax.jms.MapMessage;import javax.jms.Message;import javax.jms.MessageListener;public class Listener implements MessageListener {public void onMessage(Message message) {try {MapMessage map = (MapMessage)message;String stock = map.getString("stock");double price = map.getDouble("price");double offer = map.getDouble("offer");boolean up = map.getBoolean("up");DecimalFormat df = new DecimalFormat( "#,###,###,##0.00" );System.out.println(stock + "\t" + df.format(price) + "\t" + df.format(offer) + "\t" + (up?"up":"down"));} catch (Exception e) {e.printStackTrace();}}}

先运行Consumer.java, 输入参数ORCL，然后运行Publisher.java，输入参数ORCL，
就可以看到Publisher在发送消息，Consumer在接收消息了。
（不知道怎么在ECLIPSE里带参数运行程序的，请自行GOOGLE。）
好了，MQ的安装与第一个示例程序的介绍就到此为止了。

 

JMS API的主要概念如一下：

JMS client: 纯Java写的用于发送和接收消息的应用程序
Non-JMS client: 用JMS提供的本地用户API来发送和接收消息的应用程序
JMS producer: 创建和发送JMS消息的客户端
JMS consumer: 接收和处理JMS消息的客户端
JMS provider: 完全用Java写的JMS接口的实现
JMS message: JMS消息
JMS domains: 两种发送方式，包括点对点(point-to-point)和发布/订阅(publish/subscribe)
Administered objects: 预定义的包含JMS provider的配置数据，客户端一般通过JNDI调用
Connection factory: 客户端用Connection Factory创建Connection来连接JMS provider
Destination: 用于记录消息的目的地址或接收地址。

本节只列出提纲，详细说明，请查看附件。

下面对两种JMS domains进行一下说明：
1.publish/subscribe



在这种模式下，MQ服务器中的客户端可订阅自己感兴趣的TOPIC，当其它客户端向MQ服务器发送一个TOPIC且该TOPIC是自己订阅过的TOPIC，则接收该消息。上一节的例子就是用了这个模式

2.point-to-point



在这种模式下，消息是点对点发送的，一个QUEUE只会发送到一个客户端。

 

在MQ目录/conf/activemq-demo.xml中可看到如下配置

Xml代码  

1. <transportConnectors>    
2. <transportConnector name="openwire" uri="tcp://localhost:61616"    
3. discoveryUri="multicast://default"/>  
4. <transportConnector name="ssl"  uri="ssl://localhost:61617"/>    
5. <transportConnector name="stomp" uri="stomp://localhost:61613"/>    
6. <transportConnector name="xmpp"  uri="xmpp://localhost:61222"/>  
7. </transportConnectors>  

<transportConnectors> <transportConnector name="openwire" uri="tcp://localhost:61616" discoveryUri="multicast://default"/><transportConnector name="ssl"  uri="ssl://localhost:61617"/> <transportConnector name="stomp" uri="stomp://localhost:61613"/> <transportConnector name="xmpp"  uri="xmpp://localhost:61222"/></transportConnectors>

可以看到在MQ中可配置个连接，并且还可以配置多种协议的连接。
MQ中支持的网络协议有TCP、NIO、UDP、SSL、HTTP(S)、VM等。
下面对其中常用的几种进行一下说明。

TCP：
MQ默认使用的协议，开放性、高效性、可靠性是其主要特点，这个协议可满足一般应用的大部分需求，因此在项目中还是比较常用的。第一节中的例子用到的就是TCP协议。

NIO：
NIO的概念是在JAVASE1.4首先提出来的，这是一种新的JAVA IO模型，是对底层IO的一种封装，让程序员们可以更方便的对IO进行操作。
这种协议下，网络消息的传播效率非常的高。因此，当系统存在高用户量、高并发或网络堵塞时，可考虑用此协议。
配置示例如下：

Xml代码  

1. <transportConnector name="nio" uri="nio:localhost:61618" />  

<transportConnector name="nio" uri="nio:localhost:61618" />

SSL:
安全套接层协议，这种协议比较重要，因此本教程将对SSL协议连接方式作重点介绍。
在MQ目录/conf/activemq.xml文件中修改以下配置

Xml代码  

1. <sslContext>    
2.     <sslContext keyStore="file:${activemq.base}/conf/broker.ks" keyStorePassword="password"/>    
3. </sslContext>  
4. <transportConnectors>  
5.     <transportConnector name="ssl" uri="ssl://localhost:61617"/>  
6. </transportConnectors>  

<sslContext>     <sslContext keyStore="file:${activemq.base}/conf/broker.ks" keyStorePassword="password"/> </sslContext><transportConnectors>    <transportConnector name="ssl" uri="ssl://localhost:61617"/></transportConnectors>

broker.ks是MQ的默认证书，默认密码为password
启动activemq.bat
可发现MQ已经以SSL方式启动，端口为61617

将第一节中Consumer.java与Publisher.java的以下代码

Java代码  

1. protected static String brokerURL = "tcp://localhost:61616";  

protected static String brokerURL = "tcp://localhost:61616";

修改为

Java代码  

1. protected static String brokerURL = "ssl://localhost:61617";  

protected static String brokerURL = "ssl://localhost:61617";

在Consumer.java和Publisher的VM arguments 里输入
-Djavax.net.ssl.keyStore=MQ目录\conf\client.ks
-Djavax.net.ssl.keyStorePassword=password
-Djavax.net.ssl.trustStore=MQ目录\conf\client.ts
设置Consumer.java和Publisher的Program arguments为 ORCL

启动Consumer.java和Publisher，将看到和第一节示例一样的结果，只不过这里的连接协议改为了SSL。

由于本例中用到的证书是MQ自带的，正式环境中不可能用默认证书，否则SSL将形同虚设。因此，我们必须生成自己的证书，以保证其安全性。

在命令行中输入
keytool -genkey -alias broker -keyalg RSA -keystore mybroker.ks
按提示输入密码（本例子的密码为test123）和其它信息，可以看到在当前目录下生成了一个mybroker.ks文件，接着在命令行输入keytool -export -alias broker -keystore mybroker.ks -file mybroker_cert，输入刚才的密码test123，生成mybroker_cert。
接成生成客户端keystore，输入keytool -genkey -alias client -keyalg RSA -keystore myclient.ks，输入客户端密码和其它信息，生成myclient.ks，接着输入keytool -import -alias broker -keystore myclient.ts -file mybroker_cert，生成myclient.ts。
证书生成的工作就完成了。
接着把刚刚生成的证书复制到MQ目录\conf下，将activemq.xml的sslContext节点修改为

Xml代码  

1. <sslContext>    
2.     <sslContext keyStore="file:${activemq.base}/conf/mybroker.ks" keyStorePassword="test123"/>    
3. </sslContext>  

<sslContext>     <sslContext keyStore="file:${activemq.base}/conf/mybroker.ks" keyStorePassword="test123"/> </sslContext>

重启MQ，修改Consumer.java和Publisher.java和VM参数为
-Djavax.net.ssl.keyStore＝MQ目录\conf\myclient.ks
-Djavax.net.ssl.keyStorePassword=test123
-Djavax.net.ssl.trustStore=MQ目录\conf\myclient.ts
启动Consumer.java和Publisher.java
到此，我们把我们自己生成的证书用到了SSL协议上。
其它诸如HTTP(S)/UDP(不可靠性)/VM(用于虚拟机内应用程序间的通信)等协议，在实际中用的并不多，本教程就不介绍了。