译:1. RabbitMQ Java Client 之 "Hello World"

这些教程介绍了使用RabbitMQ创建消息传递应用程序的基础知识。您需要安装RabbitMQ服务器才能完成教程

1. 打造第一个Hello World 程序

RabbitMQ是一个消息代理：它接受和转发消息。你可以把它想象成一个邮局：当你把你想要发布的邮件放在邮箱里时，你可以确定先生或女士邮递员最终将邮件发送给你的收件人。

在这个比喻中，RabbitMQ是邮政信箱，邮局和邮递员。

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

英文原文地址：https://www.rabbitmq.com/tutorials/tutorial-one-java.html

2 "Hello World"使用 Java 客户端

在本教程的这一部分中，我们将用Java编写两个程序; 一个发送单个消息的生产者，以及接收消息并将其打印出来的消费者。

我们将详细介绍Java API中的一些细节，专注于这个非常简单的事情，以便开始使用。这是一个消息传递的“Hello World”。

在下图中，“P”是我们的生产者，“C”是我们的消费者。中间的盒子是一个队列 - RabbitMQ代表消费者保存的消息缓冲区。

RabbitMQ 有许多不同语言的RabbitMQ客户端。这里我们将使用RabbitMQ提供的Java客户端。

2.1 下载相关依赖Jar 包

下载RabbitMQ提供的Java客户端以及它的依赖(SLF4J API and SLF4J Simple)

将这些文件复制到工作目录中，并跟着教程复制Java文件。

Tips:

RabbitMQ Java客户端也位于中央Maven存储库中，其中包含groupId com.rabbitmq和artifactId amqp-client。

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

关于Maven 等其他下载方式请移步

Java Client

On Maven Central: RabbitMQ Java client.

Quick download: Binary | Source

Javadoc

All Java client downloads

Older versions

2.2 编写代码

我们拥有Java客户端及其依赖关系，那么我们接下来开始写代码。

由于是学习使用RabbitMQ,我们这里使用 STS 来写这个项目。

1. 打开STS,新建一个名字叫做 RabbitMQ_HelloWorld_Sample 的 Java Project。

2. 新建一个叫做libs的文件夹，我们将上面三个jar 复制到我们的项目中，然后并添加依赖

完成后项目结构如图所示

3. 编写生产者类

我们会打电话给我们的消息发布者（发送者）发送和我们的消息使用者（接收者）Recv。发布者将连接到RabbitMQ，发送一条消息，然后退出

创建Send.java 文件，关于代码的讲解在注释里：

import java.util.concurrent.TimeoutException;

import com.rabbitmq.client.Channel;

import com.rabbitmq.client.Connection;

import com.rabbitmq.client.ConnectionFactory;

public class Send {

    //设置消息队列的名称

    private final static String QUEUE_NAME="hello";

    public static void main(String[] args) throws java.io.IOException, TimeoutException{

        /**

         * 创建一个到RabbitMQ Server 的连接

         * 连接抽象出套接字连接，并为我们处理协议版本协商和身份验证等。

         * 在这里，我们连接到本地机器上的代理 - 因此是本地主机。

         * 如果我们想连接到另一台机器上的代理，我们只需在此指定其名称或IP地址。

         * */

        ConnectionFactory factory = new ConnectionFactory();

        factory.setHost("localhost");

        Connection connection = factory.newConnection();

        Channel channel = connection.createChannel();

        /**

         * 接下来我们创建一个Channel 对象，这是大部分用于完成任务的API驻留的地方。

         * 要想发送出去，我们必须声明一个队列来执行发送,那么我们可以将消息发布到队列中：

         * */

        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 + "'");

        //最后我们关闭这些连接对象

        channel.close();

        connection.close();

    }

}

执行成功后你将看到这样的内容：

Tips: ，

如果这是您第一次使用RabbitMQ，并且您没有看到“已发送”消息，那么您可能会抓住您的头脑，想知道会出现什么问题？

也许代理启动时没有足够的可用磁盘空间（默认情况下它至少需要200 MB空闲空间），因此拒绝接受消息。

检查代理日志文件以确认并在必要时减少限制。配置文件文档将告诉你如何设置disk_free_limit。

还有一种可能是你的RabbitMQ 没有启动，执行下面命令再次尝试即可。
rabbitmq-service.bat start

4. 编写消费者

这就是我们的出版商。我们的消费者推送来自RabbitMQ的消息，因此与发布单个消息的发布者不同，我们将继续运行以收听消息并将其打印出来。

创建一个Recv.java 文件，代码讲解在注释里面

import com.rabbitmq.client.ConnectionFactory;

import com.rabbitmq.client.Connection;

import java.io.IOException;

import java.util.concurrent.TimeoutException;

import com.rabbitmq.client.AMQP;

import com.rabbitmq.client.Channel;

import com.rabbitmq.client.Consumer;

import com.rabbitmq.client.DefaultConsumer;

import com.rabbitmq.client.Envelope;

/**

 * 消费者

 * 额外的DefaultConsumer是一个实现Consumer接口的类，我们将使用它来缓存由服务器推送给我们的消息。

 * */

public class Recv {

     private final static  String QUEUE_NAME="hello";

     public static void main(String[] args) throws IOException, TimeoutException {

          /**

           * 设置与发布者相同;

           * 我们打开一个连接和一个通道，并声明我们将要使用的队列。

           * 请注意，这与发送发布到的队列相匹配

           * */

           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");

            /**

             *  我们即将告诉服务器将队列中的消息传递给我们。

             *   由于它会异步推送消息，因此我们以对象的形式提供回调，该消息将缓冲消息，直到我们准备好使用它们。

             *  这是一个DefaultConsumer子类的作用。

             * */

            Consumer consumer = new DefaultConsumer(channel) {

                  @Override

                  public void handleDelivery(String consumerTag, Envelope envelope,

                                             AMQP.BasicProperties properties, byte[] body)

                      throws IOException {

                    String message = new String(body, "UTF-8");

                    System.out.println(" [x] Received '" + message + "'");

                  }

                };

            channel.basicConsume(QUEUE_NAME, true, consumer);

    }

}

执行成功后

我们可以看到我们的消费者收到了消息队列生产者刚发布的消息。

本篇完~