Package org.springframework.kafka.config

Class KafkaListenerEndpointRegistry

java.lang.Object

org.springframework.kafka.config.KafkaListenerEndpointRegistry

All Implemented Interfaces:

java.util.EventListener, org.springframework.beans.factory.Aware, org.springframework.beans.factory.DisposableBean, org.springframework.context.ApplicationContextAware, org.springframework.context.ApplicationListener<org.springframework.context.event.ContextRefreshedEvent>, org.springframework.context.Lifecycle, org.springframework.context.Phased, org.springframework.context.SmartLifecycle

public class KafkaListenerEndpointRegistry
extends java.lang.Object
implements org.springframework.beans.factory.DisposableBean, org.springframework.context.SmartLifecycle, org.springframework.context.ApplicationContextAware, org.springframework.context.ApplicationListener<org.springframework.context.event.ContextRefreshedEvent>

Creates the necessary MessageListenerContainer instances for the registered endpoints. Also manages the lifecycle of the listener containers, in particular within the lifecycle of the application context.

Contrary to MessageListenerContainers created manually, listener containers managed by registry are not beans in the application context and are not candidates for autowiring. Use getListenerContainers() if you need to access this registry's listener containers for management purposes. If you need to access to a specific message listener container, use getListenerContainer(String) with the id of the endpoint.

Author:

Stephane Nicoll, Juergen Hoeller, Artem Bilan, Gary Russell, Asi Bross

See Also:

KafkaListenerEndpoint, MessageListenerContainer, KafkaListenerContainerFactory

Field Summary

Fields

Modifier and Type	Field	Description
protected org.springframework.core.log.LogAccessor	logger

Fields inherited from interface org.springframework.context.SmartLifecycle

DEFAULT_PHASE

Constructor Summary

Constructors

Constructor	Description
KafkaListenerEndpointRegistry()

Method Summary

Modifier and Type	Method	Description
protected MessageListenerContainer	createListenerContainer(KafkaListenerEndpoint endpoint, KafkaListenerContainerFactory<?> factory)	Create and start a new MessageListenerContainer using the specified factory.
void	destroy()
java.util.Collection<MessageListenerContainer>	getAllListenerContainers()	Return all MessageListenerContainer instances including those managed by this registry and those declared as beans in the application context.
MessageListenerContainer	getListenerContainer(java.lang.String id)	Return the MessageListenerContainer with the specified id or null if no such container exists.
java.util.Set<java.lang.String>	getListenerContainerIds()	Return the ids of the managed MessageListenerContainer instance(s).
java.util.Collection<MessageListenerContainer>	getListenerContainers()	Return the managed MessageListenerContainer instance(s).
int	getPhase()
boolean	isAutoStartup()
boolean	isRunning()
void	onApplicationEvent(org.springframework.context.event.ContextRefreshedEvent event)
void	registerListenerContainer(KafkaListenerEndpoint endpoint, KafkaListenerContainerFactory<?> factory)	Create a message listener container for the given KafkaListenerEndpoint.
void	registerListenerContainer(KafkaListenerEndpoint endpoint, KafkaListenerContainerFactory<?> factory, boolean startImmediately)	Create a message listener container for the given KafkaListenerEndpoint.
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
void	start()
void	stop()
void	stop(java.lang.Runnable callback)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logger

protected final org.springframework.core.log.LogAccessor logger

Constructor Detail

KafkaListenerEndpointRegistry

public KafkaListenerEndpointRegistry()

Method Detail

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
                           throws org.springframework.beans.BeansException

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

Throws:

org.springframework.beans.BeansException

getListenerContainer

public MessageListenerContainer getListenerContainer(java.lang.String id)

Return the MessageListenerContainer with the specified id or null if no such container exists.

Parameters:

id - the id of the container

Returns:

the container or null if no container with that id exists

See Also:

KafkaListenerEndpoint.getId(), getListenerContainerIds()

getListenerContainerIds

public java.util.Set<java.lang.String> getListenerContainerIds()

Return the ids of the managed MessageListenerContainer instance(s).

Returns:

the ids.

See Also:

getListenerContainer(String)

getListenerContainers

public java.util.Collection<MessageListenerContainer> getListenerContainers()

Return the managed MessageListenerContainer instance(s).

Returns:

the managed MessageListenerContainer instance(s).

See Also:

getAllListenerContainers()

getAllListenerContainers

public java.util.Collection<MessageListenerContainer> getAllListenerContainers()

Return all MessageListenerContainer instances including those managed by this registry and those declared as beans in the application context. Prototype-scoped containers will be included. Lazy beans that have not yet been created will not be initialized by a call to this method.

Returns:

the MessageListenerContainer instance(s).

Since:

2.2.5

See Also:

getListenerContainers()

registerListenerContainer

public void registerListenerContainer(KafkaListenerEndpoint endpoint,
                                      KafkaListenerContainerFactory<?> factory)

Create a message listener container for the given KafkaListenerEndpoint.

This create the necessary infrastructure to honor that endpoint with regards to its configuration.

Parameters:

endpoint - the endpoint to add

factory - the listener factory to use

See Also:

registerListenerContainer(KafkaListenerEndpoint, KafkaListenerContainerFactory, boolean)

registerListenerContainer

public void registerListenerContainer(KafkaListenerEndpoint endpoint,
                                      KafkaListenerContainerFactory<?> factory,
                                      boolean startImmediately)

Create a message listener container for the given KafkaListenerEndpoint.

This create the necessary infrastructure to honor that endpoint with regards to its configuration.

The startImmediately flag determines if the container should be started immediately.

Parameters:

endpoint - the endpoint to add.

factory - the KafkaListenerContainerFactory to use.

startImmediately - start the container immediately if necessary

See Also:

getListenerContainers(), getListenerContainer(String)

createListenerContainer

protected MessageListenerContainer createListenerContainer(KafkaListenerEndpoint endpoint,
                                                           KafkaListenerContainerFactory<?> factory)

Create and start a new MessageListenerContainer using the specified factory.

Parameters:

endpoint - the endpoint to create a MessageListenerContainer.

factory - the KafkaListenerContainerFactory to use.

Returns:

the MessageListenerContainer.

destroy

public void destroy()

Specified by:

destroy in interface org.springframework.beans.factory.DisposableBean

getPhase

public int getPhase()

Specified by:

getPhase in interface org.springframework.context.Phased

Specified by:

getPhase in interface org.springframework.context.SmartLifecycle

isAutoStartup

public boolean isAutoStartup()

Specified by:

isAutoStartup in interface org.springframework.context.SmartLifecycle

start

public void start()

Specified by:

start in interface org.springframework.context.Lifecycle

stop

public void stop()

Specified by:

stop in interface org.springframework.context.Lifecycle

stop

public void stop(java.lang.Runnable callback)

Specified by:

stop in interface org.springframework.context.SmartLifecycle

isRunning

public boolean isRunning()

Specified by:

isRunning in interface org.springframework.context.Lifecycle

onApplicationEvent

public void onApplicationEvent(org.springframework.context.event.ContextRefreshedEvent event)

Specified by:

onApplicationEvent in interface org.springframework.context.ApplicationListener<org.springframework.context.event.ContextRefreshedEvent>