de.otto.synapse.eventsource

Interface EventSource

All Known Implementing Classes:

AbstractEventSource, DelegateEventSource, InMemoryEventSource

public interface EventSource

An event source of events.

Event sources can be consumed by consumers.

Method Summary

Modifier and Type	Method and Description
default ChannelPosition	consume() Consumes all events from the EventSource, until the (current) end of the stream is reached.
default ChannelPosition	consume(ChannelPosition startFrom) Consumes all events from the EventSource, beginning with startFrom, until the (current) end of the stream is reached.
ChannelPosition	consume(ChannelPosition startFrom, java.util.function.Predicate<Message<?>> stopCondition) Consumes all events from the EventSource, beginning with startFrom, until the stopCondition is met.
default ChannelPosition	consume(java.util.function.Predicate<Message<?>> stopCondition) Consumes all events from the EventSource until the stopCondition is met.
java.lang.String	getChannelName() Returns the name of the EventSource.
MessageDispatcher	getMessageDispatcher() Returns the MessageDispatcher used by the EventSource to translate and sent incoming messages to the registered message consumers.
java.lang.String	getName() An event source's name is used to connect event sources to their consumers.
boolean	isStopping()
void	register(MessageConsumer<?> messageConsumer) Registers a new EventConsumer at the EventSource.
void	stop()

Method Detail

getName

java.lang.String getName()

An event source's name is used to connect event sources to their consumers.

Returns:

the unique name

register

void register(MessageConsumer<?> messageConsumer)

Registers a new EventConsumer at the EventSource. consumers have to be thread safe as it may be called from multiple threads (e.g. for kinesis streams there is one thread per shard)

Parameters:

messageConsumer - registered EventConsumer

getMessageDispatcher

@Nonnull
MessageDispatcher getMessageDispatcher()

Returns the MessageDispatcher used by the EventSource to translate and sent incoming messages to the registered message consumers.

Returns:

MessageDispatcher

getChannelName

java.lang.String getChannelName()

Returns the name of the EventSource.

For streaming event-sources, this is the name of the event stream.

Returns:

name

consume

default ChannelPosition consume()

Consumes all events from the EventSource, until the (current) end of the stream is reached.

The registered consumers will be called zero or more times, depending on the number of events retrieved from the EventSource.

Returns:

the new read position

consume

default ChannelPosition consume(ChannelPosition startFrom)

Consumes all events from the EventSource, beginning with startFrom, until the (current) end of the stream is reached.

The registered consumers will be called zero or more times, depending on the number of events retrieved from the EventSource.

Parameters:

startFrom - the read position returned from earlier executions

Returns:

the new read position

consume

default ChannelPosition consume(java.util.function.Predicate<Message<?>> stopCondition)

Consumes all events from the EventSource until the stopCondition is met.

The registered consumers will be called zero or more times, depending on the number of events retrieved from the EventSource.

Parameters:

stopCondition - the predicate used as a stop condition

Returns:

the new read position

consume

ChannelPosition consume(ChannelPosition startFrom,
                        java.util.function.Predicate<Message<?>> stopCondition)

Consumes all events from the EventSource, beginning with startFrom, until the stopCondition is met.

The registered consumers will be called zero or more times, depending on the number of events retrieved from the EventSource.

Parameters:

startFrom - the read position returned from earlier executions

stopCondition - the predicate used as a stop condition

Returns:

the new read position

stop

void stop()

isStopping

boolean isStopping()