Skip to content

Commit c4b1233

Browse files
committed
GH-292 - Clarify event republication behavior on restart.
1 parent 5e80df3 commit c4b1233

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

src/docs/asciidoc/40-events.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,9 @@ image::event-publication-registry-start.png[]
117117

118118
Each transactional event listener is wrapped into an aspect that marks that log entry as completed if the execution of the listener succeeds.
119119
In case the listener fails, the log entry stays untouched so that retry mechanisms can be deployed depending on the application's needs.
120-
By default, all incomplete event publications are resubmitted at application startup.
120+
Automatic republication on application restart can be enabled by setting the `spring.modulith.republish-outstanding-events-on-restart` property to `true`.
121+
Note, that this is only recommended for single-instance application deployments.
122+
For a more flexible arrangement, `EventPublicationRegistry` exposes a method `….findIncompletePublications()` that can be called from user code.
121123

122124
.The transactional event listener arrangement after execution
123125
image::event-publication-registry-end.png[]

0 commit comments

Comments
 (0)