译:1. RabbitMQ Java Client 之 "Hello World"
这些教程介绍了使用RabbitMQ创建消息传递应用程序的基础知识。您需要安装RabbitMQ服务器才能完成教程
1. 打造第一个Hello World 程序
RabbitMQ是一个消息代理：它接受和转发消息。你可以把它想象成一个邮局：当你把你想要发布的邮件放在邮箱里时，你可以确定先生或女士邮递员最终将邮件发送给你的收件人。
在这个比喻中，RabbitMQ是邮政信箱，邮局和邮递员。
RabbitMQ和邮局的主要区别在于它不处理纸张，而是接受，存储和转发二进制数据块 - 消息。
英文原文地址：https://www.rabbitmq.com/tutorials/tutorial-one-java.html
2 "Hello World"使用 Java 客户端
在本教程的这一部分中，我们将用Java编写两个程序; 一个发送单个消息的生产者，以及接收消息并将其打印出来的消费者。
我们将详细介绍Java API中的一些细节，专注于这个非常简单的事情，以便开始使用。 这是一个消息传递的“Hello World”。
在下图中，“P”是我们的生产者，“C”是我们的消费者。 中间的盒子是一个队列 - RabbitMQ代表消费者保存的消息缓冲区。
RabbitMQ 有许多不同语言的RabbitMQ客户端。 这里我们将使用RabbitMQ提供的Java客户端。
2.1 下载相关依赖Jar 包
下载RabbitMQ提供的Java客户端以及它的依赖(SLF4J API and SLF4J Simple)
将这些文件复制到工作目录中，并跟着教程复制Java文件。
Tips:
RabbitMQ Java客户端也位于中央Maven存储库中，其中包含groupId com.rabbitmq和artifactId amqp-client。
请注意SLF4J Simple对于教程来说已经足够了，但是您应该在生产环境中使用像Logback 这样的完整日志库。
关于Maven 等其他下载方式请移步
Java Client
- On Maven Central: RabbitMQ Java client.
- Quick download: Binary | Source
- Javadoc
- All Java client downloads
- Older versions
2.2 编写代码
我们拥有Java客户端及其依赖关系，那么我们接下来开始写代码。
由于是学习使用RabbitMQ,我们这里使用 STS 来写这个项目。
1. 打开STS,新建一个名字叫做 RabbitMQ_HelloWorld_Sample 的 Java Project。
2. 新建一个叫做libs的文件夹，我们将上面三个jar 复制到我们的项目中，然后并添加依赖
完成后项目结构如图所示
3. 编写生产者类
我们会打电话给我们的消息发布者（发送者）发送和我们的消息使用者（接收者）Recv。 发布者将连接到RabbitMQ，发送一条消息，然后退出
创建Send.java 文件，关于代码的讲解在注释里：
import java.util.concurrent.TimeoutException;
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[] args) throws java.io.IOException, TimeoutException{
/**
* 创建一个到RabbitMQ Server 的连接
* 连接抽象出套接字连接，并为我们处理协议版本协商和身份验证等。
* 在这里，我们连接到本地机器上的代理 - 因此是本地主机。
* 如果我们想连接到另一台机器上的代理，我们只需在此指定其名称或IP地址。
* */
ConnectionFactory factory = new ConnectionFactory();
factory.setHost("localhost");
Connection connection = factory.newConnection();
Channel channel = connection.createChannel();
/**
* 接下来我们创建一个Channel 对象，这是大部分用于完成任务的API驻留的地方。
* 要想发送出去，我们必须声明一个队列来执行发送,那么我们可以将消息发布到队列中：
* */
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();
}
}
执行成功后你将看到这样的内容：
Tips: ，
如果这是您第一次使用RabbitMQ，并且您没有看到“已发送”消息，那么您可能会抓住您的头脑，想知道会出现什么问题？
也许代理启动时没有足够的可用磁盘空间（默认情况下它至少需要200 MB空闲空间），因此拒绝接受消息。
检查代理日志文件以确认并在必要时减少限制。 配置文件文档将告诉你如何设置disk_free_limit。
还有一种可能是你的RabbitMQ 没有启动，执行下面命令再次尝试即可。
rabbitmq-service.bat start
4. 编写消费者
这就是我们的出版商。 我们的消费者推送来自RabbitMQ的消息，因此与发布单个消息的发布者不同，我们将继续运行以收听消息并将其打印出来。
创建一个Recv.java 文件，代码讲解在注释里面
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.Connection;
import java.io.IOException;
import java.util.concurrent.TimeoutException;
import com.rabbitmq.client.AMQP;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Consumer;
import com.rabbitmq.client.DefaultConsumer;
import com.rabbitmq.client.Envelope;
/**
* 消费者
* 额外的DefaultConsumer是一个实现Consumer接口的类，我们将使用它来缓存由服务器推送给我们的消息。
* */
public class Recv {
private final static String QUEUE_NAME="hello";
public static void main(String[] args) throws IOException, TimeoutException {
/**
* 设置与发布者相同;
* 我们打开一个连接和一个通道，并声明我们将要使用的队列。
* 请注意，这与发送发布到的队列相匹配
* */
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");
/**
* 我们即将告诉服务器将队列中的消息传递给我们。
* 由于它会异步推送消息，因此我们以对象的形式提供回调，该消息将缓冲消息，直到我们准备好使用它们。
* 这是一个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);
}
}
执行成功后
我们可以看到我们的消费者收到了消息队列生产者刚发布的消息。
本篇完~
