前面已经搭建起来了两主两从异步刷盘、同步复制的集群了,感兴趣的同学可以通过传送门查看: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依赖
org.apache.rocketmq
rocketmq-spring-boot-starter
2.0.3
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 {
@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 {
@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 {
@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。