Rabbit MQ 客户端 API 开发

最新推荐文章于 2024-07-14 12:48:54 发布

原创

最新推荐文章于 2024-07-14 12:48:54 发布 · 328 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#RabbitMQ API #RabbitMQ Client

本文详细介绍了如何使用 RabbitMQ 客户端 API 进行连接、声明队列和交换器、绑定操作，以及发送和消费消息。讲解了 exchangeDeclare、queueDeclare 和 exchangeBind 方法的参数及用途，并提供了完整的生产者和消费者示例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

项目开始

第一步首先需要引入对应的 jar 包

<!-- https://mvnrepository.com/artifact/com.rabbitmq/amqp-client -->
<dependency>
    <groupId>com.rabbitmq</groupId>
    <artifactId>amqp-client</artifactId>
    <version>5.6.0</version>
</dependency>

连接 RabbitMQ

连接 RabbitMQ 有两种方式：1.根据特定参数连接 2.根据 URI 连接
根据特定的参数连接(用户名、密码、IP 地址、虚拟 broker、端口号)

// 声明连接工厂
ConnectionFactory factory = new ConnectionFactory();
// 使用连接工厂赋值 userName、password、host、vHost、port 等等
factory.setUsername("userName");
factory.setPassword("password");
factory.setHost("host");
factory.setVirtualHost("vhost");
factory.setPort(5672);
// 创建连接
Connection conn = factory.newConnection();

根据 URI 连接也可以选择使用 URI 的方式来实现

ConnectionFactory factory = new ConnectionFactory();
factory.setUri("amqp://userName:password@host:port/vhost");
Connection connection = factory.newConnection();
System.out.println(connection);
connection.close();

Connection 可以用来创建多个 Channel 实例，但是 Channel 实例不能在线程间共享，应该为每一个线程开辟一个 Channel。线程共享会导致在网络上出现错误的通信帧交错，同时也会影响发送方确认机制的运行，所以多线程间共享 Channel 实例是非线程安全的。

使用队列和交换器

如何声明一个队列和交换器

Channel channel = connection.createChannel();
channel.exchangeDeclare("exchangeName", "direct", true);
String queueName = channel.queueDeclare().getQueue();
channel.queueBind(queueName, "exchangeName", "routuingKey");

上面创建了一个持久化的、非自动删除的、绑定类型为 direct 的交换器，同时也创建了一个非持久化的、排他的、自动删除的队列(此队列的名称由 RabbitMQ 自动生成)。

exchangeDeclare 方法详解

exchangeDeclare 有多个重载方法都是由下面的这个方法中参数的缺省构成的。

public DeclareOk exchangeDeclare(String exchange, String type, boolean durable, boolean autoDelete, boolean internal, Map<String, Object> arguments) throws IOException;

此方法的返回值是 Exchange.DeclareOk 用来标识成功声明了一个交换器。
参数说明
1.exchange: 交换器的名称。
2.type: 交换器的类型。
3.durable: 设置是否持久化。true 表示持久化 false 表示非持久化。持久化可以将交换器存盘，在服务器重启的时候不会丢失相关信息。
4.autoDelete: 设置是否自动删除。true 表示自动删除。自动删除的前提是至少有一个队列或者交换器与这个交换器绑定，之后所有与这个交换器绑定的队列或者交换器都与此解绑。注意不能错误地把这个参数理解为: “当与此交换器连接的客户端都断开时，RabbitMQ 会自动删除本交换器”。
5.internal: 设置是否是内置的。true 则表示内置交换器，客户端程序无法直接发送消息到这个交换器中，只能通过交换器路由到交换器这种方式。
6.arguments: 其他一些结构化参数。比如 alternate-exchange。

有声明创建交换器的方法，也对应肯定也有删除交换器的方法。其中 exchange 表示交换器的名称，而 ifUnuserd 用来设置在交换器没有被使用的情况下删除，如果设置为 true，则只有再此交换器没有被使用的情况下才会被删除，如果设置为 false，则无论如何这个交换器都要被删除。

public AMQP.Exchange.DeleteOk exchangeDelete(String exchange, boolean ifUnused) throws IOException;
public AMQP.Exchange.DeleteOk exchangeDelete(String exchange, boolean ifUnused) throws IOException;