SpringCloud 2020.0.4 系列之 Stream 訊息廣播與訊息分組的實現

追風人聊Java發表於2021-11-12

SpringGCCloud

1. 概述

老話說的好：事情太多，做不過來，就先把事情記在本子上，然後理清思路、排好優先順序，一件一件的去完成。

言歸正傳，今天我們來聊一下 SpringCloud 的 Stream 元件，SpringCloud Stream 是一個構建訊息驅動微服務的框架，簡單理解就是在 SpringCloud 中操作訊息中介軟體的元件。

這裡我們以 RabbitMQ 為例，介紹一下如何使用 Stream 實現訊息廣播和訊息分組。

RabbitMQ 映象模式叢集的搭建，可參見我的另一篇文章《RabbitMQ 3.9.7 映象模式叢集的搭建》（https://www.cnblogs.com/w84422/p/15356202.html）

在早期的 SpringCloud 版本中常使用 @Input、@Output、@EnableBinding 和 @StreamListener 註解開發生產者與消費者。

官方原文：Deprecated as of 3.1 in favor of functional programming model。

SpringCloud 2020.0.4 版本中，已經不推薦這麼開發了，因此這裡我們也使用新的寫法（函數語言程式設計方式）開發。

閒話不多說，直接上程式碼。

2. 訊息廣播

2.1 主要依賴

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- 健康檢查 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-stream-rabbit</artifactId>
        </dependency>

2.2 訊息實體類

@Setter
@Getter
public class MyMessage implements java.io.Serializable {

    // 訊息體
    private String payload;
}

2.3 生產者

    @Autowired
    private StreamBridge streamBridge;

    // 傳送廣播訊息
    @PostMapping("/broadcast")
    public String sendBroadcastMessage(@RequestParam("body") String body) {

        MyMessage myMessage = new MyMessage();
        myMessage.setPayload(body);

        // 生產訊息
        // 第一個引數是繫結名稱，格式為：自定義的繫結名稱-out-0，myBroadcast是自定義的繫結名稱，out代表生產者，0是固定寫法
        // 自定義的繫結名稱必須與消費方法的方法名保持一致
        // 第二個引數是傳送的訊息實體
        streamBridge.send("myBroadcast-out-0", myMessage);
        return "SUCCESS";
    }

2.4 消費者

@Slf4j
@Component
// 消費者
public class Concumer {

    // 消費廣播訊息
    @Bean
    public Consumer<MyMessage> myBroadcast() {  // 方法名必須與生產訊息時自定義的繫結名稱一致

        return message -> {
            log.info("接收廣播訊息：{}", message.getPayload());
        };
    }

2.5 application.yml 配置

spring:
  application:
    name: my-stream-new
  rabbitmq:   # RabbitMQ 配置
    addresses: 192.168.1.22:5672,192.168.1.12:5672,192.168.1.11:5672
    username: guest
    password: guest
    virtual-host: /
    connection-timeout: 16000
  cloud:
    function:
      # 定義消費者，多個用分號分隔，當存在大於1個的消費者時，不定義不會生效
      definition: myBroadcast
    stream:
      bindings:
        
        # 廣播訊息
        myBroadcast-in-0:   # 消費者繫結名稱，myBroadcast是自定義的繫結名稱，in代表消費者，0是固定寫法
          destination: my-broadcast-topic   # 對應的真實的 RabbitMQ Exchange
        myBroadcast-out-0:  # 生產者繫結名稱，myBroadcast是自定義的繫結名稱，out代表生產者，0是固定寫法
          destination: my-broadcast-topic   # 對應的真實的 RabbitMQ Exchange

注意：spring.cloud.function.definition 屬性非常重要，務必配置

2.6 驗證廣播訊息

將 Stream 工程啟動兩個例項，呼叫傳送廣播訊息介面，檢視訊息消費情況。

傳送廣播訊息介面：

POST http://localhost:49000/stream/broadcast?body=這是一條廣播訊息！

自動生成的 Exchange

自動生成的 Queue

兩個例項的消費情況

3. 訊息分組

訊息分組後，同一分組的消費服務，只能有一個消費者消費到訊息。

3.1 生產者

    // 傳送分組訊息
    @PostMapping("/group")
    public String sendGroupMessage(@RequestParam("body") String body) {

        MyMessage myMessage = new MyMessage();
        myMessage.setPayload(body);

        // 生產訊息
        streamBridge.send("myGroup-out-0", myMessage);
        return "SUCCESS";
    }

3.2 消費者

    // 消費分組訊息
    @Bean
    public Consumer<MyMessage> myGroup() {  // 方法名必須與生產訊息時自定義的繫結名稱一致

        return message -> {
            log.info("接收分組訊息：{}", message.getPayload());
        };
    }

3.3 application.yml 配置

spring:
  application:
    name: my-stream-new
  rabbitmq:   # RabbitMQ 配置
    addresses: 192.168.1.22:5672,192.168.1.12:5672,192.168.1.11:5672
    username: guest
    password: guest
    virtual-host: /
    connection-timeout: 16000
  cloud:
    function:
      # 定義消費者，多個用分號分隔，當存在大於1個的消費者時，不定義不會生效
      definition: myBroadcast;myGroup
    stream:
      bindings:        
        # 廣播訊息
        myBroadcast-in-0:   # 消費者繫結名稱，myBroadcast是自定義的繫結名稱，in代表消費者，0是固定寫法
          destination: my-broadcast-topic   # 對應的真實的 RabbitMQ Exchange
        myBroadcast-out-0:  # 生產者繫結名稱，myBroadcast是自定義的繫結名稱，out代表生產者，0是固定寫法
          destination: my-broadcast-topic   # 對應的真實的 RabbitMQ Exchange

        # 分組訊息
        myGroup-in-0: # 消費者繫結名稱
          destination: my-group-topic   # 對應的真實的 RabbitMQ Exchange
          group: my-group-1   # 同一分組的消費服務，只能有一個消費者消費到訊息
        myGroup-out-0: # 生產者繫結名稱
          destination: my-group-topic   # 對應的真實的 RabbitMQ Exchange