SpringBoot整合RocketMQ实现入门案例

Posted 刘Java

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot整合RocketMQ实现入门案例相关的知识,希望对你有一定的参考价值。

此前我们学习了如何在linux安装RocketMQ,以及使用Java程序公网连接的一系列准备工作,并且学习了Spring整合RocketMQ的第一个案例

现在我们来学习Spring Boot如何整合RocketMQ实现更加简单的使用!

文章目录

1 创建maven项目

创建一个maven项目。引入springboot和rocketmq的pom依赖。

为了让用户能够更灵活、方便地结合Spring Boot使用RocketMQ消息客户端,Apache RocketMQ社区推出了spring-boot-starter实现,因此这里我们不需要引入原始的rocketmq-client,而是引入rocketmq-spring-boot-starter。

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.3.5.RELEASE</version>
    <relativePath/>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <!--RocketMQ依赖-->
    <!-- https://mvnrepository.com/artifact/org.apache.rocketmq/rocketmq-spring-boot-starter -->
    <dependency>
        <groupId>org.apache.rocketmq</groupId>
        <artifactId>rocketmq-spring-boot-starter</artifactId>
        <version>2.2.1</version>
    </dependency>
</dependencies>

建立如下目录结构:

项目启动类RocketMQApplication:

@SpringBootApplication
public class RocketmqSpringbootApplication

   public static void main( String[] args )

      SpringApplication.run( RocketmqSpringbootApplication.class, args );
   


2 配置文件

在配置文件中,我们编写rocketmq的配置信息。需要注意的是,如果你配置了rocketmq:consumer下面的参数,那么将会默认创建一个consumer。

rocketmq:
  producer:
    group: bootProducer
  name-server: xx.94.xx.xx:9876
  #自定义的配置
  topic: bootTopic
  group: bootConsumer

3 生产者

通过引入RocketMQTemplate代替DefaultMQProducer对象作为消息生产者,RocketMQTemplate被Spring boot自动配置,无需手动配置,我们直接引入即可。

@RestController
public class MqController

   /**
    * 引入template代替defaultMQProducer作为生产者
    */
   @Resource
   private RocketMQTemplate rocketMQTemplate;

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

   @GetMapping( "/testMq/flag" )
   public String testMq( @PathVariable @NotNull String flag )
      //通过MessageBuilder构建消息
      Message<String> message = MessageBuilder.withPayload( flag ).build();
      //同步发送该消息,获取发送结果
      SendResult result = rocketMQTemplate.syncSend( topic, message );
      return result.getMsgId() + "----" + result.getSendStatus();
   

4 消费者

通过实现RocketMQListener接口的对象作为消费者,实现onMessage方法,该方法的参数就是消息内容,通过在类上配置@RocketMQMessageListener注解将其包装为一个RocketMQ的消费者并自动启动。

@Service
@RocketMQMessageListener( consumerGroup = "$rocketmq.group", topic = "$rocketmq.topic" )
public class Consumer implements RocketMQListener<String>

   private static final Logger logger = LoggerFactory.getLogger( Consumer.class );

   @Override
   public void onMessage( String message )

      System.out.println( "message:  " + message );
      //模拟消费失败,抛出异常
      if( "1".equals( message ) )
         message = null;
         message.toString();
      
   

5 测试

启动项目。访问http://localhost:8080/testMq/xxx发送消息,可以观察到消息消费成功,访问http://localhost:8080/testMq/1发送错误消息,可以观察到消息消费失败,并且重试消费。关于消息重试:RocketMQ的消息重试(消息重投)

不建议使用RocketMQTemplate或者@RocketMQMessageListener的方式收发消息,因为他们提供的自动配置属性并不全,并且如果不熟悉自动配置的原理的话可能会有个好走不过你的坑,建议使用此前的配置。

以上是关于SpringBoot整合RocketMQ实现入门案例的主要内容,如果未能解决你的问题,请参考以下文章

八.RocketMQ极简入门-在SpringBoot中使用RocketMQ

优效学院JAVA高级架构师视频教程

SpringBoot(17)---SpringBoot整合RocketMQ

4 SpringBoot整合RocketMQ实现消息发送和接收

SpringBoot整合RocketMQ

Springboot 整合 rocketmq及调度方案实现