当前位置：首页 > news >正文

RocketMQTemplate.send() 与 RocketMQTemplate.syncSend() 方法详解

news 2025/8/11 20:23:01

Apache RocketMQ 是一款强大的分布式消息中间件，与 Spring Boot 集成后，通过 RocketMQTemplate 提供了多种方法来发送消息。其中，send() 和 syncSend() 是两个常用的发送消息方法，本文将深入探讨它们的区别以及详细解释这两个方法的参数列表。

引言

在分布式系统中，消息中间件是实现异步通信和解耦的关键组件之一。RocketMQ 通过提供多样化的发送消息方法，满足不同场景下的需求。在 RocketMQTemplate 中，send() 和 syncSend() 是两个常用的方法，但它们的用法和行为有一些重要的区别。

RocketMQTemplate.send() 方法详解

方法签名

SendResult send(String destination, Message<?> message, long timeout, int delayLevel, SendCallback sendCallback) throws RocketMQException;

参数列表

destination: 目标主题（Topic）的名称，指定消息发送到哪个主题。
message: 要发送的消息，类型为 Message<?>。Message 是 RocketMQ 中表示消息的对象，其中包含了消息的主体、标签、键等信息。
timeout: 发送消息的超时时间，单位为毫秒。如果在指定的时间内未能成功发送消息，则会抛出 RocketMQException 异常。
delayLevel: 延迟级别，用于设置消息的延迟投递时间。具体的延迟时间取决于 RocketMQ 的配置。
sendCallback: 发送消息的回调函数。可以通过实现 SendCallback 接口，处理发送消息的结果，包括成功和异常情况。

方法用法

SendResult sendResult = rocketMQTemplate.send("topic", MessageBuilder.withPayload("Hello, RocketMQ!").setHeader("key", "value").build(), 3000, 3, new SendCallback() {@Overridepublic void onSuccess(SendResult sendResult) {// 处理成功回调}@Overridepublic void onException(Throwable e) {// 处理异常回调}
});

在这个例子中，我们使用 send() 方法发送了一条消息到名为 "topic" 的主题。通过 MessageBuilder 构建消息体，并设置了超时时间、延迟级别以及发送回调函数。

RocketMQTemplate.syncSend() 方法详解

方法签名

SendResult syncSend(String destination, Message<?> message, long timeout) throws RocketMQException;

参数列表

destination: 目标主题（Topic）的名称，指定消息发送到哪个主题。
message: 要发送的消息，类型为 Message<?>。Message 是 RocketMQ 中表示消息的对象，其中包含了消息的主体、标签、键等信息。
timeout: 发送消息的超时时间，单位为毫秒。如果在指定的时间内未能成功发送消息，则会抛出 RocketMQException 异常。

方法用法

SendResult syncResult = rocketMQTemplate.syncSend("topic", MessageBuilder.withPayload("Hello, RocketMQ!").setHeader("key", "value").build(), 3000);

在这个例子中，我们使用 syncSend() 方法发送了一条消息到名为 "topic" 的主题。通过 MessageBuilder 构建消息体，并设置了超时时间。

区别与选择

异步与同步：send() 方法是异步的，它会立即返回，而消息的发送结果则通过回调函数处理。而 syncSend() 方法是同步的，它会阻塞当前线程，直到消息发送完成并返回发送结果。
回调函数：send() 方法允许通过回调函数处理消息的发送结果，包括成功和异常情况。而 syncSend() 方法则直接返回发送结果，不需要额外的回调处理。
适用场景：如果对异步回调更感兴趣，或者需要在消息发送后继续执行其他操作，可以选择使用 send() 方法。如果希望简单地发送消息并等待结果，可以选择使用 syncSend() 方法。