public interface Journal
StateRepository or in some other kind of storage.
Messages can come from different channels. The Journal will keep track not only of the messages for a single entity, but also from the originating channel for every message.
The messages of a Journal will be stored in a MessageStore. The store must have a
journal-key index, so the Journal is able to return the Stream
of messages (more precisely MessageStoreEntry) for every entity stored in the {code StateRepository}
when calling getJournalFor(String).
In order to identify the messages for an entity, journalKeyOf(String) must return the key of
the associated messages for a given entityId, which is the key of the stored entities: the key that
would be used, for example, to get the entity from the StateRepository.
A number of default implementations of the Journal interface can be created using the Journal
helper Journals.
Implementation hints:
If you intend to write your own Journal, you need to make sure, that messages will be added
to the journal's MessageStore, for example by registering
JournalingInterceptor for every message-log receiver that has to be journaled. The journal's
MessageStore must have a Index.JOURNAL_KEY.
In most cases, the journal-key index will be calculated by just using the message's Key.partitionKey()
as journal key. This is the case, if the partitionKey is used as primary key of your journaled entities.
| Modifier and Type | Method and Description |
|---|---|
com.google.common.collect.ImmutableList<java.lang.String> |
getJournaledChannels()
The List of channels that take influence on this Journal.
|
default java.util.stream.Stream<MessageStoreEntry> |
getJournalFor(java.lang.String entityId)
Returns the
MessageStoreEntries containing all messages that where modifying the state of the
entity identified by entityId. |
MessageStore |
getMessageStore()
Returns the
MessageStore used to store the messages of the journaled entities. |
java.lang.String |
getName()
The name of the journal.
|
default java.lang.String |
journalKeyOf(java.lang.String entityId)
Calculates the journal key for a given entityId.
|
java.lang.String getName()
In most cases, this will be equal to the name of the journaled StateRepository
com.google.common.collect.ImmutableList<java.lang.String> getJournaledChannels()
For every channel, a JournalingInterceptor is auto-configured, if the Journal is registered
as a Spring Bean. The interceptors will take care of adding incoming
messages to the journal's MessageStore.
MessageStore getMessageStore()
MessageStore used to store the messages of the journaled entities.
The store must be indexed for Index.JOURNAL_KEY. For every given entity, the journal-key
must match the key returned by journalKeyOf(String)
default java.lang.String journalKeyOf(java.lang.String entityId)
The returned key will be used to fetch the messages for the entity.
The default implementation will simply return the entityId, assuming that the message's
Key.partitionKey() will be used as a primary key for stored entites.
entityId - the key used to get the entity from a StateRepository or other entity store.default java.util.stream.Stream<MessageStoreEntry> getJournalFor(java.lang.String entityId)
MessageStoreEntries containing all messages that where modifying the state of the
entity identified by entityId.
The default implementation assumes, that all stored messages can be found by calling
getMessageStore().stream(Index.JOURNAL_KEY, journalKeyOf(entityId));.
entityId - the key of the entity. In most cases, this will be the partitionKey of the message.