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早就考虑到了，并且提供了解决方案，下一篇博文将进行详细介绍