实战指南：使用 Spring Cloud Stream 集成 Kafka 构建高效消息驱动微服务

实战指南：使用 Spring Cloud Stream 集成 Kafka 构建高效消息驱动微服务

视频地址：

• Stream为什么被引入-尚硅谷
• SCS-1-内容介绍-图灵诸葛

官方文档：

• Spring Cloud Stream

什么是 Spring Cloud Stream?

Spring Cloud Stream(SCS) 是一个用于构建消息驱动微服务的框架，它基于 Spring Boot，提供了一种简化的方式来处理消息和事件的传递。它旨在为不同消息代理（如 Kafka、RabbitMQ、Apache Kafka 等）提供统一的编程模型，使开发者能够更轻松地在微服务架构中使用消息通信。

以下是 Spring Cloud Stream 的一些关键概念和特性：

1. Binder（绑定器）：Binder 是 Spring Cloud Stream 的核心概念之一，它提供了与底层消息代理之间的连接和交互。通过 Binder，Spring Cloud Stream 能够与不同的消息代理集成，例如 Kafka、RabbitMQ 等。每个消息代理都有自己的 Binder 实现，使开发者可以在不同的消息代理之间切换而无需修改应用代码。
2. 消息通道（Message Channels：Spring Cloud Stream 通过消息通道来实现消息的发送和接收。应用程序可以通过绑定到消息通道来与消息代理进行交互。消息通道可以是输入通道（用于接收消息）或输出通道（用于发送消息）。
3. 消息转换（Message Conversion：Spring Cloud Stream 会自动进行消息的序列化和反序列化，将消息从 Java 对象转换为消息代理支持的格式，以及将从消息代理接收的消息转换回 Java 对象。
4. 发布-订阅模式：Spring Cloud Stream 支持发布-订阅模式，可以让多个消费者订阅同一个主题（topic）的消息，实现了一对多的消息通信。
5. 消息分组（Message Grouping）：消息分组可以将一组消费者组织在一起，共同处理相同分组 ID 的消息。这对于实现负载均衡和消息去重非常有用。
6. 函数式编程模型：Spring Cloud Stream 鼓励使用函数式编程模型，通过定义处理消息的函数来实现业务逻辑。这种方式使得编写简洁、可测试的消息处理逻辑变得更加容易。
7. 实时数据处理：Spring Cloud Stream 不仅用于消息传递，还可以用于实时数据处理。您可以在消息到达之后立即对其进行处理，从而支持实时分析、转换和处理。

总体而言，Spring Cloud Stream 简化了在微服务架构中使用消息传递的复杂性，提供了一种与消息代理集成的高级抽象，让开发者能够更专注于业务逻辑的实现。它的灵活性使得您能够轻松地在不同的消息代理之间切换，同时提供了强大的工具来处理消息和事件的传递，从而使您的微服务系统更具可扩展性和弹性。

消息中间件的切换只需要 更换依赖 即可。

讲讲 Kafka

Kafka 是一个开源的分布式流数据平台，最初由 LinkedIn 开发并捐赠给 Apache 软件基金会。它被设计用于处理高吞吐量、可持久化的实时数据流。Kafka 的主要目标是提供一种高效、可扩展、持久化的消息传递系统，能够处理大规模的实时数据流，同时保证数据的可靠性和可用性。

以下是 Kafka 的一些关键特性和概念：

1. 发布-订阅模式：Kafka 采用发布-订阅模式，生产者（Publisher）将消息发布到主题（Topic），而消费者（Consumer）可以订阅一个或多个主题来接收消息。这使得多个消费者能够独立地从同一个主题订阅消息，实现一对多的消息传递。
2. 分区和副本：Kafka 将每个主题分为多个分区，每个分区可以在不同的服务器上进行副本复制，从而提高可用性和容错性。分区和副本的组合允许 Kafka 处理大规模的消息流并保证数据的持久性。
3. 持久化：Kafka 将消息以持久化的方式存储在磁盘上，确保消息在生产者发送和消费者接收之间不会丢失。消息被保存在分区中，可以根据需要保留一段时间，甚至可以通过配置来保留特定时间段的历史消息。
4. 高吞吐量：Kafka 在处理消息时具有高吞吐量的能力，它能够同时处理成千上万的消息，适用于大规模的实时数据处理场景。
5. 水平扩展：Kafka 支持水平扩展，可以通过添加新的服务器节点来增加吞吐量和存储容量，从而适应不断增长的数据量。
6. 消息保序性：Kafka 保证在同一分区内的消息保持顺序，这对于一些需要按照顺序处理的场景非常重要。
7. 流处理：Kafka 不仅用于消息传递，还可以用于实时流数据处理。Kafka Streams 是一个用于处理和分析流数据的库，可以在 Kafka 上进行流式处理，支持流数据的转换、聚合和计算等操作。
8. 社区生态系统：Kafka 拥有丰富的社区生态系统，提供了许多与 Kafka 集成的工具和库，如消费者和生产者客户端、连接器（Connectors）用于将 Kafka 与其他数据源集成、Kafka 管理工具等。

总体而言，Kafka 是一个强大的分布式消息流平台，适用于许多实时数据处理和消息传递的应用场景。它的可靠性、高性能和可扩展性使得它成为构建大规模实时数据处理系统的重要组件之一。

Spring Cloud Stream 和 Kafka 之间的联系和区别

Spring Cloud Stream 是一个用于构建基于 Spring Boot 的消息驱动微服务的框架，它提供了统一的编程模型和抽象来处理消息流，而 Kafka 是 Spring Cloud Stream 支持的消息中间件之一。下面我们来讲一下它们之间的联系和区别：

联系：

1. 消息驱动架构：Spring Cloud Stream 和 Kafka 都支持消息驱动架构，通过将消息作为信息传递的核心来构建应用程序。它们都支持发布-订阅模式，允许不同的微服务之间通过消息进行通信。

2. 微服务和云原生：Spring Cloud Stream 是 Spring Cloud 生态系统中的一部分，专注于帮助开发人员构建云原生的微服务应用程序。Kafka 作为 Spring Cloud Stream 的一种消息中间件实现，与 Spring Cloud Stream 一起可以支持在微服务架构中使用消息传递来解耦微服务之间的通信。

3. 可插拔的消息中间件：Spring Cloud Stream 提供了一个抽象层，使得在不同的消息中间件之间进行切换变得容易。它支持多种消息中间件，包括 Kafka、RabbitMQ 等，使开发人员可以根据实际需求选择合适的消息中间件。

区别：

1. 定位和用途：Spring Cloud Stream 是一个用于构建消息驱动微服务的框架，它提供了统一的编程模型和抽象来简化消息传递。而 Kafka 是一个分布式流数据平台，专注于处理高吞吐量、可持久化的实时数据流。

2. 功能广度：Kafka 是一个功能丰富的消息中间件，除了消息传递外，还提供了分区、副本、持久化、高吞吐量等特性。而 Spring Cloud Stream 更加专注于在微服务架构中实现消息传递。

3. 编程模型：Spring Cloud Stream 提供了更加抽象的编程模型，通过 Binder 将应用程序与消息中间件解耦。开发人员只需关注业务逻辑，而不必过多关注底层的消息传递细节。Kafka 则需要更多的配置和代码来实现消息的生产和消费。

4. 生态系统：Spring Cloud Stream 作为 Spring Cloud 生态系统的一部分，可以与其他 Spring Cloud 组件无缝集成，如服务发现、负载均衡等。Kafka 作为独立的消息中间件，可以在不同的技术栈中使用。

总的来说，Spring Cloud Stream 和 Kafka 都是用于处理消息的技术，但它们的定位和功能略有不同。Spring Cloud Stream 提供了更加抽象和便捷的方式来构建消息驱动的微服务，而 Kafka 提供了更丰富的特性来处理实时数据流。在使用时，开发人员可以根据项目需求和技术栈的选择来决定是否使用 Spring Cloud Stream 以及选择哪种消息中间件。

实践

集成 Kafka

引入依赖

<?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>2.3.7.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
 
    <groupId>org.example</groupId>
    <artifactId>stream-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
 
    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
 
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>Hoxton.SR3</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.26</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-stream-binder-kafka</artifactId>
        </dependency>
    </dependencies>
 
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

配置文件

server:
  port: 7888
spring:
  #  application:
  #    name: producer
  cloud:
    stream:
      kafka:
        binder:
          brokers: ip:9092         #Kafka的消息中间件服务器
          zk-nodes: ip:2181        #Zookeeper的节点，如果集群，后面加,号分隔
          auto-create-topics: true        #如果设置为false,就不会自动创建Topic 有可能你Topic还没创建就直接调用了。
      bindings:
        output:      #这里用stream给我们提供的默认output，后面会讲到自定义output
          destination: topic #消息发往的目的地
          content-type: text/plain    #消息发送的格式，接收端不用指定格式，但是发送端要
        input:
          destination: topic

发送业务类

source - output

@EnableBinding(Source.class)
public class SendService {
 
     @Resource
     private Source source;
 
     public void sendMsg(String msg) {
         source.output().send(MessageBuilder.withPayload(msg).build());
     }
 
     public void sendBody(Object object) {
         source.output().send(MessageBuilder.withPayload(object).build());
     }
}

消费者

sink - input

@EnableBinding(Sink.class)
public class RecieveService {
 
    @StreamListener(Sink.INPUT)
    public void recieve(Object payload){
        System.out.println(payload);
    }
}

控制器 Controller

@RestController
@RequestMapping("/send")
public class StreamController {
    @Resource
    private SendService sendService;
 
    /**
     * 发送
     * localhost:7888/send/hello
     *
     * @param msg 消息
     */
    @GetMapping("/{msg}")
    public void send(@PathVariable("msg") String msg){
        sendService.sendMsg(msg);
    }
 
    @GetMapping("/body")
    public void sendFace() {
        // 创建一个对象
        Q_FACE_INPUT qFaceInput = new Q_FACE_INPUT();
			 // set 写入数据...
      
        sendService.sendBody(qFaceInput);
        System.out.printf("发送 Face Data 成功");
    }
 
}

自定义通道生产消息

1、创建 MyChannel 接口

/**
 * 自定义通道 - 模仿source接口造轮子
 *
 */
public interface MyChannel {
 
    String FACE_OUTPUT = "face_output";
 
    String HUMAN_OUTPUT = "human_output";
 
    String VEHICLE_INPUT = "vehicle_output";
 
    @Output(FACE_OUTPUT)
    MessageChannel faceOutput();
 
    @Output(HUMAN_OUTPUT)
    MessageChannel humanOutput();
 
    @Output(VEHICLE_INPUT)
    MessageChannel vehicleOutput();
 
}

注意事项:

• 一般接口上不写 @Component 注解。
• 接口主要用于定义行为契约，而具体的实现通常由类来提供。
• @Component 注解用于将类标识为 Spring 容器管理的组件，而不是接口。实际上，将 @Component 注解放在接口上可能会引发问题。

踩坑小记：

有时候在指定类中使用 @Resource 注入的时候会报错 – 创建不了这个接口 bean，但是使用 Spring 自带的 @Autowired 注解就会没问题。（可能是因为是两个注解默认注入 bean 的方式不一样引起的）

• Autowired 默认的注入方式为 byType（根据类型进行匹配），
• @Resource 默认注入方式为 byName（根据名称进行匹配）

详细可参考：autowired-和-resource-的区别是什么

2、修改 application.yml 文件

server:
	port: 7888
spring:
  profiles:
    active: dev # 表示开发环境
  cloud:
    stream:
      kafka:
        binder:
          brokers: ip:9092         #Kafka的消息中间件服务器
          auto-create-topics: true        #如果设置为false,就不会自动创建Topic 有可能你Topic还没创建就直接调用了。
      bindings:
        # 自定义output - 生产
        face_output:
          destination: Q_FACE_INPUT_TWO_DX #消息发往的目的地
        human_output:
          destination: Q_HUMAN_INPUT_TWO_DX
        vehicle_output:
          destination: Q_VEHICLE_INPUT_TWO_DX

3、编写生产者业务类

@EnableBinding(value = {MyChannel.class})
public class SendService {
 
     @Resource
     private MyChannel myChannel;
 
     public void sendFaceMsg(String msg) {
         myChannel.faceOutput().send(MessageBuilder.withPayload(msg).build());
     }
 
    public void sendHumanMsg(String msg) {
        myChannel.humanOutput().send(MessageBuilder.withPayload(msg).build());
    }
 
    public void sendVehicleMsg(String msg) {
        myChannel.vehicleOutput().send(MessageBuilder.withPayload(msg).build());
    }
 
}

4、编写 Controller 控制器

@RestController
@RequestMapping("/send")
public class StreamController {
    @Resource
    private SendService sendService;
 
    /**
     * 发送人脸数据
     * localhost:7888/send/face/hello
     *
     * @param msg 消息
     */
    @GetMapping("/face/{msg}")
    public void sendFace(@PathVariable("msg") String msg){
        sendService.sendFaceMsg(msg);
    }
 
    /**
     * 发送人体数据
     *
     * @param msg 
     */
    @GetMapping("/human/{msg}")
    public void sendHuman(@PathVariable("msg") String msg){
        sendService.sendHumanMsg(msg);
    }
 
    /**
     * 发送车辆数据标准
     *
     * @param msg 
     */
    @GetMapping("/veh/{msg}")
    public void sendVehicle(@PathVariable("msg") String msg){
        sendService.sendVehicleMsg(msg);
    }
 
}

自定义订阅频道

1、创建一个订阅通道注解

@Component
public interface MySubscribableChannel {
 
    String INPUT1 = "input1";
 
    String INPUT2 = "input2";
 
    String INPUT3 = "input3";
 
    @Input(INPUT1)
    SubscribableChannel input1();
 
    @Input(INPUT2)
    SubscribableChannel input2();
 
}

2、application.yml 文件配置对应的主题信息

spring:
  profiles:
    active: dev # 表示开发环境
  cloud:
    stream:
      kafka:
        binder:
          brokers: ip:9092         #Kafka的消息中间件服务器
          auto-create-topics: true        #如果设置为false,就不会自动创建Topic 有可能你Topic还没创建就直接调用了。
      bindings:
        # 自定义output - 生产
        output1:
          destination: topic1 #消息发往的目的地
        output2:
          destination: topic2
			 # input订阅消息
				input1:
					destination: topic1
				input2:
					destination: topic2

3、监听消息

    @StreamListener(INPUT1)
    public void subChannel (String msg){
      System.out.println(msg);
    }
 
		@StreamListener(INPUT2)
    public void subChannel2 (String msg){
      System.out.println(msg);
    }

其他写法参考

注意配置文件中 input-in-0 的写法

• https://blog.csdn.net/qq_42221396/article/details/128409521
• Spring Cloud Stream 3.1以后的使用方法_org.springframework.cloud.stream.annotation.enable

学习参考

• Spring Cloud 系列之 Spring Cloud Stream - 风的姿态 - 博客园 (cnblogs.com)

• Spring Cloud （十五）Stream 入门、主要概念与自定义消息发送与接收 - 东北小狐狸 - 博客园 (cnblogs.com)

• Spring Cloud Stream中文指导手册_书上有云的博客-CSDN博客

• 官方文档中文版！Spring Cloud Stream 快速入门

• Springcloud Stream详解及整合kafka - 简书 (jianshu.com)