ActiveMQ入门
作者:一路向北
   摘要:本文主要讲述ActiveMQ的基本知识和使用方法,并简单结合spring使用ActiveMQ。
一、ActiveMQ特性和使用总览
   企业消息软件从80年代起就存在,它不只是一种应用间消息传递风格,也是一种集成风格。因此,消息传递可以满足应用间的通知和互相操作。但是开源的解决方案是到最近10年才出现的。Apache ActiveMQ就是其中一种。它使应用间能以异步,松耦合方式交流。本章将向您介绍ActiveMQ。
   ActiveMQ是Apache软件基金下的一个开源软件,它遵循JMS1.1规范(Java Message Service),是消息驱动中间件软件(MOM)。它为企业消息传递提供高可用,出色性能,可扩展,稳定和安全保障。ActiveMQ使用Apache许可协议。因此,任何人都可以使用和修改它而不必反馈任何改变。这对于商业上将ActiveMQ用在重要用途的人尤为关键。MOM的工作是在分布式的各应用之间调度事件和消息,使之到达指定的接收者。所以高可用,高性能,高可扩展性尤为关键。
   ActiveMQ的目标是在尽可能多的平台和语言上提供一个标准的,消息驱动的应用集成。ActiveMQ实现JMS规范并在此之上提供大量额外的特性。
   下面是一个高层次的特性列表。
   ·遵循JMS规范 ----理解ActiveMQ的起始点是明白ActiveMQ的各种特性是JMS1.1规范的实现。本章后面将讨论JMS规范提供的好处和保证。它们包括同步和异步消息传递,一次和只有一次的消息传递,对于预订者的持久消息等等。依附于JMS规范意味着,不论JMS消息提供者是谁,同样的基本特性都是有效的。
   ·连接----ActiveMQ提供各种连接选择,包括HTTP,HTTPS,IP多点传送,SSL,STOMP,TCP,UDP,XMPP等。大量的连接协议支持使之具有更好的灵活性。很多现有的系统使用一种特定协议并且不能改变,所以一个支持多种协议的消息平台降低了使用的门槛。虽然连接很重要,但是和其他容器集成也同样重要。第四章将讲解ActiveMQ的传输连接器(transport connectors)和网络连接器(network connectors)。
   ·可插拔的持久性和安全----ActiveMQ提供多种持久性方案可供选择,也可以完全按自己需求定制验证和授权。例如,ActiveMQ通过KahaDB提供自己的超快速消息持久方案(ultra-fast message persistence),但也支持标准的JDBC方案。ActiveMQ可以通过配置文件提供简单的验证和授权,也提供标准的JAAS登陆模块。
   ·用Java建立消息驱动应用----ActiveMQ最常用在Java应用中,用于发送和接收消息。这部分的内容涉及JMS规范API。
   ·与应用服务器集成----ActiveMQ与java应用服务器集成是很常见的。
   ·客户端APIs----ActiveMQ对多种语言提供客户端API,除了Java之外还有C/C++,.NET,Perl,PHP,Python,Ruby等。这使得ActiveMQ能用在Java之外的其它语言中。很多其它语言都可以通过ActiveMQ提供的客户端API使用ActiveMQ的全部特性。当然,ActiveMQ代理器(broker)仍然是运行在java虚拟机上,但是客户端能够使用其它的被支持的语言。
   ·代理器集群(Broker clustering)----为了利于扩展,多个ActiveMQ broker能够联合工作。这个方式就是network of brokers并且能支持多种拓扑结构。
   ·高级代理器特性和客户端选项----ActiveMQ为代理器和客户端连接提供很多高级的特性。ActiveMQ也可以通过代理器的XML配置文件支持Apache Camel。
   ·简单的管理----ActiveMQ是为开发者设计的。它并不需要专门的管理工具,因为它提供各种易用且强大的管理特性。有很多方法去监控ActiveMQ的各个方面,可以通过JMX使用JConsole或ActiveMQ web console;可以运行ActiveMQ消息报告;可以用命令行脚本;可以通过日志。
   用 ActiveMQ 最好还是了解下 JMS
   JMS 公共	   点对点域	   发布/订阅域
  ConnectionFactory	  QueueConnectionFactory	  TopicConnectionFactory
  Connection	  QueueConnection	  TopicConnection
  Destination	  Queue	  Topic
  Session	  QueueSession	  TopicSession
  MessageProducer	  QueueSender	  TopicPublisher
  MessageConsumer	  QueueReceiver	  TopicSubscriber
   JMS 定义了两种方式:Quere(点对点);Topic(发布/订阅)。
   ·ConnectionFactory 是连接工厂,负责创建Connection。
   ·Connection 负责创建 Session。
   ·Session 创建 MessageProducer(用来发消息) 和 MessageConsumer(用来接收消息)。
   ·Destination 是消息的目的地。
   详细的可以网上找些 JMS 规范(有中文版)
二、开始使用ActiveMQ
   开始使用ActiveMQ并不难。你只要启动代理器并确保它能接受连接和发送消息。ActiveMQ有一些自带的例子。
   在这部分,你将下载和安装Java SE,下载和安装ActiveMQ,检查ActiveMQ目录,然后第一次启动ActiveMQ。所需工具包括JDK1.5+、Ant、ActiveMQ。
1、JDK下载和安装
   ActiveMQ 要求Sun Java SE 1.5或以上。在开始这部分前,必须先安装。JDK的下载和安装就不是本文介绍重点。
2、Ant下载和安装
   Ant可以用来构建和运行ActiveMQ自带例子。Ant可以从Apache Ant网址下载。URL: http://ant.apache.org/bindownload.cgi
   点击链接地址并选择正确的压缩包。(tar包是Linux和Unix,zip是Windows)。请按照下列地址安装Ant。URL: http://ant.apache.org/manual/install.html。确保你设置好$ANT_HOME环境变量,并将$ANT_HOME/bin放到$PATH环境变量里。安装完毕后你可以运行下面的命令查看Ant版本。
   
   你的可能跟我的不太一样,使用Ant的不同版本,不过这没关系。一旦Ant输出如上信息,你就可以确定Ant都安装正确。
3、ActiveMQ下载和安装
   ActiveMQ可以从Apache ActiveMQ网站下,URL: http://activemq.apache.org/download.html.
   点击地址到5.4.3版本,你可以看到tar和zip格式包。(tar包是Linux和Unix,zip是Windows)。下载完后解压。我的解压到了E:\tools\apache-activemq-5.4.3
   从命令行进入apache-activemq-5.4.3目录,输入如下命令。
   
   LICENSE----Apache Software Foundation(ASF)要求的一个文件.包含ActiveMQ使用的所有库的许可证.
   NOTICE----ASF要求的另一个文件.包含ActiveMQ使用的所有库的版权信息.
   README.txt 一个包含一些URL的文档,使新手可以使用ActiveMQ.
   WebConsole-README.txt----包含使用ActiveMQ web console使用说明.
   activemq-all-5.4.3.jar---一个jar包包含ActiveMQ所有东西。放在这里是方便你使用它。
   bin----包含二进制或可运行文件。ActiveMQ启动脚本就放在里面。
   conf--ActiveMQ所有的配置信息。
   data--日志和持久化文件存储地方。
   docs--包含一个简单的index.html,该文件指向ActiveMQ网站。
   example----ActiveMQ例子。我们用这些例子来简单的测试ActiveMQ。
   lib----所有ActiveMQ所需库。
   user-guide.html----一个简单指引启动ActiveMQ和运行例子。
   webapps----ActiveMQ web console和一些网络演示。
   下一部分将启动ActiveMQ并用这些例子验证它。
   启动ActiveMQ
   在命令行中输入一下命令,或者直接运行bin目录下的activemq.bat文件
   
   刚才的命令启动了ActiveMQ代理器和一些连接器,使得客户端可以通过一些诸如TCP,SSL,STOMP,XMPP协议连接进来。请注意现在ActiveMQ已经启动,并且客户端可以通过TCP 61616端口连接进来。最好的方法是使用ActiveMQ自带的例子来发送和接收消息。下面我们来运行第一个例子。
4、运行ActiveMQ第一个例子
   这个例子是模拟生产者消费者的例子,生产者产生2000条信息,然后关闭,消费者消费2000信息,然后关闭。下面我们演示一下。
   重新打开一个DOS窗口,切到MQ目录的example目录下,我的是E:\tools\apache-activemq-5.4.3\example
   然后输入一下命令
   
   最后一行显示程序在等待2000个message。这是一个消费者。再重新打开DOS窗口并且到MQ目录下的example目录,输入一下命令ant producer,这个是生产者。输入命令之后你回看到刚才打开的两个DOS窗口打印出一堆东西
   
   看到BUILD SUCCESSFUL说明程序运行成功。
   消费者窗口变成了如下内容:
   
   示例程序演示完毕,观看别人写的看着没啥意思,我们自己写一个程序,测试一下。
三、运行自己编写的第一个例子
   我们自己编写一个跟上面类似的例子。
1、建立web项目
   打开myeclipse,新建web项目,内容填下如下:
   
   点击finish。接着在项目根目录下新建一个lib目录,然后将我们上面提及的activemq-all-5.4.3.jar拷贝至lib目录下,并将其加入项目library中如下图:
   
   点击OK,项目目前的文件夹结构如下:
   
2、编写代码
   在src上右键选择新建class,具体如下:
   
   点击finish。然后输入如下代码
  package com.mq;
  
  import java.util.Date;
  
  import javax.jms.Connection;
  import javax.jms.ConnectionFactory;
  import javax.jms.Destination;
  import javax.jms.JMSException;
  import javax.jms.MapMessage;
  import javax.jms.MessageProducer;
  import javax.jms.Session;
  
  import org.apache.activemq.ActiveMQConnection;
  import org.apache.activemq.ActiveMQConnectionFactory;
  
  public class Producer {
  	public static void main(String[] args) {
  	    String user = ActiveMQConnection.DEFAULT_USER;
  	    String password = ActiveMQConnection.DEFAULT_PASSWORD;
  	    String url = ActiveMQConnection.DEFAULT_BROKER_URL;
  	    String subject = "TOOL.DEFAULT";
  		ConnectionFactory contectionFactory = new ActiveMQConnectionFactory(user,password,url);
  		try {
  			Connection connection = contectionFactory.createConnection();
  			connection.start();
  			Session session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
  			Destination destination = session.createQueue(subject);
  			MessageProducer producer = session.createProducer(destination);
  			for(int i = 0;i<=20;i++){
  				MapMessage message = session.createMapMessage();
  				message.setLong("count", new Date().getTime());
  				Thread.sleep(1000);
  				producer.send(message);
  				System.out.println("--发送消息:"+new Date());
  			}
  			session.commit();
  			session.close();
  			connection.close();
  		} catch (JMSException e) {
  			e.printStackTrace();
  		} catch (InterruptedException e) {
  			e.printStackTrace();
  		}
  	}
  
  }
   
   然后再新建一个消费者类如下图:
   
   点击finish。然后输入如下代码
  package com.mq;
  
  import java.util.Date;
  
  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.MessageConsumer;
  import javax.jms.MessageListener;
  import javax.jms.Session;
  
  import org.apache.activemq.ActiveMQConnection;
  import org.apache.activemq.ActiveMQConnectionFactory;
  
  public class Consumer {
  
  	public static void main(String[] args) {
  		String user = ActiveMQConnection.DEFAULT_USER;
  	    String password = ActiveMQConnection.DEFAULT_PASSWORD;
  	    String url = ActiveMQConnection.DEFAULT_BROKER_URL;
  	    String subject = "TOOL.DEFAULT";
  		ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(user,password,url);
  		Connection connection;
  		try {
  			connection = connectionFactory.createConnection();
  			connection.start();
  			final Session session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
  			Destination destination = session.createQueue(subject);
  			MessageConsumer message = session.createConsumer(destination);
  			message.setMessageListener(new MessageListener(){
  
  				public void onMessage(Message msg) {
  					MapMessage message = (MapMessage)msg;
  					try {
  						System.out.println("--收到消息:"+new Date(message.getLong("count")));
  						session.commit();
  					} catch (JMSException e) {
  						e.printStackTrace();
  					}
  				}
  			});
  			Thread.sleep(30000);
  			session.close();
  			connection.close();
  		} catch (JMSException e) {
  			e.printStackTrace();
  		} catch (InterruptedException e) {
  			e.printStackTrace();
  		}
  	}
  
  }
3、运行程序
   右键运行程序Consumer类,控制台打印出如下信息:
   
   再右键运行Producer类,控制台上打印出来的信息同上。稍等一秒,Producer类的运行控制台会打印出来如下信息:
   
   有信息可知,生产者正在生成消息,切到消费者类的控制台方法如下:
   
   选择Cosumer,会看到如下信息:
   
   由信息可以看到,消费者收到了同等数量的信息。
   至此我们的第一个程序成功完成。下面将MQ与spring结合使用。
四、spring与activeMQ的简单整合
   在做上面的测试例子的时候我们可以看出发送一个简单的消息,要几行代码!其实我们的目的就是发送和接受消息。幸运的是Spring为我们提供了大量的模板。spring为我们提供了JMSTemplate模板。
1、引入spring相关文件和配置
   我使用的是spring版本是3.1.0.M2,其他版本的也可以,只是配置不同,去spring官网下载zip包,解开后将dist目录下的所有jar包(根据自己选择)拷贝到项目lib目录下并加入项目library中,具体可以参考上面步骤。
在src目录下新建applicationContext.xml文件并输入一下内容:
<?xml version="1.0" encoding="GBK"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:aop="http://www.springframework.org/schema/aop"
	xmlns:tx="http://www.springframework.org/schema/tx"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation=" 
          http://www.springframework.org/schema/beans 
          http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
          http://www.springframework.org/schema/tx 
          http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
          http://www.springframework.org/schema/context 
          http://www.springframework.org/schema/context/spring-context-3.0.xsd 
          http://www.springframework.org/schema/aop 
          http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"
	default-autowire="byName">
</beans>
打开web.xml并将其内容修改为以下内容:
<?xml version="1.0" encoding="GBK"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
	http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>classpath*:applicationContext*.xml</param-value>
	</context-param>
	<servlet>
		<servlet-name>spring</servlet-name>
		<servlet-class>
			org.springframework.web.servlet.DispatcherServlet
		</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>spring</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>
	<welcome-file-list>
		<welcome-file>index.jsp</welcome-file>
	</welcome-file-list>
</web-app>
2、配置JMSTemplate模板
   类似于jdbcTemplate,首先要配置一个ConnectionFactory,之后要开始配置JmsTemplate模板了。最后是配置消息目标了。消息分为队列和主题两大类。在applicationContext.xml中加入如下内容:
<!-- 配置Jms模板  -->
	<bean id="jmsTemplate"
		class="org.springframework.jms.core.JmsTemplate">
		<property name="connectionFactory" ref="connectionFactory" />
		<property name="defaultDestination" ref="destination" />
		<property name="receiveTimeout" value="10000" />
	</bean>
	<!-- 配置JMS连接工厂 -->
	<bean id="connectionFactory"
		class="org.apache.activemq.ActiveMQConnectionFactory">
		<property name="brokerURL" value="tcp://localhost:61616" />
	</bean>
	<!-- 发送消息的目的地(队列) -->
	<bean id="destination"
		class="org.apache.activemq.command.ActiveMQQueue">
		<!-- 设置消息队列的名字 -->
		<constructor-arg index="0" value="myQueue" />
	</bean>
配置完成了,那么如何使用JmsTemplate发送消息呢?
   spring的beanfactory得到一个jmsTemplate的实例和消息目标的实例,发送消息,够简单的吧。下面我们就来编写具体代码。
3、编写代码
新建类ProducerService.java,界面如下:

代码如下:
package com.mq.service;

public interface ProducerService {
	public void send();
}
新建一个生产者实现类ProducerServiceImpl.java,界面略,代码如下:
package com.mq.service;

import java.util.Date;

import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.MapMessage;
import javax.jms.Message;
import javax.jms.Session;

import org.springframework.jms.core.JmsTemplate;
import org.springframework.jms.core.MessageCreator;

public class ProducerServiceImpl implements ProducerService {
	JmsTemplate jmsTemplate;
	 
	Destination destination;
	public void send() {
		MessageCreator messageCreator = new MessageCreator(){

			public Message createMessage(Session session) throws JMSException {
				MapMessage message = session.createMapMessage();
				message.setLong("count", new Date().getTime());
				System.out.println("--发送消息:"+new Date());
				return message;
			}
		};
		jmsTemplate.send(this.destination,messageCreator);
	}
	public void setJmsTemplate(JmsTemplate jmsTemplate) {
		this.jmsTemplate = jmsTemplate;
	}
	public void setDestination(Destination destination) {
		this.destination = destination;
	}
}
   生产者编写完了,下面我们来编写消费者,上面说了,发送消息的时候,spring的beanfactory得到一个jmsTemplate的实例和消息目标的实例,然后发送,那么接受的时候肯定也是得到一个jmsTemplate的实例和消息目标的实例,然后接受,下面我们来看具体代码。
   新建一个消费者的借口和实现类,具体代码如下:
  ConsumerService.java
package com.mq.service;

public interface ConsumerService {
	public void receive();
}
   ConsumerServiceImpl.java
package com.mq.service;

import java.util.Date;

import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.MapMessage;

import org.springframework.jms.core.JmsTemplate;

public class ConsumerServiceImpl implements ConsumerService {

	JmsTemplate jmsTemplate;

	Destination destination;

	public void receive() {
		MapMessage message = (MapMessage)jmsTemplate.receive();
		try {
			System.out.println("--收到消息:"+new Date(message.getLong("count")));
		} catch (JMSException e) {
			e.printStackTrace();
		}
	}

	public void setJmsTemplate(JmsTemplate jmsTemplate) {
		this.jmsTemplate = jmsTemplate;
	}

	public void setDestination(Destination destination) {
		this.destination = destination;
	}

}

   代码编写完毕,下面要进行bean的配置,在applicationContext.xml中加入如下代码:
<bean id="producerService"
		class="com.mq.service.ProducerServiceImpl">
		<property name="jmsTemplate" ref="jmsTemplate" />
		<property name="destination" ref="destination" />
	</bean>

	<bean id="consumerService"
		class="com.mq.service.ConsumerServiceImpl">
		<property name="jmsTemplate" ref="jmsTemplate" />
		<property name="destination" ref="destination" />
	</bean>
附上完整的applicationContext.xml的内容:
<?xml version="1.0" encoding="GBK"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:aop="http://www.springframework.org/schema/aop"
	xmlns:tx="http://www.springframework.org/schema/tx"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation=" 
          http://www.springframework.org/schema/beans 
          http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
          http://www.springframework.org/schema/tx 
          http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
          http://www.springframework.org/schema/context 
          http://www.springframework.org/schema/context/spring-context-3.0.xsd 
          http://www.springframework.org/schema/aop 
          http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"
	default-autowire="byName">
	<bean id="producerService"
		class="com.mq.service.ProducerServiceImpl">
		<property name="jmsTemplate" ref="jmsTemplate" />
		<property name="destination" ref="destination" />
	</bean>

	<bean id="consumerService"
		class="com.mq.service.ConsumerServiceImpl">
		<property name="jmsTemplate" ref="jmsTemplate" />
		<property name="destination" ref="destination" />
	</bean>

	<!-- 配置Jms模板  -->
	<bean id="jmsTemplate"
		class="org.springframework.jms.core.JmsTemplate">
		<property name="connectionFactory" ref="connectionFactory" />
		<property name="defaultDestination" ref="destination" />
		<property name="receiveTimeout" value="10000" />
	</bean>
	<!-- 配置JMS连接工厂 -->
	<bean id="connectionFactory"
		class="org.apache.activemq.ActiveMQConnectionFactory">
		<property name="brokerURL" value="tcp://localhost:61616" />
	</bean>
	<!-- 发送消息的目的地(队列) -->
	<bean id="destination"
		class="org.apache.activemq.command.ActiveMQQueue">
		<!-- 设置消息队列的名字 -->
		<constructor-arg index="0" value="myQueue" />
	</bean>
</beans>
4、编写测试程序
   需要的业务代码都已编写完毕,下面编写测试代码。新建一个生产者的测试类ProducerTest.java。具体代码如下:
package com.mq.service;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class ProducerTest {

	private static ApplicationContext appContext = new ClassPathXmlApplicationContext(
			"applicationContext.xml");

	private static void send() {
		ProducerService producerService = (ProducerService) appContext
				.getBean("producerService");
		producerService.send();
	}

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		send();
	}

}
   再建一个消费者的测试类,ConsumerTest.java,具体代码如下:
package com.mq.service;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class ConsumerTest {

	private static ApplicationContext appContext = new ClassPathXmlApplicationContext(
			"applicationContext.xml");

	private static void receive() {
		ConsumerService consumerService = (ConsumerService) appContext
				.getBean("consumerService");
		consumerService.receive();
	}

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		receive();
	}

}
5、运行程序
   所有代码都编写完了,我们来看一下我们的劳动成果。运行生产者测试类。控制台打印出如下内容,红线标注的冒号后面就是我们发送的内容:

   运行消费者测试类。控制台打印出如下内容,红线标注的冒号后面就是我们接受的内容:

两者是一样的。
   看来我们的劳动成果没有白费。以上是一些AciveMQ的基本应用,在接下来的时间,我会写一些高级应方面的文章,敬请关注本人百度空间和新郎微博。也欢迎各位通过一下两种途径和我进行交流,共同进步。推荐一下本人的微博,作为程序员,生活是非常枯燥的(一般都是很枯燥的,哪些以此为乐的不涉及),平时要自己丰富一下自己的业余生活,看些搞笑微博之类的。我每天都会发布一些糗事,欢迎大家关注。另外我在网上看到过有句话——程序员活该你单身身的,程序员招谁惹谁了啊,我们就应该单身。不过话又说回来了,程序员的生活确实单调,感情不丰富,不会说话,但是不能怨我们,其实我们也不想这样。推荐关注新浪微博一千零一夜话,微博地址:http://weibo.com/1968007227/,每天发布一条夜话,你懂得,希望各位程序猿每天能给自己的另一位一句温馨的话,不要成为苦逼的娃。
五、参考内容
   1、http://yunzhongxia.iteye.com/blog/566727
   2、ActiveMQ in action
   3、apache官网