rocketmq入门篇之集成springboot

1.安装

rocketmq支持单机和集群部署方式，目前我们做测试使用单机部署方式就可以了。

安装包下载地址
https://rocketmq.apache.org/download/
本次演示使用4.6.1的版本
安装步骤：

1.解压zip包

2.进入rocketmq目录

3.进入bin目录

4.启动mqnamesrv.cmd

5.启动mqbroker.cmd

命令是 mqbroker.cmd -n localhost:9876，localhost:9876是我们刚刚启动的nameserver的地址

到此rocketmq的安装就算完成了，只要保证nameserver 和 broker启动就可以了。

6.启动rocketmq控制台

为了方便管理rocketmq的集群信息以及topic等信息，rocketmq官方提供了一个控制台的Java项目，使用该项目我们可以可视化的查询和修改rocketmq的信息。

1.下载控制台源码

https://github.com/apache/rocketmq-dashboard

2.修改application.yml文件

我们需要把nameserver的地址做修改，替换成我们自己部署的nameserver地址。

3.mvn clean package 构建

4.java -jar 打包好的jar文件即可

5.浏览器访问

最终我们可以看到这样一个页面，访问的地址要根据你们application.yml的端口号，比如我的端口号是9001
访问地址就是http://localhost:9001

2.spring-boot集成

1.新建spring-boot工程

导入rocketmq依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <parent>
    <artifactId>springboot-mq-integration-demo</artifactId>
    <groupId>org.mq.integration</groupId>
    <version>1.0-SNAPSHOT</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>
  <artifactId>springboot-mq-integration-demo-rocketmq</artifactId>
  <packaging>pom</packaging>
  <modules>
    <module>rocketmq-producer</module>
    <module>rocketmq-consumer</module>
  </modules>

  <properties>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
    <rocketmq.starter.version>2.2.2</rocketmq.starter.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.apache.rocketmq</groupId>
      <artifactId>rocketmq-spring-boot-starter</artifactId>
      <version>${rocketmq.starter.version}</version>
    </dependency>
  </dependencies>

</project>

2.创建producer

application.yml配置

server:
  port: 9001

rocketmq:
  name-server: 127.0.0.1:9876
  producer:
    group: test-topic-group
    sendMessageTimeout: 300000

demo:
  rocketmq:
    extNameServer: 127.0.0.1:9876
    ext:
      useTLS: false

新增一个controller

package org.mq.integration.producer.controller;

import org.apache.rocketmq.client.producer.SendResult;
import org.apache.rocketmq.spring.core.RocketMQTemplate;
import org.apache.rocketmq.spring.support.RocketMQHeaders;
import org.springframework.messaging.Message;
import org.springframework.messaging.support.MessageBuilder;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;
import java.util.ArrayList;
import java.util.List;

@RestController
public class ProducerController {

        @Resource
        private RocketMQTemplate rocketMQTemplate;

        /**
         * 普通单条消息发送
         */
        @RequestMapping("/send")
        public void testSimpleMessage() {
            Message<String> message = MessageBuilder.withPayload("Hello RocketMQ Msg").
                setHeader(RocketMQHeaders.KEYS, "KEY_1").build();
            SendResult sendResult = rocketMQTemplate.syncSend("test-topic", message, 60000);
            System.out.println("send result" + sendResult);
        }

        /**
         * 普通多条消息发送
         */
        @RequestMapping("/sendBatch")
        public void testBatchMessage() {
            List<Message> messages = new ArrayList<>();
            for (int i = 0; i < 10; i++) {
                Message<String> message = MessageBuilder.withPayload("Hello RocketMQ Batch Msg#" + i).
                    setHeader(RocketMQHeaders.KEYS, "KEY_" + i).build();
                messages.add(message);
            }
            SendResult sendResult = rocketMQTemplate.syncSend("test-batch-topic", messages, 60000);
            System.out.println("batch send result" + sendResult);
        }

        /**
         * 延迟消息发送
         */
        @RequestMapping("/sendDelay")
        public void testDelayMessage() {
            Message<String> message = MessageBuilder.withPayload("Hello RocketMQ Delay Msg").
                setHeader(RocketMQHeaders.KEYS, "KEY_1").build();
            SendResult sendResult = rocketMQTemplate.syncSend("test-delay-topic", message, 60000, 3);
            System.out.println("delay send result" + sendResult);
        }

    }

生产者发送消息spring为我们同一抽象了一个RocketMQTemplate 的bean，我们需要发送消息只需要注入即可使用了。

3.创建consumer

application.yml配置

server:
  port: 9012

rocketmq:
  name-server: localhost:9876
  consumer:
    group: my-group2
    topic: test-tag-topic
    tlsEnable: false

新建MessageConsumer

package org.mq.integration.consumer.consumer;

import org.apache.rocketmq.spring.annotation.ConsumeMode;
import org.apache.rocketmq.spring.annotation.MessageModel;
import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

/**
* StringConsumer
*/
@Service
    @RocketMQMessageListener(topic = "test-topic", consumerGroup = "test-topic-group-consumer",
                             messageModel = MessageModel.CLUSTERING, consumeMode = ConsumeMode.CONCURRENTLY)
    public class MessageConsumer implements RocketMQListener<String> {

        private static final Logger log = LoggerFactory.getLogger(MessageConsumer.class);

        @Override
        public void onMessage(String message) {
            log.info("MessageConsumer received: " + message);
        }

    }

新建BatchMessageConsumer

package org.mq.integration.consumer.consumer;

import org.apache.rocketmq.spring.annotation.ConsumeMode;
import org.apache.rocketmq.spring.annotation.MessageModel;
import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

/**
 * BatchMessageConsumer
 */
@Service
@RocketMQMessageListener(topic = "test-batch-topic", consumerGroup = "test-batch-topic-group-consumer",
        messageModel = MessageModel.CLUSTERING, consumeMode = ConsumeMode.CONCURRENTLY)
public class BatchMessageConsumer implements RocketMQListener<String> {

    private static final Logger log = LoggerFactory.getLogger(BatchMessageConsumer.class);

    @Override
    public void onMessage(String message) {
        log.info("BatchMessageConsumer received: " + message);
    }

}

新建DelayMessageConsumer

package org.mq.integration.consumer.consumer;

import org.apache.rocketmq.spring.annotation.ConsumeMode;
import org.apache.rocketmq.spring.annotation.MessageModel;
import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

/**
 * DelayMessageConsumer
 */
@Service
@RocketMQMessageListener(topic = "test-delay-topic", consumerGroup = "test-delay-topic-group-consumer",
        messageModel = MessageModel.CLUSTERING, consumeMode = ConsumeMode.CONCURRENTLY)
public class DelayMessageConsumer implements RocketMQListener<String> {

    private static final Logger log = LoggerFactory.getLogger(DelayMessageConsumer.class);

    @Override
    public void onMessage(String message) {
        log.info("DelayMessageConsumer received: " + message);
    }

}

4.rocketmq控制台创建topic

进入rocketmq控制台
点击Topic->ADD/UPDATE

新增即可

注意新增topic时候上面的数字选项一定不要修改，如果大家了解的情况可以更改，如果刚接触别轻易修改这些值

3.运行测试

分别启动生产者和消费者应用
调用生产者的controller接口进行消息发送
http://localhost:9011/send
http://localhost:9011/sendBatch
http://localhost:9011/sendDelay
分别查看生产者和消费者日志

2022-09-17 16:14:56.189  INFO 3136 --- [nio-9011-exec-8] o.m.i.p.controller.ProducerController    : send resultSendResult [sendStatus=SEND_OK, msgId=7F0000010C4018B4AAC255E254BB000C, offsetMsgId=0200000100002A9F0000000003005EB1, messageQueue=MessageQueue [topic=test-topic, brokerName=yangt-dev, queueId=10], queueOffset=0]

2022-09-17 16:14:56.198  INFO 16576 --- [roup-consumer_2] o.m.i.consumer.consumer.MessageConsumer  : MessageConsumer received: Hello RocketMQ Msg