本文主要是介绍RabbitMQ文档翻译一(JAVA).Hello World!,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
RabbitMQ是一个消息代理:它接受和转发消息。你可以把它想象成一个邮局:当你把你想寄出的邮件放进一个邮箱里时,你可以确信邮件的收件人最终会收到邮件。类似的,RabbitMQ是一个邮箱、一个邮局和一个邮递员。
RabbitMQ与邮局的主要区别在于,它不处理纸张信件,而是接受、存储和转发二进制的数据信息块。
RabbitMQ和消息传递通常使用一些行业术语
-
生产只意味着发送。发送消息的程序是生产者:
-
queue是RabbitMQ中的邮箱的名称。尽管消息流经RabbitMQ和您的应用程序,但它们只能存储在队列中。队列只受主机的内存和磁盘限制的约束,它本质上是一个大的消息缓冲区。许多生产者可以将消息发送到一个队列,而许多消费者可以尝试从一个队列接收数据。如下是我们表示队列的方式
-
消费和接收有着相似的含义。消费者是一个主要等待接收消息的程序:
请注意,生产者、消费者和代理不必驻留在同一主机上;事实上,在大多数应用程序中,它们不必驻留在同一主机上。应用程序也可以既是生产者又是消费者。
“Hello World”
在这部分中,我们将用Java编写两个程序:一个是发送单个消息的生产者,另一个是接收消息并将其打印出来的消费者。我们将略过Java API中的一些细节,重点放在这件非常简单的事情上,以便于快速开始上手。一个“Hello World”消息。
在下图中,“P”是我们的生产者,“C”是我们的消费者。中间的框是一个队列,是RabbitMQ持有的供消费者使用的的消息缓冲区。
Java客户端库
RabbitMQ有多种协议。本教程使用AMQP 0-9-1,这是一个开放的、通用的消息传递协议。RabbitMQ有许多不同语言的客户机。我们将使用RabbitMQ提供的Java客户端。下载客户端库及其依赖项(SLF4J API和SLF4J Simple)。将这些文件与教程中的Java文件一起复制到工作目录中。
请注意,SLF4J Simple对于教程来说已经足够了,但是您应该在生产中使用完整的日志库,比如Logback。
(RabbitMQ Java客户端也在中央Maven存储库中,groupId为com.rabbitmq,artifactId为amqp-client.)
现在我们有了Java客户端及其依赖项,我们可以编写一些代码。
发送
我们将调用我们的消息发布者(sender)发送和消息使用者(receiver)接收。发布者将连接到RabbitMQ,发送一条消息,然后退出。
在 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");
try (Connection connection = factory.newConnection();Channel channel = connection.createChannel()) {}
该连接抽象了socket连接,为我们负责协议版本协商和认证等工作。在这里,我们连接到本地机器上的RabbitMQ节点-因此是本地主机。如果我们想连接到另一台机器上的节点,我们只需在这里指定它的主机名或IP地址。
接下来,我们创建一个通道,这是大多数完成任务的API所在的位置。注意,我们可以使用try-with-resources语句,因为连接Connection和通道Channel都实现了java.io.Closeable. 这样我们就不需要在代码中显式地关闭它们。
要发送,我们必须声明要发送到的队列;然后我们可以将消息发布到队列,所有这些都在try with resources语句中:
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 + "'");
声明队列是等幂的——只有当它不存在时才会创建它。消息内容是一个字节数组,因此您可以在那里对任何您喜欢的内容进行编码。
这里是完整的Send.java类.
发送不起作用!
如果这是您第一次使用RabbitMQ,而您没有看到已发送的消息,那么您可能会挠头想知道可能是什么问题。可能代理启动时没有足够的可用磁盘空间(默认情况下至少需要200 MB的可用空间),因此拒绝接受消息。检查代理日志文件以确认并在必要时降低限制。配置文件文档 将向您展示如何设置磁盘可用空间限制。
接收
这是我们的发布者。我们的消费者监听来自RabbitMQ的消息,因此与发布单个消息的发布者不同,我们将保持它的运行以监听消息并将其打印出来。
代码(在 Recv.java 中)与Send有几乎相同的import:
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DeliverCallback;
我们将使用额外的DeliveryCallback接口来缓冲服务器推送到我们的消息。
设置与发布服务器相同;我们打开一个连接和一个通道,并声明要使用的队列。注意,这与send发布消息的队列是匹配的。
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");}
}
注意,我们在这里声明了队列。可能在生产者之前启动了消费者,所以在尝试使用队列中的消息之前,我们要确保队列存在。
为什么不使用try-with-resource语句自动关闭通道和连接?这样做,可以让程序运行,然后关闭所有内容,然后退出!这可能会很不方便,因为我们希望进程在使用者异步侦听消息到达时保持活动状态。
我们将告诉服务器从队列中向我们传递消息。由于它将异步地推送消息,因此我们以对象的形式提供回调,该回调将缓冲消息,直到我们准备好使用它们。这就是DeliverCallback子类所做的。
DeliverCallback deliverCallback = (consumerTag, delivery) -> {String message = new String(delivery.getBody(), "UTF-8");System.out.println(" [x] Received '" + message + "'");
};
channel.basicConsume(QUEUE_NAME, true, deliverCallback, consumerTag -> { });
这是完整的Recv.java类
整合
您可以使用类路径上的RabbitMQ java客户端编译这两个文件:
javac -cp amqp-client-5.7.1.jar Send.java Recv.java
要运行它们,您需要rabbitmq-client.jar以及它对类路径的依赖关系。在终端中,运行消费者(receiver):
java -cp .:amqp-client-5.7.1.jar:slf4j-api-1.7.26.jar:slf4j-simple-1.7.26.jar Recv
然后,运行生产者(sender):
java -cp .:amqp-client-5.7.1.jar:slf4j-api-1.7.26.jar:slf4j-simple-1.7.26.jar Send
在Windows上,使用分号而不是冒号分隔类路径中的项。
消费者将通过RabbitMQ打印从生产者处获得的消息。消费者将继续运行,等待消息(使用Ctrl-C停止),因此尝试从另一个终端运行发布服务器。
列出队列
您可能希望看到RabbitMQ有哪些队列以及其中有多少消息。您可以使用rabbitmqctl工具(作为特权用户)执行此操作:sudo rabbitmqctl list_queues
在Windows上,省略sudo:
rabbitmqctl.bat list_queues
是时候进入第2部分并构建一个简单的工作队列了。
提示
为了节省输入,您可以为类路径设置一个环境变量,例如。
export CP=.:amqp-client-5.7.1.jar:slf4j-api-1.7.26.jar:slf4j-simple-1.7.26.jar
java -cp $CP Send
在Windows上:
set CP=.;amqp-client-5.7.1.jar;slf4j-api-1.7.26.jar;slf4j-simple-1.7.26.jar
java -cp %CP% Send
这篇关于RabbitMQ文档翻译一(JAVA).Hello World!的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!