Spring Cloud Stream 3.x+kafka 3.8整合

news2024/10/10 5:53:59

Spring Cloud Stream 3.x+kafka 3.8整合，文末有完整项目链接

前言
一、如何看官方文档(有深入了解需求的人)
二、kafka的安装
- tar包安装
- docker安装
三、代码中集成
- 创建一个测试topic：test
- producer代码
- producer配置（配置的格式，上篇文章我有详细解释，大家可以回看）
- Consumer代码
- Consumer 配置
- Consumer 2的代码和配置
四、测试
五、结语

前言

上一篇文章，我们用Spring Cloud Stream整合了RocketMQ：SpringCloud Alibaba五大组件之——RocketMQ，趁着此机会，继续学习了解一下Spring Cloud Stream，本文就以kafka为例。本文项目用到的所有Maven依赖和版本，都是和前面几篇文章一样。

由于整合kafka 不需要用到Cloud Alibaba一系列的技术，所以下载到源码运行不起来的，请删除mysql，nacos，dubbo，redis等一系列相关的依赖和代码。本文写下的时候，kafka最新版本为3.8版本，所以就以3.8版本举例说明。

官方中文文档：https://kafka1x.apachecn.org/documentation.html
官网文档：https://kafka.apache.org/documentation/
中文文档的版本比较老，建议大家对照着英文文档3.8版本的，相互结合起来看。

一、如何看官方文档(有深入了解需求的人)

1.基础操作：建议大家看operation一栏，后面我会简单贴出基本安装使用流程
在这里插入图片描述
2.配置建议看中文版本

二、kafka的安装

tar包安装

下载链接：kafka_2.13-3.8.0.tgz
选择一个合适的位置解压
```
tar -zxvf kafka_2.12-3.8.0.tgz
```

启动自带的zookeeper(后台启动)

nohup bin/zookeeper-server-start.sh config/zookeeper.properties &

修改kafka server的配置文件，便于外网能够访问
找到bin\config目录下的server.properties文件
修改以下两行listeners照着我这样写，advertised.listeners修改为你服务器的ip，端口默认9092
```
listeners=PLAINTEXT://0.0.0.0:9092
advertised.listeners=PLAINTEXT://172.16.72.133:9092
```

启动kafka server(后台启动)

nohup bin/kafka-server-start.sh config/server.properties &

稍微扩展一下，集群的搭建，比如我们要扩展为三个集群代理：
首先，为每个代理创建一个配置文件 (在Windows上使用copy 命令来代替)：
```
cp config/server.properties config/server-1.properties
cp config/server.properties config/server-2.properties
```
编辑这些新文件并设置如下属性：
```
config/server-1.properties:
    broker.id=1
    listeners=PLAINTEXT://:9093
    log.dir=/tmp/kafka-logs-1
 
config/server-2.properties:
    broker.id=2
    listeners=PLAINTEXT://:9094
    log.dir=/tmp/kafka-logs-2
```
broker.id属性是集群中每个节点的名称，这一名称是唯一且永久的，必须重写端口和日志目录
然后启动就好了：低一个启动的为leader，如果杀死leader，会重新推荐一个leader出来
```
bin/kafka-server-start.sh config/server-1.properties &
bin/kafka-server-start.sh config/server-2.properties &
```
但是这样扩展的唯一不好的一点就是，会没有以前的数据，新的topic不影响，具体操作大家可以看文档。

docker安装

拉取镜像
```
docker pull apache/kafka:3.8.0
```

启动

docker run -p -d 9092:9092 apache/kafka:3.8.0

三、代码中集成

创建一个测试topic：test

bin/kafka-topics.sh --create --topic test --bootstrap-server localhost:9092

所有的topic的操作，都可以用kafka-topics.sh来操作，具体的可以看文档。老版本的启动是加–zookeeper的，会报错not found，新版本要用–bootstrap-server。

producer代码

@RestController
@RequestMapping("/mqtest")
public class KafkaTestController {
    private static final Logger logger = LoggerFactory.getLogger(KafkaTestController.class);
    @Autowired
    private StreamBridge streamBridge;

    @RequestMapping("/test1")
    public void testOne() {
        Message<SimpleMsg> msg = new GenericMessage<>(new SimpleMsg("我是 broadcastMessage", new Date().toString()));
        streamBridge.send("broadcastMessage-out-0", msg);
    }
}

自定义消息体SimpleMsg，此类不需要序列化

@AllArgsConstructor
@Data
@NoArgsConstructor
public class SimpleMsg{
    private String msg;
    private String time;
}

producer配置（配置的格式，上篇文章我有详细解释，大家可以回看）

key:serializer 重中之重，发送对象消息的时候，解决转换错误，SpringCloudStream默认的是ByteArraySerializer，但是kafkamore默认的是String

spring:
  cloud:
    stream:
      kafka:
        binder:
          ##kafka的server地址
          brokers: 172.16.72.133:9092
          ##如果topic不存在则创建
          auto-create-topics: true
          auto-add-partitions: true #自动分区
          min-partition-count: 1 #最小分区
          ##这个序列化很关键，如果不加这个配置，则发送对象消息时候，会报转换错误
          configuration:
            key:
              serializer: org.apache.kafka.common.serialization.ByteArraySerializer
      bindings:
        broadcastMessage-out-0:
          destination: test
          content-type: application/json

Consumer代码

 @Bean
 public Consumer<Message<SimpleMsg>> broadcastMessage() {
     return msg -> {
         log.info(Thread.currentThread().getName() + " Consumer1 Receive New Messages: " + msg.getPayload().getMsg() + msg.getPayload().getTime());
     };
 }

Consumer 配置

项目中有更详细的配置，这里为了测试用的简化版

spring:
  cloud:
    stream:
      function:
        definition: broadcastMessage
      kafka:
        binder:
          brokers: 172.16.72.133:9092
          auto-create-topics: true
          configuration:
            key:
              serializer: org.apache.kafka.common.serialization.ByteArraySerializer
      bindings:
        broadcastMessage-in-0:
          destination: test
          group: test-topic-account
          content-type: application/json