二 RabbitMQ

AMQP

高级消息队列协议（AMQP）是面向消息中间件的平台无关的有线协议。Spring AMQP项目将核心Spring概念应用于基于AMQP的消息传递解决方案的开发。Spring Boot为通过RabbitMQ使用AMQP提供了多种便利，包括Spring Boot starter AMQP“starter”。

RabbitMQ支持

RabbitMQ是一个基于AMQP协议的轻量级、可靠、可扩展和可移植的消息代理。Spring使用RabbitMQ通过AMQP协议进行通信。

Properties

spring.rabbitmq.host=localhost
spring.rabbitmq.port=5672
spring.rabbitmq.username=admin
spring.rabbitmq.password=secret

或者，您可以使用addresses属性配置相同的连接

Properties

spring.rabbitmq.addresses=amqp://admin:secret@localhost

以这种方式指定地址时，将忽略主机和端口属性。如果地址使用amqps协议，则会自动启用SSL支持。

有关更多受支持的基于属性的配置选项，请参阅RabbitProperties。要配置Spring AMQP使用的RabbitMQ ConnectionFactory的较低级别详细信息，请定义ConnectionFactoryCustomizer bean。

如果上下文中存在ConnectionNamestrategybean，则将自动使用它命名由自动配置的CachingConnectionFactory创建的连接

发送消息

Spring的AmqpTemplate和AmqpAdmin是自动配置的，您可以将它们直接自动关联到您自己的bean中

@Component
public class MyBean {

    private final AmqpAdmin amqpAdmin;

    private final AmqpTemplate amqpTemplate;

    public MyBean(AmqpAdmin amqpAdmin, AmqpTemplate amqpTemplate) {
        this.amqpAdmin = amqpAdmin;
        this.amqpTemplate = amqpTemplate;
    }

    // ...

}

RabbitMessagingTemplate可以以类似的方式注入。如果定义了MessageConverter bean，它将自动关联到自动配置的AmqpTemplate

Properties

spring.rabbitmq.template.retry.enabled=true
spring.rabbitmq.template.retry.initial-interval=2s

如有必要，任何组织。springframework。amqp。果心定义为bean的队列自动用于在RabbitMQ实例上声明相应的队列。

要重试操作，可以在AmqpTemplate上启用重试（例如，在代理连接丢失的情况下）

默认情况下禁用重试。还可以通过声明RabbitRetryTemplateCustomizer bean以编程方式自定义RetryTemplate。

如果需要创建更多的rabbitmplate实例，或者希望覆盖默认值，Spring Boot提供了一个rabbitmplateconfigurer bean，您可以使用与自动配置使用的工厂相同的设置来初始化rabbitmplate。

向流发送消息

要向特定流发送消息，请指定流的名称

Properties

spring.rabbitmq.stream.name=my-stream

如果定义了MessageConverter、StreamMessageConverter或ProducerCustomizer bean，则它会自动关联到自动配置的RabbitStreamTemplate。

如果需要创建更多RabbitStreamTemplate实例，或者希望覆盖默认值，Spring Boot提供了一个RabbitStreamTemplateConfigurer bean，您可以使用与自动配置使用的工厂相同的设置来初始化RabbitStreamTemplate。

接收消息

当存在Rabbit基础结构时，可以使用@RabbitListener对任何bean进行注释，以创建监听器端点。如果未定义RabbitListenerContainerFactory，则会自动配置默认的SimpleRabbitListenerContainerFactory，您可以使用spring切换到直接容器。rabbitmq。侦听器。类型属性。如果定义了MessageConverter或MessageRecoverer bean，它将自动与默认工厂关联。

以下示例组件在someQueue队列上创建侦听器端点：

@Component
public class MyBean {

    @RabbitListener(queues = "someQueue")
    public void processMessage(String content) {
        // ...
    }

}

如果需要创建更多RabbitListenerContainerFactory实例，或者如果要覆盖默认值，Spring Boot提供了一个SimpleRabbitListenerContainerFactoryConfigurer和一个DirectRabbitListenerContainerFactoryConfigurer，可用于初始化SimpleRabbitListenerContainerFactory和DirectRabbitListenerContainerFactory，设置与自动配置使用的工厂相同。

例如，以下配置类公开了另一个使用特定MessageConverter的工厂

@Configuration(proxyBeanMethods = false)
public class MyRabbitConfiguration {

    @Bean
    public SimpleRabbitListenerContainerFactory myFactory(SimpleRabbitListenerContainerFactoryConfigurer configurer) {
        SimpleRabbitListenerContainerFactory factory = new SimpleRabbitListenerContainerFactory();
        ConnectionFactory connectionFactory = getCustomConnectionFactory();
        configurer.configure(factory, connectionFactory);
        factory.setMessageConverter(new MyMessageConverter());
        return factory;
    }

    private ConnectionFactory getCustomConnectionFactory() {
        return ...
    }

}

然后，您可以在任何带@RabbitListener注释的方法中使用工厂

@Component
public class MyBean {

    @RabbitListener(queues = "someQueue", containerFactory = "myFactory")
    public void processMessage(String content) {
        // ...
    }

}

您可以启用重试来处理侦听器引发异常的情况。默认情况下，使用RejectAndDontRequeueRecoverer，但您可以定义自己的MessageRecoverer。重试次数用尽时，消息将被拒绝，并被丢弃或路由到死信交换（如果代理配置为这样做）。默认情况下，将禁用重试。还可以通过声明RabbitRetryTemplateCustomizer bean以编程方式自定义RetryTemplate

重点

默认情况下，如果禁用重试，并且侦听器引发异常，则将无限期重试传递。您可以通过两种方式修改此行为：将defaultRequeueRejected属性设置为false，以便尝试零次重新传递，或引发AmqpRejectAndDontRequeueException以指示应拒绝消息。后者是启用重试并达到最大传递尝试次数时使用的机制