RabbitMQ-Java客户端API指南-上
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使用。
