A Participant participates in a Coordination.
A Participant can participate in a Coordination by
Coordination#addParticipant(Participant) itself with the
Coordination. After successfully registering itself, the Participant is
notified when the Coordination is terminated.
If a Coordination terminates
Coordination#end(), then all
registered Participants are notified on their
#ended(Coordination)method. If the Coordination terminates as a
Coordination#fail(Throwable), then all registered
Participants are notified on their
#failed(Coordination) method.
Participants are required to be thread safe as notification can be made on
any thread.
A Participant can only be registered with a single active Coordination at a
time. If a Participant is already registered with an active Coordination,
attempts to register the Participation with another active Coordination will
block until the Coordination the Participant is registered with terminates.
Notice that in edge cases the notification to the Participant that the
Coordination has terminated can happen before the registration method
returns.