消息队列 / 系统课时
创建基础消费者
创建基础消费者
本节实现一个能够持续监听队列的 Java 消费者,并通过一次自包含测试触发回调。重点不是“把消息打印出来”,而是理解订阅注册、consumerTag、回调线程和进程持续存活之间的关系。
学习目标
- 使用
basicConsume注册一个持续消费者 - 区分 consumerTag、消息内容与回调函数的职责
- 解释为什么消费者注册成功后主进程仍不能立即退出
注册消费者并保持监听
以下示例仍使用 hello.queue。为了让代码单独运行也能看到回调效果,程序在消费者注册完成后向同一队列发送一条测试消息;真实系统中,消息通常来自独立生产者。
import com.rabbitmq.client.CancelCallback;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DeliverCallback;
import java.nio.charset.StandardCharsets;
import java.util.concurrent.CountDownLatch;
public class BasicConsumer {
private static final String QUEUE = "hello.queue";
public static void main(String[] args) throws Exception {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
factory.setPort(5672);
factory.setUsername("guest");
factory.setPassword("guest");
try (Connection connection = factory.newConnection();
Channel channel = connection.createChannel()) {
channel.queueDeclare(QUEUE, true, false, false, null);
DeliverCallback onMessage = (consumerTag, delivery) -> {
String message = new String(
delivery.getBody(),
StandardCharsets.UTF_8
);
System.out.printf(
"received by %s: %s%n",
consumerTag,
message
);
};
CancelCallback onCancel = consumerTag ->
System.out.println("consumer cancelled: " + consumerTag);
// autoAck=true 便于先理解回调,可靠消费时应改为手动确认。
String consumerTag = channel.basicConsume(
QUEUE,
true,
onMessage,
onCancel
);
System.out.println("consumer started, tag=" + consumerTag);
// 仅用于让本示例独立验证回调是否工作。
channel.basicPublish(
"",
QUEUE,
null,
"hello consumer".getBytes(StandardCharsets.UTF_8)
);
new CountDownLatch(1).await();
}
}
}预期输出
consumer started, tag=<ID>
received by <ID>: hello consumer<ID> 是 RabbitMQ 为本次订阅返回的 consumerTag,实际值每次可能不同。由于程序在最后等待,连接和信道会保持打开,消费者才能继续接收之后到达的消息。

consumerTag 与两个回调分别表示什么
basicConsume 返回的 consumerTag 是一次消费者订阅的标识,不是消息 ID。应用需要主动取消订阅时,可以把这个 tag 传给 basicCancel;日志中保留它,也能帮助区分同一队列上的多个消费者实例。
DeliverCallback 在消息送达时执行,参数中可以取得消息体、属性和投递元数据。CancelCallback 则处理服务端取消订阅等情况,例如队列被删除。两者承担的是不同事件,不能把取消回调当成普通异常处理器。
为什么主线程不能直接结束
basicConsume 完成的是“注册消费者”,它会很快返回 consumerTag,之后真正的消息处理由客户端内部线程异步触发。如果 main 方法马上结束并关闭 Connection,Broker 会认为这个消费者已经离线,后续消息自然不会再触发回调。
示例用 CountDownLatch(1).await() 让主线程持续等待,因此 try 代码块不会结束,连接和信道也不会被自动关闭。服务程序里通常由应用容器或进程生命周期承担这件事,而不是人为写一个无限循环去轮询队列。
自动确认适合什么范围
示例把 autoAck 设为 true,Broker 在投递后就认为消息已经完成确认。这样最容易观察回调机制,但如果回调处理到一半进程崩溃,消息可能已经从“待处理”状态消失,无法重新投递。
基础消费者的关键心智模型是:basicConsume 创建一条持续订阅关系,consumerTag 标识这条关系,消息到达后由回调处理,而连接和进程必须保持存活,订阅才会持续有效。