深入掌握JMS

博客分类：
• Java中间件

JMSActiveMQApacheJavaEE企业应用

1. JMS基本概念
    JMS(Java Message Service) 即Java消息服务。它提供标准的产生、发送、接收消息的接口简化企业应用的开发。它支持两种消息通信模型：点到点（point-to-point）（P2P）模型和发布/订阅（Pub/Sub）模型。P2P模型规定了一个消息只能有一个接收者;Pub/Sub 模型允许一个消息可以有多个接收者。
    对于点到点模型，消息生产者产生一个消息后，把这个消息发送到一个Queue（队列）中，然后消息接收者再从这个Queue中读取，一旦这个消息被一个接收者读取之后，它就在这个Queue中消失了，所以一个消息只能被一个接收者消费。与点到点模型不同，发布/订阅模型中，消息生产者产生一个消息后，把这个消息发送到一个Topic中，这个Topic可以同时有多个接收者在监听，当一个消息到达这个Topic之后，所有消息接收者都会收到这个消息。 

几个重要概念
    Destination：消息发送的目的地，也就是前面说的Queue和Topic。创建好一个消息之后，只需要把这个消息发送到目的地，消息的发送者就可以继续做自己的事情，而不用等待消息被处理完成。至于这个消息什么时候，会被哪个消费者消费，完全取决于消息的接受者。
              

Message：从字面上就可以看出是被发送的消息。它有下面几种类型： 

    StreamMessage：Java 数据流消息，用标准流操作来顺序的填充和读取。 
    MapMessage：一个Map类型的消息；名称为 string 类型，而值为 Java 的基本类型。 
    TextMessage：普通字符串消息，包含一个String。 
    ObjectMessage：对象消息，包含一个可序列化的Java 对象 
    BytesMessage：二进制数组消息，包含一个byte[]。 
    XMLMessage:  一个XML类型的消息。 
    

最常用的是TextMessage和ObjectMessage。
              Session：与JMS提供者所建立的会话，通过Session我们才可以创建一个Message。
              Connection：与JMS提供者建立的一个连接。可以从这个连接创建一个会话，即Session。
           ConnectionFactory:那如何创建一个Connection呢？这就需要下面讲到的ConnectionFactory了。通过这个工厂类就可以得到一个与JMS提供者的连接，即Conection。

              Producer：消息的生产者，要发送一个消息，必须通过这个生产者来发送。
              MessageConsumer：与生产者相对应，这是消息的消费者或接收者，通过它来接收一个消息。

           前面多次提到JMS提供者，因为JMS给我们提供的只是一系列接口，当我们使用一个JMS的时候，还是需要一个第三方的提供者，它的作用就是真正管理这些Connection，Session，Topic和Queue等。

               通过下面这个简图可以看出上面这些概念的关系。

             ConnectionFactory---->Connection--->Session--->Message
             Destination + Session------------------------------------>Producer
             Destination + Session------------------------------------>MessageConsumer 

 

那么可能有人会问: ConnectionFactory和Destination 从哪儿得到? 这就和JMS提供者有关了. 如果在一个JavaEE环境中, 可以通过JNDI查找得到, 如果在一个非JavaEE环境中, 那只能通过JMS提供者提供给我们的接口得到了.

 

 2. 一个JMS的例子
首先需要做的是选择一个JMS提供者, 如果在JavaEE环境中可以不用考虑这些. 我们选择ActiveMQ, 官方地址:
http://activemq.apache.org/.

 

ActiveMQConnectionFactory connectionFactory = new ActiveMQConnectionFactory(user, password, url);   

url:  tcp://10.104.46.119:61616

 

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.ConnectionFactory;   
6. import javax.jms.Message;   
7. import javax.jms.MessageConsumer;   
8. import javax.jms.MessageProducer;   
9. import javax.jms.Queue;   
10. import javax.jms.Session;   
11. import javax.jms.TextMessage;   
12.   
13. public class MessageSendAndReceive {   
14.   
15.     public static void main(String[] args) throws Exception {   
16.         ConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
17.         Connection connection = factory.createConnection();   
18.         connection.start();   
19.         Queue queue = new ActiveMQQueue("testQueue");   
20.         final Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
21.         Message message = session.createTextMessage("Hello JMS!");   
22.         MessageProducer producer = session.createProducer(queue);  

Java代码

 

1.     producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);     
2.     producer.send(message);   
3.     System.out.println("Send Message Completed!");   
4.     MessageConsumer comsumer = session.createConsumer(queue);   
5.     Message recvMessage = comsumer.receive();   
6.     System.out.println(((TextMessage) recvMessage).getText());   
7. }   

Java代码

 

1.   

Java代码

 

1.  // 关闭连接          
2.     public void close() throws JMSException {          
3.         System.out.println("Producer:->Closing connection");          
4.         if (producer != null)          
5.             producer.close();          
6.         if (session != null)          
7.             session.close();          
8.         if (connection != null)          
9.             connection.close();          
10.     }    

 

 

  3. MessageListener 

 

消息的消费者接收消息可以采用两种方式：

              1、consumer.receive() 或 consumer.receive(int timeout)；

 

Java代码

 

1. MessageConsumer comsumer = session.createConsumer(queue);   
2. connection.start();   
3. for (int i = 0; i < 1; i++) {   
4.     Message recvMessage = comsumer.receive();   
5.     System.out.println(((TextMessage) recvMessage).getText());   
6. }  

 

 
              2、注册一个MessageListener。
            采用第一种方式，消息的接收者会一直等待下去，直到有消息到达，或者超时。后一种方式会注册一个监听器，当有消息到达的时候，会回调它的onMessage()方法。

 

Java代码

 

1. MessageConsumer comsumer = session.createConsumer(queue);    
2.              comsumer.setMessageListener(new MessageListener(){    
3.                         @Override    
4.                         public void onMessage(Message m) {    
5.                             TextMessage textMsg = (TextMessage) m;    
6.                             try {    
7.                                 System.out.println(textMsg.getText());    
8.                             } catch (JMSException e) {    
9.                                 e.printStackTrace();    
10.                             }    
11.                         }    
12.                     });  

 

 

4. 实战Queue

 Queue实现的是点到点模型，在下面的例子中，启动2个消费者共同监听一个Queue，然后循环给这个Queue中发送多个消息，我们依然采用ActiveMQ。

 

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.JMSException;   
6. import javax.jms.Message;   
7. import javax.jms.MessageConsumer;   
8. import javax.jms.MessageListener;   
9. import javax.jms.MessageProducer;   
10. import javax.jms.Queue;   
11. import javax.jms.Session;   
12. import javax.jms.TextMessage;   
13.   
14. public class QueueTest {   
15.   
16.     public static void main(String[] args) throws Exception {   
17.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
18.         Connection connection = factory.createConnection();   
19.         connection.start();   
20.   
21.         //创建一个Queue   
22.         Queue queue = new ActiveMQQueue("testQueue");   
23.         //创建一个Session   
24.         Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
25.   
26.         //注册消费者1   
27.         MessageConsumer comsumer1 = session.createConsumer(queue);   
28.         comsumer1.setMessageListener(   
29.             new MessageListener() {   
30.                 public void onMessage(Message m) {   
31.                     try {   
32.                         System.out.println("Consumer1 get " + ((TextMessage) m).getText());   
33.                     } catch (JMSException e) {   
34.                         e.printStackTrace();   
35.                     }   
36.                 }   
37.             });   
38.   
39.         //注册消费者2   
40.         MessageConsumer comsumer2 = session.createConsumer(queue);   
41.         comsumer2.setMessageListener(   
42.             new MessageListener() {   
43.                 public void onMessage(Message m) {   
44.                     try {   
45.                         System.out.println("Consumer2 get " + ((TextMessage) m).getText());   
46.                     } catch (JMSException e) {   
47.                         e.printStackTrace();   
48.                     }   
49.                 }   
50.             });   
51.   
52.         //创建一个生产者，然后发送多个消息。   
53.         MessageProducer producer = session.createProducer(queue);   
54.         for (int i = 0; i < 10; i++) {   
55.             producer.send(session.createTextMessage("Message:" + i));   
56.         }   
57.     }   
58. }  

 

 运行这个例子会得到下面的输出结果：

            Consumer1 get Message:0
            Consumer2 get Message:1
            Consumer1 get Message:2
            Consumer2 get Message:3
            Consumer1 get Message:4
            Consumer2 get Message:5
            Consumer1 get Message:6
            Consumer2 get Message:7
            Consumer1 get Message:8
            Consumer2 get Message:9

    可以看出每个消息直被消费了一次，但是如果有多个消费者同时监听一个Queue的话，无法确定一个消息最终会被哪一个消费者消费。

 

5. 实战Topic 

 

 与Queue不同的是，Topic实现的是发布/订阅模型，在下面的例子中，启动2个消费者共同监听一个Topic，然后循环给这个Topic中发送多个消息。

 

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQTopic;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.JMSException;   
6. import javax.jms.Message;   
7. import javax.jms.MessageConsumer;   
8. import javax.jms.MessageListener;   
9. import javax.jms.MessageProducer;   
10. import javax.jms.Session;   
11. import javax.jms.TextMessage;   
12. import javax.jms.Topic;   
13.   
14.   
15. public class TopicTest {   
16.   
17.     public static void main(String[] args) throws Exception {   
18.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
19.   
20.         Connection connection = factory.createConnection();   
21.         connection.start();   
22.   
23.         //创建一个Topic   
24.         Topic topic = new ActiveMQTopic("testTopic");   
25.         Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
26.   
27.         //注册消费者1   
28.         MessageConsumer comsumer1 = session.createConsumer(topic);   
29.         comsumer1.setMessageListener(   
30.             new MessageListener() {   
31.                 public void onMessage(Message m) {   
32.                     try {   
33.                         System.out.println("Consumer1 get " + ((TextMessage) m).getText());   
34.                     } catch (JMSException e) {   
35.                         e.printStackTrace();   
36.                     }   
37.                 }   
38.             });   
39.   
40.         //注册消费者2   
41.         MessageConsumer comsumer2 = session.createConsumer(topic);   
42.         comsumer2.setMessageListener(   
43.             new MessageListener() {   
44.                 public void onMessage(Message m) {   
45.                     try {   
46.                         System.out.println("Consumer2 get " + ((TextMessage) m).getText());   
47.                     } catch (JMSException e) {   
48.                         e.printStackTrace();   
49.                     }   
50.                 }   
51.   
52.             });   
53.   
54.         //创建一个生产者，然后发送多个消息。   
55.         MessageProducer producer = session.createProducer(topic);   
56.         for (int i = 0; i < 10; i++) {   
57.             producer.send(session.createTextMessage("Message:" + i));   
58.         }   
59.     }   
60.   
61. }  

  

运行后得到下面的输出结果：

Consumer1 get Message:0
Consumer2 get Message:0
Consumer1 get Message:1
Consumer2 get Message:1
Consumer1 get Message:2
Consumer2 get Message:2
Consumer1 get Message:3
Consumer2 get Message:3
Consumer1 get Message:4
Consumer2 get Message:4
Consumer1 get Message:5
Consumer2 get Message:5
Consumer1 get Message:6
Consumer2 get Message:6
Consumer1 get Message:7
Consumer2 get Message:7
Consumer1 get Message:8
Consumer2 get Message:8
Consumer1 get Message:9
 Consumer2 get Message:9

 

 

6. 消息头

 

一个消息对象分为三部分：消息头(Headers)，属性（Properties）和消息体（Payload）。对于StreamMessage和MapMessage，消息本身就有特定的结构，而对于TextMessage，ObjectMessage和BytesMessage是无结构的。一个消息可以包含一些重要的数据或者仅仅是一个事件的通知。

    消息的Headers部分通常包含一些消息的描述信息，它们都是标准的描述信息。包含下面一些值：

　　JMSDestination
       消息的目的地，Topic或者是Queue。

　　JMSDeliveryMode
        消息的发送模式：persistent或nonpersistent。前者表示消息在被消费之前，如果JMS提供者DOWN了，重新启动后消息仍然存在。后者在这种情况下表示消息会被丢失。可以通过下面的方式设置：
       Producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);

       JMSTimestamp
       当调用send()方法的时候，JMSTimestamp会被自动设置为当前事件。可以通过下面方式得到这个值：
       long timestamp = message.getJMSTimestamp();

　　JMSExpiration
       表示一个消息的有效期。只有在这个有效期内，消息消费者才可以消费这个消息。默认值为0，表示消息永不过期。可以通过下面的方式设置：
       producer.setTimeToLive(3600000); //有效期1小时 （1000毫秒 * 60秒 * 60分）

　　JMSPriority
       消息的优先级。0-4为正常的优先级，5-9为高优先级。可以通过下面方式设置：
       producer.setPriority(9);

　　JMSMessageID
       一个字符串用来唯一标示一个消息。

　　JMSReplyTo
       有时消息生产者希望消费者回复一个消息，JMSReplyTo为一个Destination，表示需要回复的目的地。当然消费者可以不理会它。

　　JMSCorrelationID
       通常用来关联多个Message。例如需要回复一个消息，可以把JMSCorrelationID设置为所收到的消息的JMSMessageID。

　　JMSType
       表示消息体的结构，和JMS提供者有关。

　　JMSRedelivered
       如果这个值为true，表示消息是被重新发送了。因为有时消费者没有确认他已经收到消息或者JMS提供者不确定消费者是否已经收到。

    除了Header，消息发送者可以添加一些属性(Properties)。这些属性可以是应用自定义的属性，JMS定义的属性和JMS提供者定义的属性。我们通常只适用自定义的属性。

    后面会讲到这些Header和属性的用法。

 

 7. DeliveryMode例子

 

在下面的例子中，分别发送一个Persistent和nonpersistent的消息，然后关闭退出JMS。

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.DeliveryMode;   
6. import javax.jms.MessageProducer;   
7. import javax.jms.Queue;   
8. import javax.jms.Session;   
9.   
10. public class DeliveryModeSendTest {   
11.   
12.     public static void main(String[] args) throws Exception {   
13.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
14.   
15.         Connection connection = factory.createConnection();   
16.         connection.start();   
17.   
18.         Queue queue = new ActiveMQQueue("testQueue");   
19.         Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
20.   
21.         MessageProducer producer = session.createProducer(queue);   
22.         producer.setDeliveryMode(DeliveryMode.PERSISTENT);   
23.         producer.send(session.createTextMessage("A persistent Message"));   
24.   
25.         producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);   
26.         producer.send(session.createTextMessage("A non persistent Message"));   
27.   
28.         System.out.println("Send messages sucessfully!");   
29.     }   
30. }  

 

运行上面的程序，当输出“Send messages sucessfully!”时，说明两个消息都已经发送成功，然后我们结束它，来停止JMS Provider。

    接下来我们重新启动JMS Provicer，然后添加一个消费者：

 

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.JMSException;   
6. import javax.jms.Message;   
7. import javax.jms.MessageConsumer;   
8. import javax.jms.MessageListener;   
9. import javax.jms.Queue;   
10. import javax.jms.Session;   
11. import javax.jms.TextMessage;   
12.   
13. public class DeliveryModeReceiveTest {   
14.   
15.     public static void main(String[] args) throws Exception {   
16.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
17.   
18.         Connection connection = factory.createConnection();   
19.         connection.start();   
20.   
21.         Queue queue = new ActiveMQQueue("testQueue");   
22.         Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
23.   
24.         MessageConsumer comsumer = session.createConsumer(queue);   
25.         comsumer.setMessageListener(   
26.             new MessageListener() {   
27.                 public void onMessage(Message m) {   
28.                     try {   
29.                         System.out.println("Consumer get " + ((TextMessage) m).getText());   
30.                     } catch (JMSException e) {   
31.                         e.printStackTrace();   
32.                     }   
33.                 }   
34.             });   
35.     }   
36. }  

  

运行上面的程序，可以得到下面的输出结果：
Consumer get A persistent Message

可以看出消息消费者只接收到一个消息，它是一个Persistent的消息。而刚才发送的non persistent消息已经丢失了。
另外, 如果发送一个non persistent消息, 而刚好这个时候没有消费者在监听, 这个消息也会丢失

 

 

8. JMSReplyTo

    在下面的例子中，首先创建两个Queue，发送者给一个Queue发送，接收者接收到消息之后给另一个Queue回复一个Message，然后再创建一个消费者来接受所回复的消息。

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.JMSException;   
6. import javax.jms.Message;   
7. import javax.jms.MessageConsumer;   
8. import javax.jms.MessageListener;   
9. import javax.jms.MessageProducer;   
10. import javax.jms.Queue;   
11. import javax.jms.Session;   
12. import javax.jms.TextMessage;   
13.   
14. public class MessageSendReceiveAndReply {   
15.   
16.     public static void main(String[] args) throws Exception {   
17.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
18.   
19.         Connection connection = factory.createConnection();   
20.         connection.start();   
21.   
22.         //消息发送到这个Queue   
23.         Queue queue = new ActiveMQQueue("testQueue");   
24.   
25.         //消息回复到这个Queue   
26.         Queue replyQueue = new ActiveMQQueue("replyQueue");   
27.   
28.         final Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
29.   
30.         //创建一个消息，并设置它的JMSReplyTo为replyQueue。   
31.         Message message = session.createTextMessage("Andy");   
32.         message.setJMSReplyTo(replyQueue);   
33.   
34.         MessageProducer producer = session.createProducer(queue);   
35.         producer.send(message);   
36.   
37.         //消息的接收者   
38.         MessageConsumer comsumer = session.createConsumer(queue);   
39.         comsumer.setMessageListener(   
40.             new MessageListener() {   
41.                 public void onMessage(Message m) {   
42.                     try {   
43.                         //创建一个新的MessageProducer来发送一个回复消息。   
44.                         MessageProducer producer = session.createProducer(m.getJMSReplyTo());   
45.                         producer.send(session.createTextMessage("Hello " + ((TextMessage) m).getText()));   
46.                     } catch (JMSException e1) {   
47.                         e1.printStackTrace();   
48.                     }   
49.                 }   
50.   
51.             });   
52.   
53.         //这个接收者用来接收回复的消息   
54.         MessageConsumer comsumer2 = session.createConsumer(replyQueue);   
55.         comsumer2.setMessageListener(   
56.             new MessageListener() {   
57.                 public void onMessage(Message m) {   
58.                     try {   
59.                         System.out.println(((TextMessage) m).getText());   
60.                     } catch (JMSException e) {   
61.                         e.printStackTrace();   
62.                     }   
63.                 }   
64.             });   
65.     }   
66. }  

 

首先消息生产者发送一个消息，内容为“Andy”， 然后消费者收到这个消息之后根据消息的JMSReplyTo，回复一个消息，内容为“Hello Andy‘。 最后在回复的Queue上创建一个接收回复消息的消费者，它输出所回复的内容。

    运行上面的程序，可以得到下面的输出结果：
          Hello Andy

 

 

 9. Selector

 

      前面的例子中创建一个消息消费者使用的是:
          sesssion.createConsumer(destination)
  另外，还提供了另一种方式：
    sesssion.createConsumer(destination, selector)
  这里selector是一个字符串，用来过滤消息。也就是说，这种方式可以创建一个可以只接收特定消息的一个消费者。Selector的格式是类似于SQL-92的一种语法。可以用来比较消息头信息和属性。
  下面的例子中，创建两个消费者，共同监听同一个Queue，但是它们的Selector不同，然后创建一个消息生产者，来发送多个消息。

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.JMSException;   
6. import javax.jms.Message;   
7. import javax.jms.MessageConsumer;   
8. import javax.jms.MessageListener;   
9. import javax.jms.MessageProducer;   
10. import javax.jms.Queue;   
11. import javax.jms.Session;   
12. import javax.jms.TextMessage;   
13.   
14. public class JMSSelectorTest {   
15.   
16.     public static void main(String[] args) throws Exception {   
17.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
18.   
19.         Connection connection = factory.createConnection();   
20.         connection.start();   
21.   
22.         Queue queue = new ActiveMQQueue("testQueue");   
23.   
24.         Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
25.   
26.         MessageConsumer comsumerA = session.createConsumer(queue, "receiver = 'A'");   
27.         comsumerA.setMessageListener(   
28.             new MessageListener() {   
29.                 public void onMessage(Message m) {   
30.                     try {   
31.                         System.out.println("ConsumerA get " + ((TextMessage) m).getText());   
32.                     } catch (JMSException e1) {   
33.                     }   
34.                 }   
35.             });   
36.   
37.         MessageConsumer comsumerB = session.createConsumer(queue, "receiver = 'B'");   
38.         comsumerB.setMessageListener(   
39.             new MessageListener() {   
40.                 public void onMessage(Message m) {   
41.                     try {   
42.                         System.out.println("ConsumerB get " + ((TextMessage) m).getText());   
43.                     } catch (JMSException e) {   
44.                     }   
45.                 }   
46.             });   
47.   
48.         MessageProducer producer = session.createProducer(queue);   
49.         for (int i = 0; i < 10; i++) {   
50.             String receiver = (i % 3 == 0 ? "A" : "B");   
51.             TextMessage message = session.createTextMessage("Message" + i + ", receiver:" + receiver);   
52.             message.setStringProperty("receiver", receiver);   
53.             producer.send(message);   
54.         }   
55.     }   
56. }  

 

 

 10. JMSCorrelationID与Selector

 

    前面讲过JMSCorrelationID主要是用来关联多个Message，例如需要回复一个消息的时候，通常把回复的消息的JMSCorrelationID设置为原来消息的ID。在下面这个例子中，创建了三个消息生产者A，B，C和三个消息消费者A，B，C。生产者A给消费者A发送一个消息，同时需要消费者A给它回复一个消息。B、C与A类似。
    简图如下：
       生产者A-----发送----〉消费者A-----回复------〉生产者A
        生产者B-----发送----〉消费者B-----回复------〉生产者B
        生产者C-----发送----〉消费者C-----回复------〉生产者C
   
    需要注意的是，所有的发送和回复都使用同一个Queue，通过Selector区分。

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.DeliveryMode;   
6. import javax.jms.JMSException;   
7. import javax.jms.Message;   
8. import javax.jms.MessageConsumer;   
9. import javax.jms.MessageListener;   
10. import javax.jms.MessageProducer;   
11. import javax.jms.Queue;   
12. import javax.jms.Session;   
13. import javax.jms.TextMessage;   
14.   
15. public class JMSCorrelationIDTest {   
16.   
17.     private Queue queue;   
18.     private Session session;   
19.   
20.     public JMSCorrelationIDTest() throws JMSException {   
21.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
22.         Connection connection = factory.createConnection();   
23.         connection.start();   
24.   
25.         queue = new ActiveMQQueue("testQueue");   
26.         session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
27.   
28.         setupConsumer("ConsumerA");   
29.         setupConsumer("ConsumerB");   
30.         setupConsumer("ConsumerC");   
31.   
32.         setupProducer("ProducerA", "ConsumerA");   
33.         setupProducer("ProducerB", "ConsumerB");   
34.         setupProducer("ProducerC", "ConsumerC");   
35.     }   
36.   
37.     private void setupConsumer(final String name) throws JMSException {   
38.         //创建一个消费者，它只接受属于它自己的消息   
39.         MessageConsumer consumer = session.createConsumer(queue, "receiver='" + name + "'");   
40.         consumer.setMessageListener(   
41.             new MessageListener() {   
42.                 public void onMessage(Message m) {   
43.                     try {   
44.                         MessageProducer producer = session.createProducer(queue);   
45.                         System.out.println(name + " get:" + ((TextMessage) m).getText());   
46.                         //回复一个消息   
47.                         Message replyMessage = session.createTextMessage("Reply from " + name);   
48.                         //设置JMSCorrelationID为刚才收到的消息的ID   
49.                         replyMessage.setJMSCorrelationID(m.getJMSMessageID());   
50.                         producer.send(replyMessage);   
51.                     } catch (JMSException e) {   
52.                     }   
53.                 }   
54.             });   
55.     }   
56.   
57.     private void setupProducer(final String name, String consumerName) throws JMSException {   
58.         MessageProducer producer = session.createProducer(queue);   
59.         producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);   
60.         //创建一个消息，并设置一个属性receiver，为消费者的名字。   
61.         Message message = session.createTextMessage("Message from " + name);   
62.         message.setStringProperty("receiver", consumerName);   
63.         producer.send(message);   
64.   
65.         //等待回复的消息   
66.         MessageConsumer replyConsumer =   
67.             session.createConsumer(queue, "JMSCorrelationID='" + message.getJMSMessageID() + "'");   
68.         replyConsumer.setMessageListener(   
69.             new MessageListener() {   
70.                 public void onMessage(Message m) {   
71.                     try {   
72.                         System.out.println(name + " get reply:" + ((TextMessage) m).getText());   
73.                     } catch (JMSException e) {   
74.                     }   
75.                 }   
76.             });   
77.     }   
78.   
79.     public static void main(String[] args) throws Exception {   
80.         new JMSCorrelationIDTest();   
81.     }   
82. }  

 

运行结果为：
ConsumerA get:Message from ProducerA
ProducerA get reply:Reply from ConsumerA
ConsumerB get:Message from ProducerB
ProducerB get reply:Reply from ConsumerB
ConsumerC get:Message from ProducerC
ProducerC get reply:Reply from ConsumerC

 

 

11. TemporaryQueue和TemporaryTopic

 

 TemporaryQueue和TemporaryTopic，从字面上就可以看出它们是“临时”的目的地。可以通过Session来创建，例如：
    TemporaryQueue replyQueue = session.createTemporaryQueue();
    虽然它们是由Session来创建的，但是它们的生命周期确实整个Connection。如果在一个Connection上创建了两个Session，则一个Session创建的TemporaryQueue或TemporaryTopic也可以被另一个Session访问。那如果这两个Session是由不同的Connection创建，则一个Session创建的TemporaryQueue不可以被另一个Session访问。
    另外，它们的主要作用就是用来指定回复目的地， 即作为JMSReplyTo。
    在下面的例子中，先创建一个Connection，然后创建两个Session，其中一个Session创建了一个TemporaryQueue，另一个Session在这个TemporaryQueue上读取消息。

 

Java代码

 

1. import org.apache.activemq.ActiveMQConnectionFactory;   
2. import org.apache.activemq.command.ActiveMQQueue;   
3.   
4. import javax.jms.Connection;   
5. import javax.jms.JMSException;   
6. import javax.jms.Message;   
7. import javax.jms.MessageConsumer;   
8. import javax.jms.MessageListener;   
9. import javax.jms.MessageProducer;   
10. import javax.jms.Queue;   
11. import javax.jms.Session;   
12. import javax.jms.TemporaryQueue;   
13. import javax.jms.TextMessage;   
14.   
15. public class TemporaryQueueTest {   
16.   
17.     public static void main(String[] args) throws Exception {   
18.         ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory("vm://localhost");   
19.         Connection connection = factory.createConnection();   
20.         connection.start();   
21.         Queue queue = new ActiveMQQueue("testQueue2");   
22.         final Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);   
23.         //使用session创建一个TemporaryQueue。   
24.         TemporaryQueue replyQueue = session.createTemporaryQueue();   
25.         //接收消息，并回复到指定的Queue中（即replyQueue）   
26.         MessageConsumer comsumer = session.createConsumer(queue);   
27.         comsumer.setMessageListener(   
28.             new MessageListener() {   
29.                 public void onMessage(Message m) {   
30.                     try {   
31.                         System.out.println("Get Message: " + ((TextMessage) m).getText());   
32.                         MessageProducer producer = session.createProducer(m.getJMSReplyTo());   
33.                         producer.send(session.createTextMessage("ReplyMessage"));   
34.                     } catch (JMSException e) {   
35.                     }   
36.                 }   
37.             });   
38.         //使用同一个Connection创建另一个Session，来读取replyQueue上的消息。   
39.         Session session2 = connection.createSession(true, Session.AUTO_ACKNOWLEDGE);   
40.         MessageConsumer replyComsumer = session2.createConsumer(replyQueue);   
41.         replyComsumer.setMessageListener(   
42.             new MessageListener() {   
43.                 public void onMessage(Message m) {   
44.                     try {   
45.                         System.out.println("Get reply: " + ((TextMessage) m).getText());   
46.                     } catch (JMSException e) {   
47.                     }   
48.                 }   
49.             });   
50.         MessageProducer producer = session.createProducer(queue);   
51.         TextMessage message = session.createTextMessage("SimpleMessage");   
52.         message.setJMSReplyTo(replyQueue);   
53.         producer.send(message);   
54.     }   
55. }  

 

运行结果为：
Get Message: SimpleMessage
Get reply: ReplyMessage
如果将：
Session session2 = connection.createSession(true, Session.AUTO_ACKNOWLEDGE);
更改为：
Connection connection2 = factory.createConnection();
Session session2 = connection2.createSession(true, Session.AUTO_ACKNOWLEDGE);
就会得到类似于下面的异常：
Exception in thread "main" javax.jms.InvalidDestinationException: Cannot use a Temporary destination from another Connection。

 

12. MDB  

 

在EJB3中，一个MDB（消息驱动Bean）就是一个实现了MessageListener接口的POJO。下面就是一个简单的MDB。

Java代码

 

1. @MessageDriven(activationConfig={    
2.                     @ActivationConfigProperty(propertyName="destinationType",    
3.                             propertyValue="javax.jms.Queue"),    
4.                     @ActivationConfigProperty(propertyName="destination",    
5.                             propertyValue="queue/testQueue")})    
6.             public class SimpleMDB implements MessageListener {    
7.                 public void onMessage(Message message) {    
8.                     try {    
9.                         System.out.println("Receive Message : " +    
10.             ((TextMessage)message).getText());    
11.                     } catch (JMSException e) {    
12.                         e.printStackTrace();    
13.                     }    
14.                 }    
15.             }   

Java代码

 

1. @MessageDriven(mappedName = "Test-Topic",   
2.     activationConfig = {   
3. //        @ActivationConfigProperty(propertyName = "MessageType",   
4. //            propertyValue = "INTF"),   
5.         @ActivationConfigProperty(propertyName = "acknowledgeMode",   
6.             propertyValue = "Auto-acknowledge"),   
7.         @ActivationConfigProperty(propertyName = "destinationType",   
8.             propertyValue = "javax.jms.Queue")   
9.     })   
10. @TransactionManagement(TransactionManagementType.BEAN)  

 

它要求必须标注为@MessageDriven。它所监听Destination通过标注属性来注入。

            下面是一个发送消息的StatelessBean：

Java代码

 

1. @Remote    
2.             public interface IMessageSender {    
3.                 public void sendMessage(String content) throws Exception;    
4.             }    
5.   
6.             @Stateless    
7.             @Remote    
8.             public class MessageSender implements IMessageSender {    
9.                 @Resource(mappedName="ConnectionFactory")    
10.                 private ConnectionFactory factory;    
11.                 @Resource(mappedName="queue/testQueue")    
12.                 private Queue queue;    
13.                 public void sendMessage(String content) throws Exception {    
14.                     Connection cn = factory.createConnection();    
15.                     Session session = cn.createSession(false,    
16.             Session.AUTO_ACKNOWLEDGE);    
17.                     MessageProducer producer = session.createProducer(queue);    
18.                     producer.send(session.createTextMessage(content));    
19.                 }    
20.             }   

 

这个EJB只有一个方法SendMessage。ConnectionFactory和Queue通过标注注入。

            接下来是客户端： 

 

Java代码

 

1. public class MessageSenderClient {    
2.                public static void main(String[] args) throws Exception {    
3.                    Properties props = new Properties();    
4.                    props.setProperty(Context.INITIAL_CONTEXT_FACTORY,    
5.            "org.jnp.interfaces.NamingContextFactory");    
6.                    props.setProperty(Context.PROVIDER_URL, "localhost:2099");    
7.                    Context context = new InitialContext(props);    
8.                    IMessageSender messageSender = (IMessageSender)    
9.            context.lookup("MessageSender/remote");    
10.                    messageSender.sendMessage("Hello");    
11.                }    
12.            }   

 

它通过JNDI查找到上面的EJB，然后调用sengMessage.