1、安装erlang语言环境1.1 创建 erlang安装目录
mkdir erlang
1.2 上传解压压缩包
上传到: /root/解压缩# tar -zxvf otp_src_22.0.tar.gz
1.3 进入解压缩目录,指定目录并安装
进入解压目录,指定安装目录# ./configure --prefix=/usr/local/kh96/erlang安装# make install添加环境变量# echo 'export PATH=$PATH:/usr/local/kh96/erlang/bin' >> /etc/profile刷新环境变量# source /etc/profile
1.4 测试环境
进入erlang环境#erl退出# halt().
2、安装RabbitMQ2.1上传解压压缩包
第一步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 添加环境变量
添加环境变量# echo 'export PATH=$PATH:/usr/local/kh96/rabbitmq/rabbitmq_server-3.7.15/sbin' >> /etc/profile刷新环境变量# source /etc/profile
2.3 启动
启动# rabbitmq-server -detached查看状态# rabbitmqctl status查看防火墙状态# firewall-cmd --state (建议不开)
2.4 开启云服务端口
RabbitMQ 服务端口: 5672RabbitMQ 监控平台端口: 15672开启web插件允许监控平台访问 # rabbitmq-plugins enable rabbitmq_management
2.5 远程 访问 15672
公网ip:15672Username: guestPassword: guest提示这个这个账号只允许本地访问,所以需要添加用户
2.6 添加用户
显示所有用户# 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 登录成功
Username: adminPassword: admin
3、SpringBoot整合3.0 项目准备3.0.1 jar包
org.springframework.boot spring-boot-starter-amqp
3.0.2 配置信息
# 端口server: port: 8104# RabbitMQ配置spring: rabbitmq: host: x.xxx.xx.xx #服务器公网ip port: 5672 username: admin password: admin
3.0.3 常量类
/** * Created On : 1/11/2022. * * Author : huayu *
* 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)
- name参数:name – the name of the queue.
- 指定创建的消息队列的名字,参数必传,即创建队列必须要有队列名。
- durable参数:durable – true if we are declaring a durable queue (the queue will survive a server restart)
- 指定创建的消息队列是否需要持久化,默认是true,如果是true,该队列支持持久化,自动持久化到磁盘,RabbitMQ服务重启,队列仍然是可用的(存活的)。
- exclusive参数:true if we are declaring an exclusive queue (the queue will only be used by the declarer’s connection)
- 指定创建的消息队列是否是排他队列,默认是false,如果是true,该队列是排他队列,只有创建当前队列的连接才可以使用,连接一旦断开,队列会自动删除。
- autoDelete参数:true if the server should delete the queue when it is no longer in use
- 指定创建的消息队列是否是自动删除队列,默认是false,如果是true,该队列是自动删除队列,一旦没有消息生产者或者消费者使用当前队列,会被自动删除。
3.1.1 配置类
/** * Created On : 1/11/2022. * * Author : huayu *
* Description: Direct直连模式,自动配置类,自动创建队列,交换机,并将队列绑定到交换机,指定唯一路由 */@Configurationpublic 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 消息生产者
/** * Created On : 1/11/2022. * * Author : huayu *
* Description: Direct 直连模式 消息生产者 */@Slf4j@Componentpublic 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
/** * Created On : 1/11/2022. * * Author : huayu *
* 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 directMsgJson){// log.info("***** Direct直连模式,消费者Two,消费消息:{} ******",directMsgJson);//// // TODO 核心业务逻辑处理//// }}
3.1.3.2 消费者Two
/** * Created On : 1/11/2022. * * Author : huayu *
* 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 请求测试方法
/** * Created On : 1/11/2022. * * Author : huayu *
* Description: 测试 RabbitMQ 消息队列的操作入口 */@Slf4j@RestControllerpublic class RabbitMQController { @Autowired private RabbitMQDirectProducer rabbitMQDirectProducer; /** * @author : Administrator * @date : 2022/11/1 * @param : [directMsg] * @return : com.kgc.sct.util.RequestResult * @description : 测试direct直连模式,发送和消费消息 */ @GetMapping("/direct") public RequestResult testRabbitMQDirect(@RequestParam String directMsg){ log.info("direct直连模式,发送消息"); //模拟发送5条直连消息 Stream.of(11,22,33,44,55).forEach(directNo ->{ //模拟创建消息对象 Map 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 配置类
/** * Created On : 1/11/2022. * * Author : huayu *
* Description: Fanout扇形模式,自动配置类,自动创建队列,交换机,并将队列绑定到交换机 */@Configurationpublic 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 消息生产者
/** * Created On : 1/11/2022. * * Author : huayu *
* Description: RabbitMQFanoutProducer */@Slf4j@Componentpublic 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
/** * Created On : 1/11/2022. * * Author : huayu *
* 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
/** * Created On : 1/11/2022. * * Author : huayu *
* 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 请求测试方法
/** * Created On : 1/11/2022. * * Author : huayu *
* Description: 测试 RabbitMQ 消息队列的操作入口 */@Slf4j@RestControllerpublic class RabbitMQController { @Autowired private RabbitMQFanoutProducer rabbitMQFanoutProducer; /** * @author : huayu * @date : 1/11/2022 * @param : [fanoutMsg] * @return : com.kgc.scd.uitl.RequestResult * @description : 测试扇形(广播)模式,发送和消费信息 */ @GetMapping("/fanout") public RequestResult testRabbitMQFanout(@RequestParam String fanoutMsg){ log.info("------- fanout 扇形模式,发送消息 -------"); //模拟发送5条直连消息 Stream.of(66,77,88,99,96).forEach(directNo ->{ //模拟创建消息对象 Map 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 配置类
/** * Created On : 2/11/2022. * * Author : huayu *
* Description: Topic 主题模式,自动配置类 */@Configurationpublic 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 消息生产者
/** * Created On : 2/11/2022. * * Author : huayu *
* Description: RabbitMQ 主题模式消息生产者 */@Slf4j@Componentpublic 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
/** * Created On : 2/11/2022. * * Author : huayu *
* 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
/** * Created On : 2/11/2022. * * Author : huayu *
* 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
/** * Created On : 2/11/2022. * * Author : huayu *
* 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 请求测试方法
/** * Created On : 1/11/2022. * * Author : huayu *
* Description: 测试 RabbitMQ 消息队列的操作入口 */@Slf4j@RestControllerpublic class RabbitMQController { @Autowired private RabbitMQTopicProducer rabbitMQTopicProducer; @GetMapping("/topic") public RequestResult testRabbitMQTopic(@RequestParam String topicMsg){ log.info("------- topic 主题模式,发送消息 -------"); //模拟发送5条直连消息 Stream.of(95,96,97,98,99).forEach(directNo ->{ //模拟创建消息对象 Map 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:使用唯一路由键
发送消息路由键名: rabbitmq_topic_routing_key_kh96.only
发起请求:
请求结果:
队列One,Two,Three都接收到了信息,所以对应的消费者One,Two,Three都消费了信息;
3.3.5.2 场景2:使用单词匹配路由键
发送消息路由键名: rabbitmq_topic_routing_key_kh96.abc
发起请求:
请求结果:
队列Two,Three都接收到了信息,所以对应的消费者Two,Three都消费了信息;
3.3.5.3 场景3:0 或多词匹配
发送消息路由键名: rabbitmq_topic_routing_key_kh96.abc.def
发起请求:
请求结果:
只有队列Three接收到了信息,所以只有对应的消费者Three消费了信息;
3.3.6 主题模式小结
当生产者发送消息到交换机,指定的路由键一般都是使用句点(.)作为分隔符,分割多个单词。
- 比如:词1.词…
所谓单词:是由一个或多个单词组成,多个单词组成的路由键,就代表某种主题的关键信息,路由键长度最多不能超过256字节。
匹配规则格式:* 或者 #
- *代表单个单词。
- 比如 队列绑定主题交换机的 路由键: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。
备注:
- 如果主题交换机,队列绑定的路由键使用的不是模糊匹配符,主题交换机跟直连交换机一致。
- 如果单独使用#,代表所有队列都可以收消息,主题交换机跟扇形交换机一致。
- *代表单个单词。
提醒:
主题模式下,队列绑定的路由键,是允许为多个的。
如果路由键被更换,之前的路由键是不会删除,仍然会绑定到当前队列上。
如果有多个路由键匹配,规则为:如果其中一个没有匹配到,会自动匹配其他路由键,如果需要删除历史路由键,需要在RabbitMQ控制台删除。
3.4 消息 发送确认 – 交换机,队列 确认3.4.1 配置信息
# RabbitMQ配置spring: rabbitmq: # 打开发送消息确认配置 publisher-confirms: true # 发送消息到交换机确认,默认false publisher-returns: true # 发送消息到队列确认,默认是false
3.4.2 消息发送确认配置类
- 触发机制
- ConfirmCallback 函数式接口中的唯一抽象方法 confirm : 是否有交换机都会触发;
- 标识:true,发送到交换机正常;
- 标识:false,发送到交换机失败,进行特殊处理;
- ReturnCallback 函数式接口中的唯一抽象方法 returnedMessage :交换机存在且队列不存在才会触发;
- 触发:发送到队列失败,进行特殊处理;
- ConfirmCallback 函数式接口中的唯一抽象方法 confirm : 是否有交换机都会触发;
/** * Created On : 2/11/2022. * * Author : huayu *
* Description: RabbitMQ 消息确认机制: 发送确认 */@Slf4j@Configurationpublic 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 交换机
/** * Created On : 2/11/2022. * * Author : huayu *
* Description: Ack 测试交换机,没有绑定队列 */@Configurationpublic class RabbitMQAckConfig { //ack 测试交换机,没有绑定队列 @Bean public DirectExchange directExchange(){ return new DirectExchange(RabbitMQConstant.RABBITMQ_ACK_EXCHANGE_KH96); }}
3.4.4 请求方法
/*** @author : huayu* @date : 2/11/2022* @param : [topicMsg]* @return : com.kgc.scd.uitl.RequestResult* @description : 直连模式测试 Ack 不存在交换机 和 存在交换机*/@GetMapping("/sendMsgAck")public RequestResult 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 配置信息
# 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接收消息,然后触发异常,重试的效果;
/** * Created On : 1/11/2022. * * Author : huayu *
* 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 请求方法
/*** @author : huayu* @date : 3/11/2022* @param : [ackMsg]* @return : com.kgc.scd.uitl.RequestResult* @description : 测试 消费者自动 重试 */@GetMapping("/consumeAckAuto")public RequestResult 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);
/** * Created On : 2/11/2022. * * Author : huayu *
* Description: 消费端 消费消息手动确认的监听器,注意它也是一个消费者,并可以通过 消息监听容器工厂,动态配置多个 */@Slf4j@Componentpublic 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);
/** * Created On : 2/11/2022. * * Author : huayu *
* Description: RabbitMQ 消费消息手动确认配置类 */@Configurationpublic 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 请求方法
//======================/*** @author : huayu* @date : 3/11/2022* @param : [ackMsg]* @return : com.kgc.scd.uitl.RequestResult* @description : 测试 消费者手动确认*/@GetMapping("/consumeAckManual")public RequestResult 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 模拟发送扇形消息并成功确认
发送请求:
请求结果: