此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring AMQP 3.2.0! |
回复管理
现有的支持MessageListenerAdapter
already 允许您的方法具有非 void 返回类型。
在这种情况下,调用的结果将封装在发送到ReplyToAddress
标头,或发送到侦听程序上配置的默认地址。
您可以使用@SendTo
消息抽象的注释。
假设我们的processOrder
方法现在应该返回一个OrderStatus
,我们可以这样写来自动发送回复:
@RabbitListener(destination = "myQueue")
@SendTo("status")
public OrderStatus processOrder(Order order) {
// order processing
return status;
}
如果需要以独立于传输的方式设置其他 Headers,则可以返回Message
相反,如下所示:
@RabbitListener(destination = "myQueue")
@SendTo("status")
public Message<OrderStatus> processOrder(Order order) {
// order processing
return MessageBuilder
.withPayload(status)
.setHeader("code", 1234)
.build();
}
或者,您可以使用MessagePostProcessor
在beforeSendReplyMessagePostProcessors
Container Factory 属性来添加更多标头。
从版本 2.2.3 开始,被调用的 bean/方法在回复消息中可用,它可以在消息后处理器中使用,将信息传回给调用者:
factory.setBeforeSendReplyPostProcessors(msg -> {
msg.getMessageProperties().setHeader("calledBean",
msg.getMessageProperties().getTargetBean().getClass().getSimpleName());
msg.getMessageProperties().setHeader("calledMethod",
msg.getMessageProperties().getTargetMethod().getName());
return m;
});
从版本 2.2.5 开始,您可以配置ReplyPostProcessor
在发送回复消息之前对其进行修改;它在correlationId
标头已设置为匹配请求。
@RabbitListener(queues = "test.header", group = "testGroup", replyPostProcessor = "echoCustomHeader")
public String capitalizeWithHeader(String in) {
return in.toUpperCase();
}
@Bean
public ReplyPostProcessor echoCustomHeader() {
return (req, resp) -> {
resp.getMessageProperties().setHeader("myHeader", req.getMessageProperties().getHeader("myHeader"));
return resp;
};
}
从版本 3.0 开始,您可以在容器工厂而不是 Comments 上配置后处理器。
factory.setReplyPostProcessorProvider(id -> (req, resp) -> {
resp.getMessageProperties().setHeader("myHeader", req.getMessageProperties().getHeader("myHeader"));
return resp;
});
这id
parameter 是侦听器 ID。
注释上的设置将取代出厂设置。
这@SendTo
value 被假定为回复exchange
和routingKey
对,它跟在exchange/routingKey
模式
其中,可以省略其中一个部分。
取值如下:
-
thing1/thing2
:这replyTo
exchange 和routingKey
.thing1/
:这replyTo
exchange 和默认值 (空)routingKey
.thing2
或/thing2
:这replyTo
routingKey
和默认 (空) 交换。 或空的:/
replyTo
default exchange 和默认的routingKey
.
此外,您还可以使用@SendTo
没有value
属性。
这种情况等于空的sendTo
模式。@SendTo
仅在入站邮件没有replyToAddress
财产。
从版本 1.5 开始,@SendTo
value 可以是 bean 初始化 SPEL 表达式,如以下示例所示:
@RabbitListener(queues = "test.sendTo.spel")
@SendTo("#{spelReplyTo}")
public String capitalizeWithSendToSpel(String foo) {
return foo.toUpperCase();
}
...
@Bean
public String spelReplyTo() {
return "test.sendTo.reply.spel";
}
表达式的计算结果必须为String
,可以是简单的队列名称(发送到默认 exchange)或使用
表单exchange/routingKey
如前面的示例所述。
这#{…} expression 在初始化期间计算一次。 |
对于动态回复路由,邮件发件人应包含reply_to
message 属性或使用替代
运行时 SpEL 表达式(在下一个示例后描述)。
从版本 1.6 开始,@SendTo
可以是在运行时根据请求评估的 SPEL 表达式
和 reply,如下例所示:
@RabbitListener(queues = "test.sendTo.spel")
@SendTo("!{'some.reply.queue.with.' + result.queueName}")
public Bar capitalizeWithSendToSpel(Foo foo) {
return processTheFooAndReturnABar(foo);
}
SPEL 表达式的运行时性质用!{…}
分隔符。
评估上下文#root
object 具有三个属性:
-
request
:这o.s.amqp.core.Message
request 对象。 -
source
:这o.s.messaging.Message<?>
转换后。 -
result
:方法结果。
上下文有一个 map 属性访问器、一个标准类型转换器和一个 bean 解析器,它允许
context 被引用(例如@someBeanName.determineReplyQ(request, result)
).
总之,#{…}
在初始化期间计算一次,使用#root
object 是应用程序上下文。
Bean 由其名称引用。!{…}
在运行时针对每条消息进行评估,其中根对象具有前面列出的属性。
Bean 以其名称引用,前缀为 .@
从版本 2.1 开始,还支持简单的属性占位符(例如,${some.reply.to}
).
对于早期版本,可以使用以下方法作为解决方法,如下例所示:
@RabbitListener(queues = "foo")
@SendTo("#{environment['my.send.to']}")
public String listen(Message in) {
...
return ...
}