RabbitMQ（一）：Hello World程序

痛定思痛。 2022-04-24 18:42 236阅读 0赞

内容翻译自：[RabbitMQ Tutorials Java版][RabbitMQ Tutorials Java]

--------------------

[RabbitMQ（一）：Hello World程序][RabbitMQ_Hello World]

[RabbitMQ（二）：Work Queues、循环分发、消息确认、持久化、公平分发][RabbitMQ_Work Queues]

[RabbitMQ（三）：Exchange交换器--fanout][RabbitMQ_Exchange_--fanout]

[RabbitMQ（四）：Exchange交换器--direct][RabbitMQ_Exchange_--direct]

[RabbitMQ（五）：Exchange交换器--topic][RabbitMQ_Exchange_--topic]

[RabbitMQ（六）：回调队列callback queue、关联标识correlation id、实现简单的RPC系统][RabbitMQ_callback queue_correlation id_RPC]

[RabbitMQ（七）：常用方法说明 与 学习小结][RabbitMQ_ _]

--------------------

### 介绍： ###

RabbitMQ是一个消息代理：它接受并转发消息。你可以把它当成一个邮局：当你想邮寄信件的时候，你会把信件放在投递箱中，并确信邮递员最终会将信件送到收件人的手里。在这个例子中，RabbitMQ就相当与投递箱、邮局和邮递员。

RabbitMQ与邮局的区别在于：RabbitMQ并不处理纸质信件，而是接受、存储并转发二进制数据---消息。

谈到RabbitMQ的消息，通常有几个术语：

（1）生产者：是指发送消息的程序

（2）队列：相当于RabbitMQ的投递箱。尽管消息在RabbitMQ和你的应用之间传递，但是消息仅仅会在队列之中存储。队列只能存储在内存或磁盘中，本质上是一个大的消息缓冲区。不同的生产者可以发送消息到同一个对队列，不同的消费者也可以从同一个队列中获取消息。

（3）消费者：等待接受消息的程序。

注意，生产者、消费者以及RabbitMQ并不一定要在同一个主机上，在绝大部分的应用中它们都不在同一主机上。

在开始教程之前，请确保：你已经安装了RabbitMQ，并且在`localhost`上运行起来（默认端口5672）。如果你使用了不同的主机或端口，请在下文中的连接设置中  
更改相应的参数。

--------------------

### 一、Hello World： ###

在这一部分，我们将会使用Java编写两个小程序：一个发送单个消息的生产者、一个接受消息并打印出消息的消费者。这个消息就是`Hello World`。

下图中，P代表生产者，C代表消费者，中间红色的小箱子就代表队列--RabbitMQ为了让消费者收到消息而保持的消息缓冲区。

![20210324002732330.png][]

在这一部分，只需要引入Java客户端依赖即可：amqp-client.jar，也可以通过maven的方式引入：

<dependency>
        <groupId>com.rabbitmq</groupId>
        <artifactId>amqp-client</artifactId>
        <version>4.1.0</version>
    </dependency>

**1、生产者：**

我们将消息的发布者（生产者）命名为Send，将消息的消费者命名为Recv。发布者将会连接到RabbitMQ，并且发送一条消息，然后退出。

在`Send.java`中，首先引入相关类：

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

再定义队列的名字：

private final static String QUEUE_NAME = "hello";

然后，创建一个连接到Rabbit服务器的连接：

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

上面的代码中，connection是socket连接的抽象，为我们处理了通信协议版本协商以及认证等。这样，我们就连接到了本地机器上的一个消息代理（broker）。如果想连接到其他机器上的broker，只要修改IP即可。

之后，我们又创建了一个通道（channel），大部分的API操作均在这里完成。

对于Send来说，必须指明消息要发到哪个队列：

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

队列的定义是幂等的，它仅仅在不存在时才会创建。消息的内容是一个字节数组，所以你可以随意编码（encode）。

最后，必须将通道和连接关闭。

channel.close();
    connection.close();

完整代码

//引入相关Class文件
    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[] 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);
            String message = "Hello World!";
            
            //发布消息
            channel.basicPublish("", QUEUE_NAME, null, message.getBytes("UTF-8"));
            System.out.println(" [x] Sent '" + message + "'");
    
            //关闭连接
            channel.close();
            connection.close();
        }
    }

**2、接收者（消费者）：**

消费者从RabbitMQ中取出消息。不同于发布者只发送一条消息就退出，这里我们让消费者一直监听消息，并把接受到的消息打印出来。

与Send.java类似，首先引入相关类：

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

上面引入的`DefaultConsumer`是`Consumer`接口的实现类，我们使用它来缓冲从服务器push来的消息。  
接下来的设置与发布者类似，打开连接和通道，声明我们想消费的队列。注意，这里的队列的名字要与发布者中声明的队列的名字一致。

public class Recv {
      private final static String QUEUE_NAME = "hello";
    
      public static void main(String[] argv)
          throws java.io.IOException,
                 java.lang.InterruptedException {
    
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("localhost");
        Connection connection = factory.newConnection();
        Channel channel = connection.createChannel();
    
        channel.queueDeclare(QUEUE_NAME, fasle, false, false, null);
        System.out.println(" [*] Waiting for messages. To exit press CTRL+C");
        ...
        }
    }

注意，消费者同样声明了队列。这是因为，我们可能在启动生产者之前启动了消费者应用，我们想确保在从一个队列消费消息之前，这个队列是存在的。

接下来，告诉服务器（RabbitMQ）把队列中的消息发过来。因为这个过程是异步的，可以通过`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);

Consumer的完整代码如下：

package com.maxwell.rabbitdemo;
    
    import com.rabbitmq.client.*;
    
    import java.io.IOException;
    
    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");
    
            //回调消费消息
            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);
        }
    }

这样，消费者就会一直监听声明的队列。运行一次生产者（即`Send.java`中的`main`方法），消费者就会打印出接受到的消息。

--------------------

### 说明： ###

①与原文略有出入，如有疑问，请参考原文。

②RabbitMQ的官方**[rabbitmq-tutorials][]**的java示例中，`amqp-client`版本为3.5，我改为了4.1，否则后续的示例教程中会报错说找不到文件。

[RabbitMQ Tutorials Java]: https://link.jianshu.com/?t=http://www.rabbitmq.com/tutorials/tutorial-one-java.html
[RabbitMQ_Hello World]: https://blog.csdn.net/a745233700/article/details/89680776
[RabbitMQ_Work Queues]: https://blog.csdn.net/a745233700/article/details/89680957
[RabbitMQ_Exchange_--fanout]: https://blog.csdn.net/a745233700/article/details/89681388
[RabbitMQ_Exchange_--direct]: https://blog.csdn.net/a745233700/article/details/89681621
[RabbitMQ_Exchange_--topic]: https://blog.csdn.net/a745233700/article/details/89681801
[RabbitMQ_callback queue_correlation id_RPC]: https://blog.csdn.net/a745233700/article/details/89681941
[RabbitMQ_ _]: https://blog.csdn.net/a745233700/article/details/89703132
[20210324002732330.png]: /images/20220212/2af57e2213c84e61a4439e052735d462.png
[rabbitmq-tutorials]: https://link.jianshu.com?t=https://github.com/rabbitmq/rabbitmq-tutorials