RabbitMQ文档翻译一(JAVA).Hello World!

RabbitMQ是一个消息代理：它接受和转发消息。你可以把它想象成一个邮局：当你把你想寄出的邮件放进一个邮箱里时，你可以确信邮件的收件人最终会收到邮件。类似的，RabbitMQ是一个邮箱、一个邮局和一个邮递员。

RabbitMQ与邮局的主要区别在于，它不处理纸张信件，而是接受、存储和转发二进制的数据信息块。

RabbitMQ和消息传递通常使用一些行业术语

生产只意味着发送。发送消息的程序是生产者：
queue是RabbitMQ中的邮箱的名称。尽管消息流经RabbitMQ和您的应用程序，但它们只能存储在队列中。队列只受主机的内存和磁盘限制的约束，它本质上是一个大的消息缓冲区。许多生产者可以将消息发送到一个队列，而许多消费者可以尝试从一个队列接收数据。如下是我们表示队列的方式
消费和接收有着相似的含义。消费者是一个主要等待接收消息的程序：

请注意，生产者、消费者和代理不必驻留在同一主机上；事实上，在大多数应用程序中，它们不必驻留在同一主机上。应用程序也可以既是生产者又是消费者。

“Hello World”

在这部分中，我们将用Java编写两个程序：一个是发送单个消息的生产者，另一个是接收消息并将其打印出来的消费者。我们将略过Java API中的一些细节，重点放在这件非常简单的事情上，以便于快速开始上手。一个“Hello World”消息。

在下图中，“P”是我们的生产者，“C”是我们的消费者。中间的框是一个队列，是RabbitMQ持有的供消费者使用的的消息缓冲区。

(P) -> [|||] -> (C)

Java客户端库
RabbitMQ有多种协议。本教程使用AMQP 0-9-1，这是一个开放的、通用的消息传递协议。RabbitMQ有许多不同语言的客户机。我们将使用RabbitMQ提供的Java客户端。

下载客户端库及其依赖项（SLF4J API和SLF4J Simple）。将这些文件与教程中的Java文件一起复制到工作目录中。

请注意，SLF4J Simple对于教程来说已经足够了，但是您应该在生产中使用完整的日志库，比如Logback。

（RabbitMQ Java客户端也在中央Maven存储库中，groupId为com.rabbitmq，artifactId为amqp-client.）

现在我们有了Java客户端及其依赖项，我们可以编写一些代码。

发送

(P) -> [|||]

我们将调用我们的消息发布者（sender）发送和消息使用者（receiver）接收。发布者将连接到RabbitMQ，发送一条消息，然后退出。
在 Send.java，我们需要导入一些类：

import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.Channel;

设置启动类并命名队列：

public class Send {
    
    
  private final static String QUEUE_NAME = "hello";
  public static void main(String[] argv) throws Exception {
    
    
      ...
  }
}

然后我们可以创建到服务器的连接：

ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
try (Connection connection = factory.newConnection();
     Channel channel = connection.createChannel()) {
    
    

}

该连接抽象了socket连接，为我们负责协议版本协商和认证等工作。在这里，我们连接到本地机器上的RabbitMQ节点-因此是本地主机。如果我们想连接到另一台机器上的节点，我们只需在这里指定它的主机名或IP地址。

接下来，我们创建一个通道，这是大多数完成任务的API所在的位置。注意，我们可以使用try-with-resources语句，因为连接Connection和通道Channel都实现了java.io.Closeable. 这样我们就不需要在代码中显式地关闭它们。

要发送，我们必须声明要发送到的队列；然后我们可以将消息发布到队列，所有这些都在try with resources语句中：

channel.queueDeclare(QUEUE_NAME, false, false, false, null);
String message = "Hello World!";
channel.basicPublish("", QUEUE_NAME, null, message.getBytes());
System.out.println(" [x] Sent '" + message + "'");

声明队列是等幂的——只有当它不存在时才会创建它。消息内容是一个字节数组，因此您可以在那里对任何您喜欢的内容进行编码。

这里是完整的Send.java类.

发送不起作用！

如果这是您第一次使用RabbitMQ，而您没有看到已发送的消息，那么您可能会挠头想知道可能是什么问题。可能代理启动时没有足够的可用磁盘空间（默认情况下至少需要200 MB的可用空间），因此拒绝接受消息。检查代理日志文件以确认并在必要时降低限制。配置文件文档将向您展示如何设置磁盘可用空间限制。

接收

这是我们的发布者。我们的消费者监听来自RabbitMQ的消息，因此与发布单个消息的发布者不同，我们将保持它的运行以监听消息并将其打印出来。

[|||] -> (C)

代码（在 Recv.java 中)与Send有几乎相同的import：

import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DeliverCallback;

我们将使用额外的DeliveryCallback接口来缓冲服务器推送到我们的消息。
设置与发布服务器相同；我们打开一个连接和一个通道，并声明要使用的队列。注意，这与send发布消息的队列是匹配的。

public class Recv {
    
    

  private final static String QUEUE_NAME = "hello";

  public static void main(String[] argv) throws Exception {
    
    
    ConnectionFactory factory = new ConnectionFactory();
    factory.setHost("localhost");
    Connection connection = factory.newConnection();
    Channel channel = connection.createChannel();

    channel.queueDeclare(QUEUE_NAME, false, false, false, null);
    System.out.println(" [*] Waiting for messages. To exit press CTRL+C");

  }
}

注意，我们在这里声明了队列。可能在生产者之前启动了消费者，所以在尝试使用队列中的消息之前，我们要确保队列存在。

为什么不使用try-with-resource语句自动关闭通道和连接？这样做，可以让程序运行，然后关闭所有内容，然后退出！这可能会很不方便，因为我们希望进程在使用者异步侦听消息到达时保持活动状态。

我们将告诉服务器从队列中向我们传递消息。由于它将异步地推送消息，因此我们以对象的形式提供回调，该回调将缓冲消息，直到我们准备好使用它们。这就是DeliverCallback子类所做的。

DeliverCallback deliverCallback = (consumerTag, delivery) -> {
    
    
    String message = new String(delivery.getBody(), "UTF-8");
    System.out.println(" [x] Received '" + message + "'");
};
channel.basicConsume(QUEUE_NAME, true, deliverCallback, consumerTag -> {
    
     });

这是完整的Recv.java类

整合

您可以使用类路径上的RabbitMQ java客户端编译这两个文件：

javac -cp amqp-client-5.7.1.jar Send.java Recv.java

要运行它们，您需要rabbitmq-client.jar以及它对类路径的依赖关系。在终端中，运行消费者（receiver）：

java -cp .:amqp-client-5.7.1.jar:slf4j-api-1.7.26.jar:slf4j-simple-1.7.26.jar Recv

然后，运行生产者（sender）：

java -cp .:amqp-client-5.7.1.jar:slf4j-api-1.7.26.jar:slf4j-simple-1.7.26.jar Send

在Windows上，使用分号而不是冒号分隔类路径中的项。
消费者将通过RabbitMQ打印从生产者处获得的消息。消费者将继续运行，等待消息（使用Ctrl-C停止），因此尝试从另一个终端运行发布服务器。

列出队列
您可能希望看到RabbitMQ有哪些队列以及其中有多少消息。您可以使用rabbitmqctl工具（作为特权用户）执行此操作：
sudo rabbitmqctl list_queues
在Windows上，省略sudo：
rabbitmqctl.bat list_queues

是时候进入第2部分并构建一个简单的工作队列了。

提示
为了节省输入，您可以为类路径设置一个环境变量，例如。

export CP=.:amqp-client-5.7.1.jar:slf4j-api-1.7.26.jar:slf4j-simple-1.7.26.jar
java -cp $CP Send

在Windows上：

set CP=.;amqp-client-5.7.1.jar;slf4j-api-1.7.26.jar;slf4j-simple-1.7.26.jar
java -cp %CP% Send

RabbitMQ文档翻译一(JAVA).Hello World!

“Hello World”

发送

接收

整合

猜你喜欢