RabbitMQ-从基础到实战（1）— Hello RabbitMQ

转载请注明出处

0.目录

RabbitMQ-从基础到实战（2）— 防止消息丢失

RabbitMQ-从基础到实战（3）— 消息的交换（上）

RabbitMQ-从基础到实战（4）— 消息的交换（中）

RabbitMQ-从基础到实战（5）— 消息的交换（下）

RabbitMQ-从基础到实战（6）— 与Spring集成

1.简介

本篇博文介绍了在windows平台下安装RabbitMQ Server端，并用JAVA代码实现收发消息

2.安装RabbitMQ

1. RabbitMQ是用Erlang开发的，所以需要先安装Erlang环境，在这里下载对应系统的Erlang安装包进行安装
2. 点击这里下载对应平台的RabbitMQ安装包进行安装

Windows平台安装完成后如图

 

3.启用RabbitMQ Web控制台

RabbitMQ提供一个控制台，用于管理和监控RabbitMQ，默认是不启动的，需要运行以下命令进行启动

1. 点击上图的Rabbit Command Prompt，打开rabbitMQ控制台
2. 在官方介绍管理控制台的页面，可以看到，输入以下命令启动后台控制插件

   rabbitmq-plugins enable rabbitmq_management

3. 登录后台页面：http://localhost:15672/   密码和用户名都是 guest ，界面如下

 

目前可以先不用理会此界面，后面使用到时会详细介绍，也可以到这里查看官方文档。

4.编写MessageSender

Spring对RabbitMQ已经进行了封装，正常使用中，会使用Spring集成，第一个项目中，我们先不考虑那么多

在IDE中新建一个Maven项目，并在pom.xml中贴入如下依赖，RabbitMQ的最新版本依赖可以在这里找到

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

等待Maven下载完成后，就可以在Maven Dependencies中看到RabbitMQ的JAR

在这里，我们发现，RabbitMQ的日志依赖了slf4j-api这个包，slf4j-api并不是一个日志实现，这样子是打不出日志的，所以，我们给pom加上一个日志实现，这里用了logback

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.1</version>
</dependency>

之后maven依赖如下，可以放心写代码了

 

新建一个MessageSender类，代码如下

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

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

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

public class MessageSender {
    
    private Logger logger = LoggerFactory.getLogger(MessageSender.class);

    //声明一个队列名字
    private final static String QUEUE_NAME = "hello";
    
    public boolean sendMessage(String message){
        //new一个RabbitMQ的连接工厂
        ConnectionFactory factory = new ConnectionFactory();
        //设置需要连接的RabbitMQ地址，这里指向本机
        factory.setHost("127.0.0.1");
        Connection connection = null;
        Channel channel = null;
        try {
            //尝试获取一个连接
            connection = factory.newConnection();
            //尝试创建一个channel
            channel = connection.createChannel();
            //这里的参数在后面详解
            channel.queueDeclare(QUEUE_NAME, false, false, false, null);
            //注意这里调用了getBytes()，发送的其实是byte数组，接收方收到消息后，需要重新组装成String
            channel.basicPublish("", QUEUE_NAME, null, message.getBytes());
            logger.info("Sent '" + message + "'");
            //关闭channel和连接
            channel.close();
            connection.close();
        } catch (IOException | TimeoutException e) {
            //失败后记录日志，返回false，代表发送失败
            logger.error("send message faild!",e);
            return false;
        }
        return true;
    }
}

然后在App类的main方法中调用sendMessage

public class App {
    public static void main( String[] args ){
        MessageSender sender = new MessageSender();
        sender.sendMessage("hello RabbitMQ!");
    }
}

打印日志如下

打开RabbitMQ的控制台，可以看到消息已经进到了RabbitMQ中

点进去，用控制台自带的getMessage功能，可以看到消息已经成功由RabbitMQ管理了

至此，MessageSender已经写好了，在该类的31和33行，我们分别调用了队列声明和消息发送

channel.queueDeclare(QUEUE_NAME, false, false, false, null);
channel.basicPublish("", QUEUE_NAME, null, message.getBytes());

queueDeclare，有很多参数，我们可以看一下他的源码，注释上有详细的解释，我简单翻译了一下

/**
     * Declare a queue 声明一个队列
     * @see com.rabbitmq.client.AMQP.Queue.Declare
     * @see com.rabbitmq.client.AMQP.Queue.DeclareOk
     * @param queue the name of the queue队列的名字
     * @param durable true if we are declaring a durable queue (the queue will survive a server restart)是否持久化，为true则在rabbitMQ重启后生存
     * @param exclusive true if we are declaring an exclusive queue (restricted to this connection)是否是排他性队列（别人看不到），只对当前连接有效，当前连接断开后，队列删除（设置了持久化也删除）
     * @param autoDelete true if we are declaring an autodelete queue (server will delete it when no longer in use)自动删除，在最后一个连接断开后删除队列
     * @param arguments other properties (construction arguments) for the queue 其他参数
     * @return a declaration-confirm method to indicate the queue was successfully declared
     * @throws java.io.IOException if an error is encountered
     */
    Queue.DeclareOk queueDeclare(String queue, boolean durable, boolean exclusive, boolean autoDelete,
                                 Map<String, Object> arguments) throws IOException;

前面4个都非常好理解，最后一个“其他参数”，到底是什么其他参数，这个东西真的很难找，用到再解释吧，官方文档如下

• TTL Time To Live  存活时间

• Dead Lettering  遗言，当消息死亡时，做些什么

• Length Limit  长度限制

• Priority Queues  优先级

basicPublish的翻译如下

 /**
     * Publish a message.发送一条消息
     *
     * Publishing to a non-existent exchange will result in a channel-level
     * protocol exception, which closes the channel.
     *
     * Invocations of <code>Channel#basicPublish</code> will eventually block if a
     * <a href="http://www.rabbitmq.com/alarms.html">resource-driven alarm</a> is in effect.
     *
     * @see com.rabbitmq.client.AMQP.Basic.Publish
     * @see <a href="http://www.rabbitmq.com/alarms.html">Resource-driven alarms</a>
     * @param exchange the exchange to publish the message to 交换模式，会在后面讲，官方文档在这里
     * @param routingKey the routing key 控制消息发送到哪个队列
     * @param props other properties for the message - routing headers etc 其他参数
     * @param body the message body 消息，byte数组
     * @throws java.io.IOException if an error is encountered
     */
    void basicPublish(String exchange, String routingKey, BasicProperties props, byte[] body) throws IOException;

这里又有个其他参数，它的类型是这样的，设置消息的一些详细属性

 

5.编写MessageConsumer

为了和Sender区分开，新建一个Maven项目MessageConsumer

package com.liyang.ticktock.rabbitmq;

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

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

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

public class MessageConsumer {
    
    private Logger logger = LoggerFactory.getLogger(MessageConsumer.class);
    
    public boolean consume(String queueName){
        //连接RabbitMQ
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("127.0.0.1");
        Connection connection = null;
        Channel channel = null;
        try {
            connection = factory.newConnection();
            channel = connection.createChannel();
            //这里声明queue是为了取消息的时候，queue肯定会存在
            //注意，queueDeclare是幂等的，也就是说，消费者和生产者，不论谁先声明，都只会有一个queue
            channel.queueDeclare(queueName, false, false, false, null);
            
            //这里重写了DefaultConsumer的handleDelivery方法，因为发送的时候对消息进行了getByte()，在这里要重新组装成String
            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");
                        logger.info("Received '" + message + "'");
                }
            };
            //上面是声明消费者，这里用声明的消费者消费掉队列中的消息
            channel.basicConsume(queueName, true, consumer);
            
            //这里不能关闭连接，调用了消费方法后，消费者会一直连接着rabbitMQ等待消费
           
        } catch (IOException | TimeoutException e) {
            //失败后记录日志，返回false，代表消费失败
            logger.error("send message faild!",e);
            return false;
        }
        
        
        return true;
    }
}

然后在App的main方法中调用Cunsumer进行消费

public class App 
{
    //这个队列名字要和生产者中的名字一样，否则找不到队列
    private final static String QUEUE_NAME = "hello";
    
    public static void main( String[] args )
    {
        MessageConsumer consumer = new MessageConsumer();
        consumer.consume(QUEUE_NAME);
    }
}

结果如下，消费者一直在等待消息，每次有消息进来，就会立刻消费掉

6.多个消费者同时消费一个队列

改造一下Consumer

在App中new多个消费者

改造Sender，使它不停的往RabbitMQ中发送消息

启动Sender

启动Consumer，发现消息很平均的发给四个客户端，一人一个，谁也不插队

如果我们把速度加快呢？把Sender的休息时间去掉，发现消费开始变得没有规律了，其实呢，它还是有规律的，这个是RabbitMQ的特性，称作“Round-robin dispatching”，消息会平均的发送给每一个消费者，可以看第一第二行，消息分别是56981和56985，相应的82、82、84都被分给了其他线程，只是在当前线程的时间片内，可以处理这么多任务，所以就一次打印出来了

 

7.结束语

这一章介绍了从安装到用JAVA语言编写生产者与消费者，在这里只是简单的消费消息并打印日志，如果一个消息需要处理的时间很长，而处理的过程中，这个消费者挂掉了，那消息会不会丢失呢？答案是肯定的，而且已经分配给这个消费者，但还没来得及处理的消息也会一并丢失掉，这个问题，RabbitMQ早就考虑到了，并且提供了解决方案，下一篇博文将进行详细介绍