【RabbitMQ】Topics 通配符模式（使用案例）

Albert Edison2026-04-20 8:27

文章目录

  • [1. Topics（通配符模式）](#1. Topics（通配符模式）)
  • [2. 引入依赖](#2. 引入依赖)
  • [3. 生产者代码编写](#3. 生产者代码编写)
    • [3.1 创建交换机](#3.1 创建交换机)
    • [3.2 声明队列](#3.2 声明队列)
    • [3.3 绑定交换机和队列](#3.3 绑定交换机和队列)
    • [3.4 发送消息](#3.4 发送消息)
    • [3.5 完整代码](#3.5 完整代码)
  • [4. 消费者代码编写](#4. 消费者代码编写)
    • [4.1 消费者一](#4.1 消费者一)
    • [4.2 消费者二](#4.2 消费者二)
  • [5. 运行程序](#5. 运行程序)

1. Topics（通配符模式）

Topics 和 Routing 模式的区别是：

  • topics 模式使用的交换机类型为 topic（Routing 模式使用的交换机类型为 direct）
  • topic 类型的交换机在匹配规则上进行了扩展，Binding Key 支持通配符匹配（direct 类型的交换机路由规则是 BindingKey 和 RoutingKey 完全匹配）。

在 topic 类型的交换机在匹配规则上，有些要求：

  • RoutingKey 是一系列由点 . 分隔的单词，比如 "stock.usd.nyse"，"nyse.vmw"，"quick.orange.rabbit" 等
  • BindingKey 和 RoutingKey 一样，也是点 . 分割的字符串。
  • Binding Key 中可以存在两种特殊字符串，用于模糊匹配
    • * 表示一个单词
    • # 表示多个单词（0-N个）

如下所示：

比如：

  • Binding Key 为 "d.a.b" 会同时路由到 Q1 和 Q2
  • Binding Key 为 "d.a.f" 会路由到 Q1
  • Binding Key 为 "c.e.f" 会路由到 Q2
  • Binding Key 为 "d.b.f" 会被丢弃，或者返回给生产者（需要设置 mandatory 参数）

接下来我们看看 Topic 模式的实现，步骤：

  • 1、引入依赖
  • 2、编写生产者代码
  • 3、编写消费者代码

2. 引入依赖

先引入 rabbitmq 的依赖

xml 复制代码 
<!-- Source: https://mvnrepository.com/artifact/com.rabbitmq/amqp-client -->
<dependency>
    <groupId>com.rabbitmq</groupId>
    <artifactId>amqp-client</artifactId>
    <version>5.20.0</version>
    <scope>compile</scope>
</dependency>

3. 生产者代码编写

和路由模式，发布订阅模式的区别是：交换机类型不同，绑定队列的 Routing Key 不同

那么先去 Constants.java 里面定义交换机和队列。

java 复制代码 
// 通配符模式
public static final String TOPIC_EXCHANGE = "topic.exchange";
public static final String TOPIC_QUEUE1 = "topic.queue1";
public static final String TOPIC_QUEUE2 = "topic.queue2";

3.1 创建交换机

定义交换机类型为 BuiltinExchangeType.TOPIC，代码如下所示：

java 复制代码 
channel.exchangeDeclare(Constants.TOPIC_EXCHANGE, BuiltinExchangeType.TOPIC, true);

3.2 声明队列

代码如下所示：

java 复制代码 
channel.queueDeclare(Constants.TOPIC_QUEUE1, true, false, false, null);
channel.queueDeclare(Constants.TOPIC_QUEUE2, true, false, false, null);

3.3 绑定交换机和队列

代码如下所示：

java 复制代码 
// 5. 绑定队列和交换机
channel.queueBind(Constants.TOPIC_QUEUE1, Constants.TOPIC_EXCHANGE, "*.a.*");
channel.queueBind(Constants.TOPIC_QUEUE2, Constants.TOPIC_EXCHANGE, "*.*.b");
channel.queueBind(Constants.TOPIC_QUEUE2, Constants.TOPIC_EXCHANGE, "c.#");

直接按照下图来进行设定：

3.4 发送消息

还是老样子，发送消息和上面的图要对应起来。

java 复制代码 
String msg = "Hello topic, my routing key is : ae.a.f";
channel.basicPublish(Constants.TOPIC_EXCHANGE, "ae.a.f",null, msg.getBytes()); // 转发到Q1

String msg_b = "Hello topic, my routing key is : ef.a.b";
channel.basicPublish(Constants.TOPIC_EXCHANGE, "ef.a.b",null, msg_b.getBytes()); // 转发到Q1和Q2

String msg_c = "Hello topic, my routing key is : c.ef.d";
channel.basicPublish(Constants.TOPIC_EXCHANGE, "c.ef.d",null, msg_c.getBytes()); // 转发到Q2

System.out.println("消息发送成功");

3.5 完整代码

代码如下所示：

java 复制代码 
package topic;

import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import constant.Constants;

import java.io.IOException;
import java.util.concurrent.TimeoutException;

public class Producer {
    public static void main(String[] args) throws IOException, TimeoutException {
        // 1. 建立连接
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost(Constants.HOST);   // MQ所在的服务器地址
        factory.setPort(Constants.PORT);            // 端口号
        factory.setUsername(Constants.USERNAME);    // 账号
        factory.setPassword(Constants.PASSWORD);    // 密码
        factory.setVirtualHost(Constants.VIRTUAL_HOST);      // 虚拟主机
        Connection connection = factory.newConnection();

        // 2. 开启 channel 通道
        Channel channel = connection.createChannel();

        // 3. 声明交换机（使用内置的交换机即可）
        channel.exchangeDeclare(Constants.TOPIC_EXCHANGE, BuiltinExchangeType.TOPIC, true);

        // 4. 声明队列
        channel.queueDeclare(Constants.TOPIC_QUEUE1, true, false, false, null);
        channel.queueDeclare(Constants.TOPIC_QUEUE2, true, false, false, null);

        // 5. 绑定队列和交换机
        channel.queueBind(Constants.TOPIC_QUEUE1, Constants.TOPIC_EXCHANGE, "*.a.*");
        channel.queueBind(Constants.TOPIC_QUEUE2, Constants.TOPIC_EXCHANGE, "*.*.b");
        channel.queueBind(Constants.TOPIC_QUEUE2, Constants.TOPIC_EXCHANGE, "c.#");

        // 6. 发送消息
        String msg = "Hello topic, my routing key is : ae.a.f";
        channel.basicPublish(Constants.TOPIC_EXCHANGE, "ae.a.f",null, msg.getBytes()); // 转发到Q1

        String msg_b = "Hello topic, my routing key is : ef.a.b";
        channel.basicPublish(Constants.TOPIC_EXCHANGE, "ef.a.b",null, msg_b.getBytes()); // 转发到Q1和Q2

        String msg_c = "Hello topic, my routing key is : c.ef.d";
        channel.basicPublish(Constants.TOPIC_EXCHANGE, "c.ef.d",null, msg_c.getBytes()); // 转发到Q2

        System.out.println("消息发送成功");

        // 7. 资源释放
        channel.close();
        connection.close();
    }
}

4. 消费者代码编写

Topic 模式的消费者代码 和 Routing 模式代码一样，同样复制出来两份，然后修改消费的队列名称就可以了。

4.1 消费者一

代码如下所示：

java 复制代码 
package topic;

import com.rabbitmq.client.*;
import constant.Constants;

import java.io.IOException;
import java.util.concurrent.TimeoutException;

public class Consumer1 {
    public static void main(String[] args) throws IOException, TimeoutException {
        // 1. 建立连接
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost(Constants.HOST);   // MQ所在的服务器地址
        factory.setPort(Constants.PORT);            // 端口号
        factory.setUsername(Constants.USERNAME);    // 账号
        factory.setPassword(Constants.PASSWORD);    // 密码
        factory.setVirtualHost(Constants.VIRTUAL_HOST);      // 虚拟主机
        Connection connection = factory.newConnection();

        // 2. 开启 channel 通道
        Channel channel = connection.createChannel();

        // 3. 声明队列
        channel.queueDeclare(Constants.TOPIC_QUEUE1, true, false, false, null);

        // 4. 接收消息并消费
        DefaultConsumer consumer = new DefaultConsumer(channel) {
            // 从队列中收到消息后, 就会执行的方法
            @Override
            public void handleDelivery(String consumerTag, Envelope envelope, AMQP.BasicProperties properties, byte[] body) throws IOException {
                // 收到消息以后就进行打印
                System.out.println("接收到消息: " + new String(body));
            }
        };
        channel.basicConsume(Constants.TOPIC_QUEUE1, true, consumer);

        // 5. 不需要释放资源
    }
}

4.2 消费者二

代码如下所示：

java 复制代码 
package topic;

import com.rabbitmq.client.*;
import constant.Constants;

import java.io.IOException;
import java.util.concurrent.TimeoutException;

public class Consumer2 {
    public static void main(String[] args) throws IOException, TimeoutException {
        // 1. 建立连接
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost(Constants.HOST);   // MQ所在的服务器地址
        factory.setPort(Constants.PORT);            // 端口号
        factory.setUsername(Constants.USERNAME);    // 账号
        factory.setPassword(Constants.PASSWORD);    // 密码
        factory.setVirtualHost(Constants.VIRTUAL_HOST);      // 虚拟主机
        Connection connection = factory.newConnection();

        // 2. 开启 channel 通道
        Channel channel = connection.createChannel();

        // 3. 声明队列
        channel.queueDeclare(Constants.TOPIC_QUEUE2, true, false, false, null);

        // 4. 接收消息并消费
        DefaultConsumer consumer = new DefaultConsumer(channel) {
            // 从队列中收到消息后, 就会执行的方法
            @Override
            public void handleDelivery(String consumerTag, Envelope envelope, AMQP.BasicProperties properties, byte[] body) throws IOException {
                // 收到消息以后就进行打印
                System.out.println("接收到消息: " + new String(body));
            }
        };
        channel.basicConsume(Constants.TOPIC_QUEUE2, true, consumer);

        // 5. 不需要释放资源
    }
}

5. 运行程序

先运行生产者代码

可以看到 topic.queue1 队列中，路由了两条消息。topic.queue2 队列中，路由了两条消息

exchange 下队列和 Routing Key 的绑定关系，如下所示：

对应图如下所示：

然后运行 Consumer1 消费者代码：

运行 Consumer2 消费者代码：

同时可以看到，队列中的消息已经被全部给消费完了

相关推荐
原来是猿10 小时前
服务端高并发分布式结构演进之路
分布式
LoneEon12 小时前
Kafka集群搭建指南：KRaft模式彻底摒弃Zookeeper
分布式·kafka·centos
薪火铺子12 小时前
分布式锁深度实战：从 Redis 到 Zookeeper 深度解析
redis·分布式·zookeeper
学习中.........12 小时前
高并发架构下的 Kafka 与消息队列核心机制
分布式·kafka
Han.miracle12 小时前
分布式部署项目
分布式
努力努力再努力wz12 小时前
【Redis 入门系列】为什么需要 Redis？一文串起缓存、分布式、读写分离、分库分表与微服务
数据库·redis·分布式·sql·mysql·缓存·微服务
逆境不可逃12 小时前
黑马 RabbitMq 基础篇 学习记录
学习·rabbitmq·ruby
番茄去哪了13 小时前
单体转微服务：微服务保护和分布式事务（上）
分布式·微服务·架构
念何架构之路13 小时前
分布式详解
分布式
Elastic 中国社区官方博客13 小时前
将 Logstash Pipeline 从 Azure Event Hubs 迁移到 OTel Collector Kafka Receiver
大数据·数据库·人工智能·分布式·elasticsearch·搜索引擎·kafka
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03CC-Switch & Claude 基于 Linux 服务器安装使用指南04零基础教你claude code 接入 deepseek V405【AI】2026 年具身智能模型和世界模型总结06要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法07Windows端Codex接入第三方模型（DeekSeek，BaiLian)08裂开！ChatGPT 居然开始要手机号验证，附详细解决方法09Cursor 接入 DeepSeek‑V4‑Pro 完整指南（2026 实测）10codex app每次打开重连5次Reconnecting问题解决