010 使用RabbitMQ处理消息

原文

https://spring.io/guides/gs/messaging-rabbitmq/

直译

设置RabbitMQ 代理

在构建消息传递应用程序之前，需要设置将处理接收和发送消息的服务器。

RabbitMQ是一个AMQP服务器。该服务器可从http://www.rabbitmq.com/download.html免费获得。您可以手动下载，或者如果您使用的是带自制软件的Mac：

brew install rabbitmq

解压缩服务器并使用默认设置启动它。

rabbitmq-server

你应该看到这样的东西：

            RabbitMQ 3.1.3. Copyright (C) 2007-2013 VMware, Inc.
##  ##      Licensed under the MPL.  See http://www.rabbitmq.com/
##  ##
##########  Logs: /usr/local/var/log/rabbitmq/rabbit@localhost.log
######  ##        /usr/local/var/log/rabbitmq/rabbit@localhost-sasl.log
##########
            Starting broker... completed with 6 plugins.

如果您在本地运行docker，也可以使用Docker Compose快速启动RabbitMQ服务器。有一个docker-compose.yml在Github上“完整”的项目的根。这很简单：

docker-compose.yml

rabbitmq:
  image: rabbitmq:management
  ports:
    - "5672:5672"
    - "15672:15672"

使用当前目录中的此文件，您可以运行docker-compose up以在容器中运行RabbitMQ。

创建一个RabbitMQ消息接收器

使用任何基于消息传递的应用程序，您需要创建一个响应已发布消息的接收器。

src/main/java/hello/Receiver.java

package hello;

import java.util.concurrent.CountDownLatch;
import org.springframework.stereotype.Component;

@Component
public class Receiver {

    private CountDownLatch latch = new CountDownLatch(1);

    public void receiveMessage(String message) {
        System.out.println("Received <" + message + ">");
        latch.countDown();
    }

    public CountDownLatch getLatch() {
        return latch;
    }

}

这Receiver是一个简单的POJO，它定义了一种接收消息的方法。当您注册接收消息时，您可以将其命名为任何名称。

为方便起见，这个POJO也有一个CountDownLatch。这允许它发出信号表示已收到消息。这是您不太可能在生产应用程序中实现的。
注册监听器并发送消息
Spring AMQP RabbitTemplate提供了使用RabbitMQ发送和接收消息所需的一切。具体来说，您需要配置：

消息侦听器容器

声明队列，交换以及它们之间的绑定

用于发送一些消息以测试侦听器的组件

Spring Boot会自动创建连接工厂和RabbitTemplate，从而减少您必须编写的代码量。
您将使用RabbitTemplate发送消息，并将Receiver使用消息侦听器容器注册a 以接收消息。连接工厂驱动两者，允许它们连接到RabbitMQ服务器。

src/main/java/hello/Application.java

package hello;

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.TopicExchange;
import org.springframework.amqp.rabbit.connection.ConnectionFactory;
import org.springframework.amqp.rabbit.listener.SimpleMessageListenerContainer;
import org.springframework.amqp.rabbit.listener.adapter.MessageListenerAdapter;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
public class Application {

    static final String topicExchangeName = "spring-boot-exchange";

    static final String queueName = "spring-boot";

    @Bean
    Queue queue() {
        return new Queue(queueName, false);
    }

    @Bean
    TopicExchange exchange() {
        return new TopicExchange(topicExchangeName);
    }

    @Bean
    Binding binding(Queue queue, TopicExchange exchange) {
        return BindingBuilder.bind(queue).to(exchange).with("foo.bar.#");
    }

    @Bean
    SimpleMessageListenerContainer container(ConnectionFactory connectionFactory,
            MessageListenerAdapter listenerAdapter) {
        SimpleMessageListenerContainer container = new SimpleMessageListenerContainer();
        container.setConnectionFactory(connectionFactory);
        container.setQueueNames(queueName);
        container.setMessageListener(listenerAdapter);
        return container;
    }

    @Bean
    MessageListenerAdapter listenerAdapter(Receiver receiver) {
        return new MessageListenerAdapter(receiver, "receiveMessage");
    }

    public static void main(String[] args) throws InterruptedException {
        SpringApplication.run(Application.class, args).close();
    }

}

@SpringBootApplication 是一个便利注释，添加了以下所有内容：

• @Configuration 标记该类作为应用程序上下文的bean定义的来源。

• @EnableAutoConfiguration 告诉Spring Boot开始根据类路径设置，其他bean和各种属性设置添加bean。

• 通常你会添加@EnableWebMvc一个Spring MVC应用程序，但Spring Boot会在类路径上看到spring-webmvc时自动添加它。这会将应用程序标记为Web应用程序并激活关键行为，例如设置a DispatcherServlet。

• @ComponentScan告诉Spring在包中寻找其他组件，配置和服务hello，允许它找到控制器。

该main()方法使用Spring Boot的SpringApplication.run()方法启动应用程序。您是否注意到没有一行XML？也没有web.xml文件。此Web应用程序是100％纯Java，您无需处理配置任何管道或基础结构。

listenerAdapter()方法中定义的bean在定义的容器中注册为消息侦听器container()。它将侦听“spring-boot”队列中的消息。因为Receiver该类是POJO，所以需要将其包装在MessageListenerAdapter指定要调用的位置receiveMessage。

JMS队列和AMQP队列具有不同的语义。例如，JMS仅向一个使用者发送排队的消息。虽然AMQP队列执行相同的操作，但AMQP生成器不会将消息直接发送到队列。相反，消息被发送到交换机，交换机可以转到单个队列，或扇出到多个队列，模仿JMS主题的概念。有关更多信息，请参阅了解AMQP。
消息监听器容器和接收器bean是您监听消息所需的全部内容。要发送消息，您还需要一个Rabbit模板。

该queue()方法创建AMQP队列。该exchange()方法创建主题交换。该binding()方法将这两者绑定在一起，定义RabbitTemplate发布到交换时发生的行为。

Spring AMQP要求将the Queue，the TopicExchange和Binding声明为顶级Spring bean才能正确设置。
在这种情况下，我们使用主题交换，并且队列与路由密钥绑定，foo.bar.#这意味着使用以路由键开头的任何消息foo.bar.都将路由到队列。

发送测试消息
测试消息由a发送CommandLineRunner，它还等待接收器中的锁存器并关闭应用程序上下文：

src/main/java/hello/Runner.java

package hello;

import java.util.concurrent.TimeUnit;

import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

@Component
public class Runner implements CommandLineRunner {

    private final RabbitTemplate rabbitTemplate;
    private final Receiver receiver;

    public Runner(Receiver receiver, RabbitTemplate rabbitTemplate) {
        this.receiver = receiver;
        this.rabbitTemplate = rabbitTemplate;
    }

    @Override
    public void run(String... args) throws Exception {
        System.out.println("Sending message...");
        rabbitTemplate.convertAndSend(Application.topicExchangeName, "foo.bar.baz", "Hello from RabbitMQ!");
        receiver.getLatch().await(10000, TimeUnit.MILLISECONDS);
    }

}

请注意，模板将消息路由到交换机，其路由密钥foo.bar.baz与绑定匹配。

可以在测试中模拟跑步者，以便可以单独测试接收器。

运行应用程序

该main()方法通过创建Spring应用程序上下文来启动该过程。这将启动消息侦听器容器，该容器将开始侦听消息。Runner然后有一个bean自动执行：它RabbitTemplate从应用程序上下文中检索并发送一个“来自RabbitMQ的Hello！” “spring-boot”队列中的消息。最后，它关闭Spring应用程序上下文，应用程序结束。

构建可执行的JAR

您可以使用Gradle或Maven从命令行运行该应用程序。或者，您可以构建一个包含所有必需依赖项，类和资源的可执行JAR文件，并运行该文件。这使得在整个开发生命周期中，跨不同环境等将服务作为应用程序发布，版本和部署变得容易。

如果您使用的是Gradle，则可以使用./gradlew bootRun。或者您可以使用构建JAR文件./gradlew build。然后你可以运行JAR文件：

java -jar build / libs / gs-messaging-rabbitmq-0.1.0.jar

如果您使用的是Maven，则可以使用该应用程序运行该应用程序./mvnw spring-boot:run。或者您可以使用构建JAR文件./mvnw clean package。然后你可以运行JAR文件：

java -jar target / gs-messaging-rabbitmq-0.1.0.jar

上面的过程将创建一个可运行的JAR。您也可以选择构建经典WAR文件。
您应该看到以下输出：

Sending message...
Received <Hello from RabbitMQ!>

摘要

恭喜！您刚刚使用Spring和RabbitMQ开发了一个简单的发布 - 订阅应用程序。还有更多，你可以使用Spring和RabbitMQ的做的比这里覆盖，但是这应该提供一个良好的开端。

扩展知识

RabbitMQ的安装／启动

https://www.rabbitmq.com/install-homebrew.html