raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 11

Add delivery semantics notes to stream refs (#24777)

Browse source
This commit is contained in:
Konrad `ktoso` Malawski 2018-03-24 10:45:43 +09:00 • committed by GitHub
parent f2d3a9dd27
commit d503cb0da3
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

12
akka-docs/src/main/paradox/stream/stream-refs.md
View file

@ -140,6 +140,18 @@ The process of preparing and running a `SinkRef` powered distributed stream is s
(i.e. by using "merge preferred" or any other variation of the fan-in stages).
@@@
### Delivery guarantees
Stream refs utilise normal actor messaging for their trainsport, and as such provide the same level of basic delivery guarantees. Stream refs do extend the semantics somewhat by demand re-delivery and sequence fault detection; in other words:
- messages are sent over actor remoting
- which relies on TCP (classic remoting, or artery tcp) or Aeron UDP for basic redelivery mechanisms
- messages are guaranteed to to be in-order
- messages can be lost, however:
- a *dropped demand signal* will be re-delivered automatically (similar to system messages)
- a *dropped element* signal* will cause the stream to *fail*
## Bulk Stream References
@@@ warning