添加依賴

類似spring-boot-starter-web等依賴也是需要加的

<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-spring-boot-starter</artifactId>
    <version>2.0.4</version>
</dependency>

配置文件配置

rocketmq:
  # NameServer地址
  name-server: 192.168.0.1:9876
  # 生產者組名
  producer:
    group: boot-producer

編寫生產者

生產者，僅需要注入RocketMQTemplate這個類就可以發送消息，本例將消息的發送寫到controller裏

不同於rocketmq-client，RocketMQTemplate發送消息使用destination參數來代表Topic和Tag，格式爲"Topic:Tag"

@RestController
@RequestMapping("/rocketmq")
public class RocketmqController {

    @Autowired
    private RocketMQTemplate rocketMQTemplate;

    @RequestMapping("/send/message/{tag}")
    public String sendMessage(@PathVariable("tag") String tag) {
        # 拼接出Topic與Tag
        rocketMQTemplate.convertAndSend("springboot-rocketmq:" + tag, "Hello springboot rocketmq");
        return "success";
    }
}

編寫消費者

通過之前的博客，我們知道，消費者是一個監聽器，需要一直運行。所以我們要將消費者註冊到Spring裏成爲一個監聽器。那麼就會使用@Component這個註解。此外我們還會使用@RocketMQMessageListener來標識這是一個RocketMQ消費者

我們可以來看一下@RocketMQMessageListener這個註解裏有什麼

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RocketMQMessageListener {
    String NAME_SERVER_PLACEHOLDER = "${rocketmq.name-server:}";
    String ACCESS_KEY_PLACEHOLDER = "${rocketmq.consumer.access-key:}";
    String SECRET_KEY_PLACEHOLDER = "${rocketmq.consumer.secret-key:}";
    String TRACE_TOPIC_PLACEHOLDER = "${rocketmq.consumer.customized-trace-topic:}";
    String ACCESS_CHANNEL_PLACEHOLDER = "${rocketmq.access-channel:}";

    // 消費者組名
    String consumerGroup();

    // 主題
    String topic();

    // 過濾類型，有Tag過濾和SQL過濾（SelectorType.TAG/SelectorType.SQL92）
    SelectorType selectorType() default SelectorType.TAG;

    // 過濾的表達式
    String selectorExpression() default "*";

    // ConsumeMode.CONCURRENTLY（多線程同時消費），ConsumeMode.ORDERLY（單線程消費）
    ConsumeMode consumeMode() default ConsumeMode.CONCURRENTLY;

    // MessageModel.CLUSTERING（負載均衡），MessageModel.BROADCASTING（廣播）
    MessageModel messageModel() default MessageModel.CLUSTERING;

    // 消費相關的其他限制
    int consumeThreadMax() default 64;

    long consumeTimeout() default 30000L;

    String accessKey() default "${rocketmq.consumer.access-key:}";

    String secretKey() default "${rocketmq.consumer.secret-key:}";

    boolean enableMsgTrace() default true;

    String customizedTraceTopic() default "${rocketmq.consumer.customized-trace-topic:}";

    String nameServer() default "${rocketmq.name-server:}";

    String accessChannel() default "${rocketmq.access-channel:}";
}

理解了這個註解，就不難理解下面的例子了

@Slf4j
@Component
@RocketMQMessageListener(topic = "springboot-rocketmq", selectorExpression = "tag1", consumerGroup = "boot-consumer")
public class Consumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String s) {
      log.info(s);
    }
}