Springboot 整合RabbitMq(用心看完這一篇就夠了)

更新時間：2020年12月20日 10:41:20 作者：小目標青年

這篇文章主要介紹了Springboot 整合RabbitMq(用心看完這一篇就夠了)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧

該篇文章內容較多，包括有rabbitMq相關的一些簡單理論介紹，provider消息推送實例，consumer消息消費實例，Direct、Topic、Fanout的使用，消息回調、手動確認等。（但是關于rabbitMq的安裝，就不介紹了）

在安裝完rabbitMq后，輸入http://ip:15672/ ，是可以看到一個簡單后臺管理界面的。

在這個界面里面我們可以做些什么？

可以手動創(chuàng)建虛擬host，創(chuàng)建用戶，分配權限，創(chuàng)建交換機，創(chuàng)建隊列等等，還有查看隊列消息，消費效率，推送效率等等。

以上這些管理界面的操作在這篇暫時不做擴展描述，我想著重介紹后面實例里會使用到的。

首先先介紹一個簡單的一個消息推送到接收的流程，提供一個簡單的圖：

RabbitMq -JCccc

黃色的圈圈就是我們的消息推送服務，將消息推送到中間方框里面也就是 rabbitMq的服務器，然后經過服務器里面的交換機、隊列等各種關系（后面會詳細講）將數據處理入列后，最終右邊的藍色圈圈消費者獲取對應監(jiān)聽的消息。

常用的交換機有以下三種，因為消費者是從隊列獲取信息的，隊列是綁定交換機的（一般），所以對應的消息推送/接收模式也會有以下幾種：

Direct Exchange

直連型交換機，根據消息攜帶的路由鍵將消息投遞給對應隊列。

大致流程，有一個隊列綁定到一個直連交換機上，同時賦予一個路由鍵 routing key 。
然后當一個消息攜帶著路由值為X，這個消息通過生產者發(fā)送給交換機時，交換機就會根據這個路由值X去尋找綁定值也是X的隊列。

Fanout Exchange

扇型交換機，這個交換機沒有路由鍵概念，就算你綁了路由鍵也是無視的。這個交換機在接收到消息后，會直接轉發(fā)到綁定到它上面的所有隊列。

Topic Exchange

主題交換機，這個交換機其實跟直連交換機流程差不多，但是它的特點就是在它的路由鍵和綁定鍵之間是有規(guī)則的。
簡單地介紹下規(guī)則：

* (星號) 用來表示一個單詞 (必須出現的)
# (井號) 用來表示任意數量（零個或多個）單詞
通配的綁定鍵是跟隊列進行綁定的，舉個小例子
隊列Q1 綁定鍵為 *.TT.* 隊列Q2綁定鍵為 TT.#
如果一條消息攜帶的路由鍵為 A.TT.B，那么隊列Q1將會收到；
如果一條消息攜帶的路由鍵為TT.AA.BB，那么隊列Q2將會收到；

主題交換機是非常強大的，為啥這么膨脹？
當一個隊列的綁定鍵為 "#"（井號）的時候，這個隊列將會無視消息的路由鍵，接收所有的消息。
當 * (星號) 和 # (井號) 這兩個特殊字符都未在綁定鍵中出現的時候，此時主題交換機就擁有的直連交換機的行為。
所以主題交換機也就實現了扇形交換機的功能，和直連交換機的功能。

另外還有 Header Exchange 頭交換機，Default Exchange 默認交換機，Dead Letter Exchange 死信交換機，這幾個該篇暫不做講述。

好了，一些簡單的介紹到這里為止，接下來我們來一起編碼。

本次實例教程需要創(chuàng)建2個springboot項目，一個 rabbitmq-provider （生產者），一個rabbitmq-consumer（消費者）。

首先創(chuàng)建 rabbitmq-provider，

pom.xml里用到的jar依賴：

    <!--rabbitmq-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-amqp</artifactId>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

然后application.yml：

ps：里面的虛擬host配置項不是必須的，我自己在rabbitmq服務上創(chuàng)建了自己的虛擬host，所以我配置了；你們不創(chuàng)建，就不用加這個配置項。

server:
 port: 8021
spring:
 #給項目來個名字
 application:
  name: rabbitmq-provider
 #配置rabbitMq 服務器
 rabbitmq:
  host: 127.0.0.1
  port: 5672
  username: root
  password: root
  #虛擬host 可以不設置,使用server默認host
  virtual-host: JCcccHost

接著我們先使用下direct exchange(直連型交換機),創(chuàng)建DirectRabbitConfig.java（對于隊列和交換機持久化以及連接使用設置，在注釋里有說明，后面的不同交換機的配置就不做同樣說明了）：

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Configuration
public class DirectRabbitConfig {
 
  //隊列 起名：TestDirectQueue
  @Bean
  public Queue TestDirectQueue() {
    // durable:是否持久化,默認是false,持久化隊列：會被存儲在磁盤上，當消息代理重啟時仍然存在，暫存隊列：當前連接有效
    // exclusive:默認也是false，只能被當前創(chuàng)建的連接使用，而且當連接關閉后隊列即被刪除。此參考優(yōu)先級高于durable
    // autoDelete:是否自動刪除，當沒有生產者或者消費者使用此隊列，該隊列會自動刪除。
    //  return new Queue("TestDirectQueue",true,true,false);
 
    //一般設置一下隊列的持久化就好,其余兩個就是默認false
    return new Queue("TestDirectQueue",true);
  }
 
  //Direct交換機 起名：TestDirectExchange
  @Bean
  DirectExchange TestDirectExchange() {
   // return new DirectExchange("TestDirectExchange",true,true);
    return new DirectExchange("TestDirectExchange",true,false);
  }
 
  //綁定 將隊列和交換機綁定, 并設置用于匹配鍵：TestDirectRouting
  @Bean
  Binding bindingDirect() {
    return BindingBuilder.bind(TestDirectQueue()).to(TestDirectExchange()).with("TestDirectRouting");
  }
 
  @Bean
  DirectExchange lonelyDirectExchange() {
    return new DirectExchange("lonelyDirectExchange");
  }
}

然后寫個簡單的接口進行消息推送（根據需求也可以改為定時任務等等，具體看需求），SendMessageController.java：

import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@RestController
public class SendMessageController {
 
  @Autowired
  RabbitTemplate rabbitTemplate; //使用RabbitTemplate,這提供了接收/發(fā)送等等方法
 
  @GetMapping("/sendDirectMessage")
  public String sendDirectMessage() {
    String messageId = String.valueOf(UUID.randomUUID());
    String messageData = "test message, hello!";
    String createTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
    Map<String,Object> map=new HashMap<>();
    map.put("messageId",messageId);
    map.put("messageData",messageData);
    map.put("createTime",createTime);
    //將消息攜帶綁定鍵值：TestDirectRouting 發(fā)送到交換機TestDirectExchange
    rabbitTemplate.convertAndSend("TestDirectExchange", "TestDirectRouting", map);
    return "ok";
  } 
}

把rabbitmq-provider項目運行，調用下接口:

因為我們目前還沒弄消費者 rabbitmq-consumer，消息沒有被消費的，我們去rabbitMq管理頁面看看，是否推送成功：

再看看隊列（界面上的各個英文項代表什么意思，可以自己查查哈，對理解還是有幫助的）：

很好，消息已經推送到rabbitMq服務器上面了。

接下來，創(chuàng)建rabbitmq-consumer項目：

pom.xml里的jar依賴：

    <!--rabbitmq-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-amqp</artifactId>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter</artifactId>
    </dependency>

然后是 application.yml：

server:
 port: 8022
spring:
 #給項目來個名字
 application:
  name: rabbitmq-consumer
 #配置rabbitMq 服務器
 rabbitmq:
  host: 127.0.0.1
  port: 5672
  username: root
  password: root
  #虛擬host 可以不設置,使用server默認host
  virtual-host: JCcccHost

然后一樣，創(chuàng)建DirectRabbitConfig.java（消費者單純的使用，其實可以不用添加這個配置，直接建后面的監(jiān)聽就好，使用注解來讓監(jiān)聽器監(jiān)聽對應的隊列即可。配置上了的話，其實消費者也是生成者的身份，也能推送該消息。）：

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Configuration
public class DirectRabbitConfig {
 
  //隊列 起名：TestDirectQueue
  @Bean
  public Queue TestDirectQueue() {
    return new Queue("TestDirectQueue",true);
  }
 
  //Direct交換機 起名：TestDirectExchange
  @Bean
  DirectExchange TestDirectExchange() {
    return new DirectExchange("TestDirectExchange");
  }
 
  //綁定 將隊列和交換機綁定, 并設置用于匹配鍵：TestDirectRouting
  @Bean
  Binding bindingDirect() {
    return BindingBuilder.bind(TestDirectQueue()).to(TestDirectExchange()).with("TestDirectRouting");
  }
}

然后是創(chuàng)建消息接收監(jiān)聽類，DirectReceiver.java：

@Component
@RabbitListener(queues = "TestDirectQueue")//監(jiān)聽的隊列名稱 TestDirectQueue
public class DirectReceiver {
 
  @RabbitHandler
  public void process(Map testMessage) {
    System.out.println("DirectReceiver消費者收到消息 : " + testMessage.toString());
  }
 
}

然后將rabbitmq-consumer項目運行起來，可以看到把之前推送的那條消息消費下來了：

然后可以再繼續(xù)調用rabbitmq-provider項目的推送消息接口，可以看到消費者即時消費消息：

那么直連交換機既然是一對一，那如果咱們配置多臺監(jiān)聽綁定到同一個直連交互的同一個隊列，會怎么樣？

可以看到是實現了輪詢的方式對消息進行消費，而且不存在重復消費。

接著，我們使用Topic Exchange 主題交換機。

在rabbitmq-provider項目里面創(chuàng)建TopicRabbitConfig.java：

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.TopicExchange;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
 
@Configuration
public class TopicRabbitConfig {
  //綁定鍵
  public final static String man = "topic.man";
  public final static String woman = "topic.woman";
 
  @Bean
  public Queue firstQueue() {
    return new Queue(TopicRabbitConfig.man);
  }
 
  @Bean
  public Queue secondQueue() {
    return new Queue(TopicRabbitConfig.woman);
  }
 
  @Bean
  TopicExchange exchange() {
    return new TopicExchange("topicExchange");
  }
 
  //將firstQueue和topicExchange綁定,而且綁定的鍵值為topic.man
  //這樣只要是消息攜帶的路由鍵是topic.man,才會分發(fā)到該隊列
  @Bean
  Binding bindingExchangeMessage() {
    return BindingBuilder.bind(firstQueue()).to(exchange()).with(man);
  }
 
  //將secondQueue和topicExchange綁定,而且綁定的鍵值為用上通配路由鍵規(guī)則topic.#
  // 這樣只要是消息攜帶的路由鍵是以topic.開頭,都會分發(fā)到該隊列
  @Bean
  Binding bindingExchangeMessage2() {
    return BindingBuilder.bind(secondQueue()).to(exchange()).with("topic.#");
  }
}

然后添加多2個接口，用于推送消息到主題交換機：

 @GetMapping("/sendTopicMessage1")
  public String sendTopicMessage1() {
    String messageId = String.valueOf(UUID.randomUUID());
    String messageData = "message: M A N ";
    String createTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
    Map<String, Object> manMap = new HashMap<>();
    manMap.put("messageId", messageId);
    manMap.put("messageData", messageData);
    manMap.put("createTime", createTime);
    rabbitTemplate.convertAndSend("topicExchange", "topic.man", manMap);
    return "ok";
  }
 
  @GetMapping("/sendTopicMessage2")
  public String sendTopicMessage2() {
    String messageId = String.valueOf(UUID.randomUUID());
    String messageData = "message: woman is all ";
    String createTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
    Map<String, Object> womanMap = new HashMap<>();
    womanMap.put("messageId", messageId);
    womanMap.put("messageData", messageData);
    womanMap.put("createTime", createTime);
    rabbitTemplate.convertAndSend("topicExchange", "topic.woman", womanMap);
    return "ok";
  }
}

生產者這邊已經完事，先不急著運行，在rabbitmq-consumer項目上，創(chuàng)建TopicManReceiver.java：

import org.springframework.amqp.rabbit.annotation.RabbitHandler;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import java.util.Map;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Component
@RabbitListener(queues = "topic.man")
public class TopicManReceiver {
 
  @RabbitHandler
  public void process(Map testMessage) {
    System.out.println("TopicManReceiver消費者收到消息 : " + testMessage.toString());
  }
}

再創(chuàng)建一個TopicTotalReceiver.java：

package com.elegant.rabbitmqconsumer.receiver;
 
import org.springframework.amqp.rabbit.annotation.RabbitHandler;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import java.util.Map;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
 
@Component
@RabbitListener(queues = "topic.woman")
public class TopicTotalReceiver {
 
  @RabbitHandler
  public void process(Map testMessage) {
    System.out.println("TopicTotalReceiver消費者收到消息 : " + testMessage.toString());
  }
}

同樣，加主題交換機的相關配置，TopicRabbitConfig.java（消費者一定要加這個配置嗎？不需要的其實，理由在前面已經說過了。）：

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.TopicExchange;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
 
@Configuration
public class TopicRabbitConfig {
  //綁定鍵
  public final static String man = "topic.man";
  public final static String woman = "topic.woman";
 
  @Bean
  public Queue firstQueue() {
    return new Queue(TopicRabbitConfig.man);
  }
 
  @Bean
  public Queue secondQueue() {
    return new Queue(TopicRabbitConfig.woman);
  }
 
  @Bean
  TopicExchange exchange() {
    return new TopicExchange("topicExchange");
  }
 
 
  //將firstQueue和topicExchange綁定,而且綁定的鍵值為topic.man
  //這樣只要是消息攜帶的路由鍵是topic.man,才會分發(fā)到該隊列
  @Bean
  Binding bindingExchangeMessage() {
    return BindingBuilder.bind(firstQueue()).to(exchange()).with(man);
  }
 
  //將secondQueue和topicExchange綁定,而且綁定的鍵值為用上通配路由鍵規(guī)則topic.#
  // 這樣只要是消息攜帶的路由鍵是以topic.開頭,都會分發(fā)到該隊列
  @Bean
  Binding bindingExchangeMessage2() {
    return BindingBuilder.bind(secondQueue()).to(exchange()).with("topic.#");
  }
 
}

然后把rabbitmq-provider，rabbitmq-consumer兩個項目都跑起來，先調用/sendTopicMessage1 接口：

然后看消費者rabbitmq-consumer的控制臺輸出情況：
TopicManReceiver監(jiān)聽隊列1，綁定鍵為：topic.man
TopicTotalReceiver監(jiān)聽隊列2，綁定鍵為：topic.#
而當前推送的消息，攜帶的路由鍵為：topic.man

所以可以看到兩個監(jiān)聽消費者receiver都成功消費到了消息，因為這兩個recevier監(jiān)聽的隊列的綁定鍵都能與這條消息攜帶的路由鍵匹配上。

接下來調用接口/sendTopicMessage2:

然后看消費者rabbitmq-consumer的控制臺輸出情況：
TopicManReceiver監(jiān)聽隊列1，綁定鍵為：topic.man
TopicTotalReceiver監(jiān)聽隊列2，綁定鍵為：topic.#
而當前推送的消息，攜帶的路由鍵為：topic.woman

所以可以看到兩個監(jiān)聽消費者只有TopicTotalReceiver成功消費到了消息。

接下來是使用Fanout Exchang 扇型交換機。

同樣地，先在rabbitmq-provider項目上創(chuàng)建FanoutRabbitConfig.java：

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.FanoutExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
 
@Configuration
public class FanoutRabbitConfig {
 
  /**
   * 創(chuàng)建三個隊列 ：fanout.A  fanout.B fanout.C
   * 將三個隊列都綁定在交換機 fanoutExchange 上
   * 因為是扇型交換機, 路由鍵無需配置,配置也不起作用
   */
 
 
  @Bean
  public Queue queueA() {
    return new Queue("fanout.A");
  }
 
  @Bean
  public Queue queueB() {
    return new Queue("fanout.B");
  }
 
  @Bean
  public Queue queueC() {
    return new Queue("fanout.C");
  }
 
  @Bean
  FanoutExchange fanoutExchange() {
    return new FanoutExchange("fanoutExchange");
  }
 
  @Bean
  Binding bindingExchangeA() {
    return BindingBuilder.bind(queueA()).to(fanoutExchange());
  }
 
  @Bean
  Binding bindingExchangeB() {
    return BindingBuilder.bind(queueB()).to(fanoutExchange());
  }
 
  @Bean
  Binding bindingExchangeC() {
    return BindingBuilder.bind(queueC()).to(fanoutExchange());
  }
}

然后是寫一個接口用于推送消息，

 @GetMapping("/sendFanoutMessage")
  public String sendFanoutMessage() {
    String messageId = String.valueOf(UUID.randomUUID());
    String messageData = "message: testFanoutMessage ";
    String createTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
    Map<String, Object> map = new HashMap<>();
    map.put("messageId", messageId);
    map.put("messageData", messageData);
    map.put("createTime", createTime);
    rabbitTemplate.convertAndSend("fanoutExchange", null, map);
    return "ok";
  }

接著在rabbitmq-consumer項目里加上消息消費類，

FanoutReceiverA.java：

import org.springframework.amqp.rabbit.annotation.RabbitHandler;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import java.util.Map;
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Component
@RabbitListener(queues = "fanout.A")
public class FanoutReceiverA {
 
  @RabbitHandler
  public void process(Map testMessage) {
    System.out.println("FanoutReceiverA消費者收到消息 : " +testMessage.toString());
  }
}

FanoutReceiverB.java：

import org.springframework.amqp.rabbit.annotation.RabbitHandler;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import java.util.Map;
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Component
@RabbitListener(queues = "fanout.B")
public class FanoutReceiverB {
 
  @RabbitHandler
  public void process(Map testMessage) {
    System.out.println("FanoutReceiverB消費者收到消息 : " +testMessage.toString());
  }
}

FanoutReceiverC.java：

import org.springframework.amqp.rabbit.annotation.RabbitHandler;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;
import java.util.Map;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Component
@RabbitListener(queues = "fanout.C")
public class FanoutReceiverC {
 
  @RabbitHandler
  public void process(Map testMessage) {
    System.out.println("FanoutReceiverC消費者收到消息 : " +testMessage.toString());
  } 
}

然后加上扇型交換機的配置類，FanoutRabbitConfig.java（消費者真的要加這個配置嗎？不需要的其實，理由在前面已經說過了）：

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.FanoutExchange;
import org.springframework.amqp.core.Queue;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Configuration
public class FanoutRabbitConfig {
 
  /**
   * 創(chuàng)建三個隊列 ：fanout.A  fanout.B fanout.C
   * 將三個隊列都綁定在交換機 fanoutExchange 上
   * 因為是扇型交換機, 路由鍵無需配置,配置也不起作用
   */
 
 
  @Bean
  public Queue queueA() {
    return new Queue("fanout.A");
  }
 
  @Bean
  public Queue queueB() {
    return new Queue("fanout.B");
  }
 
  @Bean
  public Queue queueC() {
    return new Queue("fanout.C");
  }
 
  @Bean
  FanoutExchange fanoutExchange() {
    return new FanoutExchange("fanoutExchange");
  }
 
  @Bean
  Binding bindingExchangeA() {
    return BindingBuilder.bind(queueA()).to(fanoutExchange());
  }
 
  @Bean
  Binding bindingExchangeB() {
    return BindingBuilder.bind(queueB()).to(fanoutExchange());
  }
 
  @Bean
  Binding bindingExchangeC() {
    return BindingBuilder.bind(queueC()).to(fanoutExchange());
  }
}

最后將rabbitmq-provider和rabbitmq-consumer項目都跑起來，調用下接口/sendFanoutMessage ：

然后看看rabbitmq-consumer項目的控制臺情況：

可以看到只要發(fā)送到 fanoutExchange 這個扇型交換機的消息，三個隊列都綁定這個交換機，所以三個消息接收類都監(jiān)聽到了這條消息。

到了這里其實三個常用的交換機的使用我們已經完畢了，那么接下來我們繼續(xù)講講消息的回調，其實就是消息確認（生產者推送消息成功，消費者接收消息成功）。

在rabbitmq-provider項目的application.yml文件上，加上消息確認的配置項后：

ps：本篇文章使用springboot版本為 2.1.7.RELEASE ;
如果你們在配置確認回調，測試發(fā)現無法觸發(fā)回調函數，那么存在原因也許是因為版本導致的配置項不起效，
可以把publisher-confirms: true 替換為 publisher-confirm-type: correlated

server:
 port: 8021
spring:
 #給項目來個名字
 application:
  name: rabbitmq-provider
 #配置rabbitMq 服務器
 rabbitmq:
  host: 127.0.0.1
  port: 5672
  username: root
  password: root
  #虛擬host 可以不設置,使用server默認host
  virtual-host: JCcccHost
  #消息確認配置項
 
  #確認消息已發(fā)送到交換機(Exchange)
  publisher-confirms: true
  #確認消息已發(fā)送到隊列(Queue)
  publisher-returns: true

然后是配置相關的消息確認回調函數，RabbitConfig.java：

import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.connection.ConnectionFactory;
import org.springframework.amqp.rabbit.connection.CorrelationData;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
 
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/3
 * @Description :
 **/
@Configuration
public class RabbitConfig {
 
  @Bean
  public RabbitTemplate createRabbitTemplate(ConnectionFactory connectionFactory){
    RabbitTemplate rabbitTemplate = new RabbitTemplate();
    rabbitTemplate.setConnectionFactory(connectionFactory);
    //設置開啟Mandatory,才能觸發(fā)回調函數,無論消息推送結果怎么樣都強制調用回調函數
    rabbitTemplate.setMandatory(true);
 
    rabbitTemplate.setConfirmCallback(new RabbitTemplate.ConfirmCallback() {
      @Override
      public void confirm(CorrelationData correlationData, boolean ack, String cause) {
        System.out.println("ConfirmCallback:   "+"相關數據："+correlationData);
        System.out.println("ConfirmCallback:   "+"確認情況："+ack);
        System.out.println("ConfirmCallback:   "+"原因："+cause);
      }
    });
 
    rabbitTemplate.setReturnCallback(new RabbitTemplate.ReturnCallback() {
      @Override
      public void returnedMessage(Message message, int replyCode, String replyText, String exchange, String routingKey) {
        System.out.println("ReturnCallback:   "+"消息："+message);
        System.out.println("ReturnCallback:   "+"回應碼："+replyCode);
        System.out.println("ReturnCallback:   "+"回應信息："+replyText);
        System.out.println("ReturnCallback:   "+"交換機："+exchange);
        System.out.println("ReturnCallback:   "+"路由鍵："+routingKey);
      }
    });
 
    return rabbitTemplate;
  }
 
}

到這里，生產者推送消息的消息確認調用回調函數已經完畢。
可以看到上面寫了兩個回調函數，一個叫 ConfirmCallback ，一個叫 RetrunCallback；
那么以上這兩種回調函數都是在什么情況會觸發(fā)呢？

先從總體的情況分析，推送消息存在四種情況：

①消息推送到server，但是在server里找不到交換機
②消息推送到server，找到交換機了，但是沒找到隊列
③消息推送到sever，交換機和隊列啥都沒找到
④消息推送成功

那么我先寫幾個接口來分別測試和認證下以上4種情況，消息確認觸發(fā)回調函數的情況：

①消息推送到server，但是在server里找不到交換機
寫個測試接口，把消息推送到名為‘non-existent-exchange'的交換機上（這個交換機是沒有創(chuàng)建沒有配置的）：

 @GetMapping("/TestMessageAck")
  public String TestMessageAck() {
    String messageId = String.valueOf(UUID.randomUUID());
    String messageData = "message: non-existent-exchange test message ";
    String createTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
    Map<String, Object> map = new HashMap<>();
    map.put("messageId", messageId);
    map.put("messageData", messageData);
    map.put("createTime", createTime);
    rabbitTemplate.convertAndSend("non-existent-exchange", "TestDirectRouting", map);
    return "ok";
  }

調用接口，查看rabbitmq-provuder項目的控制臺輸出情況（原因里面有說，沒有找到交換機'non-existent-exchange'）：

2019-09-04 09:37:45.197 ERROR 8172 --- [ 127.0.0.1:5672] o.s.a.r.c.CachingConnectionFactory : Channel shutdown: channel error; protocol method: #method<channel.close>(reply-code=404, reply-text=NOT_FOUND - no exchange 'non-existent-exchange' in vhost 'JCcccHost', class-id=60, method-id=40)
ConfirmCallback: 相關數據：null
ConfirmCallback: 確認情況：false
ConfirmCallback: 原因：channel error; protocol method: #method<channel.close>(reply-code=404, reply-text=NOT_FOUND - no exchange 'non-existent-exchange' in vhost 'JCcccHost', class-id=60, method-id=40)

結論： ①這種情況觸發(fā)的是 ConfirmCallback 回調函數。

②消息推送到server，找到交換機了，但是沒找到隊列
這種情況就是需要新增一個交換機，但是不給這個交換機綁定隊列，我來簡單地在DirectRabitConfig里面新增一個直連交換機，名叫‘lonelyDirectExchange'，但沒給它做任何綁定配置操作：

@Bean
  DirectExchange lonelyDirectExchange() {
    return new DirectExchange("lonelyDirectExchange");
  }

然后寫個測試接口，把消息推送到名為‘lonelyDirectExchange'的交換機上（這個交換機是沒有任何隊列配置的）：

 @GetMapping("/TestMessageAck2")
  public String TestMessageAck2() {
    String messageId = String.valueOf(UUID.randomUUID());
    String messageData = "message: lonelyDirectExchange test message ";
    String createTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
    Map<String, Object> map = new HashMap<>();
    map.put("messageId", messageId);
    map.put("messageData", messageData);
    map.put("createTime", createTime);
    rabbitTemplate.convertAndSend("lonelyDirectExchange", "TestDirectRouting", map);
    return "ok";
  }

調用接口，查看rabbitmq-provuder項目的控制臺輸出情況：

ReturnCallback: 消息：(Body:'{createTime=2019-09-04 09:48:01, messageId=563077d9-0a77-4c27-8794-ecfb183eac80, messageData=message: lonelyDirectExchange test message }' MessageProperties [headers={}, contentType=application/x-java-serialized-object, contentLength=0, receivedDeliveryMode=PERSISTENT, priority=0, deliveryTag=0])
ReturnCallback: 回應碼：312
ReturnCallback: 回應信息：NO_ROUTE
ReturnCallback: 交換機：lonelyDirectExchange
ReturnCallback: 路由鍵：TestDirectRouting

ConfirmCallback: 相關數據：null
ConfirmCallback: 確認情況：true
ConfirmCallback: 原因：null

可以看到這種情況，兩個函數都被調用了；
這種情況下，消息是推送成功到服務器了的，所以ConfirmCallback對消息確認情況是true；
而在RetrunCallback回調函數的打印參數里面可以看到，消息是推送到了交換機成功了，但是在路由分發(fā)給隊列的時候，找不到隊列，所以報了錯誤 NO_ROUTE 。
結論：②這種情況觸發(fā)的是 ConfirmCallback和RetrunCallback兩個回調函數。

③消息推送到sever，交換機和隊列啥都沒找到
這種情況其實一看就覺得跟①很像，沒錯，③和①情況回調是一致的，所以不做結果說明了。
結論： ③這種情況觸發(fā)的是 ConfirmCallback 回調函數。

④消息推送成功
那么測試下，按照正常調用之前消息推送的接口就行，就調用下 /sendFanoutMessage接口，可以看到控制臺輸出：

ConfirmCallback: 相關數據：null
ConfirmCallback: 確認情況：true
ConfirmCallback: 原因：null

結論： ④這種情況觸發(fā)的是 ConfirmCallback 回調函數。

以上是生產者推送消息的消息確認回調函數的使用介紹（可以在回調函數根據需求做對應的擴展或者業(yè)務數據處理）。

接下來我們繼續(xù)，消費者接收到消息的消息確認機制。

和生產者的消息確認機制不同，因為消息接收本來就是在監(jiān)聽消息，符合條件的消息就會消費下來。
所以，消息接收的確認機制主要存在三種模式：

①自動確認，這也是默認的消息確認情況。 AcknowledgeMode.NONE
RabbitMQ成功將消息發(fā)出（即將消息成功寫入TCP Socket）中立即認為本次投遞已經被正確處理，不管消費者端是否成功處理本次投遞。
所以這種情況如果消費端消費邏輯拋出異常，也就是消費端沒有處理成功這條消息，那么就相當于丟失了消息。
一般這種情況我們都是使用try catch捕捉異常后，打印日志用于追蹤數據，這樣找出對應數據再做后續(xù)處理。

② 根據情況確認，這個不做介紹
③ 手動確認，這個比較關鍵，也是我們配置接收消息確認機制時，多數選擇的模式。
消費者收到消息后，手動調用basic.ack/basic.nack/basic.reject后，RabbitMQ收到這些消息后，才認為本次投遞成功。
basic.ack用于肯定確認
basic.nack用于否定確認（注意：這是AMQP 0-9-1的RabbitMQ擴展）
basic.reject用于否定確認，但與basic.nack相比有一個限制:一次只能拒絕單條消息

消費者端以上的3個方法都表示消息已經被正確投遞，但是basic.ack表示消息已經被正確處理。
而basic.nack,basic.reject表示沒有被正確處理：

著重講下reject，因為有時候一些場景是需要重新入列的。

channel.basicReject(deliveryTag, true); 拒絕消費當前消息，如果第二參數傳入true，就是將數據重新丟回隊列里，那么下次還會消費這消息。設置false，就是告訴服務器，我已經知道這條消息數據了，因為一些原因拒絕它，而且服務器也把這個消息丟掉就行。下次不想再消費這條消息了。

使用拒絕后重新入列這個確認模式要謹慎，因為一般都是出現異常的時候，catch異常再拒絕入列，選擇是否重入列。

但是如果使用不當會導致一些每次都被你重入列的消息一直消費-入列-消費-入列這樣循環(huán)，會導致消息積壓。

順便也簡單講講 nack，這個也是相當于設置不消費某條消息。

channel.basicNack(deliveryTag, false, true);
第一個參數依然是當前消息到的數據的唯一id;
第二個參數是指是否針對多條消息；如果是true，也就是說一次性針對當前通道的消息的tagID小于當前這條消息的，都拒絕確認。
第三個參數是指是否重新入列，也就是指不確認的消息是否重新丟回到隊列里面去。

同樣使用不確認后重新入列這個確認模式要謹慎，因為這里也可能因為考慮不周出現消息一直被重新丟回去的情況，導致積壓。

看了上面這么多介紹，接下來我們一起配置下，看看一般的消息接收手動確認是怎么樣的。

在消費者項目里，
新建MessageListenerConfig.java上添加代碼相關的配置代碼：

import com.elegant.rabbitmqconsumer.receiver.MyAckReceiver;
import org.springframework.amqp.core.AcknowledgeMode;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.rabbit.connection.CachingConnectionFactory;
import org.springframework.amqp.rabbit.listener.SimpleMessageListenerContainer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
 
/**
 * @Author : JCccc
 * @CreateTime : 2019/9/4
 * @Description :
 **/
@Configuration
public class MessageListenerConfig {
 
  @Autowired
  private CachingConnectionFactory connectionFactory;
  @Autowired
  private MyAckReceiver myAckReceiver;//消息接收處理類
 
  @Bean
  public SimpleMessageListenerContainer simpleMessageListenerContainer() {
    SimpleMessageListenerContainer container = new SimpleMessageListenerContainer(connectionFactory);
    container.setConcurrentConsumers(1);
    container.setMaxConcurrentConsumers(1);
    container.setAcknowledgeMode(AcknowledgeMode.MANUAL); // RabbitMQ默認是自動確認，這里改為手動確認消息
    //設置一個隊列
    container.setQueueNames("TestDirectQueue");
    //如果同時設置多個如下： 前提是隊列都是必須已經創(chuàng)建存在的
    // container.setQueueNames("TestDirectQueue","TestDirectQueue2","TestDirectQueue3");
 
    //另一種設置隊列的方法,如果使用這種情況,那么要設置多個,就使用addQueues
    //container.setQueues(new Queue("TestDirectQueue",true));
    //container.addQueues(new Queue("TestDirectQueue2",true));
    //container.addQueues(new Queue("TestDirectQueue3",true));
    container.setMessageListener(myAckReceiver);
 
    return container;  }
 
}

對應的手動確認消息監(jiān)聽類，MyAckReceiver.java（手動確認模式需要實現 ChannelAwareMessageListener）：
//之前的相關監(jiān)聽器可以先注釋掉，以免造成多個同類型監(jiān)聽器都監(jiān)聽同一個隊列。
//這里的獲取消息轉換，只作參考，如果報數組越界可以自己根據格式去調整。

import com.rabbitmq.client.Channel;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.listener.api.ChannelAwareMessageListener;
import org.springframework.stereotype.Component;
import java.util.HashMap;
import java.util.Map;
 
@Component
 
public class MyAckReceiver implements ChannelAwareMessageListener {
 
  @Override
  public void onMessage(Message message, Channel channel) throws Exception {
    long deliveryTag = message.getMessageProperties().getDeliveryTag();
    try {
      //因為傳遞消息的時候用的map傳遞,所以將Map從Message內取出需要做些處理
      String msg = message.toString();
      String[] msgArray = msg.split("'");//可以點進Message里面看源碼,單引號直接的數據就是我們的map消息數據
      Map<String, String> msgMap = mapStringToMap(msgArray[1].trim(),3);
      String messageId=msgMap.get("messageId");
      String messageData=msgMap.get("messageData");
      String createTime=msgMap.get("createTime");
      System.out.println(" MyAckReceiver messageId:"+messageId+" messageData:"+messageData+" createTime:"+createTime);
      System.out.println("消費的主題消息來自："+message.getMessageProperties().getConsumerQueue());
      channel.basicAck(deliveryTag, true); //第二個參數，手動確認可以被批處理，當該參數為 true 時，則可以一次性確認 delivery_tag 小于等于傳入值的所有消息
//			channel.basicReject(deliveryTag, true);//第二個參數，true會重新放回隊列，所以需要自己根據業(yè)務邏輯判斷什么時候使用拒絕
    } catch (Exception e) {
      channel.basicReject(deliveryTag, false);
      e.printStackTrace();
    }
  }
 
   //{key=value,key=value,key=value} 格式轉換成map
  private Map<String, String> mapStringToMap(String str,int entryNum ) {
    str = str.substring(1, str.length() - 1);
    String[] strs = str.split(",",entryNum);
    Map<String, String> map = new HashMap<String, String>();
    for (String string : strs) {
      String key = string.split("=")[0].trim();
      String value = string.split("=")[1];
      map.put(key, value);
    }
    return map;
  }
}

這時，先調用接口/sendDirectMessage，給直連交換機TestDirectExchange 的隊列TestDirectQueue 推送一條消息，可以看到監(jiān)聽器正常消費了下來：

到這里，我們其實已經掌握了怎么去使用消息消費的手動確認了。

但是這個場景往往不夠！因為很多伙伴之前給我評論反應，他們需要這個消費者項目里面，監(jiān)聽的好幾個隊列都想變成手動確認模式，而且處理的消息業(yè)務邏輯不一樣。

沒有問題，接下來看代碼

場景：除了直連交換機的隊列TestDirectQueue需要變成手動確認以外，我們還需要將一個其他的隊列

或者多個隊列也變成手動確認，而且不同隊列實現不同的業(yè)務處理。

那么我們需要做的第一步，往SimpleMessageListenerContainer里添加多個隊列：

然后我們的手動確認消息監(jiān)聽類，MyAckReceiver.java 就可以同時將上面設置到的隊列的消息都消費下來。

但是我們需要做不用的業(yè)務邏輯處理，那么只需要根據消息來自的隊列名進行區(qū)分處理即可，如：

import com.rabbitmq.client.Channel;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.listener.api.ChannelAwareMessageListener;
import org.springframework.stereotype.Component;
import java.util.HashMap;
import java.util.Map;
 
@Component
public class MyAckReceiver implements ChannelAwareMessageListener {
 
  @Override
  public void onMessage(Message message, Channel channel) throws Exception {
    long deliveryTag = message.getMessageProperties().getDeliveryTag();
    try {
      //因為傳遞消息的時候用的map傳遞,所以將Map從Message內取出需要做些處理
      String msg = message.toString();
      String[] msgArray = msg.split("'");//可以點進Message里面看源碼,單引號直接的數據就是我們的map消息數據
      Map<String, String> msgMap = mapStringToMap(msgArray[1].trim(),3);
      String messageId=msgMap.get("messageId");
      String messageData=msgMap.get("messageData");
      String createTime=msgMap.get("createTime");
      
      if ("TestDirectQueue".equals(message.getMessageProperties().getConsumerQueue())){
        System.out.println("消費的消息來自的隊列名為："+message.getMessageProperties().getConsumerQueue());
        System.out.println("消息成功消費到 messageId:"+messageId+" messageData:"+messageData+" createTime:"+createTime);
        System.out.println("執(zhí)行TestDirectQueue中的消息的業(yè)務處理流程......");
        
      }
 
      if ("fanout.A".equals(message.getMessageProperties().getConsumerQueue())){
        System.out.println("消費的消息來自的隊列名為："+message.getMessageProperties().getConsumerQueue());
        System.out.println("消息成功消費到 messageId:"+messageId+" messageData:"+messageData+" createTime:"+createTime);
        System.out.println("執(zhí)行fanout.A中的消息的業(yè)務處理流程......");
 
      }
      
      channel.basicAck(deliveryTag, true);
//			channel.basicReject(deliveryTag, true);//為true會重新放回隊列
    } catch (Exception e) {
      channel.basicReject(deliveryTag, false);
      e.printStackTrace();
    }
  }
 
  //{key=value,key=value,key=value} 格式轉換成map
  private Map<String, String> mapStringToMap(String str,int enNum) {
    str = str.substring(1, str.length() - 1);
    String[] strs = str.split(",",enNum);
    Map<String, String> map = new HashMap<String, String>();
    for (String string : strs) {
      String key = string.split("=")[0].trim();
      String value = string.split("=")[1];
      map.put(key, value);
    }
    return map;
  }
}

ok，這時候我們來分別往不同隊列推送消息，看看效果：

調用接口/sendDirectMessage 和 /sendFanoutMessage ，

如果你還想新增其他的監(jiān)聽隊列，也就是按照這種方式新增配置即可（或者完全可以分開多個消費者項目去監(jiān)聽處理）。

好，這篇Springboot整合rabbitMq教程就暫且到此。

到此這篇關于Springboot 整合RabbitMq(用心看完這一篇就夠了)的文章就介紹到這了,更多相關Springboot 整合RabbitMq內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

SpringCloud OpenFeign超時控制示例詳解
在Spring Cloud中使用OpenFeign時,可以通過配置來控制請求的超時時間,這篇文章主要介紹了SpringCloud OpenFeign超時控制,需要的朋友可以參考下
2024-05-05
java避免死鎖的常見方法代碼解析
這篇文章主要介紹了java避免死鎖的常見方法代碼解析，具有一定借鑒價值,需要的朋友可以參考下
2018-01-01
導出maven項目依賴的jar包(圖文教程)
下面小編就為大家?guī)硪黄獙С鰉aven項目依賴的jar包(圖文教程)。小編覺得挺不錯的，現在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2017-10-10
SpringBoot如何使用p6spy監(jiān)控數據庫
這篇文章主要介紹了SpringBoot如何使用p6spy監(jiān)控數據庫問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
2024-01-01
eclipse 安裝lombok插件
這篇文章主要介紹了eclipse 安裝lombok插件的詳細步驟，非常不錯，具有一定的參考借鑒價值,需要的朋友可以參考下
2018-07-07
java中實現漢字按照拼音排序(示例代碼)
這篇文章主要是對java中將漢字按照拼音排序的實現代碼進行了詳細的分析介紹。需要的朋友可以過來參考下，希望對大家有所幫助
2013-12-12
Spring?Boot中調用外部接口的3種方式步驟
這篇文章主要給大家介紹了關于Spring?Boot中調用外部接口的3種方式步驟,在Spring-Boot項目開發(fā)中,存在著本模塊的代碼需要訪問外面模塊接口,或外部url鏈接的需求,需要的朋友可以參考下
2023-08-08
SpringCloud Config統(tǒng)一配置中心問題分析解決與客戶端動態(tài)刷新實現
springcloud config是一個解決分布式系統(tǒng)的配置管理方案。它包含了 client和server兩個部分，server端提供配置文件的存儲、以接口的形式將配置文件的內容提供出去，client端通過接口獲取數據、并依據此數據初始化自己的應用
2022-10-10
Maven 命令行打包和 pom.xml的常用配置詳解
這篇文章主要介紹了Maven 命令行打包和 pom.xml的常用配置詳解，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2020-11-11
Java編程實現排他鎖代碼詳解
這篇文章主要介紹了Java編程實現排他鎖的相關內容，敘述了實現此代碼鎖所需要的功能，以及作者的解決方案，然后向大家分享了設計源碼，需要的朋友可以參考下。
2017-10-10