RabbitMQ——2、HelloWorld

一、原理概述

RabbitMQ is a message broker: it accepts and forwards messages.

RabbitMQ中有3个重要概念：生产者、队列和消费者。

1. 生产者：用户应用程序，用于发送消息。
2. 队列：一块缓存，用于存储消息。
3. 消费者：用户应用程序，用于接收消息。

二、引入依赖

如果使用的是SpringBoot，那么只需引入一条starter依赖：

 <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-amqp</artifactId>
 </dependency>

三、消息发送Send

生产者向rabbitmq发送消息。

消息发送的代码比较简洁，如下所示：

package com.nigelzhou.rabbitmqtest;

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

import java.io.IOException;
import java.util.concurrent.TimeoutException;

public class Send {
    private final static String QUEUE_NAME="hello";

    public static void main(String[] args) {
        //1 实例化连接工厂
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("110.29.111.79");
        factory.setUsername("admin");
        factory.setPassword("admin");
        //factory.setHost("www.deardull.com");
        try {
            //2 创建连接
            Connection conn = factory.newConnection();
            //3 创建channel.接下来，我们创建一个通道，用于完成任务的大部分API都位于这个通道中。
            Channel channel = conn.createChannel();
            //4 声明队列，发送的消息将送到该队列中
            channel.queueDeclare(QUEUE_NAME,false,false,false,null);
            //5 发送消息
            String message = "你好啊!";
            channel.basicPublish("",QUEUE_NAME,null,message.getBytes());
            
            System.out.println("[send]"+message);

        } catch (IOException | TimeoutException e) {
            e.printStackTrace();
        }
    }
}

如代码中的注释所示，要发送一条hello world，需要5步：

1. 创建连接工厂。连接工厂中配置rabbitmq-server的地址、用户名、密码等信息，可以通过连接工厂来创建新的连接。
2. 创建连接。通过连接工厂来创建一个新的连接。
3. 创建channel。为连接创建一个channel，消息相关的API大部分都在这个channel中。
4. 为channel声明队列。消息将会发送到此消息队列中，如果QUEUE_NAME队列不存在则会创建一个。
5. 发送消息。通过channel的basicPublish方法可以发送消息到rabbitmq-server。

四、消息接收Recv

消费者向rabbitmq订阅并接收消息。

消费者简单代码如下：

package com.nigelzhou.rabbitmqtest;

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

import java.io.IOException;
import java.util.concurrent.TimeoutException;

public class Recv {
    private final static String QUEUE_NAME = "hello";

    public static void main(String[] args) throws IOException, TimeoutException {
        //1 连接工厂
        ConnectionFactory factory = new ConnectionFactory();
        //2 设置连接属性
        factory.setHost("119.29.101.72");
        factory.setUsername("admin");
        factory.setPassword("txyadmin");
        //3 获取连接
        Connection conn = factory.newConnection();
        //4 获取channel
        Channel channel = conn.createChannel();
        //5 为通道绑定队列
        channel.queueDeclare(QUEUE_NAME,false,false,false,null);
        System.out.println("[*] Waiting for messages. To exit press CTRL+C");

        //6 定义回调函数
        DeliverCallback deliverCallback = (consumerTag,delivery)->{
            String message = new String(delivery.getBody(),"UTF-8");
            System.out.println(" [x] Received '" + message + "'");
        };

        //7 消费消息
        channel.basicConsume(QUEUE_NAME,true,deliverCallback,consumerTag->{});

    }
}

消费者的大部分代码与生产者一样，包括连接工厂、连接、channel的创建以及队列的声明。不同的地方在于声明队列后，消费者是调用basicConsumer来消费队列中的消息。

basicConsumer函数需要回调接口DeliverCallback，该接口只有一个方法handle：

@FunctionalInterface
public interface DeliverCallback {
    void handle(String var1, Delivery var2) throws IOException;
}

当消费者接收到消息后，该handle方法会被调用。

DeliverCallback是一个函数式接口（只含有一个方法），因此可以使用lambda表达式来简化它的声明：

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

五、可能遇到的问题

5.1 发送消息不成功

发送消息不成功，并返回ACCESS_REFUSE错误。这是由于我们使用的用户没有开启访问权限导致的，可以进入RabbitMQ-Management设置，具体步骤可以参考这篇博文：https://blog.youkuaiyun.com/luwei42768/article/details/53730960