一、Exchange 交换器
1.1 Exchange Type
生产者将消息投递到交换器,然后交换器再将消息路由到一个或者多个队列中。
RabbitMQ 定义了4种类型的交换器:
- fanout:将消息路由到与之绑定的所有队列中,这种交换器会无视 RoutingKey,类似于子网广播
- direct:将消息路由到 RoutingKey 和 BindingKey 完全匹配的队列中
- topic:将 RoutingKey 和 BindingKey 进行模式匹配,在 topic 模式下 RoutingKey 和 BindingKey 必须是用点号 "." 分隔的字符串,被点号 "." 分隔的每一段称为之单词。在 BindingKey 中,"*" 用来匹配一个单词,"#" 用来匹配零个或多个单词。
- headers:不常用,略过
1.2 Exchange Declare
在使用交换器之前,需要先创建交换器,RabbitMQ 的 Java 客户端提供了 exchangeDeclare()
方法来声明交换器。
Exchange.DeclareOk exchangeDeclare(String exchangeName, String type, boolean durable, boolean autoDelete, boolean internal, Map<String, Object> arguments) throws IOException;
参数说明:
- exchangeName:交换器的名称
- type:交换器类型
- durable:是否为持久化
- autoDelete:是否自动删除
- internal:是否为内部交换器
- arguments:交换器的其它参数列表
返回值:
- Exchange.DeclareOK:表示成功声明了一个交换器
方法重载:
Exchange.DeclareOk exchangeDeclare(String exchangeName, String type) throws IOException;
Exchange.DeclareOk exchangeDeclare(String exchangeName, String type, boolean durable) throws IOException;
Exchange.DeclareOk exchangeDeclare(String exchangeName, String type, boolean durable, boolean autoDelete, Map<String, Object> arguments) throws IOException;
1.3 Exchange Delete
有创建就会有删除,RabbitMQ 的 Java 客户端提供了 exchangeDelete()
方法来删除交换器。
Exchange.DeleteOk exchangeDelete(String exchangeName) throws IOException;
Exchange.DeleteOk exchangeDelete(String exchangeName, boolean isUnused) throws IOException;
参数说明:
- exchangeName:交换器名称
- isUnused:设置是否交换器处于未使用状态下才删除交换器;如果为 true,则只有在交换器处于未使用状态时才能被删除,如果为 false,则交换器会直接被删除
返回值:
- Exchange.DeleteOk:表示成功删除了交换器
1.4 检测交换器是否存在
exchangeDeclarePassive()
方法用来检测交换器是否存在。如果存在,则正常返回;如果不存在,则抛出异常 404 channel exception
Exchange.DeclareOk exchangeDeclarePassive(String exchangeName) throws IOException;
二、Queue 队列
队列在 RabbitMQ 中用来存储消息,队列通过 BindingKey 与 交换器相互绑定。
2.1 Queue Declare
与 exchangeDeclare()
方法相比,queueDeclare()
的重载方法少很多,只有两个重载方法:
// 不带任何参数的 queueDeclare() 方法会创建一个匿名的、非持久化的、排它的、自动删除的队列
Queue.DeclareOk queueDeclare() throws IOException;
Queue.DeclareOk queueDeclare(String queueName, boolean durable, boolean exclusive, boolean autoDelete, Map<String, Object> arguments) throws IOException;
参数说明:
- queueName:队列名称
- durable:是否为持久化
- exclusive:是否为排它的,如果一个队列为排它的,那么这个队列只能对首次声明它的连接可见,其它连接不允许建立同名的排它队列;如果队列是排它的,那么当连接断开时,不管队列是否是持久化的,都会被删除
- autoDelete:是否自动删除
- arguments:队列的其它参数列表
返回值:
- Queue.DeclareOk:表示成功声明了一个队列
2.2 Queue Delete
与交换器一样,队列也可以删除
Queue.DeleteOk queueDelete(String queueName) throws IOException;
Queue.DeleteOk queueDelete(String queueName, boolean isUnused, boolean isEmpty) throws IOException;
参数说明:
- queueName:队列名称
- isUnused:是否在队列处于未使用状态时删除队列
- isEmpty:是否在队列为空时删除队列
返回值:
- Queue.DeleteOk:表示队列删除成功
2.3 检测队列是否存在
Queue.DeclareOk queueDeclarePassive(String queueName) throws IOException;