SpringAMQP入门

将来我们开发业务功能的时候,肯定不会在控制台收发消息,而是应该基于编程的方式。由于RabbitMQ采用了AMQP协议,因此它具备跨语言的特性。任何语言只要遵循AMQP协议收发消息,都可以与RabbitMQ交互。并且RabbitMQ官方也提供了各种不同语言的客户端。

但是,RabbitMQ官方提供的Java客户端编码相对复杂,一般生产环境下我们更多会结合Spring来使用。而Spring的官方刚好基于RabbitMQ提供了这样一套消息收发的模板工具:SpringAMQP。并且还基于SpringBoot对其实现了自动装配,使用起来非常方便。

SpringAmqp的官方地址:

https://spring.io/projects/spring-amqp

SpringAMQP提供了三个功能:

  • 自动声明队列、交换机及其绑定关系

  • 基于注解的监听器模式,异步接收消息

  • 封装了RabbitTemplate工具,用于发送消息

这一章我们就一起学习一下,如何利用SpringAMQP实现对RabbitMQ的消息收发。

1. 创建工程

包括三部分:

  • RabbitMQ:父工程,管理项目依赖

  • publisher:消息的发送者

  • consumer:消息的消费者

父工程RabbitMQ

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.0</version> <!-- 使用 Spring Boot 3.2.0 -->
        <relativePath/> <!-- 指向父 POM 文件的路径 -->
    </parent>

    <groupId>org.example</groupId>
    <artifactId>RabbitMQ</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>consumer</module>
        <module>publisher</module>
    </modules>

    <properties>
        <java.version>17</java.version> <!-- Spring Boot 默认使用 Java 17 -->
        <lombok.version>1.18.28</lombok.version> <!-- Lombok 版本 -->
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-log4j12</artifactId>
                <version>1.7.28</version>
            </dependency>
                    <!-- Spring Boot 核心依赖 -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter</artifactId>
                <version>3.2.0</version>
            </dependency>
            <!-- RabbitMQ Starter -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-amqp</artifactId>
                <version>3.2.0</version>
            </dependency>

            <!-- Lombok -->
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>${lombok.version}</version>
            </dependency>

            <!-- 测试 Starter -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <version>3.2.0</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

子工程publisher

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.example</groupId>
        <artifactId>RabbitMQ</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>publisher</artifactId>
    <name>publisher</name>

    <packaging>jar</packaging>
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
        </dependency>
        <!-- Spring Boot 核心依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <!-- RabbitMQ Starter -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-amqp</artifactId>
            <version>3.2.0</version>
        </dependency>

        <!-- Lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <scope>provided</scope>
        </dependency>

        <!-- 测试 Starter -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

子工程consumer

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.example</groupId>
        <artifactId>RabbitMQ</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>consumer</artifactId>
    <name>consumer</name>

    <packaging>jar</packaging>
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
        </dependency>
        <!-- Spring Boot 核心依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <!-- RabbitMQ Starter -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-amqp</artifactId>
        </dependency>

        <!-- Lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <scope>provided</scope>
        </dependency>


        <!-- 测试 Starter -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

</project>

2. 快速入门

我们都是经过交换机发送消息到队列,不过有时候为了测试方便,我们也可以直接向队列发送消息,跳过交换机。

在入门案例中,我们就演示这样的简单模型,如图:

enter image description here

注意:这种模式一般测试使用,很少在生产中使用。

也就是:

  • publisher直接发送消息到队列

  • 消费者监听并处理队列中的消息

注意:这种模式一般测试使用,很少在生产中使用。

为了方便测试,我们现在控制台新建一个队列:RabbitMQSample


接下来,我们就可以利用Java代码收发消息了。

消息发送

首先配置MQ地址,在publisher服务的application.yml中添加配置:

spring:  
  rabbitmq:  
    host: 127.0.0.1  
    port: 5672  
  virtual-host: /David  
    username: Spike  
    password: '#Alone117'  
server:  
  port: 8082

然后在publisher服务中编写测试类SpringAmqpTest,并利用RabbitTemplate实现消息发送:

import jakarta.annotation.Resource;  
import org.junit.jupiter.api.Test;  
import org.springframework.amqp.rabbit.core.RabbitTemplate;  
import org.springframework.boot.test.context.SpringBootTest;  
  
@SpringBootTest  
public class SpringAMPtest {  
    @Resource  
  private RabbitTemplate rabbitTemplate;  
  
    @Test  
  public void test() {  
        String message = "Hello World";  
        String queueName = "RabbitMQSample";  
        rabbitTemplate.convertAndSend(queueName, message);  
    }  
}

打开控制台,可以看到消息已经发送到队列中:

enter image description here
接下来,我们再来实现消息接收。

消息接收

首先配置MQ地址,在consumer服务的application.yml中添加配置:

spring:  
  rabbitmq:  
    host: 127.0.0.1  
    port: 5672  
  virtual-host: /David  
    username: Spike  
    password: '#Alone117'  
server:  
  port: 8082

然后在consumer服务的com.itheima.consumer.listener包中新建一个类SpringRabbitListener,代码如下:

import lombok.extern.slf4j.Slf4j;  
import org.springframework.amqp.rabbit.annotation.RabbitListener;  
import org.springframework.stereotype.Component;  
@Component  
@Slf4j  
public class SpringRabbitListener {  
    // 利用RabbitListener来声明要监听的队列信息
    // 将来一旦监听的队列中有了消息,就会推送给当前服务,调用当前方法,处理消息。
    // 可以看到方法体中接收的就是消息体的内容
    @RabbitListener(queues = "RabbitMQSample")  
    public void receive(String message) throws InterruptedException {  
        System.out.println(message);  
        log.info("RabbitMQSample message: {}", message);  
    }  
}

测试

启动consumer服务,然后在publisher服务中运行测试代码,发送MQ消息。最终consumer收到消息:

enter image description here

3. WorkQueues模型

注意: 创建交换机的时候请指定交换机类型

Work queues,任务模型。简单来说就是让多个消费者绑定到一个队列,共同消费队列中的消息

enter image description here
当消息处理比较耗时的时候,可能生产消息的速度会远远大于消息的消费速度。长此以往,消息就会堆积越来越多,无法及时处理。

此时就可以使用work 模型,多个消费者共同处理消息处理,消息处理的速度就能大大提高了。

消息发送

这次我们循环发送,模拟大量消息堆积现象。

在publisher服务中的SpringAmqpTest类中添加一个测试方法:

/**  
 * workQueue * 向队列中不停发送消息,模拟消息堆积。  
  */  
@Test  
public void testWorkQueue() throws InterruptedException {  
    String message = "Hello World";  
    String queueName = "RabbitMQSample";  
    for (int i = 0; i < 25; i++) {  
        // 发送消息,每50毫秒发送一次,相当于每秒发送25条消息  
  rabbitTemplate.convertAndSend(queueName, message + i);  
        Thread.sleep(40);  
    }  
}

消息接收

要模拟多个消费者绑定同一个队列,我们在consumer服务的SpringRabbitListener中添加2个新的方法:

@RabbitListener(queues = "RabbitMQSample")  
public void receive(String message) throws InterruptedException {  
    System.out.println("消费者1接收到消息:【" + message + "】" + LocalTime.now());  
    Thread.sleep(20);  
}  
  
@RabbitListener(queues = "RabbitMQSample")  
public void receive2(String message) throws InterruptedException {  
    System.out.println("消费者2接收到消息:【" + message + "】" + LocalTime.now());  
    Thread.sleep(200);  
}
消费者1接收到消息:【Hello World0】19:20:54.271843987
消费者2缓慢接收到消息:【Hello World1】19:20:54.299730634
消费者1接收到消息:【Hello World2】19:20:54.340192027
消费者1接收到消息:【Hello World4】19:20:54.420822866
消费者2缓慢接收到消息:【Hello World3】19:20:54.500507101
消费者1接收到消息:【Hello World6】19:20:54.501276410
消费者1接收到消息:【Hello World8】19:20:54.582170999
消费者1接收到消息:【Hello World10】19:20:54.663028211
消费者2缓慢接收到消息:【Hello World5】19:20:54.701053954
消费者1接收到消息:【Hello World12】19:20:54.744712067
消费者1接收到消息:【Hello World14】19:20:54.825619912
消费者2缓慢接收到消息:【Hello World7】19:20:54.901780317
消费者1接收到消息:【Hello World16】19:20:54.906339218
消费者1接收到消息:【Hello World18】19:20:54.987172765
消费者1接收到消息:【Hello World20】19:20:55.067933837
消费者2缓慢接收到消息:【Hello World9】19:20:55.102683947
消费者1接收到消息:【Hello World22】19:20:55.148662417
消费者1接收到消息:【Hello World24】19:20:55.229391972
消费者2缓慢接收到消息:【Hello World11】19:20:55.303402451
消费者2缓慢接收到消息:【Hello World13】19:20:55.503977358
消费者2缓慢接收到消息:【Hello World15】19:20:55.704598655
消费者2缓慢接收到消息:【Hello World17】19:20:55.905286651
消费者2缓慢接收到消息:【Hello World19】19:20:56.105912259
消费者2缓慢接收到消息:【Hello World21】19:20:56.307609477
消费者2缓慢接收到消息:【Hello World23】19:20:56.508466869

可以看到消费者1和消费者2竟然每人消费了12条左右的消息:

  • 消费者1很快完成了自己的12条消息

  • 消费者2却在缓慢的处理自己的12条消息。

也就是说消息是平均分配给每个消费者,并没有考虑到消费者的处理能力。导致1个消费者空闲,另一个消费者忙的不可开交。没有充分利用每一个消费者的能力,最终消息处理的耗时远远超过了1秒。这样显然是有问题的。

能者多劳(流处理网络耗时)

消费者1接收到消息:【Hello World0】19:19:11.702641605
消费者2缓慢接收到消息:【Hello World1】19:19:11.721349175
消费者1接收到消息:【Hello World2】19:19:11.761544625
消费者1接收到消息:【Hello World3】19:19:11.802006485
消费者1接收到消息:【Hello World4】19:19:11.842382641
消费者1接收到消息:【Hello World5】19:19:11.883319701
消费者1接收到消息:【Hello World6】19:19:11.923177303
消费者2缓慢接收到消息:【Hello World7】19:19:11.964591061
消费者1接收到消息:【Hello World8】19:19:12.004571144
消费者1接收到消息:【Hello World9】19:19:12.044987166
消费者1接收到消息:【Hello World10】19:19:12.085519341
消费者1接收到消息:【Hello World11】19:19:12.126376127
消费者1接收到消息:【Hello World12】19:19:12.166076134
消费者2缓慢接收到消息:【Hello World13】19:19:12.209760514
消费者1接收到消息:【Hello World14】19:19:12.247740987
消费者1接收到消息:【Hello World15】19:19:12.288511843
消费者1接收到消息:【Hello World16】19:19:12.328917746
消费者1接收到消息:【Hello World17】19:19:12.369241819
消费者1接收到消息:【Hello World18】19:19:12.411125432
消费者1接收到消息:【Hello World19】19:19:12.451027250
消费者2缓慢接收到消息:【Hello World20】19:19:12.492941375
消费者1接收到消息:【Hello World21】19:19:12.532032107
消费者1接收到消息:【Hello World22】19:19:12.572750997
消费者1接收到消息:【Hello World23】19:19:12.612835165
消费者1接收到消息:【Hello World24】19:19:12.653165897

可以发现,由于消费者1处理速度较快,所以处理了更多的消息;消费者2处理速度较慢,只处理了6条消息。而最终总的执行耗时也在1秒左右,大大提升。

Work模型的使用:

  • 多个消费者绑定到一个队列,同一条消息只会被一个消费者处理
  • 通过设置prefetch来控制消费者预取的消息数量

4. 交换机类型

注意: 创建交换机的时候请指定交换机类型

在之前的两个测试案例中,都没有交换机,生产者直接发送消息到队列。而一旦引入交换机,消息发送的模式会有很大变化:

注意: Exchange(交换机)只负责转发消息,不具备存储消息的能力

enter image description here

可以看到,在订阅模型中,多了一个exchange角色,而且过程略有变化:

  • Publisher:生产者,不再发送消息到队列中,而是发给交换机

  • Exchange:交换机,一方面,接收生产者发送的消息。另一方面,知道如何处理消息,例如递交给某个特别队列、递交给所有队列、或是将消息丢弃。到底如何操作,取决于Exchange的类型。

  • Queue:消息队列也与以前一样,接收消息、缓存消息。不过队列一定要与交换机绑定。

  • Consumer:消费者,与以前一样,订阅队列,没有变化

Exchange(交换机)只负责转发消息,不具备存储消息的能力,因此如果没有任何队列与Exchange绑定,或者没有符合路由规则的队列,那么消息会丢失!

交换机的类型有四种:

  • Fanout:广播,将消息交给所有绑定到交换机的队列。我们最早在控制台使用的正是Fanout交换机

  • Direct:订阅,基于RoutingKey(路由key)发送给订阅了消息的队列

  • Topic:通配符订阅,与Direct类似,只不过RoutingKey可以使用通配符

  • Headers:头匹配,基于MQ的消息头匹配,用的较少。

5. Fanout交换机

注意: 创建交换机的时候请指定交换机类型

Fanout,英文翻译是扇出,我觉得在MQ中叫广播更合适,工作原理与广播网络很像。

消息发送给绑定过的所有队列

在广播模式下,消息发送流程是这样的:

  • 1) 可以有多个队列

  • 2) 每个队列都要绑定到Exchange(交换机)

  • 3) 生产者发送的消息,只能发送到交换机

  • 4) 交换机把消息发送给绑定过的所有队列

  • 5) 订阅队列的消费者都能拿到消息

我们的计划是这样的:

  • 创建一个名为 Spike.exchage的交换机,类型是Fanout

  • 创建两个队列Spike.queue1Spike.queue2,绑定到交换机Spike.exchage

1. 声明队列和交换机

在控制台创建队列Spike.queue1:

enter image description here

在控制台创建队列Spike.queue2:

enter image description here

然后再创建一个交换机Spike.exchage

enter image description here

然后绑定两个队列到交换机:

enter image description here
enter image description here

2. 消息发送

在publisher服务的SpringAmqpTest类中添加测试方法:

    @Test
    public void testExchange() {
        String exchangeName = "Spike.exchage";
        String message = "Hello World";
        rabbitTemplate.convertAndSend(exchangeName, "", message);
    }

3. 消息接收

    @RabbitListener(queues = "Spike.queue1")
    public void receive(String message) throws InterruptedException {
        System.out.println("消费者1接收到消息:【" + message + "】" + LocalTime.now());
        Thread.sleep(20);
    }

    @RabbitListener(queues = "Spike.queue2")
    public void receive2(String message) throws InterruptedException {
        System.out.println("消费者2接收到消息:【" + message + "】" + LocalTime.now());
        Thread.sleep(200);
    }

4. 控制台

消费者1接收到消息:【Hello World】20:28:31.239567181
消费者2接收到消息:【Hello World】20:28:31.239567158

交换机的作用:

  • 接收publisher发送的消息

  • 将消息按照规则路由到与之绑定的队列

  • 不能缓存消息,路由失败,消息丢失

  • Spike.exchage的会将消息路由到每个绑定的队列

6. Direct交换机

注意: 创建交换机的时候请指定交换机类型

在Fanout模式中,一条消息,会被所有订阅的队列都消费。但是,在某些场景下,我们希望不同的消息被不同的队列消费。这时就要用到Direct类型的Exchange。

在Direct模型下:

  • 队列与交换机的绑定,不能是任意绑定了,而是要指定一个RoutingKey(路由key)

  • 消息的发送方在 向 Exchange发送消息时,也必须指定消息的 RoutingKey

  • Exchange不再把消息交给每一个绑定的队列,而是根据消息的Routing Key进行判断,只有队列的Routingkey与消息的 Routing key完全一致,才会接收到消息

案例需求如图

  1. 声明一个名为hmall.direct的交换机

  2. 声明队列direct.queue1,绑定Spike.exchagebindingKeybludred

  3. 声明队列direct.queue2,绑定Spike.exchagebindingKeyyellowred

  4. consumer服务中,编写两个消费者方法,分别监听direct.queue1和direct.queue2

  5. 在publisher中编写测试方法,向Spike.exchage发送消息

声明队列和交换机

首先在控制台声明两个队列direct.queue1direct.queue2,这里不再展示过程:

enter image description here
然后使用redblue作为key,绑定direct.queue1Spike.exchage

enter image description here
enter image description here

消息接收

在consumer服务的SpringRabbitListener中添加方法:

@RabbitListener(queues = "direct.queue1")
public void listenDirectQueue1(String msg) {
    System.out.println("消费者1接收到direct.queue1的消息:【" + msg + "】");
}

@RabbitListener(queues = "direct.queue2")
public void listenDirectQueue2(String msg) {
    System.out.println("消费者2接收到direct.queue2的消息:【" + msg + "】");
}

消息发送

在publisher服务的SpringAmqpTest类中添加测试方法:

@Test
public void testSendDirectExchange() {
    String exchangeName = "hmall.direct";
    String message = "Hello World";
    rabbitTemplate.convertAndSend(exchangeName, "red", message);
}

由于使用的red这个key,所以两个消费者都收到了消息:

消费者2接收到direct.queue2的消息:【Hello World】
消费者1接收到direct.queue1的消息:【Hello World】

我们再切换为blue这个key:

@Test  
public void testSendDirectExchange2() {  
    String exchangeName = "Spike.exchage";  
    String message = "Hello Friend";  
    rabbitTemplate.convertAndSend(exchangeName, "blue", message);  
}

你会发现,只有消费者1收到了消息:

消费者1接收到direct.queue1的消息:【Hello Friend】

Direct交换机与Fanout交换机的差异?

  • Fanout交换机将消息路由给每一个与之绑定的队列

  • Direct交换机根据RoutingKey判断路由给哪个队列

  • 如果多个队列具有相同的RoutingKey,则与Fanout功能类似

7. Topic交换机

注意: 创建交换机的时候请指定交换机类型

1. 说明

Topic类型的ExchangeDirect相比,都是可以根据RoutingKey把消息路由到不同的队列。

只不过Topic类型Exchange可以让队列在绑定BindingKey 的时候使用通配符!

BindingKey 一般都是有一个或多个单词组成,多个单词之间以.分割,例如: item.insert

通配符规则:

  • #:匹配一个或多个词

  • *:匹配不多不少恰好1个词

举例:

  • item.#:能够匹配item.spu.insert 或者 item.spu

  • item.*:只能匹配item.spu

图示:


假如此时publisher发送的消息使用的RoutingKey共有四种:

  • china.news 代表有中国的新闻消息;

  • china.weather 代表中国的天气消息;

  • japan.news 则代表日本新闻

  • japan.weather 代表日本的天气消息;

解释:

  • topic.queue1:绑定的是china.# ,凡是以 china.开头的routing key 都会被匹配到,包括:

    • china.news

    • china.weather

  • topic.queue2:绑定的是#.news ,凡是以 .news结尾的 routing key 都会被匹配。包括:

    • china.news

    • japan.news

接下来,我们就按照上图所示,来演示一下Topic交换机的用法。

首先,在控制台按照图示例子创建队列、交换机,并利用通配符绑定队列和交换机。此处步骤略。最终结果如下:

enter image description here

2. 消息发送

在publisher服务的SpringAmqpTest类中添加测试方法:

/**
 * topicExchange
 */
@Test
public void testSendTopicExchange() {
    String exchangeName = "Spike.exchage";  
		String message = "Hello World";
    rabbitTemplate.convertAndSend(exchangeName, "china.news", message);
}

3. 消息接收

在consumer服务的SpringRabbitListener中添加方法:

@RabbitListener(queues = "topic.queue1")
public void listenTopicQueue1(String msg){
    System.out.println("消费者1接收到topic.queue1的消息:【" + msg + "】");
}

@RabbitListener(queues = "topic.queue2")
public void listenTopicQueue2(String msg){
    System.out.println("消费者2接收到topic.queue2的消息:【" + msg + "】");
}

Direct交换机与Topic交换机的差异

  • Topic交换机接收的消息RoutingKey必须是多个单词,以 . 分割
  • Topic交换机与队列绑定时的bindingKey可以指定通配符
  • #:代表0个或多个词
  • *:代表1个词

8. 声明队列和交换机

基本API

SpringAMQP提供了一个Queue类,用来创建队列:

SpringAMQP还提供了一个Exchange接口,来表示所有不同类型的交换机:

我们可以自己创建队列和交换机,不过SpringAMQP还提供了ExchangeBuilder来简化这个过程:

而在绑定队列和交换机时,则需要使用BindingBuilder来创建Binding对象:

Fanout示例

在consumer中创建一个类,声明队列和交换机:

package org.example.consumer.config;

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;

@Configuration
public class FanoutConfig {
    /**
     * 声明交换机
     * @return Fanout类型交换机
     */
    @Bean
    public FanoutExchange fanoutExchange(){
        return new FanoutExchange("create.fanout.exchange");
    }

    /**
     * 第1个队列
     */
    @Bean
    public Queue fanoutQueue1(){
        return new Queue("fanout.queue1");
    }

    /**
     * 绑定队列和交换机
     */
    @Bean
    public Binding bindingQueue1(Queue fanoutQueue1, FanoutExchange fanoutExchange){
        return BindingBuilder.bind(fanoutQueue1).to(fanoutExchange);
    }

    /**
     * 第2个队列
     */
    @Bean
    public Queue fanoutQueue2(){
        return new Queue("fanout.queue2");
    }

    /**
     * 绑定队列和交换机
     */
    @Bean
    public Binding bindingQueue2(Queue fanoutQueue2, FanoutExchange fanoutExchange){
        return BindingBuilder.bind(fanoutQueue2).to(fanoutExchange);
    }
}

enter image description here

direct示例

direct模式由于要绑定多个KEY,会非常麻烦,每一个Key都要编写一个binding:

import org.springframework.amqp.core.*;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class DirectConfig {

    /**
     * 声明交换机
     * @return Direct类型交换机
     */
    @Bean
    public DirectExchange directExchange(){
        return ExchangeBuilder.directExchange("create.direct.exchange").build();
    }

    /**
     * 第1个队列
     */
    @Bean
    public Queue directQueue1(){
        return new Queue("direct.queue1");
    }

    /**
     * 绑定队列和交换机
     */
    @Bean
    public Binding bindingQueue1WithRed(Queue directQueue1, DirectExchange directExchange){
        return BindingBuilder.bind(directQueue1).to(directExchange).with("red");
    }
    /**
     * 绑定队列和交换机
     */
    @Bean
    public Binding bindingQueue1WithBlue(Queue directQueue1, DirectExchange directExchange){
        return BindingBuilder.bind(directQueue1).to(directExchange).with("blue");
    }

    /**
     * 第2个队列
     */
    @Bean
    public Queue directQueue2(){
        return new Queue("direct.queue2");
    }

    /**
     * 绑定队列和交换机
     */
    @Bean
    public Binding bindingQueue2WithRed(Queue directQueue2, DirectExchange directExchange){
        return BindingBuilder.bind(directQueue2).to(directExchange).with("red");
    }
    /**
     * 绑定队列和交换机
     */
    @Bean
    public Binding bindingQueue2WithYellow(Queue directQueue2, DirectExchange directExchange){
        return BindingBuilder.bind(directQueue2).to(directExchange).with("yellow");
    }
}

enter image description here

基于注解声明

基于@Bean的方式声明队列和交换机比较麻烦,Spring还提供了基于注解方式来声明。

例如,我们同样声明Direct模式的交换机和队列:

import org.springframework.amqp.core.ExchangeTypes;
import org.springframework.amqp.rabbit.annotation.Exchange;
import org.springframework.amqp.rabbit.annotation.Queue;
import org.springframework.amqp.rabbit.annotation.QueueBinding;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;

@Component
public class DirectAgainConfig {
    @RabbitListener(bindings = @QueueBinding(
            value = @Queue(name = "direct.queue1"),
            exchange = @Exchange(name = "create.boot.direct.exchange", type = ExchangeTypes.DIRECT),
            key = {"red", "blue"}
    ))
    public void listenDirectQueue1(String msg){
        System.out.println("消费者1接收到direct.queue1的消息:【" + msg + "】");
    }

    @RabbitListener(bindings = @QueueBinding(
            value = @Queue(name = "direct.queue2"),
            exchange = @Exchange(name = "create.boot.direct.exchange", type = ExchangeTypes.DIRECT),
            key = {"red", "yellow"}
    ))
    public void listenDirectQueue2(String msg){
        System.out.println("消费者2接收到direct.queue2的消息:【" + msg + "】");
    }
}

enter image description here

是不是简单多了。再试试Topic模式:

import org.springframework.amqp.core.ExchangeTypes;
import org.springframework.amqp.rabbit.annotation.Exchange;
import org.springframework.amqp.rabbit.annotation.Queue;
import org.springframework.amqp.rabbit.annotation.QueueBinding;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;

@Component
public class TopicConfig {
    @RabbitListener(bindings = @QueueBinding(
            value = @Queue(name = "topic.queue1"),
            exchange = @Exchange(name = "create.topic.exchange", type = ExchangeTypes.TOPIC),
            key = "china.#"
    ))
    public void listenTopicQueue1(String msg){
        System.out.println("消费者1接收到topic.queue1的消息:【" + msg + "】");
    }

    @RabbitListener(bindings = @QueueBinding(
            value = @Queue(name = "topic.queue2"),
            exchange = @Exchange(name = "create.topic.exchange", type = ExchangeTypes.TOPIC),
            key = "#.news"
    ))
    public void listenTopicQueue2(String msg){
        System.out.println("消费者2接收到topic.queue2的消息:【" + msg + "】");
    }
}

enter image description here

9. 消息转换器

Spring的消息发送代码接收的消息体是一个Object:

而在数据传输时,它会把你发送的消息序列化为字节发送给MQ,接收消息的时候,还会把字节反序列化为Java对象。

只不过,默认情况下Spring采用的序列化方式是JDK序列化。众所周知,JDK序列化存在下列问题:

  • 数据体积过大

  • 有安全漏洞

  • 可读性差

测试默认转换器

1. 创建测试队列

首先,我们在consumer服务中声明一个新的配置类MessageConfig:

利用@Bean的方式创建一个队列,具体代码:

import org.springframework.amqp.core.Queue;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MessageConfig {

    @Bean
    public Queue objectQueue() {
        return new Queue("object.queue");
    }
}

注意,这里我们先不要给这个队列添加消费者,我们要查看消息体的格式。

重启consumer服务以后,该队列就会被自动创建出来了:

enter image description here

2. 发送消息

我们在publisher模块的SpringAmqpTest中新增一个消息发送的代码,发送一个Map对象:

 @Test
 public void testSendMap() throws InterruptedException {
     Map<String,Object> msg = new HashMap<>();
     msg.put("name", "David");
     msg.put("age", 21);
     rabbitTemplate.convertAndSend("object.queue", msg);
 }

enter image description here

消息格式非常不友好。

配置JSON转换器

显然,JDK序列化方式并不合适。我们希望消息体的体积更小、可读性更高,因此可以使用JSON方式来做序列化和反序列化。

publisherconsumer两个服务中都引入依赖:

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.9.10</version>
</dependency>

注意: 如果项目中引入了spring-boot-starter-web依赖,则无需再次引入Jackson依赖。

配置消息转换器,在publisherconsumer两个服务的启动类中添加一个Bean即可:

import org.springframework.amqp.support.converter.Jackson2JsonMessageConverter;  
import org.springframework.amqp.support.converter.MessageConverter;  
import org.springframework.context.annotation.Bean;  
import org.springframework.context.annotation.Configuration;  
  
@Configuration  
public class JsonConfig {  
    @Bean  
  public MessageConverter messageConverter(){  
        // 1.定义消息转换器  
  Jackson2JsonMessageConverter jackson2JsonMessageConverter = new Jackson2JsonMessageConverter();  
        // 2.配置自动创建消息id,用于识别不同消息,也可以在业务中基于ID判断是否是重复消息  
  jackson2JsonMessageConverter.setCreateMessageIds(true);  
        return jackson2JsonMessageConverter;  
    }  
}

此时,我们到MQ控制台删除object.queue中的旧的消息。然后再次执行刚才的消息发送的代码,到MQ的控制台查看消息结构:

enter image description here

消费者接收Object

我们在consumer服务中定义一个新的消费者,publisher是用Map发送,那么消费者也一定要用Map接收,格式如下:

@RabbitListener(queues = "object.queue")
public void listenSimpleQueueMessage(Map<String, Object> msg) throws InterruptedException {
    System.out.println("消费者接收到object.queue消息:【" + msg + "】");
}
消费者接收到object.queue消息:【{name=David, age=21}】