Package org.springframework.kafka.retrytopic

Class ListenerContainerFactoryConfigurer

java.lang.Object

org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer

public class ListenerContainerFactoryConfigurer
extends java.lang.Object

Decorates the provided ConcurrentKafkaListenerContainerFactory to add a DefaultErrorHandler and the DeadLetterPublishingRecoverer created by the DeadLetterPublishingRecovererFactory. Since 2.8.3 these configurations don't interfere with the provided factory instance itself, so the same factory instance can be shared among retryable and non-retryable endpoints.

Since:

2.7

Constructor Summary

Constructors

Constructor	Description
ListenerContainerFactoryConfigurer(KafkaConsumerBackoffManager kafkaConsumerBackoffManager, DeadLetterPublishingRecovererFactory deadLetterPublishingRecovererFactory, java.time.Clock clock)

Method Summary

Modifier and Type	Method	Description
protected DefaultErrorHandler	createDefaultErrorHandlerInstance(DeadLetterPublishingRecoverer deadLetterPublishingRecoverer)
protected CommonErrorHandler	createErrorHandler(DeadLetterPublishingRecoverer deadLetterPublishingRecoverer, org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration)
KafkaListenerContainerFactory<?>	decorateFactory(ConcurrentKafkaListenerContainerFactory<?,?> factory, org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration)	Decorates the provided ConcurrentKafkaListenerContainerFactory.
KafkaListenerContainerFactory<?>	decorateFactoryWithoutSettingContainerProperties(ConcurrentKafkaListenerContainerFactory<?,?> factory, org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration)	Decorates the provided ConcurrentKafkaListenerContainerFactory.
void	setBlockingRetriesBackOff(org.springframework.util.backoff.BackOff blockingBackOff)	Set a BackOff to be used with blocking retries.
void	setBlockingRetryableExceptions(java.lang.Class<? extends java.lang.Exception>... exceptionTypes)	Specify the exceptions to be retried via blocking.
void	setContainerCustomizer(java.util.function.Consumer<ConcurrentMessageListenerContainer<?,?>> containerCustomizer)
void	setErrorHandlerCustomizer(java.util.function.Consumer<DefaultErrorHandler> errorHandlerCustomizer)
protected void	setupBackoffAwareMessageListenerAdapter(ConcurrentMessageListenerContainer<?,?> container, org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration, boolean isSetContainerProperties)

Methods inherited from class java.lang.Object

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

Constructor Detail

ListenerContainerFactoryConfigurer

public ListenerContainerFactoryConfigurer(KafkaConsumerBackoffManager kafkaConsumerBackoffManager,
                                          DeadLetterPublishingRecovererFactory deadLetterPublishingRecovererFactory,
                                          java.time.Clock clock)

Method Detail

decorateFactory

public KafkaListenerContainerFactory<?> decorateFactory(ConcurrentKafkaListenerContainerFactory<?,?> factory,
                                                        org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration)

Decorates the provided ConcurrentKafkaListenerContainerFactory.

Parameters:

factory - the factory instance to be decorated.

configuration - the configuration provided by the RetryTopicConfiguration.

Returns:

the decorated factory instance.

decorateFactoryWithoutSettingContainerProperties

public KafkaListenerContainerFactory<?> decorateFactoryWithoutSettingContainerProperties(ConcurrentKafkaListenerContainerFactory<?,?> factory,
                                                                                         org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration)

Decorates the provided ConcurrentKafkaListenerContainerFactory. Meant to be used for the main endpoint, this method ignores the provided backOff values.

Parameters:

factory - the factory instance to be decorated.

configuration - the configuration provided by the RetryTopicConfiguration.

Returns:

the decorated factory instance.

setBlockingRetriesBackOff

public void setBlockingRetriesBackOff(org.springframework.util.backoff.BackOff blockingBackOff)

Set a BackOff to be used with blocking retries. If the BackOff execution returns STOP, the record will be forwarded to the next retry topic or to the DLT, depending on how the non-blocking retries are configured.

Parameters:

blockingBackOff - the BackOff policy to be used by blocking retries.

Since:

2.8.4

See Also:

DefaultErrorHandler

setBlockingRetryableExceptions

@SafeVarargs
public final void setBlockingRetryableExceptions(java.lang.Class<? extends java.lang.Exception>... exceptionTypes)

Specify the exceptions to be retried via blocking.

Parameters:

exceptionTypes - the exceptions that should be retried.

Since:

2.8.4

See Also:

DefaultErrorHandler

setContainerCustomizer

public void setContainerCustomizer(java.util.function.Consumer<ConcurrentMessageListenerContainer<?,?>> containerCustomizer)

setErrorHandlerCustomizer

public void setErrorHandlerCustomizer(java.util.function.Consumer<DefaultErrorHandler> errorHandlerCustomizer)

createErrorHandler

protected CommonErrorHandler createErrorHandler(DeadLetterPublishingRecoverer deadLetterPublishingRecoverer,
                                                org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration)

createDefaultErrorHandlerInstance

protected DefaultErrorHandler createDefaultErrorHandlerInstance(DeadLetterPublishingRecoverer deadLetterPublishingRecoverer)

setupBackoffAwareMessageListenerAdapter

protected void setupBackoffAwareMessageListenerAdapter(ConcurrentMessageListenerContainer<?,?> container,
                                                       org.springframework.kafka.retrytopic.ListenerContainerFactoryConfigurer.Configuration configuration,
                                                       boolean isSetContainerProperties)