SpringCloud(六) - RabbitMQ安装,三种消息发送模式,消息发送确认,消息消费确认(自动,手动)

2022-11-14 17:38:09 浏览数 (1)

1、安装erlang语言环境

1.1 创建 erlang安装目录

代码语言:javascript复制
mkdir erlang

1.2 上传解压压缩包

代码语言:javascript复制
上传到: /root/

解压缩# tar -zxvf otp_src_22.0.tar.gz

1.3 进入解压缩目录,指定目录并安装

代码语言:javascript复制
进入解压目录,指定安装目录# ./configure --prefix=/usr/local/kh96/erlang

安装# make install

添加环境变量# echo 'export PATH=$PATH:/usr/local/kh96/erlang/bin' >> /etc/profile

刷新环境变量# source /etc/profile

1.4 测试环境

代码语言:javascript复制
进入erlang环境#erl

退出# halt().

2、安装RabbitMQ

2.1上传解压压缩包

代码语言:javascript复制
第一步xx.tar.xz->xx.tar # /bin/xz -d rabbitmq-server-generic-unix-3.7.15.tar.xz

第二步#tar -xvf rabbitmq-server-generic-unix-3.7.15.tar

2.2 添加环境变量

代码语言:javascript复制
添加环境变量# echo 'export PATH=$PATH:/usr/local/kh96/rabbitmq/rabbitmq_server-3.7.15/sbin' >> /etc/profile

刷新环境变量# source /etc/profile

2.3 启动

代码语言:javascript复制
启动#  rabbitmq-server -detached

查看状态# rabbitmqctl status

查看防火墙状态# firewall-cmd --state (建议不开)

2.4 开启云服务端口

代码语言:javascript复制
RabbitMQ 服务端口: 5672

RabbitMQ 监控平台端口: 15672

开启web插件允许监控平台访问 # rabbitmq-plugins enable rabbitmq_management

2.5 远程 访问 15672

代码语言:javascript复制
公网ip:15672

Username: guest

Password: guest

提示这个这个账号只允许本地访问,所以需要添加用户

2.6 添加用户

代码语言:javascript复制
显示所有用户# rabbitmqctl list_users

查看guest用户权限# rabbitmqctl list_user_permissions guest

添加admin用户及密码# rabbitmqctl add_user admin admin

设置限权# rabbitmqctl set_permissions -p "/" admin ".*" ".*" ".*"

授予admin用户administrator角色# rabbitmqctl set_user_tags admin administrator

查看admin用户权限# rabbitmqctl list_user_permissions admin

删除用户guest# rabbitmqctl delete_user guest

停止RabbitMQ# rabbitmqctl stop

2.7 登录成功

代码语言:javascript复制
Username: admin

Password: admin

3、SpringBoot整合

3.0 项目准备

3.0.1 jar包
代码语言:javascript复制
<!--rabbitmq依赖-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-amqp</artifactId>
</dependency>
3.0.2 配置信息
代码语言:javascript复制
# 端口
server:
  port: 8104

# RabbitMQ配置
spring:
  rabbitmq:
    host: x.xxx.xx.xx #服务器公网ip
    port: 5672
    username: admin
    password: admin
3.0.3 常量类
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQ 常量类,系统的所有队列名,交换机名,路由键名等,统一进行配置管理
 */
public class RabbitMQConstant {

    //========================== 直连模式
    /**
     * Direct直连模式 队列名
     */
    public static final String RABBITMQ_DIRECT_QUEUE_NAME_KH96 ="rabbitmq_direct_queue_name_kh96";

    /**
     * Direct直连模式 交换机名
     */
    public static final String RABBITMQ_DIRECT_EXCHANGE_KH96 ="rabbitmq_direct_exchange_kh96";

    /**
     * Direct直连模式 路由键
     */
    public static final String RABBITMQ_DIRECT_ROUTING_KEY_KH96 ="rabbitmq_direct_routing_key_kh96";

    //========================== 扇形模式

    /**
     * Fanout 扇形模式 队列名one
     */
    public static final String RABBITMQ_FANOUT_QUEUE_NAME_KH96_ONE ="rabbitmq_fanout_queue_name_kh96_one";

    /**
     * Fanout 扇形模式 队列名two
     */
    public static final String RABBITMQ_FANOUT_QUEUE_NAME_KH96_TWO ="rabbitmq_fanout_queue_name_kh96_two";

    /**
     * Fanout 扇形模式 交换机名
     */
    public static final String RABBITMQ_FANOUT_EXCHANGE_KH96 ="rabbitmq_fanout_exchange_kh96";


    //========================== 主题模式
    // -- 队列
    /**
     * Topic 主题模式 队列名one
     */
    public static final String RABBITMQ_TOPIC_QUEUE_NAME_KH96_ONE ="rabbitmq_topic_queue_name_kh96_one";
    /**
     * Topic 主题模式 队列名two
     */
    public static final String RABBITMQ_TOPIC_QUEUE_NAME_KH96_TWO ="rabbitmq_topic_queue_name_kh96_two";
    /**
     * Topic 主题模式 队列名Three
     */
    public static final String RABBITMQ_TOPIC_QUEUE_NAME_KH96_THREE ="rabbitmq_topic_queue_name_kh96_three";

    //-- 交换机
    /**
     * Topic 主题模式 交换机名
     */
    public static final String RABBITMQ_TOPIC_EXCHANGE_KH96 ="rabbitmq_topic_exchange_kh96";


    //-- 路由键
    /**
     * Topic 主题模式 -路由键-唯一匹配规则
     */
    public static final String RABBITMQ_TOPIC_ROUTING_KEY_KH96_ONLY="rabbitmq_topic_routing_key_kh96.only";

    /**
     * Topic 主题模式 -路由键-单词匹配规则  * 单个词
     */
    public static final String RABBITMQ_TOPIC_ROUTING_KEY_KH96_WORLD="rabbitmq_topic_routing_key_kh96.*";

    /**
     * Topic 主题模式 -路由键-模糊匹配规则 # 0 或 多个词
     */
    public static final String RABBITMQ_TOPIC_ROUTING_KEY_KH96_LIKE="rabbitmq_topic_routing_key_kh96.#";

}
3.0.4 手动操作队列关系

在测试的时候,一定要注意交换机和队列的绑定关系,只要绑定过的关系就会一直存在需要手动删除;如果测试结果不正常的时候,看一些交换机和队列与键值的绑定关系;

选择队列:
删除队列:

3.1 Direct 直连模式

3.1.0 核心构造方法:Queue
  • 核心构造方法:Queue(String name, boolean durable, boolean exclusive, boolean autoDelete)
  1. name参数:name – the name of the queue.
    • 指定创建的消息队列的名字,参数必传,即创建队列必须要有队列名。
  2. durable参数:durable – true if we are declaring a durable queue (the queue will survive a server restart)
    • 指定创建的消息队列是否需要持久化,默认是true,如果是true,该队列支持持久化,自动持久化到磁盘,RabbitMQ服务重启,队列仍然是可用的(存活的)。
  3. exclusive参数:true if we are declaring an exclusive queue (the queue will only be used by the declarer's connection)
    • 指定创建的消息队列是否是排他队列,默认是false,如果是true,该队列是排他队列,只有创建当前队列的连接才可以使用,连接一旦断开,队列会自动删除。
  4. autoDelete参数:true if the server should delete the queue when it is no longer in use
    • 指定创建的消息队列是否是自动删除队列,默认是false,如果是true,该队列是自动删除队列,一旦没有消息生产者或者消费者使用当前队列,会被自动删除。
3.1.1 配置类
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: Direct直连模式,自动配置类,自动创建队列,交换机,并将队列绑定到交换机,指定唯一路由
 */
@Configuration
public class RabbitMQDirectConfig {

    //创建 直连队列
    @Bean
    public Queue directQueue(){
        //创建 直连队列
        return new Queue(RabbitMQConstant.RABBITMQ_DIRECT_QUEUE_NAME_KH96,true);
    }

    //创建 直连交换机
    @Bean
    public DirectExchange directExchange(){
        // 创建支持持久化的直连交换机,指定交换机的名称
        return new DirectExchange(RabbitMQConstant.RABBITMQ_DIRECT_EXCHANGE_KH96);
    }

   	//将直连队列和直连交换机 进行绑定,并指定绑定的唯一路由键
    @Bean
    public Binding directBinding(){
        // 将直连队列和直连交换机进行绑定,并指定绑定的唯一路由键
        return BindingBuilder.bind(directQueue())
                            .to(directExchange())
                            .with(RabbitMQConstant.RABBITMQ_DIRECT_ROUTING_KEY_KH96);
    }


}
3.1.2 消息生产者
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: Direct 直连模式 消息生产者
 */
@Slf4j
@Component
public class RabbitMQDirectProducer {

    @Autowired
    private RabbitTemplate rabbitTemplate;

    /**
     * @author : huayu
     * @date   : 1/11/2022
     * @param  : [directMsg, directExchange, directRoutingKey]
     * @return : void
     * @description : 使用直连模式,发送消息到直连交换机,通过交换机绑定的唯一路由键,将消息发送到绑定的队列中
     */
    public void sendDirectMsg2DirectExchange(String directExchange,String directRoutingKey,String directMsg){
        log.info("        direct模式消息生产者,发送直连消息:{},到交换机:{},路由键:{}       ",directMsg,directExchange,directRoutingKey);

        rabbitTemplate.convertAndSend(directExchange,directRoutingKey,directMsg);

    }

}
3.1.3 消费者
3.1.3.1 消费者One
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: Direct 直连模式消费者 One
 */
@Slf4j
@Component
//指定接听的 消息队列 名字
@RabbitListener(queues = RabbitMQConstant.RABBITMQ_DIRECT_QUEUE_NAME_KH96)
public class RabbitMQDirectConsumerOne {

    /**
     * @author : huayu
     * @date   : 1/11/2022
     * @param  : [directMsgJson]
     * @return : void
     * @description : Direct 直连模式消费者One,消费信息
     */
    //指定消息队列中的消息,交给对应的方法处理
    @RabbitHandler
    public void consumeOneDirectMsgFromDirectQueue(String directMsgJson){
        log.info("***** Direct直连模式,消费者One,消费消息:{} ******",directMsgJson);

        // TODO 核心业务逻辑处理

    }


//    @RabbitHandler  //自动根据队列中的消息类型,自动区分方法
//    public void consumeOtherDirectMsgFromDirectQueue(List<String> directMsgJson){
//        log.info("***** Direct直连模式,消费者Two,消费消息:{} ******",directMsgJson);
//
//        // TODO 核心业务逻辑处理
//
//    }


}
3.1.3.2 消费者Two
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQDirectConsumerTwo
 */
@Slf4j
@Component
//指定监听的消息队列 名字
@RabbitListener(queues = RabbitMQConstant.RABBITMQ_DIRECT_QUEUE_NAME_KH96)
public class RabbitMQDirectConsumerTwo {
    /**
     * @author : huayu
     * @date   : 1/11/2022
     * @param  : [directMsgJson]
     * @return : void
     * @description : Direct 直连模式消费者 Two,消费信息
     */
    //指定消息队列中的消息,交给对应的方法处理
    @RabbitHandler
    public void consumeOneDirectMsgFromDirectQueue(String directMsgJson){
        log.info("***** Direct直连模式,消费者Two,消费消息:{} ******",directMsgJson);

        // TODO 核心业务逻辑处理

    }

}
3.1.4 请求测试方法
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: 测试 RabbitMQ 消息队列的操作入口
 */
@Slf4j
@RestController
public class RabbitMQController {

    @Autowired
    private RabbitMQDirectProducer rabbitMQDirectProducer;
    

    /**
     * @author : Administrator
     * @date   : 2022/11/1
     * @param  : [directMsg]
     * @return : com.kgc.sct.util.RequestResult<java.lang.String>
     * @description : 测试direct直连模式,发送和消费消息
     */
    @GetMapping("/direct")
    public RequestResult<String> testRabbitMQDirect(@RequestParam String directMsg){
        log.info("direct直连模式,发送消息");
        //模拟发送5条直连消息
        Stream.of(11,22,33,44,55).forEach(directNo ->{
            //模拟创建消息对象
            Map<String,Object> directMap =new HashMap<>();
            directMap.put("directNo",directNo);
            directMap.put("directData",directMsg);
            directMap.put("directTime", LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));

        //调用直连模式消息生产者,发送消息
            rabbitMQDirectProducer.sendDirectMsg2DirectExchange(RabbitMQConstant.RABBITMQ_DIRECT_EXCHANGE_KH96
                                                         ,RabbitMQConstant.RABBITMQ_DIRECT_ROUTING_KEY_KH96
                                                         ,JSON.toJSONString(directMap));

        return ResultBuildUtil.success("使用直连模式。发送消息成功");
    }

}
3.1.5 请求测试

发起请求

3.1.5.1 一个消费者

消费者One消费了队列中的所有信息(只有一个队列);

3.1.5.2 两个消费者

消费者One和消费者Two依次消费了队列中的所有信息(只有一个队列);

3.2 Fanout 扇形模式

3.2.1 配置类
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: Fanout扇形模式,自动配置类,自动创建队列,交换机,并将队列绑定到交换机
 */
@Configuration
public class RabbitMQFanoutConfig {

    //创建 扇形队列One
    @Bean
    public Queue fanoutQueueOne(){
        return new Queue(RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_ONE);
    }

    //创建 扇形队列Two
    @Bean
    public Queue fanoutQueueTwo(){
        return new Queue(RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_TWO);
    }

    // 创建扇形交换机
    @Bean
    public FanoutExchange fanoutExchange(){
        return new FanoutExchange(RabbitMQConstant.RABBITMQ_FANOUT_EXCHANGE_KH96);

    }

    //绑定队列到扇形交换机,不需要 指定 路由键
    @Bean
    public Binding fanoutBindingQueueOne(){
        //绑定队列到扇形交换机,不需要路由键,消息是广播发送,会给多有绑定的队列群发信息消息(根本没有提供with方法)
        return BindingBuilder.bind(fanoutQueueOne())
                            .to(fanoutExchange());
    }

    @Bean
    public Binding fanoutBindingQueueTwo(){
        //绑定队列到扇形交换机,不需要路由键,消息是广播发送,会给多有绑定的队列群发信息消息(根本没有提供with方法)
        return BindingBuilder.bind(fanoutQueueTwo())
                            .to(fanoutExchange());
    }

}
3.2.2 消息生产者
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQFanoutProducer
 */
@Slf4j
@Component
public class RabbitMQFanoutProducer {

    @Autowired
    private RabbitTemplate rabbitTemplate;

    /**
     * @author : huayu
     * @date   : 1/11/2022
     * @param  : [fanoutExchange, fanoutRoutingKey, fanoutMsg]
     * @return : void
     * @description : 使用扇形模式,发送消息到扇形交换机,将消息发送到绑定的队列中
     */
    public void sendFanoutMsg2FanoutExchange(String fanoutExchange,String fanoutRoutingKey,String fanoutMsg){
        log.info("       Fanout模式消息生产者,发送广播消息:{},到交换机:{},路由键:{}       ", fanoutMsg, fanoutExchange, fanoutRoutingKey);
        rabbitTemplate.convertAndSend(fanoutExchange, fanoutRoutingKey, fanoutMsg);
    }

}
3.2.3 消费者
3.2.3.1 消费者One
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQFanoutConsumerOne
 */
@Slf4j
@Component
@RabbitListener(queues = RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_ONE)
public class RabbitMQFanoutConsumerOne {

    @RabbitHandler
    public void fanoutConsumeOneFanoutMsgFromFanoutQueueOne(String fanoutMsgJson){
        log.info("****** Fanout扇形模式,消费One,消费队列One,消息:{}  ******",fanoutMsgJson);

        // TODO 核心业务逻辑处理

    }

}
3.2.3.2 消费者Two
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQFanoutConsumerTwo
 */
@Slf4j
@Component
//@RabbitListener(queues = RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_TWO)
public class RabbitMQFanoutConsumerTwo {

//    @RabbitHandler
    public void fanoutConsumeTwoFanoutMsgFromFanoutQueueTwo(String fanoutMsgJson){
        log.info("****** Fanout扇形模式,消费Two,消费队列Two,消息:{}  ******",fanoutMsgJson);

        // TODO 核心业务逻辑处理

    }

}
3.2.4 请求测试方法
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: 测试 RabbitMQ 消息队列的操作入口
 */
@Slf4j
@RestController
public class RabbitMQController {

    @Autowired
    private RabbitMQFanoutProducer rabbitMQFanoutProducer;
    
 	/**
     * @author : huayu
     * @date   : 1/11/2022
     * @param  : [fanoutMsg]
     * @return : com.kgc.scd.uitl.RequestResult<java.lang.String>
     * @description : 测试扇形(广播)模式,发送和消费信息
     */
    @GetMapping("/fanout")
    public RequestResult<String> testRabbitMQFanout(@RequestParam String fanoutMsg){
        log.info("------- fanout 扇形模式,发送消息 -------");
        //模拟发送5条直连消息
        Stream.of(66,77,88,99,96).forEach(directNo ->{
            //模拟创建消息对象
            Map<String,Object> fanoutMap =new HashMap<>();
            fanoutMap.put("directNo",directNo);
            fanoutMap.put("directData",fanoutMsg);
            fanoutMap.put("directTime", LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));

            //调用扇形模式消息生产者,发送消息
            rabbitMQFanoutProducer.sendFanoutMsg2FanoutExchange(RabbitMQConstant.RABBITMQ_FANOUT_EXCHANGE_KH96
                                                                ,null
                                                                ,JSON.toJSONString(fanoutMap));

        });

        return ResultBuildUtil.success("使用扇形模式。发送消息成功");
        
    }

}     
3.2.5 请求测试
3.2.5.1 一个消费者

消费者One消费了队列One中的所有信息;

3.2.5.2 两个消费者

消费者One消费了队列One中的所有信息;

消费者Two消费了队列Two中的所有信息;

3.3 Topic 主题模式

3.3.1 配置类
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: Topic 主题模式,自动配置类
 */
@Configuration
public class RabbitMQTopicConfig {

    //======== 队列
    //Topic 主题模式 队列One
    @Bean
    public Queue topicQueueOne(){
        return new Queue(RabbitMQConstant.RABBITMQ_TOPIC_QUEUE_NAME_KH96_ONE,true);
    }

    //Topic 主题模式 队列Two
    @Bean
    public Queue topicQueueTwo(){
        return new Queue(RabbitMQConstant.RABBITMQ_TOPIC_QUEUE_NAME_KH96_TWO,true);
    }

    //Topic 主题模式 队列Three
    @Bean
    public Queue topicQueueThree(){
        return new Queue(RabbitMQConstant.RABBITMQ_TOPIC_QUEUE_NAME_KH96_THREE,true);
    }

    //======= 交换机
    //Topic 主题模式 交换机
    @Bean
    public TopicExchange topicExchange(){
        return new TopicExchange(RabbitMQConstant.RABBITMQ_TOPIC_EXCHANGE_KH96);

    }

    //======= 绑定
    // 队列One 绑定 Topic主题模式交换机  和 路由键-唯一匹配规则
    @Bean
    public Binding topicBindingQueueOne(){
        return BindingBuilder.bind(topicQueueOne())
                .to(topicExchange())
                .with(RabbitMQConstant.RABBITMQ_TOPIC_ROUTING_KEY_KH96_ONLY);

    }

    // 队列Two 绑定 Topic主题模式交换机  和 路由键-单个单词词匹配规则
    @Bean
    public Binding topicBindingQueueTwo(){
        return BindingBuilder.bind(topicQueueTwo())
                .to(topicExchange())
                .with(RabbitMQConstant.RABBITMQ_TOPIC_ROUTING_KEY_KH96_WORLD);

    }

    // 队列Two 绑定 Topic主题模式交换机  和 路由键-模糊匹配规则
    @Bean
    public Binding topicBindingQueueThree(){
        return BindingBuilder.bind(topicQueueThree())
                .to(topicExchange())
                .with(RabbitMQConstant.RABBITMQ_TOPIC_ROUTING_KEY_KH96_LIKE);

    }


}
3.3.2 消息生产者
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQ 主题模式消息生产者
 */
@Slf4j
@Component
public class RabbitMQTopicProducer {

    @Autowired
    private RabbitTemplate rabbitTemplate;

    /**
     * @author : huayu
     * @date   : 1/11/2022
     * @param  : [topicExchange, topicRoutingKey, topicMsg]
     * @return : void
     * @description : 使用主题模式,发送消息到主题交换机,主题交换机会根据发送消息的路由键 ,根据匹配规则将消息投递到匹配的队列中
     */
    public void sendTopicMsg2TopicExchange(String topicExchange,String topicRoutingKey,String topicMsg){
        log.info("        direct模式消息生产者,发送直连消息:{},到交换机:{},路由键:{}       ",topicMsg,topicExchange,topicRoutingKey);

        rabbitTemplate.convertAndSend(topicExchange,topicRoutingKey,topicMsg);

    }

}
3.3.3 消费者
3.3.3.1 消费者One
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQTopicConsumerOne
 */
@Slf4j
@Component
@RabbitListener(queues = RabbitMQConstant.RABBITMQ_TOPIC_QUEUE_NAME_KH96_ONE)
public class RabbitMQTopicConsumerOne {

    @RabbitHandler
    public void consumeTopicMsgFromTopicQueue(String topicMapJson){
        log.info("****** Topic 主题模式,消费One,消费队列One,消息:{}  ******",topicMapJson);

        // TODO 核心业务逻辑处理

    }

}
3.3.3.2 消费者Two
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQTopicConsumerTwo
 */
@Slf4j
@Component
@RabbitListener(queues = RabbitMQConstant.RABBITMQ_TOPIC_QUEUE_NAME_KH96_TWO)
public class RabbitMQTopicConsumerTwo {

    @RabbitHandler
    public void consumeTopicMsgFromTopicQueue(String topicMapJson){
        log.info("****** Topic 主题模式,消费 Two,消费队列 Two,消息:{}  ******",topicMapJson);

        // TODO 核心业务逻辑处理

    }

}
3.3.3.3 消费者Three
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQTopicConsumerThree
 */
@Slf4j
@Component
@RabbitListener(queues = RabbitMQConstant.RABBITMQ_TOPIC_QUEUE_NAME_KH96_THREE)
public class RabbitMQTopicConsumerThree {

    @RabbitHandler
    public void consumeTopicMsgFromTopicQueue(String topicMapJson){
        log.info("****** Topic 主题模式,消费 Three,消费队列 Three,消息:{}  ******",topicMapJson);

        // TODO 核心业务逻辑处理

    }

}
3.3.4 请求测试方法
代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: 测试 RabbitMQ 消息队列的操作入口
 */
@Slf4j
@RestController
public class RabbitMQController {

    @Autowired
    private RabbitMQTopicProducer rabbitMQTopicProducer;
    
        @GetMapping("/topic")
    public RequestResult<String> testRabbitMQTopic(@RequestParam String topicMsg){
        log.info("------- topic 主题模式,发送消息 -------");
        //模拟发送5条直连消息
        Stream.of(95,96,97,98,99).forEach(directNo ->{
            //模拟创建消息对象
            Map<String,Object> fanoutMap =new HashMap<>();
            fanoutMap.put("directNo",directNo);
            fanoutMap.put("directData",topicMsg);
            fanoutMap.put("directTime", LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));

            //调用主题模式消息生产者,发送消息
            //场景1:使用唯一路由键 rabbitmq_topic_routing_key_kh96.only , 发送消息
            rabbitMQTopicProducer.sendTopicMsg2TopicExchange(RabbitMQConstant.RABBITMQ_TOPIC_EXCHANGE_KH96
                                                            ,RabbitMQConstant.RABBITMQ_TOPIC_ROUTING_KEY_KH96_ONLY
                                                            ,JSON.toJSONString(fanoutMap));

            //场景2:使用单词匹配路由键 rabbitmq_topic_routing_key_kh96.* ,发送消息
//            rabbitMQTopicProducer.sendTopicMsg2TopicExchange(RabbitMQConstant.RABBITMQ_TOPIC_EXCHANGE_KH96
//                                    ,"rabbitmq_topic_routing_key_kh96.abc"
//                                    ,JSON.toJSONString(fanoutMap));

            //场景3:0 或多词匹配 rabbitmq_topic_routing_key_kh96.# ,发送消息
//            rabbitMQTopicProducer.sendTopicMsg2TopicExchange(RabbitMQConstant.RABBITMQ_TOPIC_EXCHANGE_KH96
//                                                            ,"rabbitmq_topic_routing_key_kh96.abc.def"
//                                                            ,JSON.toJSONString(fanoutMap));

        });

        return ResultBuildUtil.success("使用主题模式。发送消息成功");
    }

    
}
3.3.5 请求测试
3.3.5.1 场景1:使用唯一路由键
代码语言:javascript复制
发送消息路由键名: rabbitmq_topic_routing_key_kh96.only
发起请求:
请求结果:

队列One,Two,Three都接收到了信息,所以对应的消费者One,Two,Three都消费了信息;

3.3.5.2 场景2:使用单词匹配路由键
代码语言:javascript复制
发送消息路由键名: rabbitmq_topic_routing_key_kh96.abc
发起请求:
请求结果:

队列Two,Three都接收到了信息,所以对应的消费者Two,Three都消费了信息;

3.3.5.3 场景3:0 或多词匹配
代码语言:javascript复制
发送消息路由键名: rabbitmq_topic_routing_key_kh96.abc.def
发起请求:
请求结果:

只有队列Three接收到了信息,所以只有对应的消费者Three消费了信息;

3.3.6 主题模式小结
  1. 当生产者发送消息到交换机,指定的路由键一般都是使用句点(.)作为分隔符,分割多个单词。
    • 比如:词1.词...
  2. 所谓单词:是由一个或多个单词组成,多个单词组成的路由键,就代表某种主题的关键信息,路由键长度最多不能超过256字节。
  3. 匹配规则格式:* 或者 #
    • *代表单个单词。
      • 比如 队列绑定主题交换机的 路由键:KH96.* ,代表发送消息的路由键是以KH96开头,后面只能跟一个单词,如:KH96.aaa,KH96.bbb等。
      • 再比如:绑定路由键为:KH96.*.KGC,代表发送消息路由键是以KH96开头,中间可以带一个单词,结尾,如:KH96.aa.KGC,KH96.bb.KGC。
      • #代表0或多个单词,比如 队列绑定主题交换机的 路由键:KH96.#,代表发送消息的路由键是以KH96开头,后面只能跟0个或者多个单词,如:KH96,KH96.aaa,KH96.aaa.bbb。
      • 再比如:绑定路由键为:KH96.#.KGC,代表发送消息路由键是以KH96开头,中间可以带一个或多个单词,结尾,如KH96.KGC,KH96.aa.KGC,KH96.aa.bb.KGC。
    1. 备注:
      • 如果主题交换机,队列绑定的路由键使用的不是模糊匹配符,主题交换机跟直连交换机一致。
      • 如果单独使用#,代表所有队列都可以收消息,主题交换机跟扇形交换机一致。
  4. 提醒:
    • 主题模式下,队列绑定的路由键,是允许为多个的。
    • 如果路由键被更换,之前的路由键是不会删除,仍然会绑定到当前队列上。
    • 如果有多个路由键匹配,规则为:如果其中一个没有匹配到,会自动匹配其他路由键,如果需要删除历史路由键,需要在RabbitMQ控制台删除。

3.4 消息 发送确认 - 交换机,队列 确认

3.4.1 配置信息
代码语言:javascript复制
# RabbitMQ配置
spring:
  rabbitmq:
    # 打开发送消息确认配置
    publisher-confirms: true # 发送消息到交换机确认,默认false
    publisher-returns: true # 发送消息到队列确认,默认是false
3.4.2 消息发送确认配置类
  • 触发机制
    • ConfirmCallback 函数式接口中的唯一抽象方法 confirm : 是否有交换机都会触发;
      • 标识:true,发送到交换机正常;
      • 标识:false,发送到交换机失败,进行特殊处理;
    • ReturnCallback 函数式接口中的唯一抽象方法 returnedMessage :交换机存在且队列不存在才会触发;
      • 触发:发送到队列失败,进行特殊处理;
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQ 消息确认机制: 发送确认
 */
@Slf4j
@Configuration
public class RabbitMQSendMsgAck {

    @Bean
    public RabbitTemplate rabbitTemplate(ConnectionFactory connectionFactory){
        //发送确认,消息是通过rabbitTemplate发的,所以要重置rabbitTemplate才可以实现
        RabbitTemplate rabbitTemplate = new RabbitTemplate();
        rabbitTemplate.setConnectionFactory(connectionFactory);

        //开启触发回调处理方法,不论消息推送结果是什么,都会强制触发回调方法
        rabbitTemplate.setMandatory(true);

        //指定消息发送到RabbitMQ的broker节点,是否正确到达交换机确然
        //是否有交换机都会触发
        rabbitTemplate.setConfirmCallback( (correlationData, ack, cause) ->{
            log.info("######  发送消息确认回调,数据:{}  ######",correlationData);
            log.info("######  发送消息确认回调,标识:{}  ######",ack);
            log.info("######  发送消息确认回调,原因:{}  ######n",cause);

            //TODO 如果没有到交换机,ack返回的是false,可能是交换机被删除,就需要进行特殊处理的业务,比如给负责人发送信息或邮件

        });

        //消息是否正确到达交换机上绑定的 目标队列
        //交换机存在且队列不存在才会触发
        rabbitTemplate.setReturnCallback( ( message, replyCode, replyText,exchange,routingKey) ->{
            log.info("######  发送消息返回回调,数据:{}  ######",message);
            log.info("######  发送消息返回回调,返回码:{}  ######",replyCode);
            log.info("######  发送消息返回回调,返回说明:{}  ######",replyText);
            log.info("######  发送消息返回回调,交换机:{}  ######",exchange);
            log.info("######  发送消息返回回调,路由键:{}  ######n",routingKey);

            //TODO 如果没有到目标队列,就需要进行特殊处理的业务,比如给负责人发送信息或邮件

        });

        return rabbitTemplate;
    }

}
3.4.3 交换机
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: Ack 测试交换机,没有绑定队列
 */
@Configuration
public class RabbitMQAckConfig {


    //ack 测试交换机,没有绑定队列
    @Bean
    public DirectExchange directExchange(){

        return new DirectExchange(RabbitMQConstant.RABBITMQ_ACK_EXCHANGE_KH96);

    }

}
3.4.4 请求方法
代码语言:javascript复制
/**
* @author : huayu
* @date   : 2/11/2022
* @param  : [topicMsg]
* @return : com.kgc.scd.uitl.RequestResult<java.lang.String>
* @description : 直连模式测试 Ack  不存在交换机  和 存在交换机
*/
@GetMapping("/sendMsgAck")
public RequestResult<String> RabbitMQSendMsgAck(@RequestParam String ackMsg){
    log.info("------- 直连 模式 测试Ack,发送消息 -------");
    //模拟发送直连消息

    //调用直连模式消息生产者,发送消息
    //测试1: 不存在的 交换机
    rabbitMQDirectProducer.sendDirectMsg2DirectExchange("test_noExchange"
                                                        ,RabbitMQConstant.RABBITMQ_DIRECT_ROUTING_KEY_KH96
                                                        ,JSON.toJSONString(ackMsg));

    return ResultBuildUtil.success("使用直连模式 测试Ack。交换机不存在");

    //测试2: 存在的交换机,但是没有绑定 队列
    //            rabbitMQDirectProducer.sendDirectMsg2DirectExchange(RabbitMQConstant.RABBITMQ_ACK_EXCHANGE_KH96
    //                                    ,RabbitMQConstant.RABBITMQ_DIRECT_ROUTING_KEY_KH96
    //                                    ,JSON.toJSONString(ackMsg));


    //        return ResultBuildUtil.success("使用直连模式 测试Ack。交换机 没有绑定队列");

}
3.2.5 请求测试
3.2.5.1 交换机不存在
发起请求:
请求结果:

交换机不存在,

触发了ConfirmCallback 函数式接口中的唯一抽象方法 confirm ,

返回标识 false,发送到交换机失败,

原因,该交换机不存在;

注意:如果没有到交换机,ack返回的是false,可能是交换机被删除,就需要进行特殊处理的业务,比如给负责人发送信息或邮件;

3.2.5.2 交换机存在,但是没有绑定 队列
发起请求:
请求结果:

交换机存在,

触发了ConfirmCallback 函数式接口中的唯一抽象方法 confirm ,

返回标识 true,发送到交换机成功;

没有绑定队列,

触发了ReturnCallback 函数式接口中的唯一抽象方法 returnedMessage ,

返回说明 NO_ROUT,发送到队列失败;

注意:如果没有到目标队列,就需要进行特殊处理的业务,比如给负责人发送信息或邮件;

3.2.5.3 交换机存在,且绑定了队列
发起请求
请求结果:

交换机存在,且绑定了队列,

触发了ConfirmCallback 函数式接口中的唯一抽象方法 confirm ,

返回标识 true,发送到交换机成功;

没有触发ReturnCallback 函数式接口中的唯一抽象方法 returnedMessage ,

说明发送到队列成功;

3.5 消息确认

3.5.1 自动确认
3.5.1.1 配置信息
代码语言:javascript复制
# RabbitMQ配置
spring:
  rabbitmq:
    # 消费消息确认配置-自动
    listener:
      simple:
        retry:
          enabled: true # 开启消费消息失败重试机制
          max-attempts: 5 # 指定重试的次数
          max-interval: 10000 # 最大重试间隔时间,单位毫秒,每次重试的间隔时间,不能比当前设置的值大,如果计算间隔时间是6s,最大时间时间5s,会用5秒
          initial-interval: 1000 # 重试间隔初始时间,单位毫秒
          multiplier: 2 #乘子;重试的间隔时间 * 乘子,就是下一次重试的时间间隔市场,即:1s,2s,4s,8s,16...
3.5.1.2 消费者 模拟异常

注意:测试时为了让消费者One一定接收到消息,所以注释掉消费者Two,这样才可以保证消费者One接收消息,然后触发异常,重试的效果;

代码语言:javascript复制
/**
 * Created On : 1/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: Direct 直连模式消费者 One
 */
@Slf4j
@Component
//指定接听的 消息队列 名字
@RabbitListener(queues = RabbitMQConstant.RABBITMQ_DIRECT_QUEUE_NAME_KH96)
public class RabbitMQDirectConsumerOne {

    /**
     * @author : huayu
     * @date   : 1/11/2022
     * @param  : [directMsgJson]
     * @return : void
     * @description : Direct 直连模式消费者One,消费信息
     */
    //指定消息队列中的消息,交给对应的方法处理
    @RabbitHandler
    public void consumeOneDirectMsgFromDirectQueue(String directMsgJson){
        log.info("***** Direct直连模式,消费者One,消费消息:{} ******",directMsgJson);

        // TODO 核心业务逻辑处理

        //默认自动确认,模拟消费端消费消息,处理异常,自动重试
        int a = 10 / 0;

    }

}
3.5.1.3 请求方法
代码语言:javascript复制
/**
* @author : huayu
* @date   : 3/11/2022
* @param  : [ackMsg]
* @return : com.kgc.scd.uitl.RequestResult<java.lang.String>
* @description : 测试 消费者自动 重试 
*/
@GetMapping("/consumeAckAuto")
public RequestResult<String> testRabbitMQConsumeAckAuto(@RequestParam String ackMsg){
    log.info("------- 直连 模式 测试Ack 自动 重试,发送消息 -------");
    //模拟发送直连消息
    //消费消息失败重试机制
  rabbitMQDirectProducer.sendDirectMsg2DirectExchange(RabbitMQConstant.RABBITMQ_DIRECT_EXCHANGE_KH96
                                                        ,RabbitMQConstant.RABBITMQ_DIRECT_ROUTING_KEY_KH96
                                                        ,JSON.toJSONString(ackMsg));

    return ResultBuildUtil.success("使用直连模式 消费确认-自动消费成功");

}
3.5.1.4 请求测试

发起请求:

请求结果:

一共重试了五次

间隔时间为1,2,4,8

(如果还有一次应该为10,因为最后一次计算时间16大于最大间隔时间10,按最大间隔时间10重试);

3.4.2 手动确认

注意:

  • 手动确认需要先将自动确认的配置注释掉;
  • 使用手动确认,不能再用@RabbitListener 监听,手动确认相关队列,需要我们手动配置消费者;
3.4.2.1 消费消息手动确认的监听器
  • 获取消息消费的唯一标识 message.getMessageProperties().getDeliveryTag();
  • 执行业务处理
    • 每个消费者在同一个时间点,最多处理一个message,默认是0(全部) channel.basicQos(1);
    • 获取message的消息内容 message
    • 获取消息对应的目标队列,可以实现一些灵活判断处理message.getMessageProperties().getConsumerQueue()
      • 比如根据不同的目标队列进行不同的处理
      • 在消息处理的时候如果出错会被捕获(消息确认失败)
    • 消息确认channel.basicAck(deliveryTag,false);
  • 消息确认失败处理
    • 根据条件判断设置是否重回队列 ,是否支持批量处理 channel.basicNack(deliveryTag,true,false);
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: 消费端 消费消息手动确认的监听器,注意它也是一个消费者,并可以通过 消息监听容器工厂,动态配置多个
 */
@Slf4j
@Component
public class RabbitMQConsumerManualAckListener implements ChannelAwareMessageListener {

    @Override
    public void onMessage(Message message, Channel channel) throws IOException {
        //获取消息消费的唯一标识,rabbitMQ在推送消息时,会给每个消息携带一个唯一标识,值是一个递增的正整数
        long deliveryTag = message.getMessageProperties().getDeliveryTag();
        log.info("====== 消费消息的唯一标识:{}  ======",deliveryTag);

        //执行手动确认业务处理
        try{
            //给每个消费者在同一个时间点,最多处理一个message,默认是0(全部),换句话说,在接收到消费者的 ack 确认前,不会分发新的消息给当前的消费者
            //在接收当前消息的ack确认前是不会发送新的消息给它
            channel.basicQos(1);

            //获取message的消息内容,发送的消息的json字符串
            log.info("====== 消息队列中完整消息内容:{} ======",message);

            //获取发送的实际内容,发送消息的json字符串
            log.info("====== 发送的实际内容:{} ======",new String(message.getBody(),"utf-8"));

            //获取消息对应的目标队列,可以实现一些灵活判断
            //TODO 比如根据目标队列不同,可以做不同的处理
            log.info("======  消息的来源队列:{} =======",message.getMessageProperties().getConsumerQueue());

            //模拟错误 ,当 deliveryTag 为1的时候,进入 报错 ,捕获异常,然后(如果设置了重回队列)将消息重回队列
            //if(deliveryTag == 1){
            //    int num = 1/0;
            //}

            //消费消息的手动确认,消息确认成功-basicAck
            //第一个参数deliveryTag,消息的唯一标识
            //第二个参数multiple,消息是否支持批量确认,如果是true,代表可以一次性确认标识小于等于当前标识的所有消息
            //如果是false,只会确认当前消息
            channel.basicAck(deliveryTag,false);


        }catch (Exception e){
            //说明消费消息处理失败,如果不进行确认(自动确认,投递成功即确认,消费是否正常,不关心),消息就会丢失
            //消息处理失败确认,代表消息没有正确消费,注意:此种方式一次只能确认一个消息
            //第一给参数是消息的唯一标识,
            //第二个参数是代表是否重回队列,如果是true,重新将该消息放入队列,再次消费
            //注意:第二个参数要谨慎,必须要结合具体业务场景,根据业务判断是否需要重回队列,一旦处理不当,机会导致消息循环入队,消息挤压
            //不重回队列 require = false
//            channel.basicReject(deliveryTag,false);
            //重回队列 require = true
            channel.basicReject(deliveryTag,true);

            //消息处理失败确认,代表消息没有正确消费,注意,此种方式支持批量
            //第一个参数是消息的唯一标识,
            //第二个参数是代表是否支持批量确认
            //第三给参数代表是否重回队列
            //不重回队列 require = false
//            channel.basicNack(deliveryTag,true,false);
            //重回队列 require = true
//            channel.basicNack(deliveryTag,false,true);

            //TODO 手动消费异常处理

            log.error("====== 消费消息失败,异常信息:{}  ======",e.getMessage());

        }

    }

}
3.4.2.2 消费消息手动确认配置类
  • 配置消费者的数量 setConcurrentConsumers(2);
  • 最大并发消费者数量 setMaxConcurrentConsumers(5);
  • 消费消息确认机制为手动 setAcknowledgeMode(AcknowledgeMode.MANUAL);
  • 设置监听消息队列的名称,支持多个队列setQueueNames(RabbitMQConstant.RABBITMQ_DIRECT_QUEUE_NAME_KH96);
  • 设置消息手动确认监听器 setMessageListener(rabbitMQConsumerManualAckListener);
代码语言:javascript复制
/**
 * Created On : 2/11/2022.
 * <p>
 * Author : huayu
 * <p>
 * Description: RabbitMQ  消费消息手动确认配置类
 */
@Configuration
public class RabbitMQConsumeManualAckConfig {

    @Autowired
    private RabbitMQConsumerManualAckListener rabbitMQConsumerManualAckListener;

    /**
     * @author : huayu
     * @date   : 2/11/2022
     * @param  : [connectionFactory]
     * @return : org.springframework.amqp.rabbit.listener.SimpleMessageListenerContainer
     * @description : 自定义消息监听器工程对象
     */
    @Bean
    public SimpleMessageListenerContainer simpleBrokerMessageHandler(ConnectionFactory connectionFactory){
        //初始化消息监听容器的工程对象
        SimpleMessageListenerContainer container = new SimpleMessageListenerContainer(connectionFactory);

        //初始化并发消费者的数量,比如是2,代表同时会有 两个消费者 消费消息
        // ,投递标识可能会相同
        container.setConcurrentConsumers(2);

        //设置最大的并发消费者数量,数量不能低于初始化并发消费者数量
        //可以动态的设定当前容器的消费者数量,可以实现动态增加和减少消费者的算法在 SimpleMessageListenerContainer类中实现
        container.setMaxConcurrentConsumers(5);

        //底层动态实现消费者数量的增加减少原理
        // 有consumer已连续十个周期(consecutiveActiveTrigger)处于活动状态,并且自启动后最后一个consumer运行至少经过了10秒钟,则将启动新的consumer。
        // private static final long DEFAULT_START_CONSUMER_MIN_INTERVAL = 10000;
        // 停止消费者算法的时间间隔
        // 有consumer已连续10个周期(consecutiveIdleTrigger)连续空闲状态,并且上一个consumer至少在60秒之前停止,那么该consumer将停止
        // private static final long DEFAULT_STOP_CONSUMER_MIN_INTERVAL = 60000;
        // 默认连续活动10个周期
        // private static final int DEFAULT_CONSECUTIVE_ACTIVE_TRIGGER = 10;
        // 默认连续空闲10个周期
        // private static final int DEFAULT_CONSECUTIVE_IDLE_TRIGGER = 10;

        //默认的消费消息确认机制是自动,需要改为手动
        container.setAcknowledgeMode(AcknowledgeMode.MANUAL);

        //设置监听消息队列的名称,支持多个队列(队列名1,队列名2...),注意前提是指定的队列必须是存在的
        //监听 直连模式的 RabbitMQConstant.RABBITMQ_DIRECT_QUEUE_NAME_KH96 队列
        container.setQueueNames(RabbitMQConstant.RABBITMQ_DIRECT_QUEUE_NAME_KH96);

        //监听 扇形模式的 
        //RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_ONE 队列
        //和 RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_TWO 队列
//        container.setQueueNames(RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_ONE
//                ,RabbitMQConstant.RABBITMQ_FANOUT_QUEUE_NAME_KH96_TWO);

        //指定消息确认的处理类,会同时产生多个消费者,参数是上面设置的,
        //注意之前使用直连模式,消息消费者,要注释掉,防止同类型的监听器,处理同一队列
        //如果不是被当前消息确认的处理类消费(使用注解@RabbitListener),会导致消息不执行手动处理
        container.setMessageListener(rabbitMQConsumerManualAckListener);

        // 返回消息监听容器工厂对象
        return container;

    }


}
3.4.2.3 请求方法
代码语言:javascript复制
//======================
/**
* @author : huayu
* @date   : 3/11/2022
* @param  : [ackMsg]
* @return : com.kgc.scd.uitl.RequestResult<java.lang.String>
* @description : 测试 消费者手动确认
*/
@GetMapping("/consumeAckManual")
public RequestResult<String> testRabbitMQConsumeAckManual(@RequestParam String ackMsg){
    log.info("------- 测试Ack 手动 确认,发送消息 -------");
    //消息手动确认
    //模拟发送直连消息
    //测试1,2
    rabbitMQDirectProducer.sendDirectMsg2DirectExchange(
        RabbitMQConstant.RABBITMQ_DIRECT_EXCHANGE_KH96
        ,RabbitMQConstant.RABBITMQ_DIRECT_ROUTING_KEY_KH96
        ,JSON.toJSONString(ackMsg));

    return ResultBuildUtil.success("使用直连模式 手动消费确认-消息确认成功");
    

    //测试3
    //模拟发送扇形消息
    //        rabbitMQFanoutProducer.sendFanoutMsg2FanoutExchange(
    //                RabbitMQConstant.RABBITMQ_FANOUT_EXCHANGE_KH96
    //                ,null
    //                ,JSON.toJSONString(ackMsg));
    //
    //
    //        return ResultBuildUtil.success("使用扇形模式 手动消费确认-消息确认成功");

}
3.4.2.4 请求测试
3.4.2.4.1 模拟发送直连消息并成功确认

发送请求:

请求结果:

3.4.2.4.2 模拟发送直连消息,抛出异常,重回队列

发送请求:

代码重点:

请求结果:

3.4.2.4.3 模拟发送扇形消息并成功确认

发送请求:

请求结果:

0 人点赞