对于最新的稳定版本,请使用 Spring for Apache Kafka 3.3.9! |
@KafkaListener
生命周期管理
为@KafkaListener
注解不是应用程序上下文中的 bean。相反,它们注册了类型为KafkaListenerEndpointRegistry
. 该 bean 由框架自动声明并管理容器的生命周期;它将自动启动任何具有autoStartup
设置为true
. 所有容器工厂创建的所有容器必须位于同一容器中phase
. 有关详细信息,请参阅侦听器容器自动启动。您可以使用注册表以编程方式管理生命周期。启动或停止注册表将启动或停止所有已注册的容器。或者,您可以使用其id
属性。 您可以设置autoStartup
,这将覆盖配置到容器工厂中的默认设置。您可以从应用程序上下文(例如自动连接)获取对 bean 的引用,以管理其已注册的容器。以下示例显示了如何执行此作:
@KafkaListener(id = "myContainer", topics = "myTopic", autoStartup = "false")
public void listen(...) { ... }
@Autowired
private KafkaListenerEndpointRegistry registry;
...
this.registry.getListenerContainer("myContainer").start();
...
注册表仅维护其管理的容器的生命周期;声明为 bean 的容器不受注册表管理,可以从应用程序上下文中获取。可以通过调用注册表的getListenerContainers()
方法。 2.2.5 版本添加了一个方便的方法getAllListenerContainers()
,它返回所有容器的集合,包括那些由注册表管理的容器和那些声明为 bean 的容器。返回的集合将包括任何已初始化的原型 bean,但它不会初始化任何惰性 bean 声明。
刷新应用程序上下文后注册的终结点将立即启动,无论其autoStartup 属性,以符合SmartLifecycle contract,其中autoStartup 仅在应用程序上下文初始化期间考虑。延迟注册的一个示例是具有@KafkaListener 在原型范围内,在上下文初始化后创建实例。从版本 2.8.7 开始,您可以设置注册表的alwaysStartAfterRefresh 属性设置为false 然后是容器的autoStartup 属性将定义容器是否启动。 |