Skip to content

Commit c98fafc

Browse files
committed
Note to explain Tail and Head
1 parent d9a2246 commit c98fafc

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

axon-framework/events/event-processors/streaming.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,15 @@ Furthermore, Streaming Processors use separate threads to process the events ret
1212
Using separate threads decouples the `StreamingEventProcessor` from other operations (e.g., event publication or command handling), allowing for cleaner separation within any application.
1313
Using separate threads allows for [parallelization](#parallel-processing) of the event load, either within a single JVM or between several.
1414

15-
When starting a Streaming Processor, it will open an event stream through the configured `StreamableMessageSource`.
15+
When starting a Streaming Processor, it will open an event stream through the configured `StreamableMessageSource`. The first time a stream has started, it, by default, will begin at the tail (the oldest/the very first token) of the stream.
1616
It keeps track of the event processing progress while traversing the stream.
1717
It does so by storing the Tracking Tokens, or _tokens_ for short, accompanying the events.
1818
This solution works towards tracking the progress since the tokens specify the event's position on the stream.
1919

20+
> **Head or Tail?**
21+
>
22+
> Note that the oldest token is located at the tail of the stream and the latest (newest) token is positioned at the head of the streaming event processor.
23+
2024
Maintaining the progress through tokens makes a Streaming Processor
2125
1. able to deal with stopping and starting the processor,
2226
2. more resilient against unintended shutdowns, and

0 commit comments

Comments
 (0)