Spring AMQP 官方文档中文版

更多官方文档翻译，尽在 geekdoc.top

geekdoc.top

一、前言

#preface

2. 最新消息

#whats-new

2.1. 自 2.2 以来 2.3 的变化

#changes-in-2-3-since-2-2

2.1.1. 连接工厂更改

#connection-factory-changes

2.1.2. @RabbitListener 变化

#rabbitlistener-changes

2.1.3. 消息转换器更改

#message-converter-changes

2.1.4. 测试更改

#testing-changes

2.1.5. Rabbit模板更改

#rabbittemplate-changes

2.1.6. 侦听器容器更改

#listener-container-changes

2.1.7. 消息后处理器更改

#messagepostprocessor-changes

2.1.8. 多个代理支持改进

#multiple-broker-support-improvements

2.1.9. RepublishMessageRecoverer 更改

#republishmessagerecoverer-changes

3. 介绍

#introduction

3.1. 快速导览

#quick-tour

3.1.1. 介绍

#introduction-2

兼容性

#compatibility

最快的入门知道

#very-very-quick

使用 XML 配置

#with-xml-configuration

使用 Java 配置

#with-java-configuration

使用 Spring Boot 自动配置和异步 POJO 侦听器

#with-spring-boot-auto-configuration-and-an-async-pojo-listener

4. 参考

#reference

4.1. 使用 Spring AMQP

#amqp

4.1.1. AMQP 抽象

#amqp-abstractions

Message

#message

交换

#exchange

队列

#queue

捆绑

#binding

4.1.2. 连接和资源管理

#connections

选择连接工厂

#choosing-factory

地址解析器

#addressresolver

命名连接

#naming-connections

阻塞的连接和资源限制

#blocked-connections-and-resource-constraints

配置底层客户端连接工厂

#connection-factory

RabbitConnectionFactoryBean 和配置 SSL

#rabbitconnectionfactorybean-configuring-ssl

连接到集群

#cluster

路由连接工厂

#routing-connection-factory

队列关联和 LocalizedQueueConnectionFactory

#queue-affinity

出版商确认和退货

#cf-pub-conf-ret

连接和通道侦听器

#connection-channel-listeners

记录通道关闭事件

#channel-close-logging

运行时缓存属性

#runtime-cache-properties

RabbitMQ 自动连接/拓扑恢复

#auto-recovery

4.1.3. 添加自定义客户端连接属性

#custom-client-props

4.1.4. AmqpTemplate

#amqp-template

添加重试功能

#template-retry

发布是异步的 — 如何检测成功和失败

#publishing-is-async

相关发布者确认和退货

#template-confirms

范围操作

#scoped-operations

多线程环境中的严格消息排序

#multi-strict

消息整合

#template-messaging

经验证的用户 ID

#template-user-id

使用单独的连接

#separate-connection

4.1.5. 发送消息

#sending-messages

消息生成器 API

#message-builder

发布者返回值

#publisher-returns

批处理

#template-batching

4.1.6. 接收消息

#receiving-messages

轮询消费者

#polling-consumer

异步消费者

#async-consumer

批量消息

#de-batching

消费者事件

#consumer-events

消费者标签

#consumerTags

注释驱动的侦听器端点

#async-annotation-driven

@RabbitListener 与批处理

#receiving-batch

使用容器工厂

#using-container-factories

异步 @RabbitListener 返回类型

#async-returns

线程和异步消费者

#threading

选择容器

#choose-container

检测空闲的异步消费者

#idle-containers

监控监听器性能

#micrometer

4.1.7. 容器和代理命名队列

#containers-and-broker-named-queues

4.1.8. 消息转换器

#message-converters

SimpleMessageConverter

#simple-message-converter

SerializerMessageConverter

#serializer-message-converter

Jackson2JsonMessageConverter

#json-message-converter

MarshallingMessageConverter

#marshallingmessageconverter

Jackson2XmlMessageConverter

#jackson2xml

ContentTypeDelegatingMessageConverter

#contenttypedelegatingmessageconverter

Java反序列化

#java-deserialization

消息属性转换器

#message-properties-converters

4.1.9. 修改消息 - 压缩等

#post-processing

4.1.10. 请求/回复消息

#request-reply

回复超时

#reply-timeout

RabbitMQ 直接回复

#direct-reply-to

与回复队列的消息关联

#message-correlation-with-a-reply-queue

回复侦听器容器

#reply-listener

异步Rabbit模板

#async-template

使用 AMQP 进行 Spring 远程处理

#remoting

4.1.11. 配置代理

#broker-configuration

标头交换

#headers-exchange

用于队列和交换的构建器 API

#builder-api

声明交换、队列和绑定的集合

#collection-declaration

有条件声明

#conditional-declaration

关于 id 和 name 属性的注释

#note-id-name

AnonymousQueue

#anonymous-queue

4.1.12. 代理事件监听器

#broker-events

4.1.13. 延迟消息交换

#delayed-message-exchange

4.1.14. RabbitMQ REST API

#management-rest-api

4.1.15. 异常处理

#exception-handling

4.1.16. 交易

#transactions

有条件回滚

#conditional-rollback

关于回滚接收消息的说明

#transaction-rollback

使用 RabbitTransactionManager

#using-rabbittransactionmanager

交易同步

#tx-sync

4.1.17. 消息侦听器容器配置

#containerAttributes

4.1.18. 监听器并发

#listener-concurrency

SimpleMessageListenerContainer

#simplemessagelistenercontainer

使用 DirectMessageListenerContainer

#using-directmessagelistenercontainer

4.1.19. 独家消费者

#exclusive-consumer

4.1.20. 侦听器容器队列

#listener-queues

4.1.21. 弹性：从错误和代理故障中恢复

#resilience-recovering-from-errors-and-broker-failures

交换、队列和绑定的自动声明

#automatic-declaration

同步操作失败和重试选项

#retry

使用批处理侦听器重试

#batch-retry

消息侦听器和异步情况

#async-listeners

Spring重试异常分类

#exception-classification-for-spring-retry

4.1.22. 多代理（或集群）支持

#multi-rabbit

4.1.23. 调试

#debugging

4.2. 日志子系统 AMQP Appenders

#logging

4.2.1. 共同属性

#common-properties

4.2.2. Log4j 2 附加程序

#log4j-2-appender

4.2.3. Logback Appender

#logback-appender

4.2.4. 自定义消息

#customizing-the-messages

4.2.5. 自定义客户端属性

#customizing-the-client-properties

简单字符串属性

#simple-string-properties

Logback 的高级技术

#advanced-technique-for-logback

4.2.6. 提供自定义队列实现

#providing-a-custom-queue-implementation

4.3. 示例应用程序

#sample-apps

4.3.1. “Hello World”示例

#hello-world-sample

同步示例

#hello-world-sync

异步示例

#hello-world-async

4.3.2. 股票交易

#stock-trading

4.3.3. 从非 Spring 应用程序接收 JSON

#spring-rabbit-json

4.4. 测试支持

#testing

4.4.1. @SpringRabbitTest

#spring-rabbit-test

4.4.2. Mockito Answer 实现

#mockito-answer

4.4.3. @RabbitListenerTest 和 RabbitListenerTestHarness

#test-harness

4.4.4. 使用 TestRabbitTemplate

#test-template

4.4.5. JUnit4 @Rules

#junit-rules

使用 BrokerRunning

#using-brokerrunning

使用 LongRunningIntegrationTest

#using-longrunningintegrationtest

4.4.6. JUnit5 条件

#junit5-conditions

使用 @RabbitAvailable 注释

#using-the-rabbitavailable-annotation

使用 @LongRunning 注释

#using-the-longrunning-annotation

5. Spring 集成 - 参考

#spring-integration-reference

5.1. Spring 集成 AMQP 支持

#spring-integration-amqp

5.1.1. 介绍

#spring-integration-amqp-introduction

5.1.2. 入站通道适配器

#inbound-channel-adapter

5.1.3. 出站通道适配器

#outbound-channel-adapter

5.1.4. 入站网关

#inbound-gateway

5.1.5. 出站网关

#outbound-gateway

6. 其他资源

#resources

6.1. 进一步阅读

#further-reading

附录 A：变更历史

#change-history

A.1. 当前版本

#current-release

A2。 以前的版本

#previous-whats-new

A.2.1. 自 2.1 以来 2.2 的变化

#changes-in-2-2-since-2-1

套餐变更

#package-changes

依赖变化

#dependency-changes

“破坏性” API 更改

#breaking-api-changes

ListenerContainer 变化

#listenercontainer-changes

@RabbitListener 变化

#rabbitlistener-changes-2

AMQP 日志记录 Appender 更改

#amqp-logging-appenders-changes

MessageListenerAdapter 更改

#messagelisteneradapter-changes

交换/队列声明更改

#exchangequeue-declaration-changes

连接工厂更改

#connection-factory-changes-2

新的 MessagePostProcessor 类

#new-messagepostprocessor-classes

其他变化

#other-changes

A.2.2. 自 2.0 以来 2.1 的变化

#changes-in-2-1-since-2-0

AMQP 客户端库

#amqp-client-library

套餐变更

#package-changes-2

发布商确认更改

#publisher-confirms-changes

侦听器容器工厂改进

#listener-container-factory-improvements

代理事件监听器

#broker-event-listener

RabbitAdmin 更改

#rabbitadmin-changes

Rabbit模板更改

#rabbittemplate-changes-2

消息转换

#message-conversion

管理 REST API

#management-rest-api-2

@RabbitListener 变化

#rabbitlistener-changes-3

异步 @RabbitListener 返回

#async-rabbitlistener-return

连接工厂 Bean 更改

#connection-factory-bean-changes

连接工厂更改

#connection-factory-changes-3

侦听器容器更改

#listener-container-changes-2

立即重新排队

#immediate-requeue

A.2.3. 2.0 自 1.7 以来的变化

#changes-in-2-0-since-1-7

使用 CachingConnectionFactory

#using-cachingconnectionfactory

AMQP 客户端库

#amqp-client-library-2

一般变化

#general-changes

删除的课程

#deleted-classes

新的侦听器容器

#new-listener-container

Log4j 附加程序

#log4j-appender

RabbitTemplate 变化

#rabbittemplate-changes-3

侦听器适配器

#listener-adapter

侦听器容器更改

#listener-container-changes-3

连接工厂更改

#connection-factory-changes-4

重试更改

#retry-changes

匿名队列命名

#anonymous-queue-naming

@RabbitListener 变化

#rabbitlistener-changes-4

容器条件回滚

#container-conditional-rollback

删除 Jackson 1.x 支持

#remove-jackson-1-x-support

JSON 消息转换器

#json-message-converter-2

XML 解析器

#xml-parsers

被阻止的连接

#blocked-connection

A.2.4. 自 1.6 以来 1.7 的变化

#changes-in-1-7-since-1-6

AMQP 客户端库

#amqp-client-library-3

Log4j 2 升级

#log4j-2-upgrade

Logback Appender

#logback-appender-2

Spring重试升级

#spring-retry-upgrade

FasterXML Jackson 升级

#fasterxml-jackson-upgrade

JUnit @Rules

#junit-rules-2

容器条件回滚

#container-conditional-rollback-2

连接命名策略

#connection-naming-strategy

侦听器容器更改

#listener-container-changes-4

A.2.5. 早期版本

#earlier-releases

A.2.6. 自 1.5 以来 1.6 的变化

#changes-in-1-6-since-1-5

测试支持

#testing-support

建造者

#builder

命名空间更改

#namespace-changes

侦听器容器更改

#listener-container-changes-5

AutoDeclare 和 RabbitAdmin 实例

#autodeclare-and-rabbitadmin-instances

AmqpTemplate：超时接收

#amqptemplate-receive-with-timeout

使用 AsyncRabbitTemplate

#using-asyncrabbittemplate

RabbitTemplate 变化

#rabbittemplate-changes-4

消息属性

#message-properties

RabbitAdmin 变化

#rabbitadmin-changes-2

@RabbitListener 变化

#rabbitlistener-changes-5

延迟消息交换

#delayed-message-exchange-2

交换内部标志

#exchange-internal-flag

CachingConnectionFactory 变化

#cachingconnectionfactory-changes

使用 RabbitConnectionFactoryBean

#using-rabbitconnectionfactorybean

Java反序列化

#java-deserialization-2

JSON MessageConverter

#json-messageconverter

记录 Appender

#logging-appenders

A.2.7. 自 1.4 以来 1.5 的变化

#changes-in-1-5-since-1-4

spring-erlang 不再支持

#spring-erlang-is-no-longer-supported

CachingConnectionFactory 变化

#cachingconnectionfactory-changes-2

控制容器队列声明行为的属性

#properties-to-control-container-queue-declaration-behavior

类包更改

#class-package-change

DefaultMessagePropertiesConverter 变化

#defaultmessagepropertiesconverter-changes

@RabbitListener 改进

#rabbitlistener-improvements

自动交换、队列和绑定声明

#automatic-exchange-queue-and-binding-declaration

RabbitTemplate 变化

#rabbittemplate-changes-5

RabbitManagementTemplate 添加

#rabbitmanagementtemplate-added

侦听器容器 Bean 名称 (XML)

#listener-container-bean-names-xml

类级@RabbitListener

#class-level-rabbitlistener

SimpleMessageListenerContainer：BackOff 支持

#simplemessagelistenercontainer-backoff-support

通道关闭记录

#channel-close-logging-2

应用程序事件

#application-events

消费者标签配置

#consumer-tag-configuration

使用 MessageListenerAdapter

#using-messagelisteneradapter

LocalizedQueueConnectionFactory 添加

#localizedqueueconnectionfactory-added

匿名队列命名

#anonymous-queue-naming-2

A.2.8. 自 1.3 以来 1.4 的变化

#changes-in-1-4-since-1-3

@RabbitListener 注解

#rabbitlistener-annotation

RabbitMessagingTemplate 添加

#rabbitmessagingtemplate-added

侦听器容器 missingQueuesFatal 属性

#listener-container-missingqueuesfatal-attribute

RabbitTemplate ConfirmCallback 接口

#rabbittemplate-confirmcallback-interface

RabbitConnectionFactoryBean 添加

#rabbitconnectionfactorybean-added

使用 CachingConnectionFactory

#using-cachingconnectionfactory-2

日志附加程序

#log-appender

侦听器队列

#listener-queues-2

RabbitTemplate：mandatory 和 connectionFactorySelector 表达式

#rabbittemplate-mandatory-and-connectionfactoryselector-expressions

侦听器和路由连接工厂

#listeners-and-the-routing-connection-factory

RabbitTemplate：RecoveryCallback 选项

#rabbittemplate-recoverycallback-option

MessageConversionException 改变

#messageconversionexception-change

RabbitMQ 3.4 兼容性

#rabbitmq-3-4-compatibility

ContentTypeDelegatingMessageConverter 添加

#contenttypedelegatingmessageconverter-added

A.2.9. 自 1.2 以来 1.3 的变化

#changes-in-1-3-since-1-2

监听器并发

#listener-concurrency-2

侦听器队列

#listener-queues-3

消费者优先

#consumer-priority-2

独家消费者

#exclusive-consumer-2

Rabbit管理员

#rabbit-admin

直接交换绑定

#direct-exchange-binding

AmqpTemplate 变化

#amqptemplate-changes

缓存连接工厂

#caching-connection-factory

绑定参数

#binding-arguments

路由连接工厂

#routing-connection-factory-2

MessageBuilder and MessagePropertiesBuilder

#messagebuilder-and-messagepropertiesbuilder

RetryInterceptorBuilder 改变

#retryinterceptorbuilder-change

RepublishMessageRecoverer 添加

#republishmessagerecoverer-added

默认错误处理程序（自 1.3.2 起）

#default-error-handler-since-1-3-2

侦听器容器“missingQueuesFatal”属性（自 1.3.5 起）

#listener-container-missingqueuesfatal-property-since-1-3-5

A.2.10. 自 1.1 以来对 1.2 的更改

#changes-to-1-2-since-1-1

RabbitMQ 版本

#rabbitmq-version

Rabbit管理员

#rabbit-admin-2

Rabbit模板

#rabbit-template

JSON 消息转换器

#json-message-converters

队列和其他项目的自动声明

#automatic-declaration-of-queues-and-other-items

AMQP 远程处理

#amqp-remoting

请求的心跳

#requested-heart-beats

A.2.11. 自 1.0 以来对 1.1 的更改

#changes-to-1-1-since-1-0

一般的

#general

AMQP Log4j Appender

#amqp-log4j-appender

更多官方文档翻译，尽在 geekdoc.top

geekdoc.top