JMS ActiveMQ

本文结合了 http://www.iteye.com/topic/275045 与http://www.cnblogs.com/xwdreamer/archive/2012/02/21/2360818.html 
两篇文章和自己的测试体验及结合spring的配置 
1.JMS介绍 
    JMS源于企业应用对于消息中间件的需求，使应用程序可以通过消息进行异步处理而互不影响。Sun公司和它的合作伙伴设计的JMS API定义了一组公共的应用程序接口和相应语法，使得Java程序能够和其他消息组件进行通信。JMS有四个组成部分：JMS服务提供者、消息管理对象、消息的生产者消费者和消息本身。 
1)JMS服务提供者实现消息队列和通知，同时实现消息管理的API。JMS已经是J2EE API的一部分，J2EE服务器都提供JMS服务。 
2) 消息管理对象提供对消息进行操作的API。JMS API中有两个消息管理对象：创建jms连接使用的工厂（ConnectionFactory）和目的地（Destination），根据消息的消费方式的不同ConnectionFactory可以分为QueueConnectionFactory和TopicConnectionFactory，目的地（Destination）可以分为队列（Queue）和主题（Topic）两种。 
3)消息的生产者和消费者。消息的产生由JMS的客户端完成，JMS服务提供者负责管理这些消息，消息的消费者可以接收消息。消息的生产者可以分为――点对点消息发布者（P2P）和主题消息发布者（TopicPublisher）。所以，消息的消费者分为两类：主题消息的订阅者（TopicSubscriber)和点对点消息的接收者（queue receiver） 
4)消息。消息是服务提供者和客户端之间传递信息所使用的信息单元。JMS消息由以下三部分组成： 
　　消息头（header）――JMS消息头包含了许多字段，它们是消息发送后由JMS提供者或消息发送者产生，用来表示消息、设置优先权和失效时间等等，并且为消息确定路由。 
　　属性（property）――用来添加删除消息头以外的附加信息。 
　　消息体（body）――JMS中定义了5种消息体：ByteMessage、MapMessage、ObjectMessage、StreamMessage和TextMessage。 

2.Messages 通信方式 
上面提到JMS通信方式分为点对点通信和发布/订阅方式 
1)点对点方式（point-to-point） 
   点对点的消息发送方式主要建立在 Message Queue,Sender,receiver上，Message Queue 存贮消息，Sender 发送消息，receive接收消息.具体点就是Sender Client发送Message Queue ,而 receiver Client从Queue中接收消息和"发送消息已接受"到Queue,确认消息接收。消息发送客户端与接收客户端没有时间上的依赖，发送客户端可以在任何时刻发送信息到Queue，而不需要知道接收客户端是不是在运行 
2)发布/订阅 方式（publish/subscriber Messaging） 
    发布/订阅方式用于多接收客户端的方式.作为发布订阅的方式，可能存在多个接收客户端，并且接收端客户端与发送客户端存在时间上的依赖。一个接收端只能接收他创建以后发送客户端发送的信息。作为subscriber ,在接收消息时有两种方法，destination的receive方法，和实现message listener 接口的onMessage 方法。 

3.为什么选用ActiveMQ 
   1）ActiveMQ是一个开放源码 
   2）基于Apache 2.0 licenced 发布并实现了JMS 1.1。 
   3）ActiveMQ现在已经和作为很多项目的异步消息通信核心了 
   4）在很多中小型项目中采用ActiveMQ+SPRING+TOMCAT开发模式。 

4.编程模式 
4.1消息产生者向JMS发送消息的步骤 
(1)创建连接使用的工厂类JMS ConnectionFactory 
(2)使用管理对象JMS ConnectionFactory建立连接Connection 
(3)使用连接Connection 建立会话Session 
(4)使用会话Session和管理对象Destination创建消息生产者MessageSender 
(5)使用消息生产者MessageSender发送消息 
4.2消息消费者从JMS接受消息的步骤 
(1)创建连接使用的工厂类JMS ConnectionFactory 
(2)使用管理对象JMS ConnectionFactory建立连接Connection 
(3)使用连接Connection 建立会话Session 
(4)使用会话Session和管理对象Destination创建消息消费者MessageReceiver 
(5)使用消息消费者MessageReceiver接受消息，需要用setMessageListener将MessageListener接口绑定到MessageReceiver 
消息消费者必须实现了MessageListener接口，需要定义onMessage事件方法。 

5.ActiveMQ运行 
a.去官方网站下载：http://activemq.apache.org/ 
b.解压缩apache-activemq-5.7.0-bin.zip，然后运行文件下 \bin\activemq.bat。 
c.创建project：ActiveMQ，并导入根目录下的activemq-all-5.7.0.jar 
启动ActiveMQ以后，登陆：http://localhost:8161/admin/ 
ActiveMQ，提供一个demo应用和用于监控ActiveMQ的admin应用。 
打开http://localhost:8161/admin/queues.jsp ，可以查看相应的queue中是否有消息 

6、简单实例代码 
Sender.java 

Java代码  

1. package com.test.activemq;  
2.   
3. import javax.jms.Connection;  
4. import javax.jms.ConnectionFactory;  
5. import javax.jms.DeliveryMode;  
6. import javax.jms.Destination;  
7. import javax.jms.MessageProducer;  
8. import javax.jms.Session;  
9. import javax.jms.TextMessage;  
10. import org.apache.activemq.ActiveMQConnection;  
11. import org.apache.activemq.ActiveMQConnectionFactory;  
12.   
13. public class Sender {  
14.     private static final int SEND_NUMBER = 5;  
15.   
16.     public static void main(String[] args) {  
17.         // ConnectionFactory ：连接工厂，JMS 用它创建连接  
18.         ConnectionFactory connectionFactory;  
19.         // Connection ：JMS 客户端到JMS Provider 的连接  
20.         Connection connection = null;  
21.         // Session： 一个发送或接收消息的线程  
22.         Session session;  
23.         // Destination ：消息的目的地;消息发送给谁.  
24.         Destination destination;  
25.         // MessageProducer：消息发送者  
26.         MessageProducer producer;  
27.         // TextMessage message;  
28.         // 构造ConnectionFactory实例对象，此处采用ActiveMq的实现jar  
29.         connectionFactory = new ActiveMQConnectionFactory(  
30.                 ActiveMQConnection.DEFAULT_USER,  
31.                 ActiveMQConnection.DEFAULT_PASSWORD,  
32.                 "tcp://localhost:61616");  
33.         try {  
34.             // 构造从工厂得到连接对象  
35.             connection = connectionFactory.createConnection();  
36.             // 启动  
37.             connection.start();  
38.             // 获取操作连接  
39.             session = connection.createSession(Boolean.TRUE,  
40.                     Session.AUTO_ACKNOWLEDGE);  
41.             // 创建queue  
42.             destination = session.createQueue("FirstQueue");  
43.             // 得到消息生成者【发送者】  
44.             producer = session.createProducer(destination);  
45.             // 设置不持久化，此处学习，实际根据项目决定  
46.             producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);  
47.             // 构造消息，此处写死，项目就是参数，或者方法获取  
48.             sendMessage(session, producer);  
49.             session.commit();  
50.         } catch (Exception e) {  
51.             e.printStackTrace();  
52.         } finally {  
53.             try {  
54.                 if (null != connection)  
55.                     connection.close();  
56.             } catch (Throwable ignore) {  
57.             }  
58.         }  
59.     }  
60.   
61.     public static void sendMessage(Session session, MessageProducer producer)  
62.             throws Exception {  
63.         for (int i = 1; i <= SEND_NUMBER; i++) {  
64.             TextMessage message = session  
65.                     .createTextMessage("ActiveMq 发送的消息" + i);  
66.             // 发送消息到目的地方  
67.             System.out.println("发送消息：" + "ActiveMq 发送的消息" + i);  
68.             producer.send(message);  
69.         }  
70.     }  
71. }  

Receiver.java 

Java代码  

1. package com.test.activemq;  
2.   
3. import javax.jms.Connection;  
4. import javax.jms.ConnectionFactory;  
5. import javax.jms.Destination;  
6. import javax.jms.MessageConsumer;  
7. import javax.jms.Session;  
8. import javax.jms.TextMessage;  
9. import org.apache.activemq.ActiveMQConnection;  
10. import org.apache.activemq.ActiveMQConnectionFactory;  
11.   
12. public class Receiver {  
13.     public static void main(String[] args) {  
14.         // ConnectionFactory ：连接工厂，JMS 用它创建连接  
15.         ConnectionFactory connectionFactory;  
16.         // Connection ：JMS 客户端到JMS Provider 的连接  
17.         Connection connection = null;  
18.         // Session： 一个发送或接收消息的线程  
19.         Session session;  
20.         // Destination ：消息的目的地;消息发送给谁.  
21.         Destination destination;  
22.         // 消费者，消息接收者  
23.         MessageConsumer consumer;  
24.         connectionFactory = new ActiveMQConnectionFactory(  
25.                 ActiveMQConnection.DEFAULT_USER,  
26.                 ActiveMQConnection.DEFAULT_PASSWORD,  
27.                 "tcp://localhost:61616");  
28.         try {  
29.             // 构造从工厂得到连接对象  
30.             connection = connectionFactory.createConnection();  
31.             // 启动  
32.             connection.start();  
33.             // 获取操作连接  
34.             session = connection.createSession(Boolean.FALSE,  
35.                     Session.AUTO_ACKNOWLEDGE);  
36.             // 创建queue  
37.             destination = session.createQueue("FirstQueue");  
38.             consumer = session.createConsumer(destination);  
39.             while (true) {  
40.                 //设置接收者接收消息的时间，为了便于测试，这里谁定为100s  
41.                 TextMessage message = (TextMessage) consumer.receive(100000);  
42.                 if (null != message) {  
43.                     System.out.println("收到消息" + message.getText());  
44.                 } else {  
45.                     break;  
46.                 }  
47.             }  
48.         } catch (Exception e) {  
49.             e.printStackTrace();  
50.         } finally {  
51.             try {  
52.                 if (null != connection)  
53.                     connection.close();  
54.             } catch (Throwable ignore) {  
55.             }  
56.         }  
57.     }  
58. }  

7、与spring 结合配置 

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd">  
4.   
5.     <description>JMS简单应用配置</description>  
6.   
7.     <!-- ActiveMQ 连接工厂 -->  
8.     <bean id="connectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">  
9.         <property name="brokerURL" value="tcp://localhost:61616" />  
10.     </bean>  
11.   
12.     <!-- Spring Caching 连接工厂 -->  
13.     <bean id="cachingConnectionFactory" class="org.springframework.jms.connection.CachingConnectionFactory">  
14.         <property name="targetConnectionFactory" ref="connectionFactory" />  
15.         <property name="sessionCacheSize" value="10" />  
16.     </bean>  
17.   
18.     <!-- Queue定义 -->  
19.     <bean id="notifyQueue" class="org.apache.activemq.command.ActiveMQQueue">  
20.         <constructor-arg value="q.notify" />  
21.     </bean>  
22.   
23.     <!-- Topic定义 -->  
24.     <bean id="notifyTopic" class="org.apache.activemq.command.ActiveMQTopic">  
25.         <constructor-arg value="t.notify" />  
26.     </bean>  
27.   
28.     <!-- Spring JMS Template -->  
29.     <bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">  
30.         <property name="connectionFactory" ref="cachingConnectionFactory" />  
31.     </bean>  
32.   
33.     <!-- 使用Spring JmsTemplate的消息生产者 -->  
34.     <bean id="notifyMessageProducer" class="com.ambow.lmsx.jms.NotifyMessageProducer">  
35.         <property name="jmsTemplate" ref="jmsTemplate" />  
36.         <property name="notifyQueue" ref="notifyQueue" />  
37.         <property name="notifyTopic" ref="notifyTopic" />  
38.     </bean>  
39.   
40.     <!-- 异步接收Queue消息Container -->  
41.     <bean id="queueContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
42.         <property name="connectionFactory" ref="connectionFactory" />  
43.         <property name="destination" ref="notifyQueue" />  
44.         <property name="messageListener" ref="notifyMessageListener" />  
45.         <property name="concurrentConsumers" value="10" />  
46.     </bean>  
47.   
48.     <!-- 异步接收Topic消息Container -->  
49.     <bean id="topicContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
50.         <property name="connectionFactory" ref="connectionFactory" />  
51.         <property name="destination" ref="notifyTopic" />  
52.         <property name="messageListener" ref="notifyMessageListener" />  
53.     </bean>  
54.   
55.     <!-- 异步接收消息处理类 -->  
56.     <bean id="notifyMessageListener" class="com.ambow.lmsx.jms.NotifyMessageListener" />  
57. </beans>  

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
3.     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd">  
4.   
5.     <description>JMS高级应用配置(NON_PERSISTENT,DURIABLE,SELECTOR)</description>  
6.   
7.     <!-- ActiveMQ 连接工厂 -->  
8.     <bean id="advancedConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">  
9.         <property name="brokerURL" value="tcp://localhost:61616" />  
10.         <!-- 对PERSISTENT的消息进行异步发送(NON_PERSISTENT消息默认异步发送) -->  
11.         <!-- <property name="useAsyncSend" value="true" /> -->  
12.     </bean>  
13.   
14.     <!-- 持久化主题订阅者ActiveMQ 连接工厂 -->  
15.     <bean id="advancedTopicConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">  
16.         <property name="brokerURL" value="tcp://localhost:61616" />  
17.         <!-- Durable订阅者必须设置ClientId -->  
18.         <property name="clientID" value="durableTopicListenerDemo" />  
19.     </bean>  
20.   
21.     <!-- Spring Caching 连接工厂 -->  
22.     <bean id="advancedCachingConnectionFactory" class="org.springframework.jms.connection.CachingConnectionFactory">  
23.         <property name="targetConnectionFactory" ref="advancedConnectionFactory" />  
24.         <property name="sessionCacheSize" value="10" />  
25.     </bean>  
26.   
27.     <!-- Queue定义 -->  
28.     <bean id="advancedNotifyQueue" class="org.apache.activemq.command.ActiveMQQueue">  
29.         <constructor-arg value="q.advanced.notify" />  
30.     </bean>  
31.   
32.     <!-- Topic定义 -->  
33.     <bean id="advancedNotifyTopic" class="org.apache.activemq.command.ActiveMQTopic">  
34.         <constructor-arg value="t.advanced.notify" />  
35.     </bean>  
36.   
37.     <!-- Spring JMS Template -->  
38.     <bean id="advancedJmsTemplate" class="org.springframework.jms.core.JmsTemplate">  
39.         <property name="connectionFactory" ref="advancedCachingConnectionFactory" />  
40.         <!-- 使 deliveryMode, priority, timeToLive设置生效-->  
41.         <property name="explicitQosEnabled" value="true" />  
42.         <!-- 设置NON_PERSISTENT模式, 默认为PERSISTENT -->  
43.         <property name="deliveryPersistent" value="false" />  
44.         <!-- 设置优先级, 默认为4 -->  
45.         <property name="priority" value="9" />  
46.     </bean>  
47.   
48.     <!-- 使用Spring JmsTemplate的消息生产者 -->  
49.     <bean id="advancedNotifyMessageProducer" class="com.ambow.lmsx.jms.AdvancedNotifyMessageProducer">  
50.         <property name="jmsTemplate" ref="advancedJmsTemplate" />  
51.         <property name="notifyQueue" ref="advancedNotifyQueue" />  
52.         <property name="notifyTopic" ref="advancedNotifyTopic" />  
53.     </bean>  
54.   
55.     <!-- 异步接收Queue消息Container -->  
56.     <bean id="advancedQueueContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
57.         <property name="connectionFactory" ref="advancedConnectionFactory" />  
58.         <property name="destination" ref="advancedNotifyQueue" />  
59.         <property name="messageListener" ref="advancedNotifyMessageListener" />  
60.         <!-- 初始5个Consumer, 可动态扩展到10 -->  
61.         <property name="concurrentConsumers" value="5" />  
62.         <property name="maxConcurrentConsumers" value="10" />  
63.         <!-- 设置消息确认模式为Client -->  
64.         <property name="sessionAcknowledgeModeName" value="CLIENT_ACKNOWLEDGE" />  
65.     </bean>  
66.   
67.     <!-- 异步接收Topic消息Container -->  
68.     <bean id="advancedTopicContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">  
69.         <property name="connectionFactory" ref="advancedTopicConnectionFactory" />  
70.         <property name="destination" ref="advancedNotifyTopic" />  
71.         <property name="messageListener" ref="advancedNotifyMessageListener" />  
72.         <!-- JMS Selector消息过滤器 -->  
73.         <property name="messageSelector" value="objectType='user'" />  
74.         <!-- 持久化订阅者 -->  
75.         <property name="subscriptionDurable" value="true" />  
76.     </bean>  
77.   
78.     <!-- 异步接收消息处理类 -->  
79.     <bean id="advancedNotifyMessageListener" class="com.ambow.lmsx.jms.AdvancedNotifyMessageListener" />  
80. </beans>