Package de.otto.synapse.annotation

Annotation Type EnableEventSource

@Target(TYPE)
@Retention(RUNTIME)
@Documented
@Import(EventSourceBeanRegistrar.class)
@Repeatable(EnableEventSources.class)
@EnableEventSourcing
public @interface EnableEventSource

Enables auto-configuration of event sources.

A Spring bean with type EventSource is registered at the ApplicationContext. The name of the beans can be specified by name().

EventSources are created using a EventSourceBuilder that must be registered in the ApplicationContext. The default builder is configured in SynapseAutoConfiguration and will create instances of DefaultEventSource.

Because the EventSourceBuilder is annotated as ConditionalOnMissingBean, it can be replaced by other implementations by just registering a different bean.

The EventSource.getChannelName() is configured using channelName().

Required Element Summary

Required Elements

Modifier and Type	Required Element	Description
java.lang.String	channelName	The name of the message channel.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
java.lang.String	messageLogReceiverEndpoint	The name of the MessageLogReceiverEndpoint bean that is used to create the EventSource bean.
java.lang.String	name	The name of the registered EventSource bean.
java.lang.Class<? extends MessageLog>	selector	Selector used to select one of possibly multiple available MessageLogReceiverEndpointFactory instances used to create the MessageLogReceiverEndpoint of the EventSource.

Element Detail

channelName

java.lang.String channelName

The name of the message channel.

Resolving placeholders like "${my.channel.name}" is supported for this property.

Returns:

channel name

name

java.lang.String name

The name of the registered EventSource bean.

If #name is not set, the name of the bean is derived from the name of the message channel. The name is constructed by tranforming hyphenated variable naming convention, e.g., "my-channel" into the Spring bean naming convention, e.g., "myChannel". After this conversion, the string "EventSource" is appended. A channel named "my-channel" will therefore result in a bean name "myChannelEventSource".

Returns:

bean name

Default:

""

messageLogReceiverEndpoint

java.lang.String messageLogReceiverEndpoint

The name of the MessageLogReceiverEndpoint bean that is used to create the EventSource bean.

If messageLogReceiverEndpoint is not set, the name of the bean is derived from the name of the message channel. The name is constructed by tranforming hyphenated variable naming convention, e.g., "my-channel" into the Spring bean naming convention, e.g., "myChannel". After this conversion, the string "MessageLogReceiverEndpoint" is appended. A channel named "my-channel" will therefore result in a bean name "myChannelMessageLogReceiverEndpoint".

The EventSourceBeanRegistrar is responsible for creating the EventSources specified by this annotation. The bean name, either specified or derived from the channelName, will be used by the EventSourceBeanRegistrar as the name of the registered message log bean. If a bean having this name already exists, a BeanCreationException will be thrown during startup.

Returns:

bean name of the MessageLogReceiverEndpoint

Default:

""

selector

java.lang.Class<? extends MessageLog> selector

Selector used to select one of possibly multiple available MessageLogReceiverEndpointFactory instances used to create the MessageLogReceiverEndpoint of the EventSource.

Example: the KafkaMessageLogReceiverEndpointFactory matches both MessageLog.class and Kafka.class. The following usage of the annotation is selecting the KafkaMessageLogReceiverEndpointFactory using the more specific Kafka selector:

 @Configuration
 @EnableEventSource(
      channelName = "some-log",
      selector = Kafka.class)
 class MyExampleConfiguration {
 }
 

Returns:

MessageLog selector class

Default:

de.otto.synapse.channel.selector.MessageLog.class