柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)

柯南君:看大数据时代下的IT架构(4)消息队列之RabbitMQ--案例(Helloword起航)

一、回顾

让我们回顾一下,在上几章里都讲了什么?总结如下:

  • 《柯南君:看大数据时代下的IT架构(1)业界消息队列对比》
  • 《柯南君:看大数据时代下的IT架构(2)消息队列之RabbitMQ-基础概念详细介绍》
  • 《柯南君:看大数据时代下的IT架构(3)消息队列之RabbitMQ-安装、配置与监控》

二、起航


       本章节,柯南君将从几个层面,用官网例子讲解一下RabbitMQ的实操经典程序案例,让大家重新回到经典“Hello world!”(The simplest thing that does something )时代,RabbitMQ 支持N多种客户端(client),这里无法一一讲解,暂定java client,有时间的情况下,在弥补一下。

事先,先普及一下图标(我们会在下面的事例中,会大量用到,所以先普及一下,便于识别,最终更好理解事例的含义)

1、图标概念

① producting(生产者):在程序中 发送消息的一端,我们暂且称之为 生产者,在这里用“p”表示

柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)

 queue(队列):队列是一个邮箱的名字。它住在RabbitMQ。尽管消息流经RabbitMQ和您的应用程序,他们只可以存储在一个队列中。队列是不受任何限制,它可以储存尽可能多的信息(按你兴趣来了),它本质上是一个无限缓冲区。许多生产商可以发送消息到一个队列,许多消费者可以尝试接收数据从一个队列。

柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)

 consuming(消费者):消费者和生产者是对应的,较为相似的意思;在这里,我用“C”表示

柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)

2、The Java client library

RabbitMQ 中AMQP这是一个开放的、通用的协议消息。有许多客户AMQP在许多不同的语言。我们将使用提供的Java客户机RabbitMQ。 

我们需要下载(Download) client library package,并要核实每个jar包,解压到相应位置,如下图所示:

第一步:点击 http://www.rabbitmq.com/java-client.html,然后找到相应的lib下载位置

柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)

第二步:选择合适的下载比如我下载了zip包,如图所示:

柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)

第三步Unzip it(解压它) 到你的working directory(工作目录)中 and grab (并且获得)你的jar包文件


  • $ unzip rabbitmq-java-client-bin-*.zip
  • $ cp rabbitmq-java-client-bin-*/*.jar ./

3、程序案例

1) "Hello World" 

在这部分教程中我们将用Java写两个程序,发送一个消息的生产者,消费者接收信息并打印出来。我们会掩盖一些细节的Java API,集中在这个非常简单的东西开始。这是一个“Hello World”的消息。在下面的图中,“P”是我们的生产和“C”是我们的消费者。中间的框是一个队列,消息缓冲区RabbitMQ保持代表消费者。
柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)
 ① sending (发送)
柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)

首先 让The sender(消息发送者)发送消息并且让我们的receiver (消息接收者)接收消息,The sender(消息发送者)将会connect to(连接)RabbitMQ,发送一个single message(单一的信息),然后exit(退出)。
  • send.java 中,我们需要import一些class ,如下所示:
	import com.rabbitmq.client.ConnectionFactory;
	import com.rabbitmq.client.Connection;
	import com.rabbitmq.client.Channel;
  • set up(设置)类和queue的name
	public class Send {

 		 private final static String QUEUE_NAME = "hello";

  		public static void main(String[] argv)
    	 	 throws java.io.IOException {
     		 ...
 		 }
       }
  • then 我们create 一个connection (连接)到server(服务端)
    onnectionFactory factory = new ConnectionFactory();
    factory.setHost("localhost");
    Connection connection = factory.newConnection();
    Channel channel = connection.createChannel();
备注
  •  这个connection 是抽象的socket connection链接;
  •  负责协议版本(protocol version negotigation)和身份认证(authentication );
  • 我们在本地机器上连接到一个代理即 localhost ,如果我们想要连接到代理不同机器上我们简单的指定其名称或者IP地址即可;
  接下来,我们创建一个channel(通道),这个通道汇集了大多数的API服务!
为了发送,我们必须先声明一个为我们发送queue(队列),然后,往queue里发送一个message
    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();
问题
 如果 sending doesn‘t work! 我们将怎么办?why?
如果这是你第一次使用RabbitMQ并且你看不到“发送”消息,那么你可能抓耳挠没有足够的空闲磁盘空间(默认情况下它需要至少1 gb免费),因此拒绝接受消息。检查代理日志文件确认,如果有必要减少限制。配置文件的文档将向您展示如何设置disk_free_limit。
接下来的是send.java所有源代码:
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.Channel;

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());
    System.out.println(" [x] Sent '" + message + "'");
    
    channel.close();
    connection.close();
  }
}

    ② Receiving (接收)
  这就是我们的发送者。我们的接收器是将消息从RabbitMQ,所以不像发送方发布一个消息,我们将保持运行监听消息并打印出来
柯南君:瞧大数据时代下的IT架构(4)消息队列之RabbitMQ-案例(Helloword起航)
  • The code (in Recv.java) has almost the same imports as Send:
	import com.rabbitmq.client.ConnectionFactory;
	import com.rabbitmq.client.Connection;
	import com.rabbitmq.client.Channel;
	import com.rabbitmq.client.QueueingConsumer;
额外的QueueingConsumer是一个类,我们将使用缓冲消息推到我们的服务器。设置发送者一样,我们打开一个连接和一个通道,并宣布我们将使用的队列。注意这与队列,发送发布。
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, false, false, false, null);
    System.out.println(" [*] Waiting for messages. To exit press CTRL+C");
    ...
    }
}
注意,我们在这里声明队列。因为我们可能会发送方之前开始启动接收,我们要确保队列存在之前我们尝试使用消息。我们要告诉服务器提供我们从队列的消息。因为它将异步消息,我们提供一个回调对象的形式,将缓冲的消息,直到我们准备使用它们。
QueueingConsumer要做什么呢?
  QueueingConsumer consumer = new QueueingConsumer(channel);
    channel.basicConsume(QUEUE_NAME, true, consumer);

    while (true) {
      QueueingConsumer.Delivery delivery = consumer.nextDelivery();
      String message = new String(delivery.getBody());
      System.out.println(" [x] Received '" + message + "'");
    }

QueueingConsumer.nextDelivery()块,直到另一个来自服务器的消息交付。  

下面是Recv.java 源代码:

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

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");
    
    QueueingConsumer consumer = new QueueingConsumer(channel);
    channel.basicConsume(QUEUE_NAME, true, consumer);
    
    while (true) {
      QueueingConsumer.Delivery delivery = consumer.nextDelivery();
      String message = new String(delivery.getBody());
      System.out.println(" [x] Received '" + message + "'");
    }
  }
}
待续....