RabbitMQ-Java客户端API指南-上
客户端API严格按照AMQP 0-9-1协议规范进行建模,并提供了易于使用的附加抽象。
RabbitMQ Java客户端使用com.rabbitmq.client作为其顶层包。关键的类和接口是:
- Channel
- Connection
- ConnectionFactory
- Consumer
协议操作可通过Channel接口获得。Connection用于打开通道,注册连接生命周期事件处理程序,并关闭不再需要的连接。 连接是通过ConnectionFactory实例化的,这就是你如何配置各种连接设置,如虚拟主机或用户名。
Connections和Channels
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.Channel;
连接到Broker
以下代码使用给定的参数(主机名,端口号等)连接到AMQP代理:
ConnectionFactory factory = new ConnectionFactory();
factory.setUsername(userName);
factory.setPassword(password);
factory.setVirtualHost(virtualHost);
factory.setHost(hostName);
factory.setPort(portNumber);
Connection conn = factory.newConnection();
所有这些参数都对本地运行的RabbitMQ服务器具有合理的默认值。
或者,可以使用URI:
ConnectionFactory factory = new ConnectionFactory();
factory.setUri("amqp://userName:password@hostName:portNumber/virtualHost");
Connection conn = factory.newConnection();
所有这些参数都对本地运行的RabbitMQ服务器有合理的默认值。
然后接口可以用于打开一个通道:
Channel channel = conn.createChannel();
现在可以使用该通道发送和接收消息,如后面的部分所述。
要断开连接,只需关闭通道和连接:
channel.close();
conn.close();
使用Exchanges和Queues
客户端应用程序与AMQP的高级构建块交换和排队。这些必须被“声明”才可以使用。声明任何一种类型的对象只是确保其中一个名称存在,如果有必要的话创建它。
继续前面的例子,下面的代码声明一个Exchange和一个Queue,然后将它们绑定在一起。
channel.exchangeDeclare(exchangeName, "direct", true);
String queueName = channel.queueDeclare().getQueue();
channel.queueBind(queueName, exchangeName, routingKey);
这将主动声明以下对象,这两个对象都可以使用附加参数进行定制。这里他们都没有任何特别的论点。
- 一个耐用,非自动删除“直接”类型的交换
- 一个具有生成名称的非持久,独占,自动删除队列
上面的函数调用然后用给定的路由密钥将队列绑定到交换机上。
请注意,这将是一个典型的方式来声明一个队列,当只有一个客户端想要使用它:它不需要一个众所周知的名称,没有其他客户端可以使用它(独占),将自动清理(自动删除)。如果有几个客户想共享一个知名名字的队列,这个代码将是合适的:
channel.exchangeDeclare(exchangeName, "direct", true);
channel.queueDeclare(queueName, true, false, false, null);
channel.queueBind(queueName, exchangeName, routingKey);
这将主动宣布:
- 一个耐用,非自动删除“直接”类型的交换
- 一个具有众所周知名称的持久的,非排他性的非自动删除队列
请注意,所有这些Channel API方法都被重载。这些便捷的exchangeDeclare,queueDeclare和queueBind 使用合理的默认值。还有更多的参数更多的形式,让你根据需要重写这些默认值,在需要的地方给予完全控制。
这个“短形式,长形式”模式在整个客户端API使用。