点对点的消息传递中,目的地被称为队列(Queue)
点对点消息传递的特点如下:
(1)每个消息只能有一个消费者,类似 1 对 1 的关系,好比个人快递自己领取自己的
(2)消息的生产者和消费者之间 没有时间上的相关性。无论消费者在生产者发送消息的时候是否处于运行状态,消费者都可以提取消息。好比我们的发送短信,发送者发送后不见得接收者会立即收看
(3)消息被消费后队列中 不会再存储,所以消费者 不会消费到已经被消费掉的消息
创建 Maven 工程
关于怎么创建 Maven 工程这里就不详细讲解了,不会的朋友网上找一下
添加相关依赖
<!-- https://mvnrepository.com/artifact/org.springframework/spring-jms -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jms</artifactId>
<version>5.0.3.RELEASE</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.apache.activemq/activemq-all -->
<dependency>
<groupId>org.apache.activemq</groupId>
<artifactId>activemq-all</artifactId>
<version>5.16.3</version>
</dependency>
消息生产者
package com.jms.service.test;
import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;
public class JmsProduce {
/**
* 定义 MQ 连接地址
*/
private static final String ACTIVE_MQ_URL = "tcp://localhost:61616";
/**
* 定义队列名称
*/
private static final String QUEUE_NAME = "queue_01";
public static void main(String[] args) throws JMSException {
//创建连接工厂
ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(ACTIVE_MQ_URL);
//通过连接工厂,获得连接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://127.0.0.1:8161/admin/queues.jsp
然后我们再次刷新 Queues 界面,已经接收到了 3 条消息
通过该界面不难发现,我们在代码中定义了一个队列名称为 queue_01,该界面显示的队列名称就是我们手动设置的
Queues 说明:
总结
当有一个消息进入这个队列时,等待消费的消息是 1,进入队列的消息是 1
当消息消费后,等待消费的消息是 0,进入队列的消息是 1,出队列的消息是 1
再来一条消息时,等待消费的消息是 1,进入队列的消息就是 2
消息消费者
package com.jms.service.test;
import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;
public class JmsConsumer {
/**
* 定义 MQ 连接地址
*/
private static final String ACTIVE_MQ_URL = "tcp://127.0.0.1:61616";
/**
* 定义队列名称
*/
private static final String QUEUE_NAME = "queue_01";
public static void main (String[] args) throws JMSException {
// 1、创建连接工厂
ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(ACTIVE_MQ_URL);
// 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(4000L);
if (null != textMessage) {
System.out.println ("****** 消费者接收到消息 ******:" + textMessage.getText());
//关闭消费端
if (textMessage.getText().equals("end!")){
break;
}
} else {
break;
}
}
// 关闭资源
messageConsumer.close();
session.close();
connection.close();
}
}
在运行消费端代码之前,再观察一下该界面 http://127.0.0.1:8161/admin/queues.jsp
此时有 3 条消息等待被消费,然后我们运行一下消费端代码
控制台输出,消费端已经接收到生产者的消息
然后再看下 Queues 界面 http://127.0.0.1:8161/admin/queues.jsp
此时消息已经出现 3 条,有一个消费者
消息消费者 receive() 方法说明
在上面的代码中有一个 receive 方法,会一直在等待
在 Queues 界面中也会显示有一个客户一直在消费
这是因为 receive 默认是一直等待的,还有一个 receive(timeout) 是可以设置时间的
如下:
//只会等5s
TextMessage textMessage = (TextMessage) messageConsumer.receive(5000L);
消息消费者 MessageListener 方法说明
package com.jms.service.test;
import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;
import java.io.IOException;
public class JmsMessageListener {
/**
* 定义 MQ 连接地址
*/
private static final String ACTIVE_MQ_URL = "tcp://127.0.0.1:61616";
/**
* 定义队列名称
*/
private static final String QUEUE_NAME = "queue_01";
public static void main (String[] args) throws JMSException, IOException {
// 1、创建连接工厂
ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(ACTIVE_MQ_URL);
// 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 (message != null && 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)