ActiveMQ入门系列二：入门代码实例（点对点模式）

在上一篇《ActiveMQ入门系列一：认识并安装ActiveMQ（Windows下）》中，大致介绍了ActiveMQ和一些概念，并下载、安装、启动他，还访问了他的控制台页面。

这篇，就用代码实例说下如何实现消息的生产和消费。

一、理论基础

同RabbitMQ一样，ActiveMQ中也是有两种模式：

点对点模式（Point to Point，简写为PTP）
发布/订阅模式（Publish & Subscribe，简写为Pub & Sub）

通过上一篇我们知道了制造消息的应用叫生产者（Producer），生产者在生产了消息后会发送消息到目的地（Destination），到达消费和处理消息的应用（也就是消费者Consumer）。这里的两种模式就通过对应不同的消息目的地（Destination）来实现，PTP对应Queue（队列）、Pub&Sub对应Topic（主题）。

今天就详细介绍下PTP和Queue，下一篇介绍Pub & Sub和Topic。

在PTP模式的示意图：

消息生产者生产消息发送到queue中，然后消息消费者从queue中取出并且消费消息。
消息被消费以后，queue中不再有存储，所以消息消费者不可能消费到已经被消费的消息。
Queue支持存在多个消费者，但是对一个消息而言，只会有一个消费者可以消费、其它的则不能消费此消息了。
当消费者不存在时，消息会一直保存，直到有消费消费。

在PTP中，代码实现有两种方式：消费者主动消费和消费者监听消费，下面就分别说下。

二、消费者主动消费

主动消费是最基本也是最简单的消费方式，先上代码：

创建maven工程并引入依赖

<dependency>
      <groupId>org.apache.activemq</groupId>
      <artifactId>activemq-core</artifactId>
      <version>5.7.0</version>
    </dependency>

实现生产者

package com.sam.ptp;

import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;
/**
 * @author JAVA开发老菜鸟
 *
 */
public class Producer {

    public static final  String QUEUE_NAME = "ptp-demo";//队列名

    public void producer(String message) throws JMSException {
        ConnectionFactory factory = null;
        Connection connection = null;
        Session session = null;
        MessageProducer producer = null;
        try {
            /**
             * 1.创建连接工厂
             * 创建工厂，构造方法有三个参数：分别是用户名、密码、连接地址
             * 无参构造：有默认的连接地址，localhost
             * 一个参数：无验证模式，无用户的认证
             * 三个参数：有认证和连接地址，我这里使用三个参数的构造方法
             */
            factory = new ActiveMQConnectionFactory("admin","admin","tcp://localhost:61616");
            /**
             * 2.创建连接，有两个方法（我这里使用无参数的）
             * 无参数
             * 有参数：用户名、密码；
             */
            connection = factory.createConnection();
            /**
             * 3.启动连接
             * 生产者可以不用调用start()方法启动，因为在发送消息的时候回进行检查
             * 如果未启动连接，会自动启动。
             * 如果有特殊配置，需要配置完成后再启动连接
             */
            connection.start();
            /**
             * 4.用连接创建会话
             * 有两个参数：是否需要事务、消息确认机制
             * 如果支持事务，对于生产者来说第二个参数就无效了，这个时候第二个参数建议传入Session.SESSION_TRANSACTED
             * 如果不支持事务，第二个参数有效且必须传递
             *
             * AUTO_ACKNOWLEDGE：自动确认，消息处理后自动确认（商业开发不推荐）
             * CLIENT_ACKNOWLEDGE：客户端手动确认，消费者处理后必须手动确认
             * DUPS_OK_ACKNOWLEDGE：有副本的客户端手动确认，消息可以多次处理（不建议）
             */
            session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
            /**
             * 5.用会话创建目的地（队列）、生产者、消息
             * 队列名是队列的唯一标记
             * 创建生产者的时候可以指定目的地，也可以在发送消息的时候再指定
             */
            Destination destination = session.createQueue(QUEUE_NAME);
            producer = session.createProducer(destination);
            TextMessage textMessage = session.createTextMessage(message);
            /**
             * 6.生产者发送消息到目的地
             */
            producer.send(textMessage);
            System.out.println("消息发送成功");
        } catch(Exception ex){
            throw ex;
        } finally {
            /**
             * 7.释放资源
             */
            if(producer != null){
                producer.close();
            }

            if(session != null){
                session.close();
            }

            if(connection != null){
                connection.close();
            }
        }
    }

    public static void main(String[] args){
        Producer producer = new Producer();
        try{
            producer.producer("hello, activemq");
        } catch (Exception ex){
            ex.printStackTrace();
        }
    }
}

实现消费者

package com.sam.ptp;

import org.apache.activemq.ActiveMQConnectionFactory;

import javax.jms.*;

/**
 * @author JAVA开发老菜鸟
 *
 * 主动消费
 */
public class Consumer {

    public String consumer() throws JMSException {
        ConnectionFactory factory = null;
        Connection connection = null;
        Session session = null;
        MessageConsumer consumer = null;
        try {
            factory = new ActiveMQConnectionFactory("admin","admin","tcp://localhost:61616");
            connection = factory.createConnection();
            /**
             * 消费者必须启动连接，否则无法消费
             */
            connection.start();
            session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
            Destination destination = session.createQueue(Producer.QUEUE_NAME);
            consumer = session.createConsumer(destination);
            /**
             * 获取队列消息
             */
            Message message = consumer.receive();
            String text = ((TextMessage) message).getText();
            return text;
        } catch(Exception ex){
            throw ex;
        } finally {
            /**
             * 7.释放资源
             */
            if(consumer != null){
                consumer.close();
            }
            
            if(session != null){
                session.close();
            }

            if(connection != null){
                connection.close();
            }
        }
    }

    public static void main(String[] args){
        Consumer consumer = new Consumer();
        try{
            String message = consumer.consumer();
            System.out.println("消息消费成功：" + message);
        } catch (Exception ex){
            ex.printStackTrace();
        }
    }
}

好，这样代码就写好了，我们来测试下。

1.先运行生产者，我发现报错了。。。

好吧，原来是我这次没有启动ActiveMQ，被自己蠢哭了。。。

启动ActiveMQ之后，再运行生产者，成功了。

去看下控制台页面的变化，队列里面多了个“ptp-demo”队列，这个就是我们生产者代码里面的队列名，并且能看到该队列的基本情况：

从左到右依次为，有待消费的消息1条、消费者0个、已经发送的消息1条、已经消费的消息0条

2.接下来运行消费者，成功

再去看下控制台页面，发现队列信息变了，从左到右依次为：有待消费的消息0条、消费者0个、已经发送的消息1条、已经消费的消息1条

也就是说，消息真的被消费了！

代码写完了，也按照预期执行完了，我们现在再回过头来分析下消费者的代码，会发现他在consumer.receive()之后不会再消费其他消息了，即便后面再有消息被生产出来也不会再消费。也就是说只能在运行后消费一次消息，这个就是主动消费。

如果想要循环消费多次产生的消息的话，怎么办呢？请用下面的监听消费

三、消费者监听消费

还是先上代码，代码结构同主动消费类似，有细微差别，具体代码不贴了，可以到我的GitHub或码云上获取源码

首先为了区分，我把队列名改了

public static final  String QUEUE_NAME = "ptp-listener-demo";//队列名

生产者和消费者的消息确认方式都改成了客户端手动确认，不再自动确认，手动确认有个好处就是可以防止消息没有被正常消费而丢失，这个同RabbitMQ机制一样
```
session = connection.createSession(false, Session.CLIENT_ACKNOWLEDGE);
```

生产者生产消息的时候，为了方便我改成了一次性发送10条

/**
             * 6.创建消息并且生产者发送消息到目的地
             */
            for(int num = 0; num < 10; num++){
                TextMessage textMessage = session.createTextMessage(message + num);
                producer.send(textMessage);
                System.out.println("消息发送成功"+textMessage.getText());
            }

关键点来了，在消费者上加了一个监听器

 /**
             * 注册监听器，队列中的消息变化会自动触发监听器，接收并自动处理消息
             *
             * 监听器一旦注册，永久有效，一直到程序关闭
             * 监听器可以注册多个，相当于集群
             * activemq自动轮询多个监听器，实现并行处理
             */
            consumer.setMessageListener(new MessageListener() {
                @Override
                public void onMessage(Message message) {

                    try {
                        //需要手动确认消息
                        message.acknowledge();
                        TextMessage om = (TextMessage) message;
                        String data = om.getText();
                        System.out.println(data);
                    } catch (JMSException e) {
                        e.printStackTrace();
                    }
                }
            });