SpringBoot集成RocketMQ4.5

       前面已经搭建起来了两主两从异步刷盘、同步复制的集群了，感兴趣的同学可以通过传送门查看：Linux下搭建RocketMQ4.5.2集群，现在讲讲在SpringBoot中集成RocketMQ。

一、环境说明

开发工具用的是IDEA，虚拟机上搭建的RocketMQ集群用的是4.5.2的，项目中导入rocket-spring-starter是2.0.3，深入查看就能看到用的rocketmq-client是4.5.1。

二、集成步骤

1、创建一个springboot项目，添加pom.xml中rocket-spring-starter依赖

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

2、 application.yml增加rocketmq相关配置参数

# RocketMQ配置
rocketmq:
  #nameserver集群地址
  name-server: 192.168.0.40:9876;192.168.0.41:9876;192.168.0.42:9876;192.168.0.75:9876
  #生产者参数配置
  producer:
    group: my-group1
    sendMessageTimeout: 300000
    compress-message-body-threshold: 4096
    max-message-size: 4194304
    retry-times-when-send-async-failed: 0
    retry-next-server: true
    retry-times-when-send-failed: 2
    topic: string-topic

  #消费者参数配置
  consumer:
    topic: string-topic
  # 非标的RocketMQTemplate的nameServer
  extNameServer: 192.168.0.44:9876

相信参数的意义大家都知道，我这里就不备注了，只是简单说明一下个别参数的意义：

name-server：集群地址，我集群搭建的环境是40，41，42，75，所以nameserver要写全，以英文;隔开。

extNameServer：非标准集群地址，也就是你当期使用的是name-server对应的集群，但是你还想跟另一个集群也发送消息，需要配置这个即可，我这里另外的单独弄了一个单机版的演示用，没再额外搭建集群，大家懂了就好。

3、 创建非标准RocketMQTemplate

pom.xml中导入rocket-spring-starter依赖以后，项目中可以注入一个RocketMQTemplate来发送消息，但是这个是针对你配置文件中name-server集群使用的，若你想给另外一个集群也发送消息，那么你就得另外创建一个额外的RocketMQTemplate。

/**
 * @Description: 非标RocketMQTemplate
 * @Author: **
 * @Date: 2019/10/12
 */
@ExtRocketMQTemplateConfiguration(nameServer = "${rocketmq.extNameServer}")
public class ExtRocketMQTemplate extends RocketMQTemplate {
}

该非标准RocketMQTemplate类只需要集成RocketMQTemplate就行，然后再加上@ExtRocketMQTemplateConfiguration注解，并配置nameServer即可。

如何使用该非标准RocketMQTemplate？只需要在发送消息的类中通过@Resource注入进来，并通过name属性来指定即可使用。下面我有具体的使用案例。

4、创建生产者 

/**
 * @Description: 生产者
 * @Author: **
 * @Date: 2019/10/12
 */
@Controller
public class Producer{

    @Autowired
    private RocketMQTemplate rocketMQTemplate;

    @Value("${rocketmq.producer.topic}")
    private String topic;

    @Resource(name="extRocketMQTemplate")
    private ExtRocketMQTemplate extRocketMQTemplate;

    @RequestMapping(value="/rocketmq/producer")
    public void sendMessage() throws Exception {

        //发送同步消息
        //第一个参数是发送的目的地，一般是放topic，也可以放topic:tag;第二个参数是消息
        SendResult sendResult = rocketMQTemplate.syncSend(topic, "Hello, sychronized message!");
        System.out.println("同步消息的结果："+sendResult);

        //发送异步消息
        //第一个参数是发送的目的地，一般是放topic，也可以放topic:tag;第二个参数是消息；
        //第三个参数是异步消息发送结果的回调
        rocketMQTemplate.asyncSend(topic, "Hello, asychronized message!", new SendCallback() {
            @Override
            public void onSuccess(SendResult sendResult) {
                System.out.println("异步消息发送成功，发送结果："+sendResult);
            }

            @Override
            public void onException(Throwable throwable) {
                System.out.println("异步消息发送失败，消息回调");
            }
        });

        //发送oneway消息
        //oneway消息就是只管发送，不管发送的结果如何
        rocketMQTemplate.sendOneWay(topic,"Hello, oneway message!");

        //发送带有tag的消息
        SendResult tagResult1 = rocketMQTemplate.syncSend(topic + ":test1", "Hello, tags:test1 message!");
        System.out.println("带有tag:test1的消息发送结果："+tagResult1);

        rocketMQTemplate.convertAndSend(topic + ":test2", "Hello, tags:test2 message!");

        //使用非标RocketMQTempalate发送消息到另外一个broker
        SendResult result = extRocketMQTemplate.syncSend(topic, "Hello, extRocketMQTemplate!");
        System.out.println("非标消息发送的结果："+result);
    }
}

说明：

syncSend(...)：发送同步消息，收到反馈结果以后才会结束，有消息发送的结果；

asyncSend(...)：异步发送，发送即结束，但是有消息发送结果的回调；

sendOneWay(...)：只管发送，不管发送成功或失败，没有消息发送的结果；

converAndSend(...)：发送带tag的消息，没有消息发送的结果。syncSend也可发送带tag的消息，同时也有消息发送的结果。发送带tag的消息，格式是topic:tag，不可有多个tag。

5、创建消费者

一个消费者只能订阅一个主题，由于发送了普通的消息、带tag的消息以及非标消息，因此需要建立三个消费者类。

/**
 * @Description: 普通消费者 
 * @Author: ***
 * @Date: 2019/10/12
 */
@Service
@RocketMQMessageListener(topic = "${rocketmq.consumer.topic}",consumerGroup = "my_consumer")
public class Consumer implements RocketMQListener<MessageExt> {
    @Override
    public void onMessage(MessageExt messageExt) {
        System.out.println("收到了消息："+new String(messageExt.getBody()));
    }
}

/**
 * @Description: 带tag的消费者
 * @Author: ***
 * @Date: 2019/10/12
 */
@Service
@RocketMQMessageListener(topic = "${rocketmq.consumer.topic}",selectorExpression = "test1",consumerGroup = "my_tag_consumer")
public class TagConsumer implements RocketMQListener<String> {
    @Override
    public void onMessage(String message) {
        System.out.println("收到的消息为："+message);
    }
}

 

/**
 * @Description: 非标消费者
 * @Author: ***
 * @Date: 2019/10/12
 */
@Service
@RocketMQMessageListener(nameServer = "${rocketmq.extNameServer}", topic = "${rocketmq.consumer.topic}", consumerGroup = "my_consumer_ext")
public class ExtConsumer implements RocketMQListener<String> {
    @Override
    public void onMessage(String message) {
        System.out.println("非标消息："+message);
    }
}

 说明：只需要在消费者端创建一个类，该类实现RocketMQListener重写onMessae方法即可。同时必须加上@RocketMQMessageListener注解，注解中topic必填，consumerGroup必填，若是非标消费者，则必须加上对应对nameServer，从配置文件中读取其自己的集群属性。

注：1、实现RocketMQListener接口以后，泛型中可写String，MessageExt等，String就是发送过来的消息，MessageExt包含收到的消息，topic等，可自己查看。

2、若消费者消费的是带tag的消息，则必须使用注解@RocketMQMessageListener的属性中必须加上selectorExpression匹配对应的tag，若不填写，则默认值是*。

三、代码测试

浏览器访问：http://localhost:8066/rocketmq/producer

运行结果如下：

说明：由于topic相同，selectorExpression默认值是*，因此消费同一个topic的消费者也会消费带tag的消息。因此test1出现两次，一次是普通消费者消费的，一次是带tag的消费者消费的。而test2只出现一次，则是普通消费者消费一次，带tag的消费者因此指定消费test1，故没消费test2。