ActiveMQ —— Java 连接 ActiveMQ（点对点）

前文

消息中间件 —— 简介

ActiveMQ 下载、安装

点对点的消息传递中，目的地被称为队列（Queue）

点对点消息传递的特点如下：
（1）每个消息只能有一个消费者，类似 1 对 1 的关系，好比个人快递自己领取自己的
（2）消息的生产者和消费者之间 没有时间上的相关性。无论消费者在生产者发送消息的时候是否处于运行状态，消费者都可以提取消息。好比我们的发送短信，发送者发送后不见得接收者会立即收看
（3）消息被消费后队列中 不会再存储，所以消费者 不会消费到已经被消费掉的消息

创建 Maven 工程

关于怎么创建 Maven 工程这里就不详细讲解了，不会的朋友网上找一下

添加相关依赖

<dependency>
  <groupId>org.apache.activemqgroupId>
  <artifactId>activemq-allartifactId>
  <version>5.15.9version>
dependency>
<dependency>
  <groupId>org.apache.xbeangroupId>
  <artifactId>xbean-springartifactId>
  <version>3.16version>
dependency>

消息生产者

package com.java.elasticsearch.activemq;

import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;

/**
 * @author Woo_home
 * @create by 2020/5/2  21:32
 */
public class JmsProduce {

	// 定义 MQ 连接地址
    private static final String ACTIVE_MQ_URL = "tcp://localhost:61616";

	// 定义队列名称
    private static final String QUEUE_NAME = "queue01";

    public static void main(String[] args) throws JMSException {
        // 创建连接工厂
        ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory();
        // 通过连接工厂，获得连接 Connection
        Connection connection = activeMQConnectionFactory.createConnection();
        connection.start();

        // 创建会话
        // 两个参数，第一个叫事务 / 第二个叫签收
        Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);

        // 创建目的地（具体是队列还是主题 Topic）
        Queue queue = session.createQueue(QUEUE_NAME);

        // 创建消息的生产者
        MessageProducer messageProducer = session.createProducer(queue);

        // 通过使用 MessageProducer 生产 3 条消息发送到 MQ 的队列里面
        for (int i = 0; i < 3; i++) {
            // 创建消息
            TextMessage textMessage = session.createTextMessage("msg---" + i);// 理解为一个字符串
            // 通过 MessageProducer 发送给 MQ
            messageProducer.send(textMessage);
        }
        // 关闭资源
        messageProducer.close();
        session.close();
        connection.close();

        System.out.println("****** 消息发布到 MQ 完成 ******");
    }
}

在运行该程序之前我们需要先启动一下 ActiveMQ

访问 http://localhost:8161/admin/，点击 Queues 选项

队列中也是啥也没有

然后我们运行一下上面的程序

控制台已显示成功将消息发送到 MQ 了 http://localhost:8161/admin/queues.jsp

然后我们再次刷新 Queues 界面，已经接收到了 3 条消息

通过该界面不难发现，我们在代码中定义了一个队列名称为 queue01，该界面显示的队列名称就是我们手动设置的

Queues 说明：

	作用	说明
Number Of Pending Messages	等待消费的信息	这个是当前未出队列的数量。公式 = 总接收数 - 总出队列数
Number Of Consumers	消费者数量	消费者端的消费者数量
Messages Enqueued	进队消息数	进入队列的总数量，包括出队列的。这个数量只增不减
Messages Dequeued	出队消息数	可以理解为是消费者消费掉的数量

总结

• 当有一个消息进入这个队列时，等待消费的消息是 1，进入队列的消息是 1
• 当消息消费后，等待消费的消息是 0，进入队列的消息是 1，出队列的消息是 1
• 再来一条消息时，等待消费的消息是 1，进入队列的消息就是 2

消息消费者

package com.java.elasticsearch.activemq;

import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;

/**
 * @author Woo_home
 * @create by 2020/5/3  0:51
 */
public class JmsConsumer {

    // 定义 MQ 连接地址
    private static final String ACTIVE_MQ_URL = "tcp://localhost:61616";

    // 定义队列名称
    private static final String QUEUE_NAME = "queue01";

    public static void main(String[] args) throws JMSException {
        // 1、创建连接工厂
        ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory();
        // 2、通过连接工厂，获得连接 Connection
        Connection connection = activeMQConnectionFactory.createConnection();
        connection.start();

        ///3、创建会话
        // 两个参数，第一个叫事务 / 第二个叫签收
        Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);

        // 4、创建目的地（具体是队列还是主题 Topic）
        Queue queue = session.createQueue(QUEUE_NAME);

        // 5、创建消费者
        MessageConsumer messageConsumer = session.createConsumer(queue);
        while (true) {
        	// 同步阻塞方式（receive）
            // 因为消息生产者是 TextMessage，所以这里需要转换一下
            TextMessage textMessage = (TextMessage) messageConsumer.receive();
            if (null != textMessage) {
                System.out.println("****** 消费者接收到消息 ******:" + textMessage.getText());
            } else {
                break;
            }
        }
        // 关闭资源
        messageConsumer.close();
        session.close();
        connection.close();
    }
}

在运行消费端代码之前，再观察一下该界面 http://localhost:8161/admin/queues.jsp

此时有 3 条消息等待被消费，然后我们运行一下消费端代码

控制台输出，消费端已经接收到生产者的消息

然后在看下 Queues 界面 http://localhost:8161/admin/queues.jsp

此时消息已经出队 3 条，有一个消费者

消息消费者 receive() 方法说明

在上面的代码中有一个 receive 方法，会一直在等待

在 Queues 界面中也会显示有一个客户一直在消费

这是因为 receive 默认是一直等待的，还有一个 receive(timeout) 是可以设置时间的

如下：

// 只会等待 4 s
TextMessage textMessage = (TextMessage) messageConsumer.receive(4000L);

消息消费者 MessageListener 方法说明

package com.java.elasticsearch.activemq;

import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;
import java.io.IOException;

/**
 * @author Woo_home
 * @create by 2020/5/3  0:51
 */
public class JmsConsumer {

    // 定义 MQ 连接地址
    private static final String ACTIVE_MQ_URL = "tcp://localhost:61616";

    // 定义队列名称
    private static final String QUEUE_NAME = "queue01";

    public static void main(String[] args) throws JMSException, IOException {
        // 1、创建连接工厂
        ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory();
        // 2、通过连接工厂，获得连接 Connection
        Connection connection = activeMQConnectionFactory.createConnection();
        connection.start();

        ///3、创建会话
        // 两个参数，第一个叫事务 / 第二个叫签收
        Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);

        // 4、创建目的地（具体是队列还是主题 Topic）
        Queue queue = session.createQueue(QUEUE_NAME);

        // 5、创建消费者
        MessageConsumer messageConsumer = session.createConsumer(queue);

        // 通过监听的方式来消费消息 MessageConsumer messageConsumer = session.createConsumer(queue)
        messageConsumer.setMessageListener(new MessageListener() {
            @Override
            public void onMessage(Message message) {
                if (null != message && message instanceof TextMessage) {
                    TextMessage textMessage = (TextMessage) message;
                    try {
                        System.out.println("****** 消费者接收到消息 ****** ：" + textMessage.getText());
                    } catch (JMSException e) {
                        e.printStackTrace();
                    }
                }
            }
        });
        System.in.read();
        // 关闭资源
        messageConsumer.close();
        session.close();
        connection.close();
    }
}

使用 MessageListener 的作用是有消息就消费，没消息就等待

总结

两种消费方式

同步阻塞方式（receive()）

订阅者或者接收者调用 MessageConsumer 的 receive() 方法来接收消息，receive 方法在能够接收到消息之前（或者超时之前）将一直阻塞

异步非阻塞方式（监听器 onMessage()）

订阅者或接收者通过 MessageConsumer 的 setMessageListener(MessageListener listener) 注册一个消息监听器

当消息到达之后，系统自动调用监听器 MessageListener 的 onMessage(Message message)