Kafka的@KafkaListener注解参数详解

@KafkaListener 注解提供了许多可配置的参数,以便更灵活地定制 Kafka 消息监听器的行为。

  • topics:

描述: 指定监听的 Kafka 主题,可以是一个字符串数组。这是最基本的参数,它定义了监听器将从哪个或哪些主题接收消息。

例子: @KafkaListener(topics = "my-topic")

  • groupId:

描述: 指定 Kafka 消费者组的 ID。每个消费者都有自己所属的组。一个组中可以有多个消费者。

例子: @KafkaListener(groupId = "my-group", topics = "my-topic")

  • id:

描述: 每个Listener实例的重要标识。默认是一个自动生成的唯一 ID。如果不指定groupId,那么id将直接作为groupId。在同一应用中,如果有多个监听器,可以使用不同的id来标识不同的监听器容器。

例子: @KafkaListener(id = "myListener", topics = "my-topic")

  • concurrency:

描述: 指定并发消费者的数量,即监听器容器的线程数。控制监听器的并发性,每个线程会创建一个消费者实例。较大的并发性可以提高消息处理的吞吐量。

例子: @KafkaListener(topics = "my-topic", concurrency = "3")

  • containerFactory:

描述: 指定用于创建监听器容器的工厂类。可以用于配置监听器容器的属性。通过设置 containerFactory,可以更灵活地配置监听器容器的一些属性,例如消息转换器、错误处理器等。

例子: @KafkaListener(topics = "my-topic", containerFactory = "myContainerFactory")

  • autoStartup:

描述: 指定是否在启动时自动启动监听器容器。默认是 true。如果设置为false,则需要手动调用容器的start() 方法来启动监听器。

例子: @KafkaListener(topics ="my-topic", autoStartup = "false")

  • clientIdPrefix:

描述: 指定 Kafka 消费者的客户端 ID 前缀。可以通过设置clientIdPrefix来自定义消费者的客户端 ID。

例子: @KafkaListener(topics = "my-topic", clientIdPrefix = "my-client")

  • containerGroup:

描述: 指定监听器容器所属的组。如果有多个应用使用相同的消费者组,可以通过设置 containerGroup来区分它们。

例子:@KafkaListener(topics = "my-topic", containerGroup = "my-group")

  • errorHandler:

描述: 指定错误处理器,用于处理监听器方法抛出的异常。定义一个错误处理器,可以在发生异常时进行自定义处理。

例子:@KafkaListener(topics = "my-topic", errorHandler = "myErrorHandler")

  • properties:

描述:指定其他的消费者配置属性,以键值对的形式提供。这种方式允许你通过注解的方式灵活地设置特定的消费者属性,而不必在全局配置文件中进行设置。请确保设置的属性是合法的Kafka 消费者属性,并符合你的应用需求。

例子: @KafkaListener(topics = "my-topic",properties={"enable.auto.commit=false","auto.offset.reset=earliest"})

相关推荐
搞科研的小刘选手26 分钟前
【中山大学主办】第六届计算机科学与区块链国际学术会议(CCSB 2026)
分布式·神经网络·计算机视觉·区块链·计算机科学·共识算法·自然语言
小饼干在学嘎瓦2 小时前
本地缓存和分布式缓存如何选择?
分布式·缓存
XLYcmy3 小时前
全链路验证测试系统:一个针对智能代理(Agent)系统全链路能力的自动化验证脚本
分布式·python·http·网络安全·ai·llm·agent
phltxy12 小时前
HAProxy安装与RabbitMQ负载均衡配置
分布式·rabbitmq·负载均衡
jiayong2313 小时前
Kafka 高吞吐消息链路常见面试问题及详细解答
分布式·面试·kafka
卷毛迷你猪14 小时前
快速实验篇(A2-2)数据清洗规则修正与多语言实现验证
hadoop·分布式
业精于勤_荒于稀14 小时前
登录鉴权-ai
分布式
段一凡-华北理工大学14 小时前
工业领域的Hadoop架构学习~系列文章05:Kafka消息队列 - 工业数据流传输
人工智能·hadoop·学习·架构·kafka·工业智能体·高炉炼铁智能化
Kurisu57515 小时前
深度拆解:从 CAP 定理到 Raft 协议的分布式一致性演进
分布式
kuokay15 小时前
深入理解 LLM 分布式训练全栈:从硬件到 LLaMA-Factory
分布式·llama·deepspeed·fsdp·llama-factory·accelerate