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、安装RabbitMQ
2.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 服务端口: 5672
RabbitMQ 监控平台端口: 15672
开启web插件允许监控平台访问 # rabbitmq-plugins enable rabbitmq_management
2.5 远程 访问 15672
公网ip:15672
Username: guest
Password: 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: admin
Password: admin
3、SpringBoot整合
3.0 项目准备
3.0.1 jar包
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-amqpartifactId>
dependency>
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直连模式,自动配置类,自动创建队列,交换机,并将队列绑定到交换机,指定唯一路由
*/
@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 消息生产者
/**
* Created On : 1/11/2022.
*
* Author : huayu
*
* 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
/**
* 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
@RestController
public 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扇形模式,自动配置类,自动创建队列,交换机,并将队列绑定到交换机
*/
@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 消息生产者
/**
* Created On : 1/11/2022.
*
* Author : huayu
*
* 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
/**
* 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
@RestController
public 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 主题模式,自动配置类
*/
@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 消息生产者
/**
* Created On : 2/11/2022.
*
* Author : huayu
*
* 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
/**
* 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
@RestController
public 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
@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 交换机
/**
* Created On : 2/11/2022.
*
* Author : huayu
*
* Description: Ack 测试交换机,没有绑定队列
*/
@Configuration
public 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
@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);
/**
* Created On : 2/11/2022.
*
* Author : huayu
*
* 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 请求方法
//======================
/**
* @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 模拟发送扇形消息并成功确认
发送请求:
请求结果:
4、初始化RabbitAdmin对象,实现启动项目自动创建队列和交换机
4.1 Failed to declare queue(s):[account_pay_result_queue_kh96]
应用场景:
将交换机和队列的放在模块1
中,消息的监听放在 模块2
中,启动的时候模块2
找不到队列,原因是模块1
中的队列是懒加载的;
所以我们需要在模块2
启动的之前就创建好队列,在模块1
中添加以下配置,初始化RabbitAdmin对象,实现启动项目,自动创建队列和交换机;
报错信息:
4.2 RabbitAdminConfig
@Configuration
public class RabbitAdminConfig {
/**
* @author : huayu
* @date : 11/11/2022
* @param : [connectionFactory]
* @return : org.springframework.amqp.rabbit.core.RabbitAdmin
* @description : 初始化RabbitAdmin对象,实现启动项目 自动创建队列 和 交换机
*/
@Bean
public RabbitAdmin rabbitAdmin(ConnectionFactory connectionFactory){
//创建 rabbitAdmin 对象
RabbitAdmin rabbitAdmin = new RabbitAdmin(connectionFactory);
//设置启动时自动创建参数
rabbitAdmin.setAutoStartup(true);
//创建 需要使用的 交换机和队列
//创建需要使用的队列
rabbitAdmin.declareQueue(payResultToQueue());
//创建需要使用的交换机
rabbitAdmin.declareExchange(payResultFanoutExchange());
//返回对象
return rabbitAdmin;
}
}