添加依赖

类似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);
    }
}