AMQ学习笔记 - 02. JMS客户端编程模型

概述

---

客户端编程模型，是讲如何使用JMS API实现Java应用程序和JMS Provider的通信。

消息传送模式

---

消息传送模式又称为消息传送域，JMS API定义了两种模式：PTP和Pub/Sub。

PTP

全称：Point-to-Point 中文：点对点

上图描述了这样的内容：Sender发送Message到代理维护的Queue，然后Receiver可以从这个Queue中获取这个Message。

这个模式的特点是：

1. 一个Message只能交给一个Receiver；这里的Message像是一个消耗品。
2. 只要Queue中有Message，Receiver就能获取到。

Pub/Sub

全称：Publish/Subscribe 中文：发布/订阅

上图描述了这样的内容：Publisher发布Message到代理维护的Topic，Subscriber从代理那里订阅的Topic，从而可以获取对应的Message。

这个模式的特点是：

1. 一个Message可以复制多份，交给多个Subscriber。
2. 先订阅，再获取 - Subscriber只能获取订阅之后发送到Topic的Message。

角色定位

MOM包含四个基本元素：消息传递提供者、目的地、客户端（发送方或接收方）、消息。上述两种模式在MOM中的角色定位，可以表现为：

JMS API

---

JavaEE提供的javax.jms包中，涵盖了JMS的API。

统一域和特定于域的API

早期的规范中，PTP和Pub/Sub各有不同的接口体系，后来的JMS1.1在两个接口体系的上层，又定义了一层统一的接口体系，称为统一域的API；而之前的两套接口体系，称为特定于域的API。对比情况如下：

注意：JMS当然不是只提供了上述的接口。上述接口，只是在统一之后，有对比意义的接口。

编程模型

说明：连接工厂、目的地通常作为受管理对象来创建、配置、管理，驻留在对象存储库中；客户端程序通过JNDI查找获取对象，而不建议显示的创建。所以连接工厂、目的地在上图的表示有所不同。

对象简介

• 连接工厂（ConnectionFactory)
  客户端使用连接工厂对象(ConnectionFactory)创建连接。
• 连接（Connection）
  连接对象 (Connection) 表示客户端与代理之间的活动连接。创建连接时会分配通信资源并对客户端进行验证。这是一个相当重要的对象，大多数客户端均使用一个连接来完成所有的消息传送。连接支持并发使用：一个连接可由任意数量的生成方和使用方共享。
• 会话（Session）
  如果连接代表客户端与代理之间的通信渠道，则会话标记客户端与代理之间的单次对话。会话对象主要用于创建消息、消息生成方和消息使用方。
• 消息（Message）
  消息封装一次通信的内容。消息由三部分组成：消息头、属性和主体。
• 消息生成方（MessageProducer）
  由Session创建，负责发送Message到目的地。
• 消息使用方（MessageConsumer）
  由Session创建，负责从目的地中消费Message。
• 目的地（Destination）
  JMS Provider负责维护，用于对Message进行管理的对象。MessageProducer需要指定Destination才能发送消息，MessageReceiver需要指定Destination才能接收消息。

demo

---

将上文的客户端编程模型应用起来。两个客户端：producer-client负责发送消息到ActiveMQ；consumer-client负责从ActiveMQ中获取消息。

在此之前，你需要下载ActiveMQ，并确保成功启动。

下载：不同的版本对JDK版本的要求不同，当前最新稳定版本是5.13.2，要求JDK1.7以上。

安装：直接解压缩

启动：(1) 在cmd窗口，切换到解压缩的路径；(2) bin\activemq start^[1]

确认：ActiveMQ提供了监控器，访问http://localhost:8161/admin，默认账号：admin/admin。可以访问，表示启动成功。

 

补充：

[1] 在启动的时候可能会遇到下面的错误

Error occurred during initialization of VM
Could not reserve enough space for object heap
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

修改bin\activemq.bat文件：

if "%ACTIVEMQ_OPTS%" == "" set ACTIVEMQ_OPTS=-Xms1G -Xmx1G

将Xms和Xmx适当调小，如256M。

1.producer-client

基于Maven的simple project。你可以在jms-producer拿到源代码。

文件目录结构

pom.xml
src/main/resources/
    |---- jndi.properties
src/main/java/
    |---- cn.sinobest.asj.producer.jms.clientmode
              |---- SimpleProducer.java # 基于客户端编程模型，发送消息给ActiveMQ

文件内容

1.pom.xml

 <project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>cn.sinobest.asj</groupId>
     <artifactId>jms-producer</artifactId>
     <version>0.0.1-SNAPSHOT</version>
     <name>jms-producer</name>
     <description>基于ActiveMQ的Producer Client。</description>
     <dependencies>
         <!-- import activemq-client to send message to ActiveMQ -->
         <dependency>
             <groupId>org.apache.activemq</groupId>
             <artifactId>activemq-client</artifactId>
             <version>5.13.2</version>
         </dependency>
         <!-- not necessary, import to remove the warn message from activemq-client -->
         <dependency>
             <groupId>org.slf4j</groupId>
             <artifactId>slf4j-simple</artifactId>
             <version>1.7.19</version>
         </dependency>
     </dependencies>
 </project>

2.jndi.properties

 java.naming.factory.initial=org.apache.activemq.jndi.ActiveMQInitialContextFactory

 # use the following property to configure the default connector
 java.naming.provider.url=tcp://localhost:61616

 # register some queues in JNDI using the form
 # queue.[jndiName] = [physicalName]
 queue.exampleQueue=example.queue

 # register some topics in JNDI using the form
 # topic.[jndiName] = [physicalName]
 topic.exampleTopic = example.topic

说明：

• java.naming.factory.initial
  定义ConnectionFactory的实例化类。
• java.naming.provider.url
  定义broker的url，这个是ActiveMQ默认的url。
• queue.exampleQueue
  定义了一个Queue Destination。name为example.queue，JNDI的name为exampleQueue。
• topic.exampleTopic
  定义了一个Topic Destination。name为example.topic，JNDI的name为exampleTopic。

3.SimpleProcedure.java

 package cn.sinobest.asj.producer.jms.clientmode;
 import javax.jms.Connection;
 import javax.jms.ConnectionFactory;
 import javax.jms.Destination;
 import javax.jms.JMSException;
 import javax.jms.MessageProducer;
 import javax.jms.Session;
 import javax.jms.TextMessage;
 import javax.naming.Context;
 import javax.naming.InitialContext;
 import javax.naming.NamingException;
 /**
  * A simple demo for producer client to send message to ActiveMQ.<br>
  * refer to <a href="http://activemq.apache.org/jndi-support.html">JNDI
  * Support</a>
  *
  * @author lijinlong
  */
 public class SimpleProducer {
     /** JNDI name for ConnectionFactory */
     static final String CONNECTION_FACTORY_JNDI_NAME = "ConnectionFactory";
     /** JNDI name for Queue Destination (use for PTP Mode) */
     static final String QUEUE_JNDI_NAME = "exampleQueue";
     /** JNDI name for Topic Destination (use for Pub/Sub Mode) */
     static final String TOPIC_JNDI_NAME = "exampleTopic";
     /**
      * @param args
      */
     public static void main(String[] args) {
         Context jndiContext = null;
         ConnectionFactory connectionFactory = null;
         Connection connection = null;
         Session session = null;
         Destination destination = null;
         MessageProducer producer = null;
         // create a JNDI API IntialContext object
         try {
             jndiContext = new InitialContext();
         } catch (NamingException e) {
             System.out.println("Could not create JNDI Context:"
                     + e.getMessage());
             System.exit(1);
         }

         // look up ConnectionFactory and Destination
         try {
             connectionFactory = (ConnectionFactory) jndiContext
                     .lookup(CONNECTION_FACTORY_JNDI_NAME);
             // look up QUEUE_JNDI_NAME for PTP Mode
             // look up TOPIC_JNDI_NAME for Pub/Sub Mode
             destination = (Destination) jndiContext.lookup(QUEUE_JNDI_NAME);
         } catch (NamingException e) {
             System.out.println("JNDI look up failed:" + e.getMessage());
             System.exit(1);
         }

         // send Messages and finally release the resources.
         try {
             connection = connectionFactory.createConnection();
             session = connection.createSession(Boolean.FALSE,
                     Session.AUTO_ACKNOWLEDGE);
             producer = session.createProducer(destination);
             TextMessage message = session.createTextMessage();
             for (int i = 0; i < 3; i++) {
                 message.setText(String.format("This is the %dth message.",
                         i + 1));
                 producer.send(message);
             }
         } catch (JMSException e) {
             e.printStackTrace();
         } finally {
             try {
                 if (session != null)
                     session.close();
                 if (connection != null)
                     connection.close();
             } catch (JMSException e) {
                 e.printStackTrace();
             }
         }
     }
 }

SimpleProcedure.java

说明：

1. 第23行声明的JNDI name for ConnectionFactory的值是固定的。
2. 第25行声明的JNDI name for Queue的值，对应于jndi.properties的queue的jndi name。
3. 第27行声明的JNDI name for Topic的值，对应于jndi.properties的topic的jndi name。
4. 第55行look up Destination的实例，参数取QUEUE_JNDI_NAME或TOPIC_JNDI_NAME，分别对应PTP模式和Pub/Sub模式。

2.consumer-client

基于Maven的simple project。你可以在jms-consumer拿到源代码。

文件目录结构

pom.xml
src/main/resources/
    |---- jndi.properties
src/main/java/
    |---- cn.sinobest.asj.consumer.jms.clientmode
              |---- SimpleConsumer.java # 基于客户端编程模型，从ActiveMQ接收消息

文件内容

1.pom.xml

 <project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>cn.sinoebst.asj</groupId>
     <artifactId>jms-consumer</artifactId>
     <version>0.0.1-SNAPSHOT</version>
     <name>jms-consumer</name>
     <description>基于ActiveMQ的Consumer Client。</description>
     <dependencies>
         <!-- import activemq-client to receive message from ActiveMQ -->
         <dependency>
             <groupId>org.apache.activemq</groupId>
             <artifactId>activemq-client</artifactId>
             <version>5.13.2</version>
         </dependency>
         <!-- not necessary, import to remove the warn message from activemq-client -->
         <dependency>
             <groupId>org.slf4j</groupId>
             <artifactId>slf4j-simple</artifactId>
             <version>1.7.19</version>
         </dependency>
     </dependencies>
 </project>

2.jndi.properties

 java.naming.factory.initial=org.apache.activemq.jndi.ActiveMQInitialContextFactory

 # use the following property to configure the default connector
 java.naming.provider.url=tcp://localhost:61616

 # register some queues in JNDI using the form
 # queue.[jndiName] = [physicalName]
 queue.exampleQueue=example.queue

 # register some topics in JNDI using the form
 # topic.[jndiName] = [physicalName]
 topic.exampleTopic = example.topic

3.SimpleConsumer.java

 package cn.sinobest.asj.consumer.jms.clientmode;
 import javax.jms.Connection;
 import javax.jms.ConnectionFactory;
 import javax.jms.Destination;
 import javax.jms.JMSException;
 import javax.jms.Message;
 import javax.jms.MessageConsumer;
 import javax.jms.Session;
 import javax.jms.TextMessage;
 import javax.naming.Context;
 import javax.naming.InitialContext;
 import javax.naming.NamingException;
 /**
  * A simple demo for consumer to receive message from ActiveMQ.<br>
  *
  * @author lijinlong
  *
  */
 public class SimpleConsumer {
     /** JNDI name for ConnectionFactory */
     static final String CONNECTION_FACTORY_JNDI_NAME = "ConnectionFactory";
     /** JNDI name for Queue Destination (use for PTP Mode) */
     static final String QUEUE_JNDI_NAME = "exampleQueue";
     /** JNDI name for Topic Destination (use for Pub/Sub Mode) */
     static final String TOPIC_JNDI_NAME = "exampleTopic";
     /**
      * @param args
      */
     public static void main(String[] args) {
         Context jndiContext = null;
         ConnectionFactory connectionFactory = null;
         Connection connection = null;
         Session session = null;
         Destination destination = null;
         MessageConsumer consumer = null;
         // create a JNDI API IntialContext object
         try {
             jndiContext = new InitialContext();
         } catch (NamingException e) {
             System.out.println("Could not create JNDI Context:"
                     + e.getMessage());
             System.exit(1);
         }
         // look up ConnectionFactory and Destination
         try {
             connectionFactory = (ConnectionFactory) jndiContext
                     .lookup(CONNECTION_FACTORY_JNDI_NAME);
             // look up QUEUE_JNDI_NAME for PTP Mode
             // look up TOPIC_JNDI_NAME for Pub/Sub Mode
             destination = (Destination) jndiContext.lookup(QUEUE_JNDI_NAME);
         } catch (NamingException e) {
             System.out.println("JNDI look up failed:" + e.getMessage());
             System.exit(1);
         }
         // receive Messages and finally release the resources.
         try {
             connection = connectionFactory.createConnection();
             connection.start(); // connection should be called in
                                 // receiver-client
             session = connection.createSession(Boolean.FALSE,
                     Session.AUTO_ACKNOWLEDGE);
             consumer = session.createConsumer(destination);
             long timeout = 10 * 1000;
             for (Message message = consumer.receive(timeout); message != null; message = consumer
                     .receive(timeout)) {
                 String text = ((TextMessage) message).getText();
                 System.out.println(String.format("receive a message:%s", text));
             }
         } catch (JMSException e) {
             e.printStackTrace();
         } finally {
             try {
                 if (session != null)
                     session.close();
                 if (connection != null)
                     connection.close();
             } catch (JMSException e) {
                 e.printStackTrace();
             }
         }
     }
 }

SimpleConsumer.java

说明：在第65行调用了Connection#start方法，否则无法收到消息（目前不明白原因）。

3.测试

3.1.基于PTP Mode测试

1. 确保SimpleProducer和SimpleConsumer中，都是根据QUEUE_JNDI_NAME来look up Destination实例的。
2. 确保ActiveMQ启动正常。
3. 运行SimpleProducer。
4. 运行SimpleConsumer - 看到信息输出。
   

3.2.基于Pub/Sub测试

1. 确保SimpleProducer和SimpleConsumer中，都是根据TOPIC_JNDI_NAME来look up Destination实例的。
2. 确保ActiveMQ启动正常。
3. 运行SimpleConsumer。
   Pub/Sub的其中一个特点是：先订阅，再接收。所以要先运行Consumer。
4. 尽快运行SimpleProducer。
   Consumer设置的timeout是10s，如果10s内没有收到消息就会退出。
5. SimpleConsumer的控制台有输出信息。
   输出内容和PTP的测试结果一致。

4.编程获取ConnectionnFactory和Destination

虽然不建议使用编程的方式获取ConnectionFactory和Destination，但是还是记录一下：

 // 创建工厂实例
 // javax.jms.ConnectionFactory
 // org.apache.activemq.ActiveMQConnectionFactory
 ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(
     ActiveMQConnectionFactory.DEFAULT_USER,
     ActiveMQConnectionFactory.DEFAULT_PASSWORD,
     ActiveMQConnectionFactory.DEFAULT_BROKER_URL);

 // javax.jms.Connection
 Connection connection = connectionFactory.createConnection();
 // javax.jms.Session
 Session session = connection.createSession(Boolean.FALSE, Session.AUTO_ACKNOWLEDGE);

 // 创建目的地
 // javax.jms.Destination
 Destination destination = session.createQueue("example.queue");
 Destination destination = session.createTopic("example.topic");

附录

---

参考

1. Sun Java System Message Queue 3.7 UR1 技术概述 — 第 2 章 客户端编程模型
   大部分理论知识都参考了这里
2. JNDI Support
   如何配置、使用JNDI获取连接工厂实例和目的地实例

来自为知笔记(Wiz)