点对点的消息传递中,目的地被称为队列(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)