You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pekko.apache.org by fa...@apache.org on 2023/01/19 14:25:37 UTC
[incubator-pekko-site] branch asf-staging updated: update security doc
This is an automated email from the ASF dual-hosted git repository.
fanningpj pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/incubator-pekko-site.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new 5eb1c6c update security doc
5eb1c6c is described below
commit 5eb1c6c1f07244d2fd9cb2dfc412bfd9d88ae27a
Author: PJ Fanning <pj...@users.noreply.github.com>
AuthorDate: Thu Jan 19 14:25:27 2023 +0000
update security doc
---
content/actors.html | 116 ++++++++++-----------
content/additional/books.html | 6 +-
content/additional/deploy.html | 6 +-
content/additional/deploying.html | 6 +-
content/additional/faq.html | 6 +-
content/additional/ide.html | 6 +-
content/additional/operations.html | 6 +-
content/additional/osgi.html | 16 +--
content/additional/packaging.html | 6 +-
content/additional/rolling-updates.html | 8 +-
content/cluster-client.html | 46 ++++----
content/cluster-dc.html | 6 +-
content/cluster-metrics.html | 14 +--
content/cluster-routing.html | 12 +--
content/cluster-sharding.html | 14 +--
content/cluster-singleton.html | 14 +--
content/cluster-usage.html | 32 +++---
content/common/binary-compatibility-rules.html | 6 +-
content/common/circuitbreaker.html | 22 ++--
content/common/io-layer.html | 10 +-
content/common/may-change.html | 6 +-
content/common/other-modules.html | 6 +-
content/coordinated-shutdown.html | 10 +-
content/coordination.html | 14 +--
content/discovery/index.html | 14 +--
content/dispatchers.html | 16 +--
content/distributed-data.html | 46 ++++----
content/distributed-pub-sub.html | 40 +++----
content/durable-state/persistence-query.html | 14 +--
content/event-bus.html | 20 ++--
content/extending-pekko.html | 18 ++--
content/fault-tolerance-sample.html | 6 +-
content/fault-tolerance.html | 12 +--
content/fsm.html | 12 +--
content/futures.html | 12 +--
content/general/actor-systems.html | 10 +-
content/general/actors.html | 6 +-
content/general/addressing.html | 16 +--
content/general/configuration-reference.html | 6 +-
content/general/configuration.html | 14 +--
content/general/index.html | 6 +-
content/general/jmm.html | 6 +-
content/general/message-delivery-reliability.html | 14 +--
content/general/remoting.html | 6 +-
content/general/stream/stream-configuration.html | 6 +-
content/general/stream/stream-design.html | 24 ++---
content/general/supervision.html | 10 +-
content/general/terminology.html | 6 +-
content/index-actors.html | 12 +--
content/index-classic.html | 6 +-
content/index-cluster.html | 6 +-
content/index-network.html | 6 +-
content/index-utilities-classic.html | 12 +--
content/index-utilities.html | 6 +-
content/index.html | 6 +-
content/io-dns.html | 6 +-
content/io-tcp.html | 12 +--
content/io-udp.html | 12 +--
content/io.html | 28 ++---
content/logging.html | 54 +++++-----
content/mailboxes.html | 26 ++---
content/multi-jvm-testing.html | 6 +-
content/multi-node-testing.html | 24 ++---
content/paradox.json | 2 +-
content/persistence-fsm.html | 26 ++---
content/persistence-journals.html | 12 +--
content/persistence-plugins.html | 6 +-
content/persistence-query-leveldb.html | 12 +--
content/persistence-query.html | 46 ++++----
content/persistence-schema-evolution.html | 26 ++---
content/persistence.html | 76 +++++++-------
content/project/downstream-upgrade-strategy.html | 6 +-
content/project/examples.html | 6 +-
content/project/immutable.html | 6 +-
content/project/index.html | 6 +-
content/project/issue-tracking.html | 6 +-
content/project/licenses.html | 6 +-
content/project/links.html | 6 +-
content/project/migration-guides.html | 6 +-
content/project/rolling-update.html | 6 +-
content/project/scala3.html | 6 +-
content/remoting-artery.html | 52 ++++-----
content/remoting.html | 14 +--
content/routing.html | 86 +++++++--------
content/scheduler.html | 26 ++---
content/security/index.html | 15 +--
content/serialization-classic.html | 12 +--
content/serialization-jackson.html | 20 ++--
content/serialization.html | 34 +++---
content/split-brain-resolver.html | 14 +--
content/stream/actor-interop.html | 16 +--
content/stream/futures-interop.html | 12 +--
content/stream/index.html | 14 +--
content/stream/operators/ActorFlow/ask.html | 16 +--
.../stream/operators/ActorFlow/askWithContext.html | 16 +--
.../stream/operators/ActorFlow/askWithStatus.html | 16 +--
.../ActorFlow/askWithStatusAndContext.html | 16 +--
content/stream/operators/ActorSink/actorRef.html | 14 +--
.../ActorSink/actorRefWithBackpressure.html | 14 +--
content/stream/operators/ActorSource/actorRef.html | 14 +--
.../ActorSource/actorRefWithBackpressure.html | 14 +--
content/stream/operators/Balance.html | 6 +-
content/stream/operators/Broadcast.html | 8 +-
content/stream/operators/Compression/deflate.html | 10 +-
content/stream/operators/Compression/gunzip.html | 8 +-
content/stream/operators/Compression/gzip.html | 10 +-
content/stream/operators/Compression/inflate.html | 8 +-
content/stream/operators/FileIO/fromFile.html | 8 +-
content/stream/operators/FileIO/fromPath.html | 8 +-
content/stream/operators/FileIO/toFile.html | 8 +-
content/stream/operators/FileIO/toPath.html | 8 +-
.../stream/operators/Flow/asFlowWithContext.html | 10 +-
.../stream/operators/Flow/completionStageFlow.html | 8 +-
content/stream/operators/Flow/flattenOptional.html | 8 +-
.../stream/operators/Flow/fromSinkAndSource.html | 10 +-
.../operators/Flow/fromSinkAndSourceCoupled.html | 8 +-
content/stream/operators/Flow/futureFlow.html | 8 +-
.../operators/Flow/lazyCompletionStageFlow.html | 6 +-
content/stream/operators/Flow/lazyFlow.html | 8 +-
content/stream/operators/Flow/lazyFutureFlow.html | 8 +-
content/stream/operators/Flow/lazyInitAsync.html | 8 +-
content/stream/operators/MergeSequence.html | 8 +-
content/stream/operators/Partition.html | 8 +-
content/stream/operators/PubSub/sink.html | 16 +--
content/stream/operators/PubSub/source.html | 16 +--
.../RestartFlow/onFailuresWithBackoff.html | 18 ++--
.../stream/operators/RestartFlow/withBackoff.html | 18 ++--
.../stream/operators/RestartSink/withBackoff.html | 18 ++--
.../RestartSource/onFailuresWithBackoff.html | 16 +--
.../operators/RestartSource/withBackoff.html | 16 +--
.../stream/operators/RetryFlow/withBackoff.html | 10 +-
.../operators/RetryFlow/withBackoffAndContext.html | 10 +-
content/stream/operators/Sink/actorRef.html | 8 +-
.../operators/Sink/actorRefWithBackpressure.html | 8 +-
content/stream/operators/Sink/asPublisher.html | 8 +-
content/stream/operators/Sink/cancelled.html | 8 +-
content/stream/operators/Sink/collect.html | 8 +-
content/stream/operators/Sink/collection.html | 8 +-
content/stream/operators/Sink/combine.html | 8 +-
.../stream/operators/Sink/completionStageSink.html | 6 +-
content/stream/operators/Sink/fold.html | 8 +-
content/stream/operators/Sink/foreach.html | 8 +-
content/stream/operators/Sink/foreachAsync.html | 8 +-
content/stream/operators/Sink/foreachParallel.html | 6 +-
.../stream/operators/Sink/fromMaterializer.html | 8 +-
content/stream/operators/Sink/fromSubscriber.html | 8 +-
content/stream/operators/Sink/futureSink.html | 8 +-
content/stream/operators/Sink/head.html | 8 +-
content/stream/operators/Sink/headOption.html | 8 +-
content/stream/operators/Sink/ignore.html | 8 +-
content/stream/operators/Sink/last.html | 8 +-
content/stream/operators/Sink/lastOption.html | 8 +-
.../operators/Sink/lazyCompletionStageSink.html | 6 +-
content/stream/operators/Sink/lazyFutureSink.html | 8 +-
content/stream/operators/Sink/lazyInitAsync.html | 8 +-
content/stream/operators/Sink/lazySink.html | 8 +-
content/stream/operators/Sink/never.html | 8 +-
content/stream/operators/Sink/onComplete.html | 8 +-
content/stream/operators/Sink/preMaterialize.html | 8 +-
content/stream/operators/Sink/queue.html | 8 +-
content/stream/operators/Sink/reduce.html | 8 +-
content/stream/operators/Sink/seq.html | 8 +-
content/stream/operators/Sink/setup.html | 8 +-
content/stream/operators/Sink/takeLast.html | 8 +-
.../Source-or-Flow/aggregateWithBoundary.html | 8 +-
.../stream/operators/Source-or-Flow/alsoTo.html | 8 +-
.../stream/operators/Source-or-Flow/alsoToAll.html | 18 ++--
content/stream/operators/Source-or-Flow/ask.html | 14 +--
.../Source-or-Flow/backpressureTimeout.html | 8 +-
content/stream/operators/Source-or-Flow/batch.html | 8 +-
.../operators/Source-or-Flow/batchWeighted.html | 8 +-
.../stream/operators/Source-or-Flow/buffer.html | 8 +-
.../stream/operators/Source-or-Flow/collect.html | 10 +-
.../operators/Source-or-Flow/collectType.html | 8 +-
.../Source-or-Flow/completionTimeout.html | 8 +-
.../stream/operators/Source-or-Flow/concat.html | 8 +-
.../operators/Source-or-Flow/concatAllLazy.html | 8 +-
.../operators/Source-or-Flow/concatLazy.html | 8 +-
.../stream/operators/Source-or-Flow/conflate.html | 8 +-
.../operators/Source-or-Flow/conflateWithSeed.html | 8 +-
content/stream/operators/Source-or-Flow/delay.html | 8 +-
.../stream/operators/Source-or-Flow/delayWith.html | 8 +-
.../stream/operators/Source-or-Flow/detach.html | 8 +-
.../stream/operators/Source-or-Flow/divertTo.html | 8 +-
content/stream/operators/Source-or-Flow/drop.html | 8 +-
.../stream/operators/Source-or-Flow/dropWhile.html | 8 +-
.../operators/Source-or-Flow/dropWithin.html | 8 +-
.../stream/operators/Source-or-Flow/expand.html | 8 +-
.../operators/Source-or-Flow/extrapolate.html | 8 +-
.../stream/operators/Source-or-Flow/filter.html | 10 +-
.../stream/operators/Source-or-Flow/filterNot.html | 10 +-
.../operators/Source-or-Flow/flatMapConcat.html | 8 +-
.../operators/Source-or-Flow/flatMapMerge.html | 8 +-
.../operators/Source-or-Flow/flatMapPrefix.html | 8 +-
content/stream/operators/Source-or-Flow/fold.html | 8 +-
.../stream/operators/Source-or-Flow/foldAsync.html | 8 +-
.../operators/Source-or-Flow/fromMaterializer.html | 8 +-
.../stream/operators/Source-or-Flow/groupBy.html | 8 +-
.../stream/operators/Source-or-Flow/grouped.html | 8 +-
.../operators/Source-or-Flow/groupedWeighted.html | 8 +-
.../Source-or-Flow/groupedWeightedWithin.html | 8 +-
.../operators/Source-or-Flow/groupedWithin.html | 8 +-
.../operators/Source-or-Flow/idleTimeout.html | 8 +-
.../operators/Source-or-Flow/initialDelay.html | 8 +-
.../operators/Source-or-Flow/initialTimeout.html | 8 +-
.../operators/Source-or-Flow/interleave.html | 8 +-
.../operators/Source-or-Flow/interleaveAll.html | 8 +-
.../operators/Source-or-Flow/intersperse.html | 8 +-
.../stream/operators/Source-or-Flow/keepAlive.html | 8 +-
content/stream/operators/Source-or-Flow/limit.html | 10 +-
.../operators/Source-or-Flow/limitWeighted.html | 10 +-
content/stream/operators/Source-or-Flow/log.html | 8 +-
.../operators/Source-or-Flow/logWithMarker.html | 8 +-
content/stream/operators/Source-or-Flow/map.html | 8 +-
.../stream/operators/Source-or-Flow/mapAsync.html | 8 +-
.../Source-or-Flow/mapAsyncUnordered.html | 8 +-
.../stream/operators/Source-or-Flow/mapConcat.html | 8 +-
.../stream/operators/Source-or-Flow/mapError.html | 8 +-
content/stream/operators/Source-or-Flow/merge.html | 8 +-
.../stream/operators/Source-or-Flow/mergeAll.html | 8 +-
.../operators/Source-or-Flow/mergeLatest.html | 8 +-
.../operators/Source-or-Flow/mergePreferred.html | 8 +-
.../operators/Source-or-Flow/mergePrioritized.html | 8 +-
.../operators/Source-or-Flow/mergeSorted.html | 8 +-
.../stream/operators/Source-or-Flow/monitor.html | 8 +-
.../stream/operators/Source-or-Flow/orElse.html | 8 +-
.../operators/Source-or-Flow/preMaterialize.html | 8 +-
.../operators/Source-or-Flow/prefixAndTail.html | 8 +-
.../stream/operators/Source-or-Flow/prepend.html | 8 +-
.../operators/Source-or-Flow/prependLazy.html | 8 +-
.../stream/operators/Source-or-Flow/recover.html | 8 +-
.../operators/Source-or-Flow/recoverWith.html | 8 +-
.../Source-or-Flow/recoverWithRetries.html | 8 +-
.../stream/operators/Source-or-Flow/reduce.html | 8 +-
content/stream/operators/Source-or-Flow/scan.html | 8 +-
.../stream/operators/Source-or-Flow/scanAsync.html | 8 +-
content/stream/operators/Source-or-Flow/setup.html | 8 +-
.../stream/operators/Source-or-Flow/sliding.html | 8 +-
.../operators/Source-or-Flow/splitAfter.html | 8 +-
.../stream/operators/Source-or-Flow/splitWhen.html | 8 +-
.../operators/Source-or-Flow/statefulMap.html | 8 +-
.../Source-or-Flow/statefulMapConcat.html | 8 +-
content/stream/operators/Source-or-Flow/take.html | 8 +-
.../stream/operators/Source-or-Flow/takeWhile.html | 8 +-
.../operators/Source-or-Flow/takeWithin.html | 8 +-
.../stream/operators/Source-or-Flow/throttle.html | 10 +-
content/stream/operators/Source-or-Flow/watch.html | 8 +-
.../operators/Source-or-Flow/watchTermination.html | 8 +-
.../stream/operators/Source-or-Flow/wireTap.html | 8 +-
content/stream/operators/Source-or-Flow/zip.html | 8 +-
.../stream/operators/Source-or-Flow/zipAll.html | 8 +-
.../stream/operators/Source-or-Flow/zipLatest.html | 8 +-
.../operators/Source-or-Flow/zipLatestWith.html | 8 +-
.../stream/operators/Source-or-Flow/zipWith.html | 8 +-
.../operators/Source-or-Flow/zipWithIndex.html | 8 +-
content/stream/operators/Source/actorRef.html | 8 +-
.../operators/Source/actorRefWithBackpressure.html | 8 +-
.../operators/Source/asSourceWithContext.html | 10 +-
content/stream/operators/Source/asSubscriber.html | 12 +--
content/stream/operators/Source/combine.html | 20 ++--
.../stream/operators/Source/completionStage.html | 8 +-
.../operators/Source/completionStageSource.html | 10 +-
content/stream/operators/Source/cycle.html | 8 +-
content/stream/operators/Source/empty.html | 8 +-
content/stream/operators/Source/failed.html | 8 +-
content/stream/operators/Source/from.html | 10 +-
.../operators/Source/fromCompletionStage.html | 8 +-
content/stream/operators/Source/fromFuture.html | 8 +-
.../stream/operators/Source/fromFutureSource.html | 8 +-
content/stream/operators/Source/fromIterator.html | 8 +-
.../stream/operators/Source/fromJavaStream.html | 8 +-
content/stream/operators/Source/fromPublisher.html | 12 +--
.../Source/fromSourceCompletionStage.html | 6 +-
content/stream/operators/Source/future.html | 8 +-
content/stream/operators/Source/futureSource.html | 10 +-
content/stream/operators/Source/lazily.html | 8 +-
content/stream/operators/Source/lazilyAsync.html | 6 +-
.../operators/Source/lazyCompletionStage.html | 6 +-
.../Source/lazyCompletionStageSource.html | 6 +-
content/stream/operators/Source/lazyFuture.html | 8 +-
.../stream/operators/Source/lazyFutureSource.html | 8 +-
content/stream/operators/Source/lazySingle.html | 8 +-
content/stream/operators/Source/lazySource.html | 8 +-
content/stream/operators/Source/maybe.html | 8 +-
.../stream/operators/Source/mergePrioritizedN.html | 6 +-
content/stream/operators/Source/never.html | 8 +-
content/stream/operators/Source/queue.html | 10 +-
content/stream/operators/Source/range.html | 12 +--
content/stream/operators/Source/repeat.html | 8 +-
content/stream/operators/Source/single.html | 8 +-
content/stream/operators/Source/tick.html | 10 +-
content/stream/operators/Source/unfold.html | 8 +-
content/stream/operators/Source/unfoldAsync.html | 8 +-
.../stream/operators/Source/unfoldResource.html | 8 +-
.../operators/Source/unfoldResourceAsync.html | 8 +-
content/stream/operators/Source/zipN.html | 8 +-
content/stream/operators/Source/zipWithN.html | 8 +-
.../operators/StreamConverters/asInputStream.html | 10 +-
.../operators/StreamConverters/asJavaStream.html | 10 +-
.../operators/StreamConverters/asOutputStream.html | 10 +-
.../StreamConverters/fromInputStream.html | 10 +-
.../operators/StreamConverters/fromJavaStream.html | 10 +-
.../StreamConverters/fromOutputStream.html | 10 +-
.../operators/StreamConverters/javaCollector.html | 8 +-
.../javaCollectorParallelUnordered.html | 8 +-
content/stream/operators/Unzip.html | 6 +-
content/stream/operators/UnzipWith.html | 6 +-
content/stream/operators/index.html | 26 ++---
content/stream/reactive-streams-interop.html | 12 +--
content/stream/stream-composition.html | 14 +--
content/stream/stream-context.html | 24 ++---
content/stream/stream-cookbook.html | 12 +--
content/stream/stream-customize.html | 66 ++++++------
content/stream/stream-dynamic.html | 48 ++++-----
content/stream/stream-error.html | 40 +++----
content/stream/stream-flows-and-basics.html | 48 ++++-----
content/stream/stream-graphs.html | 12 +--
content/stream/stream-introduction.html | 6 +-
content/stream/stream-io.html | 28 ++---
content/stream/stream-parallelism.html | 14 +--
content/stream/stream-quickstart.html | 58 +++++------
content/stream/stream-rate.html | 12 +--
content/stream/stream-refs.html | 14 +--
content/stream/stream-substream.html | 34 +++---
content/stream/stream-testkit.html | 30 +++---
content/supervision-classic.html | 6 +-
content/testing.html | 14 +--
content/typed/actor-discovery.html | 20 ++--
content/typed/actor-lifecycle.html | 54 +++++-----
content/typed/actors.html | 48 ++++-----
content/typed/choosing-cluster.html | 6 +-
content/typed/cluster-concepts.html | 8 +-
content/typed/cluster-dc.html | 12 +--
content/typed/cluster-membership.html | 8 +-
content/typed/cluster-sharded-daemon-process.html | 14 +--
content/typed/cluster-sharding-concepts.html | 6 +-
content/typed/cluster-sharding.html | 74 ++++++-------
content/typed/cluster-singleton.html | 32 +++---
content/typed/cluster.html | 40 +++----
content/typed/coexisting.html | 16 +--
content/typed/cqrs.html | 6 +-
content/typed/dispatchers.html | 12 +--
content/typed/distributed-data.html | 18 ++--
content/typed/distributed-pub-sub.html | 14 +--
content/typed/durable-state/cqrs.html | 6 +-
content/typed/durable-state/persistence-style.html | 6 +-
content/typed/durable-state/persistence.html | 20 ++--
content/typed/extending.html | 10 +-
content/typed/failure-detector.html | 6 +-
content/typed/fault-tolerance.html | 30 +++---
content/typed/from-classic.html | 12 +--
content/typed/fsm.html | 6 +-
content/typed/guide/actors-intro.html | 6 +-
content/typed/guide/actors-motivation.html | 6 +-
content/typed/guide/index.html | 6 +-
content/typed/guide/introduction.html | 6 +-
content/typed/guide/modules.html | 60 +++++------
content/typed/guide/tutorial.html | 6 +-
content/typed/guide/tutorial_1.html | 26 ++---
content/typed/guide/tutorial_2.html | 6 +-
content/typed/guide/tutorial_3.html | 6 +-
content/typed/guide/tutorial_4.html | 16 +--
content/typed/guide/tutorial_5.html | 12 +--
content/typed/index-cluster.html | 6 +-
content/typed/index-persistence-durable-state.html | 6 +-
content/typed/index-persistence.html | 6 +-
content/typed/index.html | 6 +-
content/typed/interaction-patterns.html | 56 +++++-----
content/typed/logging.html | 38 +++----
content/typed/mailboxes.html | 52 ++++-----
content/typed/persistence-fsm.html | 8 +-
content/typed/persistence-snapshot.html | 6 +-
content/typed/persistence-style.html | 6 +-
content/typed/persistence-testing.html | 66 ++++++------
content/typed/persistence.html | 82 +++++++--------
content/typed/reliable-delivery.html | 34 +++---
.../typed/replicated-eventsourcing-auction.html | 6 +-
content/typed/replicated-eventsourcing-cart.html | 8 +-
.../typed/replicated-eventsourcing-examples.html | 6 +-
content/typed/replicated-eventsourcing.html | 32 +++---
content/typed/routers.html | 12 +--
content/typed/stash.html | 20 ++--
content/typed/style-guide.html | 6 +-
content/typed/testing-async.html | 22 ++--
content/typed/testing-sync.html | 20 ++--
content/typed/testing.html | 18 ++--
386 files changed, 2556 insertions(+), 2555 deletions(-)
diff --git a/content/actors.html b/content/actors.html
index 08b1f7c..216c920 100644
--- a/content/actors.html
+++ b/content/actors.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -420,7 +420,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h1><a href="#classic-actors" name="classic-actors" class="anchor"><span class="anchor-link"></span></a>Classic Actors</h1><div class="callout note "><div class="callout-title">Note</div>
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Classic Actors, add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Classic Actors, add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies ++= Seq(
"org.apache.pekko" %% "pekko-actor" % PekkoVersion,
"org.apache.pekko" %% "pekko-testkit" % PekkoVersion % Test
@@ -432,7 +432,7 @@ libraryDependencies ++= Seq(
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -452,7 +452,7 @@ libraryDependencies ++= Seq(
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
testImplementation "org.apache.pekko:pekko-testkit_${versions.ScalaBinary}"
@@ -461,7 +461,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Actors (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-actor</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -536,7 +536,7 @@ public class MyActor extends AbstractActor {
}
}</code></pre></dd>
</dl>
-<p>Please note that the Pekko Actor <span class="group-scala"><code>receive</code></span> message loop is exhaustive, which is different compared to Erlang and the late Scala Actors. This means that you need to provide a pattern match for all messages that it can accept and if you want to be able to handle unknown messages then you need to have a default case as in the example above. Otherwise an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHO [...]
+<p>Please note that the Pekko Actor <span class="group-scala"><code>receive</code></span> message loop is exhaustive, which is different compared to Erlang and the late Scala Actors. This means that you need to provide a pattern match for all messages that it can accept and if you want to be able to handle unknown messages then you need to have a default case as in the example above. Otherwise an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHO [...]
<p>Note further that the return type of the behavior defined above is <a href="http://www.scala-lang.org/api/2.13.8/scala/Unit.html" title="scala.Unit"><code>Unit</code></a>; if the actor shall reply to the received message then this must be done explicitly as explained below.</p>
<p>The result of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#receive:org.apache.pekko.actor.Actor.Receive" title="pekko.actor.Actor"><code>receive</code></a> method is a partial function object, which is</span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#createReceive()" title="pekko.actor.AbstractActor"><code>createReceive</code></a> method is <a href="https:// [...]
<h4><a href="#here-is-another-example-that-you-can-edit-and-run-in-the-browser-" name="here-is-another-example-that-you-can-edit-and-run-in-the-browser-" class="anchor"><span class="anchor-link"></span></a>Here is another example that you can edit and run in the browser:</h4>
@@ -589,7 +589,7 @@ class Ponger(pinger: ActorRef) extends Actor {
<script defer="true" src="https://embed.scalafiddle.io/integration.js"></script>
</div>
<h3><a href="#props" name="props" class="anchor"><span class="anchor-link"></span></a>Props</h3>
-<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> is a configuration class to specify options for the creation of actors, think of it as an immutable [...]
+<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> is a configuration class to specify options for the creation of actors, think of it as an immutable [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -606,9 +606,9 @@ Props props2 =
Props.create(ActorWithArgs.class, () -> new ActorWithArgs("arg")); // careful, see below
Props props3 = Props.create(ActorWithArgs.class, "arg");</code></pre></dd>
</dl>
-<p>The second variant shows how to pass constructor arguments to the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> being created, but it should only [...]
+<p>The second variant shows how to pass constructor arguments to the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> being created, but it should only [...]
<p>The last line shows a possibility to pass constructor arguments regardless of the context it is being used in. The presence of a matching constructor is verified during construction of the <code>Props</code> object, resulting in an <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="java.lang.IllegalArgumentException"><code>IllegalArgumentException</code></a> if no or multiple matching constructors are found.</p><div cl [...]
-<p>The recommended approach to create the actor <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> is not supported for cases when the actor constructor [...]
+<p>The recommended approach to create the actor <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> is not supported for cases when the actor constructor [...]
<h4><a href="#dangerous-variants" name="dangerous-variants" class="anchor"><span class="anchor-link"></span></a>Dangerous Variants</h4>
<dl>
<dt>Scala</dt>
@@ -659,7 +659,7 @@ val defaultValueProp3 = Props(classOf[DefaultValueActor2]) // Unsupported</code>
<p>In both cases, an <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="java.lang.IllegalArgumentException"><code>IllegalArgumentException</code></a> will be thrown stating no matching constructor could be found.</p>
<p>The next section explains the recommended ways to create <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>Actor</code></a> props in a way, which simultaneously safe-guards against these edge cases.</p></div>
<h4><a href="#recommended-practices" name="recommended-practices" class="anchor"><span class="anchor-link"></span></a>Recommended Practices</h4>
-<p>It is a good idea to provide <span class="group-scala">factory methods on the companion object of each <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></sp [...]
+<p>It is a good idea to provide <span class="group-scala">factory methods on the companion object of each <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></sp [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -770,7 +770,7 @@ class MyActor extends Actor with ActorLogging {
}</code></pre></dd>
</dl>
<h3><a href="#creating-actors-with-props" name="creating-actors-with-props" class="anchor"><span class="anchor-link"></span></a>Creating Actors with Props</h3>
-<p>Actors are created by passing a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> instance into the <code>actorOf</code> factory method which is avai [...]
+<p>Actors are created by passing a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> instance into the <code>actorOf</code> factory method which is avai [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -806,8 +806,8 @@ import org.apache.pekko.actor.ActorSystem;</code></pre></dd>
}</code></pre></dd>
</dl>
<p>It is recommended to create a hierarchy of children, grand-children and so on such that it fits the logical failure-handling structure of the application, see <a href="general/actor-systems.html">Actor Systems</a>.</p>
-<p>The call to <code>actorOf</code> returns an instance of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span>. This is a handle to the [...]
-<p>The name parameter is optional, but you should preferably name your actors, since that is used in log messages and for identifying actors. The name must not be empty or start with <code>$</code>, but it may contain URL encoded characters (eg., <code>%20</code> for a blank space). If the given name is already in use by another child to the same parent an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/InvalidActorName [...]
+<p>The call to <code>actorOf</code> returns an instance of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span>. This is a handle to the [...]
+<p>The name parameter is optional, but you should preferably name your actors, since that is used in log messages and for identifying actors. The name must not be empty or start with <code>$</code>, but it may contain URL encoded characters (eg., <code>%20</code> for a blank space). If the given name is already in use by another child to the same parent an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/InvalidActorName [...]
<p>Actors are automatically started asynchronously when created.</p><div class="group-scala">
<h4><a href="#value-classes-as-constructor-arguments" name="value-classes-as-constructor-arguments" class="anchor"><span class="anchor-link"></span></a>Value classes as constructor arguments</h4>
<p>The recommended way to instantiate actor props uses reflection at runtime to determine the correct actor constructor to be invoked and due to technical limitations it is not supported when said constructor takes arguments that are value classes. In these cases you should either unpack the arguments or create the props by calling the constructor manually:</p>
@@ -822,7 +822,7 @@ object ValueClassActor {
def props3(arg: Argument) = Props(new ValueClassActor(arg)) // ok
}</code></pre></div>
<h3><a href="#dependency-injection" name="dependency-injection" class="anchor"><span class="anchor-link"></span></a>Dependency Injection</h3>
-<p>If your <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> has a constructor that takes parameters then those need to be part of the <span class="grou [...]
+<p>If your <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> has a constructor that takes parameters then those need to be part of the <span class="grou [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -869,14 +869,14 @@ class DependencyInjector implements IndirectActorProducer {
.actorOf(
Props.create(DependencyInjector.class, applicationContext, "TheActor"), "TheActor");</code></pre></dd>
</dl><div class="callout warning "><div class="callout-title">Warning</div>
-<p>You might be tempted at times to offer an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/IndirectActorProducer.html" title="org.apache.pekko.actor.IndirectActorProducer"><code>IndirectActorProducer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/IndirectActorProducer.html" title="org.apache.pekko.actor.IndirectActorProducer"><code>I [...]
+<p>You might be tempted at times to offer an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/IndirectActorProducer.html" title="org.apache.pekko.actor.IndirectActorProducer"><code>IndirectActorProducer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/IndirectActorProducer.html" title="org.apache.pekko.actor.IndirectActorProducer"><code>I [...]
<p>When using a dependency injection framework, actor beans <em>MUST NOT</em> have singleton scope.</p>
<h2><a href="#actor-api" name="actor-api" class="anchor"><span class="anchor-link"></span></a>Actor API</h2>
-<p><span class="group-scala">The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> trait defines only one abstract method, the above mentioned <code>rec [...]
-<p>If the current actor behavior does not match a received message, <code>unhandled</code> is called, which by default publishes an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/UnhandledMessage.html" title="org.apache.pekko.actor.UnhandledMessage"><code>actor.UnhandledMessage(message, sender, recipient)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/a [...]
+<p><span class="group-scala">The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> trait defines only one abstract method, the above mentioned <code>rec [...]
+<p>If the current actor behavior does not match a received message, <code>unhandled</code> is called, which by default publishes an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/UnhandledMessage.html" title="org.apache.pekko.actor.UnhandledMessage"><code>actor.UnhandledMessage(message, sender, recipient)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/a [...]
<p>In addition, it offers:</p>
<ul>
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#self:org.apache.pekko.actor.ActorRef" title="pekko.actor.Actor"><code>self</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#getSelf()" title="pekko.actor.AbstractActor"><code>getSelf()</code></a></span> reference to the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297- [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#self:org.apache.pekko.actor.ActorRef" title="pekko.actor.Actor"><code>self</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#getSelf()" title="pekko.actor.AbstractActor"><code>getSelf()</code></a></span> reference to the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528- [...]
<li><span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#sender():org.apache.pekko.actor.ActorRef" title="pekko.actor.Actor"><code>sender</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#getSender()" title="pekko.actor.AbstractActor"><code>getSender()</code></a></span> reference sender Actor of the last received message, typically used as described in <span c [...]
<li><span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#supervisorStrategy:org.apache.pekko.actor.SupervisorStrategy" title="pekko.actor.Actor"><code>supervisorStrategy</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#supervisorStrategy()" title="pekko.actor.AbstractActor"><code>supervisorStrategy()</code></a></span> user overridable definition the strategy t [...]
</ul>
@@ -942,21 +942,21 @@ public void postStop() {}</code></pre></dd>
<p>The implementations shown above are the defaults provided by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>Actor</code></a> trait.</span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html" title="pekko.actor.AbstractActor"><code>AbstractActor</code></a> class.</span></p>
<h3><a href="#actor-lifecycle" name="actor-lifecycle" class="anchor"><span class="anchor-link"></span></a>Actor Lifecycle</h3>
<p><img src="./images/actor_lifecycle.png" alt="actor_lifecycle.png" /></p>
-<p>A path in an actor system represents a “place” that might be occupied by a living actor. Initially (apart from system initialized actors) a path is empty. When <code>actorOf()</code> is called it assigns an <em>incarnation</em> of the actor described by the passed <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="grou [...]
+<p>A path in an actor system represents a “place” that might be occupied by a living actor. Initially (apart from system initialized actors) a path is empty. When <code>actorOf()</code> is called it assigns an <em>incarnation</em> of the actor described by the passed <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="grou [...]
<p>It is worth noting about the difference between:</p>
<ul>
<li>restart</li>
<li>stop, followed by a re-creation of the actor</li>
</ul>
<p>as explained below.</p>
-<p>A restart only swaps the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> instance defined by the <span class="group-scala"><a href="https://doc.akk [...]
-<p>The lifecycle of an incarnation ends when the actor is stopped. At that point, the appropriate lifecycle events are called and watching actors are notified of the termination. After the incarnation is stopped, the path can be reused again by creating an actor with <code>actorOf()</code>. In this case, the name of the new incarnation will be the same as the previous one, but the UIDs will differ. An actor can be stopped by the actor itself, another actor or the <span class="group-scala [...]
+<p>A restart only swaps the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> instance defined by the <span class="group-scala"><a href="https://doc.akk [...]
+<p>The lifecycle of an incarnation ends when the actor is stopped. At that point, the appropriate lifecycle events are called and watching actors are notified of the termination. After the incarnation is stopped, the path can be reused again by creating an actor with <code>actorOf()</code>. In this case, the name of the new incarnation will be the same as the previous one, but the UIDs will differ. An actor can be stopped by the actor itself, another actor or the <span class="group-scala [...]
<p>It is important to note that Actors do not stop automatically when no longer referenced, every Actor that is created must also explicitly be destroyed. The only simplification is that stopping a parent Actor will also recursively stop all the child Actors that this parent has created.</p></div>
-<p>An <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> always represents an incarnation (path and UID) not just a given path. Therefo [...]
-<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span> on the other hand points to the path (or mult [...]
+<p>An <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> always represents an incarnation (path and UID) not just a given path. Therefo [...]
+<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span> on the other hand points to the path (or mult [...]
<a id="deathwatch"></a>
<h3><a href="#lifecycle-monitoring-aka-deathwatch" name="lifecycle-monitoring-aka-deathwatch" class="anchor"><span class="anchor-link"></span></a>Lifecycle Monitoring aka DeathWatch</h3>
-<p>To be notified when another actor terminates (i.e., stops permanently, not a temporary failure and restart), an actor may register itself for reception of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Term [...]
+<p>To be notified when another actor terminates (i.e., stops permanently, not a temporary failure and restart), an actor may register itself for reception of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Term [...]
<p>Registering a monitor is easy:</p>
<dl>
<dt>Scala</dt>
@@ -1006,9 +1006,9 @@ static class WatchActor extends AbstractActor {
}
}</code></pre></dd>
</dl>
-<p>It should be noted that the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span> message is generated independently of the [...]
+<p>It should be noted that the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span> message is generated independently of the [...]
<p>Registering multiple times does not necessarily lead to multiple messages being generated, but there is no guarantee that only exactly one such message is received: if termination of the watched actor has generated and queued the message, and another registration is done before this message has been processed, then a second message will be queued because registering for monitoring of an already terminated actor leads to the immediate generation of the <code>Terminated</code> message.</p>
-<p>It is also possible to deregister from watching another actor’s liveliness using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#unwatch(subject:org.apache.pekko.actor.ActorRef):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorContext"><code>context.unwatch(target)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apa [...]
+<p>It is also possible to deregister from watching another actor’s liveliness using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#unwatch(subject:org.apache.pekko.actor.ActorRef):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorContext"><code>context.unwatch(target)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apa [...]
<h3><a href="#start-hook" name="start-hook" class="anchor"><span class="anchor-link"></span></a>Start Hook</h3>
<p>Right after starting the actor, its <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#preStart():Unit" title="pekko.actor.Actor"><code>preStart</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#preStart()" title="pekko.actor.AbstractActor"><code>preStart</code></a></span> method is invoked.</p>
<dl>
@@ -1036,10 +1036,10 @@ public void preStart() {
<p>An actor restart replaces only the actual actor object; the contents of the mailbox are unaffected by the restart, so the processing of messages will resume after the <code>postRestart</code> hook returns. The message that triggered the exception will not be received again. Any message sent to an actor while it is being restarted will be queued to its mailbox as usual.</p><div class="callout warning "><div class="callout-title">Warning</div>
<p>Be aware that the ordering of failure notifications relative to user messages is not deterministic. In particular, a parent might restart its child before it has processed the last messages sent by the child before the failure. See <a href="general/message-delivery-reliability.html#message-ordering">Discussion: Message Ordering</a> for details.</p></div>
<h3><a href="#stop-hook" name="stop-hook" class="anchor"><span class="anchor-link"></span></a>Stop Hook</h3>
-<p>After stopping an actor, its <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#postStop():Unit" title="pekko.actor.Actor"><code>postStop</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#postStop()" title="pekko.actor.AbstractActor"><code>postStop</code></a></span> hook is called, which may be used e.g. for deregistering this actor from other services. This [...]
+<p>After stopping an actor, its <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#postStop():Unit" title="pekko.actor.Actor"><code>postStop</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#postStop()" title="pekko.actor.AbstractActor"><code>postStop</code></a></span> hook is called, which may be used e.g. for deregistering this actor from other services. This [...]
<a id="actorselection"></a>
<h2><a href="#identifying-actors-via-actor-selection" name="identifying-actors-via-actor-selection" class="anchor"><span class="anchor-link"></span></a>Identifying Actors via Actor Selection</h2>
-<p>As described in <a href="general/addressing.html">Actor References, Paths and Addresses</a>, each actor has a unique logical path, which is obtained by following the chain of actors from child to parent until reaching the root of the actor system, and it has a physical path, which may differ if the supervision chain includes any remote supervisors. These paths are used by the system to look up actors, e.g. when a remote message is received and the recipient is searched, but they are a [...]
+<p>As described in <a href="general/addressing.html">Actor References, Paths and Addresses</a>, each actor has a unique logical path, which is obtained by following the chain of actors from child to parent until reaching the root of the actor system, and it has a physical path, which may differ if the supervision chain includes any remote supervisors. These paths are used by the system to look up actors, e.g. when a remote message is received and the recipient is searched, but they are a [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1076,8 +1076,8 @@ getContext().actorSelection("/user/serviceB/worker*");
// will look up all siblings beneath same supervisor
getContext().actorSelection("../*");</code></pre></dd>
</dl>
-<p>Messages can be sent via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span> and the path of [...]
-<p>To acquire an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> for an <code>ActorSelection</code> you need to send a message to th [...]
+<p>Messages can be sent via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span> and the path of [...]
+<p>To acquire an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> for an <code>ActorSelection</code> you need to send a message to th [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1140,7 +1140,7 @@ static class Follower extends AbstractActor {
}
}</code></pre></dd>
</dl>
-<p>You can also acquire an <code>ActorRef</code> for an <code>ActorSelection</code> with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html#resolveOne(timeout:scala.concurrent.duration.FiniteDuration):scala.concurrent.Future[actor.ActorRef]" title="org.apache.pekko.actor.ActorSelection"><code>resolveOne</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c [...]
+<p>You can also acquire an <code>ActorRef</code> for an <code>ActorSelection</code> with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html#resolveOne(timeout:scala.concurrent.duration.FiniteDuration):scala.concurrent.Future[actor.ActorRef]" title="org.apache.pekko.actor.ActorSelection"><code>resolveOne</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a [...]
<p>Remote actor addresses may also be looked up, if <a href="remoting.html">remoting</a> is enabled:</p>
<dl>
<dt>Scala</dt>
@@ -1191,8 +1191,8 @@ val message = Register(user)</code></pre></dd>
<li><span class="group-scala"><code>?</code></span> <span class="group-java"><code>ask</code></span> sends a message asynchronously and returns a <span class="group-scala"><a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/Future.html" title="scala.concurrent.Future"><code>Future</code></a></span><span class="group-java"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/CompletionStage.html" title="java.util.concurrent.CompletionStag [...]
</ul>
<p>Message ordering is guaranteed on a per-sender basis.</p><div class="callout note "><div class="callout-title">Note</div>
-<p>There are performance implications of using <code>ask</code> since something needs to keep track of when it times out, there needs to be something that bridges a <code>Promise</code> into an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/o [...]
-<p>In all these methods you have the option of passing along your own <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span>. Make it a pra [...]
+<p>There are performance implications of using <code>ask</code> since something needs to keep track of when it times out, there needs to be something that bridges a <code>Promise</code> into an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/o [...]
+<p>In all these methods you have the option of passing along your own <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span>. Make it a pra [...]
<a id="actors-tell-sender"></a>
<h3><a href="#tell-fire-forget" name="tell-fire-forget" class="anchor"><span class="anchor-link"></span></a>Tell: Fire-forget</h3>
<p>This is the preferred way of sending messages. No blocking waiting for a message. This gives the best concurrency and scalability characteristics.</p>
@@ -1210,7 +1210,7 @@ target.tell(message, getSelf());</code></pre></dd>
<p>The sender reference is passed along with the message and available within the receiving actor via its <a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#getSender()" title="pekko.actor.AbstractActor"><code>getSender()</code></a> method while processing this message. Inside of an actor it is usually <a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#getSelf()" title="pekko.actor.AbstractActor"><code>getSelf()</code></ [...]
<a id="actors-ask"></a>
<h3><a href="#ask-send-and-receive-future" name="ask-send-and-receive-future" class="anchor"><span class="anchor-link"></span></a>Ask: Send-And-Receive-Future</h3>
-<p>The <code>ask</code> pattern involves actors as well as futures, hence it is offered as a use pattern rather than a method on <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.acto [...]
+<p>The <code>ask</code> pattern involves actors as well as futures, hence it is offered as a use pattern rather than a method on <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.acto [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1252,7 +1252,7 @@ pipe(transformed, system.dispatcher()).to(actorC);</code></pre></dd>
</dl>
<p>This example demonstrates <code>ask</code> together with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/pattern/PipeToSupport$PipeableFuture.html#pipeTo(recipient:org.apache.pekko.actor.ActorRef)(implicitsender:org.apache.pekko.actor.ActorRef):scala.concurrent.Future[T]" title="pekko.pattern.PipeToSupport$PipeableFuture"><code>pipeTo</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/pattern/P [...]
<p>Using <code>ask</code> will send a message to the receiving Actor as with <code>tell</code>, and the receiving actor must reply with <span class="group-scala"><code>sender() ! reply</code></span> <span class="group-java"><code>getSender().tell(reply, getSelf())</code> </span> in order to complete the returned <span class="group-scala"><code>Future</code></span><span class="group-java"><code>CompletionStage</code></span> with a value. The <code>ask</code> operation involves creating an [...]
-<p>To complete the <span class="group-scala"><a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/Future.html" title="scala.concurrent.Future"><code>Future</code></a></span><span class="group-java"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/CompletionStage.html" title="java.util.concurrent.CompletionStage"><code>CompletionStage</code></a></span> with an exception you need to send an <span class="group-scala"><a href="https://doc.a [...]
+<p>To complete the <span class="group-scala"><a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/Future.html" title="scala.concurrent.Future"><code>Future</code></a></span><span class="group-java"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/CompletionStage.html" title="java.util.concurrent.CompletionStage"><code>CompletionStage</code></a></span> with an exception you need to send an <span class="group-scala"><a href="https://doc.a [...]
<p><span class="group-scala">Please note that Scala’s <code>Try</code> sub types <a href="http://www.scala-lang.org/api/2.13.8/scala/util/Failure.html" title="scala.util.Failure"><code>scala.util.Failure</code></a> and <a href="http://www.scala-lang.org/api/2.13.8/scala/util/Success.html" title="scala.util.Success"><code>scala.util.Success</code></a> are not treated especially, and would complete the ask <span class="group-scala"><code>Future</code></span><span class="group-java">< [...]
<dl>
<dt>Scala</dt>
@@ -1465,7 +1465,7 @@ public class GraduallyBuiltActor extends AbstractActor {
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/actor/MyActor.java#L36" target="_blank" title="Go to snippet source">source</a><code class="language-java">getSender().tell(s, getSelf());</code></pre></dd>
</dl>
<h2><a href="#receive-timeout" name="receive-timeout" class="anchor"><span class="anchor-link"></span></a>Receive timeout</h2>
-<p>The <span class="group-java"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/ActorContext.html#setReceiveTimeout(timeout:scala.concurrent.duration.Duration):Unit" title="pekko.actor.ActorContext"><code>ActorContext.setReceiveTimeout</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.ActorContext.html#setReceiveTimeout(java.time.Duration)" title="pekko.actor.AbstractActor.ActorContext"><code>ActorCo [...]
+<p>The <span class="group-java"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/ActorContext.html#setReceiveTimeout(timeout:scala.concurrent.duration.Duration):Unit" title="pekko.actor.ActorContext"><code>ActorContext.setReceiveTimeout</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.ActorContext.html#setReceiveTimeout(java.time.Duration)" title="pekko.actor.AbstractActor.ActorContext"><code>ActorCo [...]
<p>Please note that the receive timeout might fire and enqueue the <code>ReceiveTimeout</code> message right after another message was enqueued; hence it is <strong>not guaranteed</strong> that upon reception of the receive timeout there must have been an idle period beforehand as configured via this method.</p>
<p>Once set, the receive timeout stays in effect (i.e. continues firing repeatedly after inactivity periods).</p>
<p>To cancel the sending of receive timeout notifications, use <code>cancelReceiveTimeout</code>.</p>
@@ -1514,7 +1514,7 @@ class MyActor extends Actor {
}
}</code></pre></dd>
</dl>
-<p>Messages marked with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/NotInfluenceReceiveTimeout.html" title="org.apache.pekko.actor.NotInfluenceReceiveTimeout"><code>NotInfluenceReceiveTimeout</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/NotInfluenceReceiveTimeout.html" title="org.apache.pekko.actor.NotInfluenceReceiveTimeout"><co [...]
+<p>Messages marked with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/NotInfluenceReceiveTimeout.html" title="org.apache.pekko.actor.NotInfluenceReceiveTimeout"><code>NotInfluenceReceiveTimeout</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/NotInfluenceReceiveTimeout.html" title="org.apache.pekko.actor.NotInfluenceReceiveTimeout"><co [...]
<a id="actors-timers"></a>
<h2><a href="#timers-scheduled-messages" name="timers-scheduled-messages" class="anchor"><span class="anchor-link"></span></a>Timers, scheduled messages</h2>
<p>Messages can be scheduled to be sent at a later point by using the <a href="scheduler.html">Scheduler</a> directly, but when scheduling periodic or single messages in an actor to itself it’s more convenient and safe to use the support for named timers. The lifecycle of scheduled messages can be difficult to manage when the actor is restarted and that is taken care of by the timers.</p>
@@ -1580,11 +1580,11 @@ static class MyActor extends AbstractActorWithTimers {
}
}</code></pre></dd>
</dl>
-<p>The <a href="scheduler.html#schedule-periodically">Scheduler</a> documentation describes the difference between <code>fixed-delay</code> and <code>fixed-rate</code> scheduling. If you are uncertain of which one to use you should pick <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/TimerScheduler.html#startTimerWithFixedDelay(key:Any,msg:Any,initialDelay:scala.concurrent.duration.FiniteDuration,delay:scala.concurrent. [...]
+<p>The <a href="scheduler.html#schedule-periodically">Scheduler</a> documentation describes the difference between <code>fixed-delay</code> and <code>fixed-rate</code> scheduling. If you are uncertain of which one to use you should pick <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/TimerScheduler.html#startTimerWithFixedDelay(key:Any,msg:Any,initialDelay:scala.concurrent.duration.FiniteDuration,delay:scala.concurrent. [...]
<p>Each timer has a key and can be replaced or cancelled. It’s guaranteed that a message from the previous incarnation of the timer with the same key is not received, even though it might already be enqueued in the mailbox when it was cancelled or the new timer was started.</p>
-<p>The timers are bound to the lifecycle of the actor that owns it and thus are cancelled automatically when it is restarted or stopped. Note that the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/TimerScheduler.html" title="org.apache.pekko.actor.TimerScheduler"><code>TimerScheduler</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Tim [...]
+<p>The timers are bound to the lifecycle of the actor that owns it and thus are cancelled automatically when it is restarted or stopped. Note that the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/TimerScheduler.html" title="org.apache.pekko.actor.TimerScheduler"><code>TimerScheduler</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Tim [...]
<h2><a href="#stopping-actors" name="stopping-actors" class="anchor"><span class="anchor-link"></span></a>Stopping actors</h2>
-<p>Actors are stopped by invoking the <code>stop</code> method of a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html" title="org.apache.pekko.actor.ActorRefFactory"><code>ActorRefFactory</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html" title="org.apache.pekko.actor.ActorRefFactory"><code>ActorRef [...]
+<p>Actors are stopped by invoking the <code>stop</code> method of a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html" title="org.apache.pekko.actor.ActorRefFactory"><code>ActorRefFactory</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html" title="org.apache.pekko.actor.ActorRefFactory"><code>ActorRef [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1622,9 +1622,9 @@ public class MyStoppingActor extends AbstractActor {
}
}</code></pre></dd>
</dl>
-<p>Processing of the current message, if any, will continue before the actor is stopped, but additional messages in the mailbox will not be processed. By default, these messages are sent to the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html#deadLetters:org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorSystem"><code>deadLetters</code></a></span><span class="group-java"><a href="https:/ [...]
-<p>Termination of an actor proceeds in two steps: first the actor suspends its mailbox processing and sends a stop command to all its children, then it keeps processing the internal termination notifications from its children until the last one is gone, finally terminating itself (invoking <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#postStop():Unit" title="pekko.actor.Actor"><code>postStop</code></a></span><span class="group-java" [...]
-<p>Upon <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html#terminate():scala.concurrent.Future[actor.Terminated]" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem.terminate()</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html#terminate()" title="org.apache.pekko.actor.ActorSystem"><code>ActorSyste [...]
+<p>Processing of the current message, if any, will continue before the actor is stopped, but additional messages in the mailbox will not be processed. By default, these messages are sent to the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html#deadLetters:org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorSystem"><code>deadLetters</code></a></span><span class="group-java"><a href="https:/ [...]
+<p>Termination of an actor proceeds in two steps: first the actor suspends its mailbox processing and sends a stop command to all its children, then it keeps processing the internal termination notifications from its children until the last one is gone, finally terminating itself (invoking <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#postStop():Unit" title="pekko.actor.Actor"><code>postStop</code></a></span><span class="group-java" [...]
+<p>Upon <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html#terminate():scala.concurrent.Future[actor.Terminated]" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem.terminate()</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html#terminate()" title="org.apache.pekko.actor.ActorSystem"><code>ActorSyste [...]
<p>The <code>postStop()</code> hook is invoked after an actor is fully stopped. This enables cleaning up of resources:</p>
<dl>
<dt>Scala</dt>
@@ -1644,10 +1644,10 @@ public void postStop() {
target = null;
}</code></pre></dd>
</dl><div class="callout note "><div class="callout-title">Note</div>
-<p>Since stopping an actor is asynchronous, you cannot immediately reuse the name of the child you just stopped; this will result in an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/InvalidActorNameException.html" title="org.apache.pekko.actor.InvalidActorNameException"><code>InvalidActorNameException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apac [...]
+<p>Since stopping an actor is asynchronous, you cannot immediately reuse the name of the child you just stopped; this will result in an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/InvalidActorNameException.html" title="org.apache.pekko.actor.InvalidActorNameException"><code>InvalidActorNameException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apac [...]
<a id="poison-pill"></a>
<h3><a href="#poisonpill" name="poisonpill" class="anchor"><span class="anchor-link"></span></a>PoisonPill</h3>
-<p>You can also send an actor the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span> message, which will stop the actor whe [...]
+<p>You can also send an actor the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span> message, which will stop the actor whe [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1659,7 +1659,7 @@ victim ! PoisonPill</code></pre></dd>
</dl>
<a id="killing-actors"></a>
<h3><a href="#killing-an-actor" name="killing-an-actor" class="anchor"><span class="anchor-link"></span></a>Killing an Actor</h3>
-<p>You can also “kill” an actor by sending a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span> message. Unlike <code>PoisonPill</code> this will c [...]
+<p>You can also “kill” an actor by sending a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span> message. Unlike <code>PoisonPill</code> this will c [...]
<p>Use <code>Kill</code> like this:</p>
<dl>
<dt>Scala</dt>
@@ -1712,11 +1712,11 @@ try {
</dl>
<p>When <code>gracefulStop()</code> returns successfully, the actor’s <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#postStop():Unit" title="pekko.actor.Actor"><code>postStop</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#postStop()" title="pekko.actor.AbstractActor"><code>postStop</code></a></span> hook will have been executed: there exists a happens-bef [...]
<p>In the above example, a custom <code>Manager.Shutdown</code> message is sent to the target actor to initiate the process of stopping the actor. You can use <code>PoisonPill</code> for this, but then you have limited possibilities to perform interactions with other actors before stopping the target actor. Simple cleanup tasks can be handled in <code>postStop</code>.</p><div class="callout warning "><div class="callout-title">Warning</div>
-<p>Keep in mind that an actor stopping and its name being deregistered are separate events that happen asynchronously from each other. Therefore it may be that you will find the name still in use after <code>gracefulStop()</code> returned. To guarantee proper deregistration, only reuse names from within a supervisor you control and only in response to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Terminated.html" ti [...]
+<p>Keep in mind that an actor stopping and its name being deregistered are separate events that happen asynchronously from each other. Therefore it may be that you will find the name still in use after <code>gracefulStop()</code> returned. To guarantee proper deregistration, only reuse names from within a supervisor you control and only in response to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Terminated.html" ti [...]
<a id="actor-hotswap"></a>
<h2><a href="#become-unbecome" name="become-unbecome" class="anchor"><span class="anchor-link"></span></a>Become/Unbecome</h2>
<h3><a href="#upgrade" name="upgrade" class="anchor"><span class="anchor-link"></span></a>Upgrade</h3>
-<p>Pekko supports hotswapping the Actor’s message loop (e.g. its implementation) at runtime: invoke the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#become(behavior:org.apache.pekko.actor.Actor.Receive,discardOld:Boolean):Unit" title="org.apache.pekko.actor.ActorContext"><code>context.become</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT [...]
+<p>Pekko supports hotswapping the Actor’s message loop (e.g. its implementation) at runtime: invoke the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#become(behavior:org.apache.pekko.actor.Actor.Receive,discardOld:Boolean):Unit" title="org.apache.pekko.actor.ActorContext"><code>context.become</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT [...]
<p>Please note that the actor will revert to its original behavior when restarted by its Supervisor.</p></div>
<p>To hotswap the Actor behavior using <code>become</code>:</p>
<dl>
@@ -1784,7 +1784,7 @@ try {
}
}</code></pre></dd>
</dl>
-<p>This variant of the <code>become</code> method is useful for many different things, such as to implement a Finite State Machine (FSM). It will replace the current behavior (i.e. the top of the behavior stack), which means that you do not use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#unbecome():Unit" title="org.apache.pekko.actor.ActorContext"><code>unbecome</code></a></span><span class="group- [...]
+<p>This variant of the <code>become</code> method is useful for many different things, such as to implement a Finite State Machine (FSM). It will replace the current behavior (i.e. the top of the behavior stack), which means that you do not use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#unbecome():Unit" title="org.apache.pekko.actor.ActorContext"><code>unbecome</code></a></span><span class="group- [...]
<p>The other way of using <code>become</code> does not replace but add to the top of the behavior stack. In this case, care must be taken to ensure that the number of “pop” operations (i.e. <code>unbecome</code>) matches the number of “push” ones in the long run, otherwise this amounts to a memory leak (which is why this behavior is not the default).</p>
<dl>
<dt>Scala</dt>
@@ -1860,7 +1860,7 @@ static class SwapperApp {
<p>See this <a href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/actor/UnnestedReceives.scala">Unnested receive example</a>.</p>
<h2><a href="#stash" name="stash" class="anchor"><span class="anchor-link"></span></a>Stash</h2>
<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Stash.html" title="pekko.actor.Stash"><code>Stash</code></a> trait</span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActorWithStash.html" title="pekko.actor.AbstractActorWithStash"><code>AbstractActorWithStash</code></a> class</span> enables an actor to temporarily stash away messages that can not or should not be handled using the acto [...]
-<p>The trait <code>Stash</code> extends the marker trait <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/dispatch/RequiresMessageQueue.html" title="pekko.dispatch.RequiresMessageQueue"><code>RequiresMessageQueue</code></a>[<a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/DequeBasedMessageQueueSemantics.html" title="org.apache.pekko.dispatch.DequeBasedMessageQueueSemantics"><code>DequeBasedMessageQueueSemantics</code></a>] which requ [...]
+<p>The trait <code>Stash</code> extends the marker trait <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/dispatch/RequiresMessageQueue.html" title="pekko.dispatch.RequiresMessageQueue"><code>RequiresMessageQueue</code></a>[<a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/DequeBasedMessageQueueSemantics.html" title="org.apache.pekko.dispatch.DequeBasedMessageQueueSemantics"><code>DequeBasedMessageQueueSemantics</code></a>] which requ [...]
<p>The abstract class <a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActorWithStash.html" title="pekko.actor.AbstractActorWithStash"><code>AbstractActorWithStash</code></a> implements the marker interface <a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/dispatch/RequiresMessageQueue.html" title="pekko.dispatch.RequiresMessageQueue"><code>RequiresMessageQueue</code></a><<a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/dispatch/DequeBased [...]
<p>Here is an example of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Stash.html" title="pekko.actor.Stash"><code>Stash</code></a> trait</span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActorWithStash.html" title="pekko.actor.AbstractActorWithStash"><code>AbstractActorWithStash</code></a> class</span> in action:</p>
<dl>
@@ -1913,10 +1913,10 @@ class ActorWithProtocol extends Actor with Stash {
}
}</code></pre></dd>
</dl>
-<p>Invoking <code>stash()</code> adds the current message (the message that the actor received last) to the actor’s stash. It is typically invoked when handling the default case in the actor’s message handler to stash messages that aren’t handled by the other cases. It is illegal to stash the same message twice; to do so results in an <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalStateException.html" title="java.lang.IllegalState [...]
+<p>Invoking <code>stash()</code> adds the current message (the message that the actor received last) to the actor’s stash. It is typically invoked when handling the default case in the actor’s message handler to stash messages that aren’t handled by the other cases. It is illegal to stash the same message twice; to do so results in an <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalStateException.html" title="java.lang.IllegalState [...]
<p>Invoking <code>unstashAll()</code> enqueues messages from the stash to the actor’s mailbox until the capacity of the mailbox (if any) has been reached (note that messages from the stash are prepended to the mailbox). In case a bounded mailbox overflows, a <code>MessageQueueAppendFailedException</code> is thrown. The stash is guaranteed to be empty after calling <code>unstashAll()</code>.</p>
<p>The stash is backed by a <a href="http://www.scala-lang.org/api/2.13.8/scala/collection/immutable/Vector.html" title="scala.collection.immutable.Vector"><code>scala.collection.immutable.Vector</code></a>. As a result, even a very large number of messages may be stashed without a major impact on performance.</p><div class="callout warning group-scala"><div class="callout-title">Warning</div>
-<p>Note that the <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Stash.html" title="pekko.actor.Stash"><code>Stash</code></a> trait must be mixed into (a subclass of) the <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>Actor</code></a> trait before any trait/class that overrides the <a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html#preRestart(reason:Throwable, [...]
+<p>Note that the <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Stash.html" title="pekko.actor.Stash"><code>Stash</code></a> trait must be mixed into (a subclass of) the <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>Actor</code></a> trait before any trait/class that overrides the <a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html#preRestart(reason:Throwable, [...]
<p>Note that the stash is part of the ephemeral actor state, unlike the mailbox. Therefore, it should be managed like other parts of the actor’s state which have the same property.</p>
<p>However, the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Stash.html" title="pekko.actor.Stash"><code>Stash</code></a> trait</span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActorWithStash.html" title="pekko.actor.AbstractActorWithStash"><code>AbstractActorWithStash</code></a> class</span> implementation of <code>preRestart</code> will call <code>unstashAll()</code>. This means that [...]
<p>The result of this is that when an actor is restarted, any stashed messages will be delivered to the new incarnation of the actor. This is usually the desired behavior.</p><div class="callout note "><div class="callout-title">Note</div>
@@ -1964,7 +1964,7 @@ final case class Give(thing: Any)
</code></pre>
<p>Instead of inheritance the same pattern can be applied via composition - compose the receive method using partial functions from delegates.</p></div>
<h2><a href="#initialization-patterns" name="initialization-patterns" class="anchor"><span class="anchor-link"></span></a>Initialization patterns</h2>
-<p>The rich lifecycle hooks of Actors provide a useful toolkit to implement various initialization patterns. During the lifetime of an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekk [...]
+<p>The rich lifecycle hooks of Actors provide a useful toolkit to implement various initialization patterns. During the lifetime of an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekk [...]
<p>Initialization might be necessary every time an actor is instantiated, but sometimes one needs initialization to happen only at the birth of the first instance when the <code>ActorRef</code> is created. The following sections provide patterns for different initialization needs.</p>
<h3><a href="#initialization-via-constructor" name="initialization-via-constructor" class="anchor"><span class="anchor-link"></span></a>Initialization via constructor</h3>
<p>Using the constructor for initialization has various benefits. First of all, it makes it possible to use <code>val</code> fields to store any state that does not change during the life of the actor instance, making the implementation of the actor more robust. The constructor is invoked when an actor instance is created calling <code>actorOf</code> and also on restart, therefore the internals of the actor can always assume that proper initialization happened. This is also the drawback [...]
@@ -2010,10 +2010,10 @@ public void preRestart(Throwable reason, Optional<Object> message) throws
postStop();
}</code></pre></dd>
</dl>
-<p>Please note, that the child actors are <em>still restarted</em>, but no new <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> is cr [...]
+<p>Please note, that the child actors are <em>still restarted</em>, but no new <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> is cr [...]
<p>For more information see <a href="general/supervision.html#supervision-restart">What Restarting Means</a>.</p>
<h3><a href="#initialization-via-message-passing" name="initialization-via-message-passing" class="anchor"><span class="anchor-link"></span></a>Initialization via message passing</h3>
-<p>There are cases when it is impossible to pass all the information needed for actor initialization in the constructor, for example in the presence of circular dependencies. In this case, the actor should listen for an initialization message, and use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#become(behavior:org.apache.pekko.actor.Actor.Receive,discardOld:Boolean):Unit" title="org.apache.pekko.ac [...]
+<p>There are cases when it is impossible to pass all the information needed for actor initialization in the constructor, for example in the presence of circular dependencies. In this case, the actor should listen for an initialization message, and use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorContext.html#become(behavior:org.apache.pekko.actor.Actor.Receive,discardOld:Boolean):Unit" title="org.apache.pekko.ac [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -2052,7 +2052,7 @@ public Receive createReceive() {
}</code></pre></dd>
</dl>
<p>If the actor may receive messages before it has been initialized, a useful tool can be the <code>Stash</code> to save messages until the initialization finishes, and replaying them after the actor became initialized.</p><div class="callout warning "><div class="callout-title">Warning</div>
-<p>This pattern should be used with care, and applied only when none of the patterns above are applicable. One of the potential issues is that messages might be lost when sent to remote actors. Also, publishing an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532 [...]
+<p>This pattern should be used with care, and applied only when none of the patterns above are applicable. One of the potential issues is that messages might be lost when sent to remote actors. Also, publishing an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533 [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/actors.md">here</a>.
</div>
@@ -2152,7 +2152,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/books.html b/content/additional/books.html
index 6264b99..aa32751 100644
--- a/content/additional/books.html
+++ b/content/additional/books.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -530,7 +530,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/deploy.html b/content/additional/deploy.html
index e06174e..7dcc46a 100644
--- a/content/additional/deploy.html
+++ b/content/additional/deploy.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -517,7 +517,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/deploying.html b/content/additional/deploying.html
index d4d352f..643cb37 100644
--- a/content/additional/deploying.html
+++ b/content/additional/deploying.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -520,7 +520,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/faq.html b/content/additional/faq.html
index c6a00ec..7978f31 100644
--- a/content/additional/faq.html
+++ b/content/additional/faq.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -527,7 +527,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/ide.html b/content/additional/ide.html
index 552e39b..b5ab28b 100644
--- a/content/additional/ide.html
+++ b/content/additional/ide.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -506,7 +506,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/operations.html b/content/additional/operations.html
index d805346..b27e6c0 100644
--- a/content/additional/operations.html
+++ b/content/additional/operations.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -529,7 +529,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/osgi.html b/content/additional/osgi.html
index 8dc217b..dc7778a 100644
--- a/content/additional/osgi.html
+++ b/content/additional/osgi.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#pekko-in-osgi" name="pekko-in-osgi" class="anchor"><span class="anchor-link"></span></a>Pekko in OSGi</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Pekko in OSGi, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko in OSGi, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-osgi" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-osgi" % PekkoVersion</code><
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-osgi" % PekkoVersion</code><
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-osgi_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -476,7 +476,7 @@ dependencies {
<h2><a href="#intended-use" name="intended-use" class="anchor"><span class="anchor-link"></span></a>Intended Use</h2>
<p>Pekko only supports the usage of an ActorSystem strictly confined to a single OSGi bundle, where that bundle contains or imports all of the actor system’s requirements. This means that the approach of offering an ActorSystem as a service to which Actors can be deployed dynamically via other bundles is not recommended — an ActorSystem and its contained actors are not meant to be dynamic in this way. ActorRefs may safely be exposed to other bundles.</p>
<h2><a href="#activator" name="activator" class="anchor"><span class="anchor-link"></span></a>Activator</h2>
-<p>To bootstrap Pekko inside an OSGi environment, you can use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko.osgi.ActorSystemActivator"><code>osgi.ActorSystemActivator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko.osgi.ActorSystemA [...]
+<p>To bootstrap Pekko inside an OSGi environment, you can use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko.osgi.ActorSystemActivator"><code>osgi.ActorSystemActivator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko.osgi.ActorSystemA [...]
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/osgi/src/test/scala/docs/osgi/Activator.scala#L25-L40" target="_blank" title="Go to snippet source">source</a><code class="language-scala">import org.apache.pekko
import pekko.actor.{ ActorSystem, Props }
import org.osgi.framework.BundleContext
@@ -493,7 +493,7 @@ class Activator extends ActorSystemActivator {
}
}</code></pre>
-<p>The goal here is to map the OSGi lifecycle more directly to the Pekko lifecycle. The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko.osgi.ActorSystemActivator"><code>ActorSystemActivator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko. [...]
+<p>The goal here is to map the OSGi lifecycle more directly to the Pekko lifecycle. The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko.osgi.ActorSystemActivator"><code>ActorSystemActivator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/osgi/ActorSystemActivator.html" title="org.apache.pekko. [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/additional/osgi.md">here</a>.
</div>
@@ -584,7 +584,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/packaging.html b/content/additional/packaging.html
index 56fd57f..4441158 100644
--- a/content/additional/packaging.html
+++ b/content/additional/packaging.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -586,7 +586,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/additional/rolling-updates.html b/content/additional/rolling-updates.html
index c86002e..719abc8 100644
--- a/content/additional/rolling-updates.html
+++ b/content/additional/rolling-updates.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -435,7 +435,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>To make use of this feature you need to define the <code>app-version</code> and increase it for each rolling update.</p>
<pre><code>pekko.cluster.app-version = 1.2.3
</code></pre>
-<p>To understand which is old and new it compares the version numbers using normal conventions, see <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/Version.html" title="org.apache.pekko.util.Version"><code>Version</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/Version.html" title="org.apache.pekko.util.Version"><code>Version</code></a></ [...]
+<p>To understand which is old and new it compares the version numbers using normal conventions, see <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/Version.html" title="org.apache.pekko.util.Version"><code>Version</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/Version.html" title="org.apache.pekko.util.Version"><code>Version</code></a></ [...]
<p>Rebalance is also disabled during rolling updates, since shards from stopped nodes are anyway supposed to be started on new nodes. Messages to shards that were stopped on the old nodes will allocate corresponding shards on the new nodes, without waiting for rebalance actions. </p>
<p>You should also enable the <a href="../typed/cluster-sharding.html#health-check">health check for Cluster Sharding</a> if you use Pekko Management. The readiness check will delay incoming traffic to the node until Sharding has been initialized and can accept messages.</p>
<p>The <code>ShardCoordinator</code> is itself a cluster singleton. To minimize downtime of the shard coordinator, see the strategies about <a href="rolling-updates.html#cluster-singleton">ClusterSingleton</a> rolling updates below.</p>
@@ -566,7 +566,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/cluster-client.html b/content/cluster-client.html
index c0a42bf..a230c39 100644
--- a/content/cluster-client.html
+++ b/content/cluster-client.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Cluster Client is deprecated in favor of using <a href="https://doc.akka.io/docs/akka-grpc/current/index.html">Pekko gRPC</a>. It is not advised to build new applications with Cluster Client, and existing users <a href="cluster-client.html#migration-to-pekko-grpc">should migrate</a>.</p></div><div class="callout note "><div class="callout-title">Note</div>
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Cluster Client, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Cluster Client, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersio
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersio
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster-tools_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -453,7 +453,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Cluster Tools (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-cluster-tools</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -478,23 +478,23 @@ dependencies {
<h2><a href="#introduction" name="introduction" class="anchor"><span class="anchor-link"></span></a>Introduction</h2>
-<p>An actor system that is not part of the cluster can communicate with actors somewhere in the cluster via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html [...]
+<p>An actor system that is not part of the cluster can communicate with actors somewhere in the cluster via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html [...]
-<p>Using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span> for c [...]
+<p>Using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span> for c [...]
-<p>Additionally, since Pekko Remoting is primarily designed as a protocol for Pekko Cluster there is no explicit resource management, when a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/clus [...]
+<p>Additionally, since Pekko Remoting is primarily designed as a protocol for Pekko Cluster there is no explicit resource management, when a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/clus [...]
-<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span> should not be u [...]
+<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span> should not be u [...]
<p>The connecting system must have its <code>org.apache.pekko.actor.provider</code> set to <code>remote</code> or <code>cluster</code> when using the cluster client.</p>
-<p>The receptionist is supposed to be started on all nodes, or all nodes with a specified role, in the cluster. The receptionist can be started with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterReceptionist.html" title="org.apache.pekko.cluster.client.ClusterReceptionist"><code>ClusterReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297- [...]
+<p>The receptionist is supposed to be started on all nodes, or all nodes with a specified role, in the cluster. The receptionist can be started with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterReceptionist.html" title="org.apache.pekko.cluster.client.ClusterReceptionist"><code>ClusterReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528- [...]
-<p>You can send messages via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</co [...]
+<p>You can send messages via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</co [...]
-<p>Both the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span> and th [...]
+<p>Both the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span> and th [...]
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientRec [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientRec [...]
<ol>
<li><strong>ClusterClient.Send</strong></li>
@@ -513,8 +513,8 @@ dependencies {
<li><span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>`sender()`</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>`getSender()`</code></a></span>, as seen by the destination actor, is not the client itself, but the receptionist</li>
<li><span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>`sender()`</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/Actor.html" title="pekko.actor.Actor"><code>`getSender()`</code></a></span> of the response messages, sent back from the destination and seen by the client, is <code>deadLetters</code></li>
</ul>
-<p>since the client should normally send subsequent messages via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.Cl [...]
-<p>While establishing a connection to a receptionist the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient" [...]
+<p>since the client should normally send subsequent messages via the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.Cl [...]
+<p>While establishing a connection to a receptionist the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient" [...]
<p>It’s worth noting that messages can always be lost because of the distributed nature of these actors. As always, additional logic should be implemented in the destination (acknowledgement) and in the client (retry) actors to ensure at-least-once message delivery.</p>
<h2><a href="#an-example" name="an-example" class="anchor"><span class="anchor-link"></span></a>An Example</h2>
<p>On the cluster nodes, first start the receptionist. Note, it is recommended to load the extension when the actor system is started by defining it in the <code>pekko.extensions</code> configuration property:</p>
@@ -541,7 +541,7 @@ ClusterClientReceptionist.get(system).registerService(serviceA);
ActorRef serviceB = system.actorOf(Props.create(Service.class), "serviceB");
ClusterClientReceptionist.get(system).registerService(serviceB);</code></pre></dd>
</dl>
-<p>On the client, you create the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</co [...]
+<p>On the client, you create the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</co [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -582,12 +582,12 @@ val settings = ClusterClientSettings(system).withInitialContacts(initialContacts
<p>You will probably define the address information of the initial contact points in configuration or system property. See also <a href="cluster-client.html#cluster-client-config">Configuration</a>.</p>
<h2><a href="#clusterclientreceptionist-extension" name="clusterclientreceptionist-extension" class="anchor"><span class="anchor-link"></span></a>ClusterClientReceptionist Extension</h2>
<p>In the example above the receptionist is started and accessed with the <code>org.apache.pekko.cluster.client.ClusterClientReceptionist</code> extension. That is convenient and perfectly fine in most cases, but it can be good to know that it is possible to start the <code>org.apache.pekko.cluster.client.ClusterReceptionist</code> actor as an ordinary actor and you can have several different receptionists at the same time, serving different types of clients.</p>
-<p>Note that the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.Cluste [...]
+<p>Note that the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.Cluste [...]
<p>It is recommended to load the extension when the actor system is started by defining it in the <code>pekko.extensions</code> configuration property:</p>
<pre><code>pekko.extensions = ["pekko.cluster.client.ClusterClientReceptionist"]
</code></pre>
<h2><a href="#events" name="events" class="anchor"><span class="anchor-link"></span></a>Events</h2>
-<p>As mentioned earlier, both the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</c [...]
+<p>As mentioned earlier, both the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClient.html" title="org.apache.pekko.cluster.client.ClusterClient"><code>ClusterClient</c [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -650,7 +650,7 @@ val settings = ClusterClientSettings(system).withInitialContacts(initialContacts
}
}</code></pre></dd>
</dl>
-<p>Similarly we can have an actor that behaves in a similar fashion for learning what cluster clients are connected to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/a [...]
+<p>Similarly we can have an actor that behaves in a similar fashion for learning what cluster clients are connected to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/a [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -715,7 +715,7 @@ val settings = ClusterClientSettings(system).withInitialContacts(initialContacts
</dl>
<a id="cluster-client-config"></a>
<h2><a href="#configuration" name="configuration" class="anchor"><span class="anchor-link"></span></a>Configuration</h2>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientRec [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientReceptionist"><code>ClusterClientReceptionist</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientReceptionist.html" title="org.apache.pekko.cluster.client.ClusterClientRec [...]
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/cluster-tools/src/main/resources/reference.conf#L57-L91" target="_blank" title="Go to snippet source">source</a><code class="language-conf"># Settings for the ClusterClientReceptionist extension
pekko.cluster.client.receptionist {
# Actor name of the ClusterReceptionist actor, /system/receptionist
@@ -751,7 +751,7 @@ pekko.cluster.client.receptionist {
# Failure detection checking interval for checking all ClusterClients
failure-detection-interval = 2s
}</code></pre>
-<p>The following configuration properties are read by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientSettings.html" title="org.apache.pekko.cluster.client.ClusterClientSettings"><code>ClusterClientSettings</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientSettings.html" title="org.apache.pe [...]
+<p>The following configuration properties are read by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientSettings.html" title="org.apache.pekko.cluster.client.ClusterClientSettings"><code>ClusterClientSettings</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/client/ClusterClientSettings.html" title="org.apache.pe [...]
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/cluster-tools/src/main/resources/reference.conf#L95-L139" target="_blank" title="Go to snippet source">source</a><code class="language-conf"># Settings for the ClusterClient
pekko.cluster.client {
# Actor paths of the ClusterReceptionist actors on the servers (cluster nodes)
@@ -927,7 +927,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/cluster-dc.html b/content/cluster-dc.html
index 03d7e88..3221b10 100644
--- a/content/cluster-dc.html
+++ b/content/cluster-dc.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -576,7 +576,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/cluster-metrics.html b/content/cluster-metrics.html
index 52bec56..bf8225a 100644
--- a/content/cluster-metrics.html
+++ b/content/cluster-metrics.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -419,7 +419,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#classic-cluster-metrics-extension" name="classic-cluster-metrics-extension" class="anchor"><span class="anchor-link"></span></a>Classic Cluster Metrics Extension</h1>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Cluster Metrics Extension, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Cluster Metrics Extension, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster-metrics" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -428,7 +428,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-metrics" % PekkoVers
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -443,7 +443,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-metrics" % PekkoVers
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster-metrics_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -454,7 +454,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Cluster Metrics (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-cluster-metrics</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -1101,7 +1101,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/cluster-routing.html b/content/cluster-routing.html
index 3788068..a099189 100644
--- a/content/cluster-routing.html
+++ b/content/cluster-routing.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -428,7 +428,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<li><strong>Pool - router that creates routees as child actors and deploys them on remote nodes.</strong> Each router will have its own routee instances. For example, if you start a router on 3 nodes in a 10-node cluster, you will have 30 routees in total if the router is configured to use one instance per node. The routees created by the different routers will not be shared among the routers. One example of a use case for this type of router is a single master that coordinates jobs an [...]
</ul>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Cluster aware routers, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Cluster aware routers, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -437,7 +437,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</cod
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -452,7 +452,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</cod
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -921,7 +921,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/cluster-sharding.html b/content/cluster-sharding.html
index 3b9ceab..056fa02 100644
--- a/content/cluster-sharding.html
+++ b/content/cluster-sharding.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the full documentation of this feature and for new projects see <a href="typed/cluster-sharding.html">Cluster Sharding</a>.</p>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Cluster Sharding, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Cluster Sharding, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster-sharding" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-sharding" % PekkoVer
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-sharding" % PekkoVer
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster-sharding_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -453,7 +453,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Cluster Sharding (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-cluster-sharding</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -958,7 +958,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/cluster-singleton.html b/content/cluster-singleton.html
index c2e6376..93993de 100644
--- a/content/cluster-singleton.html
+++ b/content/cluster-singleton.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the full documentation of this feature and for new projects see <a href="typed/cluster-singleton.html">Cluster Singleton</a>.</p>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Cluster Singleton, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Cluster Singleton, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersio
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersio
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster-tools_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -453,7 +453,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Cluster Tools (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-cluster-tools</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -772,7 +772,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/cluster-usage.html b/content/cluster-usage.html
index 2d88892..591d41f 100644
--- a/content/cluster-usage.html
+++ b/content/cluster-usage.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -430,7 +430,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
</ul><div class="callout note "><div class="callout-title">Note</div>
<p>You have to enable <a href="serialization.html">serialization</a> to send messages between ActorSystems in the Cluster. <a href="serialization-jackson.html">Serialization with Jackson</a> is a good choice in many cases, and our recommendation if you don’t have other preferences or constraints.</p></div>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Pekko Cluster add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Cluster add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -439,7 +439,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</cod
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -454,7 +454,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</cod
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -462,7 +462,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Cluster (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-cluster</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -491,7 +491,7 @@ dependencies {
<h2><a href="#cluster-api-extension" name="cluster-api-extension" class="anchor"><span class="anchor-link"></span></a>Cluster API Extension</h2>
-<p>The following configuration enables the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/Cluster.html" title="org.apache.pekko.cluster.Cluster"><code>Cluster</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/Cluster.html" title="org.apache.pekko.cluster.Cluster"><code>Cluster</code></a></span> extension to be used. It joins the clus [...]
+<p>The following configuration enables the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/Cluster.html" title="org.apache.pekko.cluster.Cluster"><code>Cluster</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/Cluster.html" title="org.apache.pekko.cluster.Cluster"><code>Cluster</code></a></span> extension to be used. It joins the clus [...]
<p>An actor that uses the cluster extension may look like this:</p>
@@ -668,7 +668,7 @@ List<Address> list =
cluster.joinSeedNodes(list);</code></pre></dd>
</dl>
<p>For more information see <a href="typed/cluster.html#tuning-joins">tuning joins</a></p>
-<p>It’s also possible to specifically join a single node as illustrated in below example, but <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#joinSeedNodes(seedNodes:Seq[org.apache.pekko.actor.Address]):Unit" title="org.apache.pekko.cluster.Cluster"><code>joinSeedNodes</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/clust [...]
+<p>It’s also possible to specifically join a single node as illustrated in below example, but <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#joinSeedNodes(seedNodes:Seq[org.apache.pekko.actor.Address]):Unit" title="org.apache.pekko.cluster.Cluster"><code>joinSeedNodes</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/clust [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -694,8 +694,8 @@ cluster.joinSeedNodes(list);</code></pre></dd>
<dd>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/cluster/SimpleClusterListener2.java#L40" target="_blank" title="Go to snippet source">source</a><code class="language-java">cluster.subscribe(getSelf(), MemberEvent.class, UnreachableMember.class);</code></pre></dd>
</dl>
-<p>A snapshot of the full state, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$CurrentClusterState.html" title="org.apache.pekko.cluster.ClusterEvent.CurrentClusterState"><code>CurrentClusterState</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$CurrentClusterState.html" title="org.apache.pekko.cluster.C [...]
-<p>Note that you may receive an empty <code>CurrentClusterState</code>, containing no members, followed by <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$MemberUp.html" title="org.apache.pekko.cluster.ClusterEvent.MemberUp"><code>MemberUp</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$MemberUp.html" tit [...]
+<p>A snapshot of the full state, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$CurrentClusterState.html" title="org.apache.pekko.cluster.ClusterEvent.CurrentClusterState"><code>CurrentClusterState</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$CurrentClusterState.html" title="org.apache.pekko.cluster.C [...]
+<p>Note that you may receive an empty <code>CurrentClusterState</code>, containing no members, followed by <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$MemberUp.html" title="org.apache.pekko.cluster.ClusterEvent.MemberUp"><code>MemberUp</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ClusterEvent$$MemberUp.html" tit [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -724,7 +724,7 @@ cluster.registerOnMemberUp {
cluster.registerOnMemberUp(
() -> cluster.subscribe(getSelf(), MemberEvent.class, UnreachableMember.class));</code></pre></dd>
</dl>
-<p>If you find it inconvenient to handle the <code>CurrentClusterState</code> you can use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/cluster/ClusterEvent$$InitialStateAsEvents$.html" title="cluster.ClusterEvent$$InitialStateAsEvents"><code>ClusterEvent.InitialStateAsEvents</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/cluster/ClusterEvent.html#initialStateAsEvents()" title="pekko.c [...]
+<p>If you find it inconvenient to handle the <code>CurrentClusterState</code> you can use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/cluster/ClusterEvent$$InitialStateAsEvents$.html" title="cluster.ClusterEvent$$InitialStateAsEvents"><code>ClusterEvent.InitialStateAsEvents</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/cluster/ClusterEvent.html#initialStateAsEvents()" title="pekko.c [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -944,7 +944,7 @@ case object BackendRegistration</code></pre></dd>
}
}</code></pre></dd>
</dl>
-<p>Note that the <code>TransformationFrontend</code> actor watch the registered backend to be able to remove it from its list of available backend workers. Death watch uses the cluster failure detector for nodes in the cluster, i.e. it detects network failures and JVM crashes, in addition to graceful termination of watched actor. Death watch generates the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Terminated.html" [...]
+<p>Note that the <code>TransformationFrontend</code> actor watch the registered backend to be able to remove it from its list of available backend workers. Death watch uses the cluster failure detector for nodes in the cluster, i.e. it detects network failures and JVM crashes, in addition to graceful termination of watched actor. Death watch generates the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Terminated.html" [...]
<h2><a href="#node-roles" name="node-roles" class="anchor"><span class="anchor-link"></span></a>Node Roles</h2>
<p>See <a href="typed/cluster.html#node-roles">Cluster Node Roles</a> in the documentation of the new APIs.</p>
<a id="min-members"></a>
@@ -961,7 +961,7 @@ case object BackendRegistration</code></pre></dd>
backend.min-nr-of-members = 2
}
</code></pre>
-<p>You can start actors or trigger any functions using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberUp[T](code:=%3ET):Unit" title="org.apache.pekko.cluster.Cluster"><code>registerOnMemberUp</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberUp(java.lang.Runnable)" title=" [...]
+<p>You can start actors or trigger any functions using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberUp[T](code:=%3ET):Unit" title="org.apache.pekko.cluster.Cluster"><code>registerOnMemberUp</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberUp(java.lang.Runnable)" title=" [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -981,7 +981,7 @@ case object BackendRegistration</code></pre></dd>
});</code></pre></dd>
</dl>
<h2><a href="#how-to-cleanup-when-member-is-removed" name="how-to-cleanup-when-member-is-removed" class="anchor"><span class="anchor-link"></span></a>How To Cleanup when Member is Removed</h2>
-<p>You can do some clean up in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberRemoved[T](code:=%3ET):Unit" title="org.apache.pekko.cluster.Cluster"><code>registerOnMemberRemoved</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberRemoved(java.lang.Runnable)" title="org.apache. [...]
+<p>You can do some clean up in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberRemoved[T](code:=%3ET):Unit" title="org.apache.pekko.cluster.Cluster"><code>registerOnMemberRemoved</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/Cluster.html#registerOnMemberRemoved(java.lang.Runnable)" title="org.apache. [...]
<p>An alternative is to register tasks to the <a href="coordinated-shutdown.html">Coordinated Shutdown</a>.</p><div class="callout note "><div class="callout-title">Note</div>
<p>Register a OnMemberRemoved callback on a cluster that have been shutdown, the callback will be invoked immediately on the caller thread, otherwise it will be invoked later when the current member status changed to <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/cluster/MemberStatus$$Removed$.html" title="pekko.cluster.MemberStatus$$Removed"><code>Removed</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache [...]
<h2><a href="#higher-level-cluster-tools" name="higher-level-cluster-tools" class="anchor"><span class="anchor-link"></span></a>Higher level Cluster tools</h2><h3><a href="#cluster-singleton" name="cluster-singleton" class="anchor"><span class="anchor-link"></span></a>Cluster Singleton</h3>
@@ -1131,7 +1131,7 @@ def assertServiceOk(): Unit = {
}
}</code></pre>
-<p>Once again we take advantage of the facilities in <a href="testing.html">testkit</a> to verify expected behavior. Here using <code>testActor</code> as sender (via <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/testkit/ImplicitSender.html" title="pekko.testkit.ImplicitSender"><code>ImplicitSender</code></a>) and verifying the reply with <a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/testkit/TestKit.html#expectMsgType[T](max:scala.concur [...]
+<p>Once again we take advantage of the facilities in <a href="testing.html">testkit</a> to verify expected behavior. Here using <code>testActor</code> as sender (via <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/testkit/ImplicitSender.html" title="pekko.testkit.ImplicitSender"><code>ImplicitSender</code></a>) and verifying the reply with <a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/testkit/TestKit.html#expectMsgType[T](max:scala.concur [...]
<p>In the above code you can see <code>node(third)</code>, which is useful facility to get the root actor reference of the actor system for a specific role. This can also be used to grab the <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Address.html" title="pekko.actor.Address"><code>actor.Address</code></a> of that node.</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/cluster-metrics/src/multi-jvm/scala/org/apache/pekko/cluster/metrics/sample/StatsSampleSpec.scala#L112-L114" target="_blank" title="Go to snippet source">source</a><code class="language-scala">val firstAddress = node(first).address
val secondAddress = node(second).address
@@ -1269,7 +1269,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/common/binary-compatibility-rules.html b/content/common/binary-compatibility-rules.html
index b4e9307..24d0235 100644
--- a/content/common/binary-compatibility-rules.html
+++ b/content/common/binary-compatibility-rules.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -588,7 +588,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/common/circuitbreaker.html b/content/common/circuitbreaker.html
index 93971ee..72c0614 100644
--- a/content/common/circuitbreaker.html
+++ b/content/common/circuitbreaker.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>A circuit breaker is used to provide stability and prevent cascading failures in distributed systems. These should be used in conjunction with judicious timeouts at the interfaces between remote systems to prevent the failure of a single component from bringing down all components.</p>
<p>As an example, we have a web application interacting with a remote third party web service.<br/>Let’s say the third party has oversold their capacity and their database melts down under load.<br/>Assume that the database fails in such a way that it takes a very long time to hand back an error to the third party web service. This in turn makes calls fail after a long period of time. Back to our web application, the users have noticed that their form submissions take much longer s [...]
<p>Introducing circuit breakers on the web service call would cause the requests to begin to fail-fast, letting the user know that something is wrong and that they need not refresh their request. This also confines the failure behavior to only those users that are using functionality dependent on the third party, other users are no longer affected as there is no resource exhaustion. Circuit breakers can also allow savvy developers to mark portions of the site that use the functionality u [...]
-<p>The Pekko library provides an implementation of a circuit breaker called <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><co [...]
+<p>The Pekko library provides an implementation of a circuit breaker called <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><co [...]
<h2><a href="#what-do-they-do-" name="what-do-they-do-" class="anchor"><span class="anchor-link"></span></a>What do they do?</h2>
<ul>
<li>
@@ -435,7 +435,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<li>
<p>While in <em>Open</em> state:</p>
<ul>
- <li>All calls fail-fast with a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreakerOpenException.html" title="org.apache.pekko.pattern.CircuitBreakerOpenException"><code>CircuitBreakerOpenException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreakerOpenException.html" title="org.apache.pekko.pattern.Circui [...]
+ <li>All calls fail-fast with a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreakerOpenException.html" title="org.apache.pekko.pattern.CircuitBreakerOpenException"><code>CircuitBreakerOpenException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreakerOpenException.html" title="org.apache.pekko.pattern.Circui [...]
<li>After the configured <em>resetTimeout</em>, the circuit breaker enters a <em>Half-Open</em> state</li>
</ul>
</li>
@@ -451,7 +451,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<li>
<p>State transition listeners:</p>
<ul>
- <li>Callbacks can be provided for every state entry via <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#onOpen(callback:=%3EUnit):org.apache.pekko.pattern.CircuitBreaker" title="org.apache.pekko.pattern.CircuitBreaker"><code>onOpen</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#addOnOpe [...]
+ <li>Callbacks can be provided for every state entry via <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#onOpen(callback:=%3EUnit):org.apache.pekko.pattern.CircuitBreaker" title="org.apache.pekko.pattern.CircuitBreaker"><code>onOpen</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#addOnOpe [...]
<li>These are executed in the <a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/ExecutionContext.html" title="scala.concurrent.ExecutionContext"><code>ExecutionContext</code></a> provided.</li>
</ul>
</li>
@@ -459,7 +459,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Calls result listeners:</p>
<ul>
<li>Callbacks can be used eg. to collect statistics about all invocations or to react on specific call results like success, failures or timeouts.</li>
- <li>Supported callbacks are: <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#onCallSuccess(callback:Long=%3EUnit):org.apache.pekko.pattern.CircuitBreaker" title="org.apache.pekko.pattern.CircuitBreaker"><code>onCallSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#addOnCallSuccessL [...]
+ <li>Supported callbacks are: <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#onCallSuccess(callback:Long=%3EUnit):org.apache.pekko.pattern.CircuitBreaker" title="org.apache.pekko.pattern.CircuitBreaker"><code>onCallSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#addOnCallSuccessL [...]
<li>These are executed in the <a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/ExecutionContext.html" title="scala.concurrent.ExecutionContext"><code>ExecutionContext</code></a> provided.</li>
</ul>
</li>
@@ -467,7 +467,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p><img src="../images/circuit-breaker-states.png" alt="circuit-breaker-states.png" /></p>
<h2><a href="#examples" name="examples" class="anchor"><span class="anchor-link"></span></a>Examples</h2>
<h3><a href="#initialization" name="initialization" class="anchor"><span class="anchor-link"></span></a>Initialization</h3>
-<p>Here’s how a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span> would be configure [...]
+<p>Here’s how a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span> would be configure [...]
<ul>
<li>5 maximum failures</li>
<li>a call timeout of 10 seconds</li>
@@ -567,7 +567,7 @@ public Receive createReceive() {
.build();
}</code></pre></dd>
</dl><div class="callout note "><div class="callout-title">Note</div>
-<p>Using the <span class="group-scala"><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker$.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker$.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span> [...]
+<p>Using the <span class="group-scala"><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker$.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker$.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span> [...]
<h3><a href="#control-failure-count-explicitly" name="control-failure-count-explicitly" class="anchor"><span class="anchor-link"></span></a>Control failure count explicitly</h3>
<p>By default, the circuit breaker treats <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Exception.html" title="java.lang.Exception"><code>Exception</code></a> as failure in synchronized API, or failed <span class="group-scala"><a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/Future.html" title="scala.concurrent.Future"><code>Future</code></a></span><span class="group-java"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.bas [...]
<p>All methods above accept an argument <code>defineFailureFn</code></p>
@@ -612,8 +612,8 @@ public int luckyNumber() {
</code></pre></dd>
</dl>
<h3><a href="#low-level-api" name="low-level-api" class="anchor"><span class="anchor-link"></span></a>Low level API</h3>
-<p>The low-level API allows you to describe the behavior of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBr [...]
-<p>As can be seen in the examples below, a <code>Tell Protection</code> pattern could be implemented by using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#succeed():Unit" title="org.apache.pekko.pattern.CircuitBreaker"><code>succeed</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#succee [...]
+<p>The low-level API allows you to describe the behavior of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBreaker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html" title="org.apache.pekko.pattern.CircuitBreaker"><code>CircuitBr [...]
+<p>As can be seen in the examples below, a <code>Tell Protection</code> pattern could be implemented by using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#succeed():Unit" title="org.apache.pekko.pattern.CircuitBreaker"><code>succeed</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/CircuitBreaker.html#succee [...]
<p>The below example doesn’t make a remote call when the state is <em>HalfOpen</em>. Using the power-user APIs, it is your responsibility to judge when to make remote calls in <em>HalfOpen</em>.</p></div>
<dl>
<dt>Scala</dt>
@@ -735,7 +735,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/common/io-layer.html b/content/common/io-layer.html
index 9116e66..2f56ae8 100644
--- a/content/common/io-layer.html
+++ b/content/common/io-layer.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -431,7 +431,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<li>extensibility for integrating new transports by way of a very lean SPI; the goal is to not force I/O mechanisms into a lowest common denominator but instead allow completely protocol-specific user-level APIs.</li>
</ul>
<h2><a href="#basic-architecture" name="basic-architecture" class="anchor"><span class="anchor-link"></span></a>Basic Architecture</h2>
-<p>Each transport implementation will be made available as a separate Pekko extension, offering an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</co [...]
+<p>Each transport implementation will be made available as a separate Pekko extension, offering an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</co [...]
<p>The central element of the implementation is the transport-specific “selector” actor; in the case of TCP this would wrap a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/nio/channels/Selector.html" title="java.nio.channels.Selector"><code>java.nio.channels.Selector</code></a>. The channel actors register their interest in readability or writability of their channel by sending corresponding messages to their assigned selector actor. However, the actual chann [...]
<p>The assignment of channels to selectors is performed by the manager actor and remains unchanged for the entire lifetime of a channel. Thereby the management actor “stripes” new channels across one or more selector actors based on some implementation-specific distribution logic. This logic may be delegated (in part) to the selectors actors, which could, for example, choose to reject the assignment of a new channel when they consider themselves to be at capacity.</p>
<p>The manager actor creates (and therefore supervises) the selector actors, which in turn create and supervise their channel actors. The actor hierarchy of one single transport implementation therefore consists of three distinct actor levels, with the management actor at the top-, the channel actors at the leaf- and the selector actors at the mid-level.</p>
@@ -439,7 +439,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h2><a href="#design-benefits" name="design-benefits" class="anchor"><span class="anchor-link"></span></a>Design Benefits</h2>
<p>Staying within the actor model for the whole implementation allows us to remove the need for explicit thread handling logic, and it also means that there are no locks involved (besides those which are part of the underlying transport library). Writing only actor code results in a cleaner implementation, while Pekko’s efficient actor messaging does not impose a high tax for this benefit. In fact the event-based nature of I/O maps so well to the actor model that we expect clear performa [...]
<p>Another benefit of supervision hierarchies is that clean-up of resources comes naturally: shutting down a selector actor will automatically clean up all channel actors, allowing proper closing of the channels and sending the appropriate messages to user-level client actors. DeathWatch allows the channel actors to notice the demise of their user-level handler actors and terminate in an orderly fashion in that case as well; this naturally reduces the chances of leaking open channels.</p>
-<p>The choice of using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> for exposing all functionality entails that these references [...]
+<p>The choice of using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> for exposing all functionality entails that these references [...]
<h2><a href="#how-to-go-about-adding-a-new-transport" name="how-to-go-about-adding-a-new-transport" class="anchor"><span class="anchor-link"></span></a>How to go about Adding a New Transport</h2>
<p>The best start is to study the TCP reference implementation to get a good grip on the basic working principle and then design an implementation, which is similar in spirit, but adapted to the new protocol in question. There are vast differences between I/O mechanisms (e.g. compare file I/O to a message broker) and the goal of this I/O layer is explicitly <strong>not</strong> to shoehorn all of them into a uniform API, which is why only the basic architecture ideas are documented here.</p>
<div class="source-github">
@@ -529,7 +529,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/common/may-change.html b/content/common/may-change.html
index 802e08c..184fdf7 100644
--- a/content/common/may-change.html
+++ b/content/common/may-change.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -504,7 +504,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/common/other-modules.html b/content/common/other-modules.html
index 7a5d3a8..1a1cac1 100644
--- a/content/common/other-modules.html
+++ b/content/common/other-modules.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -548,7 +548,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/coordinated-shutdown.html b/content/coordinated-shutdown.html
index e4d2cac..4a1c2a0 100644
--- a/content/coordinated-shutdown.html
+++ b/content/coordinated-shutdown.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#coordinated-shutdown" name="coordinated-shutdown" class="anchor"><span class="anchor-link"></span></a>Coordinated Shutdown</h1>
<p>Under normal conditions, when an <code>ActorSystem</code> is terminated or the JVM process is shut down, certain actors and services will be stopped in a specific order. </p>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/CoordinatedShutdown$.html" title="org.apache.pekko.actor.CoordinatedShutdown"><code>CoordinatedShutdown</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/CoordinatedShutdown$.html" title="org.apache.pekko.actor.CoordinatedShutdown"><code>CoordinatedShutdown</code></a></span> extension [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/CoordinatedShutdown$.html" title="org.apache.pekko.actor.CoordinatedShutdown"><code>CoordinatedShutdown</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/CoordinatedShutdown$.html" title="org.apache.pekko.actor.CoordinatedShutdown"><code>CoordinatedShutdown</code></a></span> extension [...]
<p>Especially the phases <code>before-service-unbind</code>, <code>before-cluster-shutdown</code> and <code>before-actor-system-terminate</code> are intended for application specific phases or tasks.</p>
<p>The order of the shutdown phases is defined in configuration <code>pekko.coordinated-shutdown.phases</code>. See the default phases in the <code>reference.conf</code> tab:</p>
<dl>
@@ -661,7 +661,7 @@ cancellable.cancel();</code></pre></dd>
Optional.of("stop"));</code></pre></dd>
</dl>
<p>Tasks should typically be registered as early as possible after system startup. When running the coordinated shutdown tasks that have been registered will be performed but tasks that are added too late will not be run.</p>
-<p>To start the coordinated shutdown process you can either invoke <code>terminate()</code> on the <code>ActorSystem</code>, or <span class="group-scala"><code>run</code></span> <span class="group-java"><code>runAll</code></span> on the <code>CoordinatedShutdown</code> extension and pass it a class implementing <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/CoordinatedShutdown$$Reason.html" title="org.apache.pekko.acto [...]
+<p>To start the coordinated shutdown process you can either invoke <code>terminate()</code> on the <code>ActorSystem</code>, or <span class="group-scala"><code>run</code></span> <span class="group-java"><code>runAll</code></span> on the <code>CoordinatedShutdown</code> extension and pass it a class implementing <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/CoordinatedShutdown$$Reason.html" title="org.apache.pekko.acto [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -787,7 +787,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/coordination.html b/content/coordination.html
index 0bb457c..b424623 100644
--- a/content/coordination.html
+++ b/content/coordination.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,12 +418,12 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#coordination" name="coordination" class="anchor"><span class="anchor-link"></span></a>Coordination</h1>
<p>Pekko Coordination is a set of tools for distributed coordination.</p>
-<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-coordination" % PekkoVersion</code></pre></dd><dt>Gradle</dt><dd><pre class="prettyprint"><code class="language-gradle">def versions = [
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-coordination_${versions.ScalaBinary}"
}</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
@@ -434,7 +434,7 @@ dependencies {
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -450,7 +450,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Coordination</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-coordination</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -720,7 +720,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/discovery/index.html b/content/discovery/index.html
index 423e3e5..87452c6 100644
--- a/content/discovery/index.html
+++ b/content/discovery/index.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -431,12 +431,12 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<li><a href="https://doc.akka.io/docs/akka-management/current/discovery/consul.html">Consul</a></li>
<li><a href="https://doc.akka.io/docs/akka-management/current/discovery/marathon.html">Marathon API</a></li>
</ul>
-<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-discovery" % PekkoVersion</code></pre></dd><dt>Gradle</dt><dd><pre class="prettyprint"><code class="language-gradle">def versions = [
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-discovery_${versions.ScalaBinary}"
}</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
@@ -447,7 +447,7 @@ dependencies {
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -463,7 +463,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Discovery</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-discovery</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -777,7 +777,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/dispatchers.html b/content/dispatchers.html
index 6197272..ad17cba 100644
--- a/content/dispatchers.html
+++ b/content/dispatchers.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the full documentation of this feature and for new projects see <a href="typed/dispatchers.html">Dispatchers</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>Dispatchers are part of core Pekko, which means that they are part of the pekko-actor dependency:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>Dispatchers are part of core Pekko, which means that they are part of the pekko-actor dependency:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -465,7 +465,7 @@ implicit val executionContext = system.dispatchers.lookup("my-dispatcher&qu
final ExecutionContextExecutor ex = system.dispatchers().lookup("my-dispatcher");</code></pre></dd>
</dl>
<h2><a href="#setting-the-dispatcher-for-an-actor" name="setting-the-dispatcher-for-an-actor" class="anchor"><span class="anchor-link"></span></a>Setting the dispatcher for an Actor</h2>
-<p>So in case you want to give your <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> a different dispatcher than the default, you need to do two things [...]
+<p>So in case you want to give your <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span> a different dispatcher than the default, you need to do two things [...]
<!--same config text for Scala & Java-->
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/dispatcher/DispatcherDocSpec.scala#L58-L76" target="_blank" title="Go to snippet source">source</a><code class="language-scala">my-dispatcher {
# Dispatcher is the name of the event-based dispatcher
@@ -527,7 +527,7 @@ val myActor =
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/dispatcher/DispatcherDocTest.java#L74-L75" target="_blank" title="Go to snippet source">source</a><code class="language-java">ActorRef myActor =
system.actorOf(Props.create(MyActor.class).withDispatcher("my-dispatcher"), "myactor3");</code></pre></dd>
</dl><div class="callout note "><div class="callout-title">Note</div>
-<p>The dispatcher you specify in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html#withDispatcher(d:String):org.apache.pekko.actor.Props" title="org.apache.pekko.actor.Props"><code>withDispatcher</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html#withDispatcher(java.lang.String)" title="org.apache.pekko.actor.Props"><co [...]
+<p>The dispatcher you specify in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html#withDispatcher(d:String):org.apache.pekko.actor.Props" title="org.apache.pekko.actor.Props"><code>withDispatcher</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html#withDispatcher(java.lang.String)" title="org.apache.pekko.actor.Props"><co [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/dispatchers.md">here</a>.
</div>
@@ -614,7 +614,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/distributed-data.html b/content/distributed-data.html
index ce761f9..7837505 100644
--- a/content/distributed-data.html
+++ b/content/distributed-data.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the full documentation of this feature and for new projects see <a href="typed/distributed-data.html">Distributed Data</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Pekko Distributed Data, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Distributed Data, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-distributed-data" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-distributed-data" % PekkoVer
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,16 +445,16 @@ libraryDependencies += "org.apache.pekko" %% "pekko-distributed-data" % PekkoVer
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-distributed-data_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#introduction" name="introduction" class="anchor"><span class="anchor-link"></span></a>Introduction</h2>
<p>For the full documentation of this feature and for new projects see <a href="typed/distributed-data.html#introduction">Distributed Data - Introduction</a>.</p>
<h2><a href="#using-the-replicator" name="using-the-replicator" class="anchor"><span class="anchor-link"></span></a>Using the Replicator</h2>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.ddata.Replicator"><code>Replicator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.ddata.Replicator"><code>Replicator</code></a></span> actor provides the API for intera [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.ddata.Replicator"><code>Replicator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.ddata.Replicator"><code>Replicator</code></a></span> actor provides the API for intera [...]
<p>Cluster members with status <a href="typed/cluster-membership.html#weakly-up">WeaklyUp</a>, will participate in Distributed Data. This means that the data will be replicated to the <code>WeaklyUp</code> nodes with the background gossip protocol. Note that it will not participate in any actions where the consistency mode is to read/write from all nodes or the majority of nodes. The <code>WeaklyUp</code> node is not counted as part of the cluster. So 3 nodes + 5 <code>WeaklyUp</code> is [...]
-<p>Below is an example of an actor that schedules tick messages to itself and for each tick adds or removes elements from a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/ORSet.html" title="org.apache.pekko.cluster.ddata.ORSet"><code>ORSet</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/ORSet.html" title="org.apache.pek [...]
+<p>Below is an example of an actor that schedules tick messages to itself and for each tick adds or removes elements from a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/ORSet.html" title="org.apache.pekko.cluster.ddata.ORSet"><code>ORSet</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/ORSet.html" title="org.apache.pek [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -609,10 +609,10 @@ public class DataBot extends AbstractActor {
<a id="replicator-update"></a>
<h3><a href="#update" name="update" class="anchor"><span class="anchor-link"></span></a>Update</h3>
<p>For the full documentation of this feature and for new projects see <a href="typed/distributed-data.html#update">Distributed Data - Update</a>.</p>
-<p>To modify and replicate a data value you send a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Update"><code>Replicator.Update</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replic [...]
+<p>To modify and replicate a data value you send a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Update"><code>Replicator.Update</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replic [...]
<p>The current data value for the <code>key</code> of the <code>Update</code> is passed as parameter to the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/cluster/ddata/Replicator$$Update.html#modify:Option[A]=%3EA" title="pekko.cluster.ddata.Replicator.Update"><code>modify</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/cluster/ddata/Replicator.Update.html#modify()" title="pekko.cluster.ddata.Rep [...]
<p>The <code>modify</code> function is called by the <code>Replicator</code> actor and must therefore be a pure function that only uses the data parameter and stable fields from enclosing scope. It must for example not access the sender (<span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#sender():org.apache.pekko.actor.ActorRef" title="pekko.actor.Actor"><code>sender()</code></a></span><span class="group-java"><a href="https://doc.akka.i [...]
-<p><code>Update</code> is intended to only be sent from an actor running in same local <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSyst [...]
+<p><code>Update</code> is intended to only be sent from an actor running in same local <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSyst [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -683,7 +683,7 @@ replicator ! Update(ActiveFlagKey, Flag.Disabled, writeAll)(_.switchOn)</code></
}
}</code></pre></dd>
</dl>
-<p>As reply of the <code>Update</code> a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$UpdateSuccess.html" title="org.apache.pekko.cluster.ddata.Replicator.UpdateSuccess"><code>Replicator.UpdateSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$UpdateSuccess.html" title="org.apache.pekko.cl [...]
+<p>As reply of the <code>Update</code> a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$UpdateSuccess.html" title="org.apache.pekko.cluster.ddata.Replicator.UpdateSuccess"><code>Replicator.UpdateSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$UpdateSuccess.html" title="org.apache.pekko.cl [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -718,9 +718,9 @@ case UpdateTimeout(Set1Key, req) =>
// write to 3 nodes failed within 1.second
});</code></pre></dd>
</dl>
-<p>You will always see your own writes. For example if you send two <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Update"><code>Replicator.Update</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.clu [...]
-<p>It is possible to abort the <code>Update</code> when inspecting the state parameter that is passed in to the <code>modify</code> function by throwing an exception. That happens before the update is performed and a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$ModifyFailure.html" title="org.apache.pekko.cluster.ddata.Replicator.ModifyFailure"><code>Replicator.ModifyFailure</code></a></span><span [...]
-<p>In the <code>Update</code> message you can pass an optional request context, which the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.ddata.Replicator"><code>Replicator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.dda [...]
+<p>You will always see your own writes. For example if you send two <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Update"><code>Replicator.Update</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.clu [...]
+<p>It is possible to abort the <code>Update</code> when inspecting the state parameter that is passed in to the <code>modify</code> function by throwing an exception. That happens before the update is performed and a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$ModifyFailure.html" title="org.apache.pekko.cluster.ddata.Replicator.ModifyFailure"><code>Replicator.ModifyFailure</code></a></span><span [...]
+<p>In the <code>Update</code> message you can pass an optional request context, which the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.ddata.Replicator"><code>Replicator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator.html" title="org.apache.pekko.cluster.dda [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -788,7 +788,7 @@ def receive: Receive = {
<a id="replicator-get"></a>
<h3><a href="#get" name="get" class="anchor"><span class="anchor-link"></span></a>Get</h3>
<p>For the full documentation of this feature and for new projects see <a href="typed/distributed-data.html#get">Distributed Data - Get</a>.</p>
-<p>To retrieve the current value of a data you send <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get"><code>Replicator.Get</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get">< [...]
+<p>To retrieve the current value of a data you send <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get"><code>Replicator.Get</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get">< [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -841,7 +841,7 @@ replicator ! Get(ActiveFlagKey, readAll)</code></pre></dd>
}
}</code></pre></dd>
</dl>
-<p>As reply of the <code>Get</code> a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$GetSuccess.html" title="org.apache.pekko.cluster.ddata.Replicator.GetSuccess"><code>Replicator.GetSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$GetSuccess.html" title="org.apache.pekko.cluster.ddata.Rep [...]
+<p>As reply of the <code>Get</code> a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$GetSuccess.html" title="org.apache.pekko.cluster.ddata.Replicator.GetSuccess"><code>Replicator.GetSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$GetSuccess.html" title="org.apache.pekko.cluster.ddata.Rep [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -894,7 +894,7 @@ case NotFound(Set1Key, req) => // key set1 does not exist</code></pre></dd>
// key set1 does not exist
});</code></pre></dd>
</dl>
-<p>In the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get"><code>Replicator.Get</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get"><code>Replicator.Get</code></a></span> mess [...]
+<p>In the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get"><code>Replicator.Get</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Get.html" title="org.apache.pekko.cluster.ddata.Replicator.Get"><code>Replicator.Get</code></a></span> mess [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -964,8 +964,8 @@ def receive: Receive = {
</dl>
<h3><a href="#subscribe" name="subscribe" class="anchor"><span class="anchor-link"></span></a>Subscribe</h3>
<p>For the full documentation of this feature and for new projects see <a href="typed/distributed-data.html#subscribe">Distributed Data - Subscribe</a>.</p>
-<p>You may also register interest in change notifications by sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Subscribe.html" title="org.apache.pekko.cluster.ddata.Replicator.Subscribe"><code>Replicator.Subscribe</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Subscribe.html" title="org.apa [...]
-<p>The subscriber is automatically removed if the subscriber is terminated. A subscriber can also be deregistered with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Unsubscribe.html" title="org.apache.pekko.cluster.ddata.Replicator.Unsubscribe"><code>Replicator.Unsubscribe</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pe [...]
+<p>You may also register interest in change notifications by sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Subscribe.html" title="org.apache.pekko.cluster.ddata.Replicator.Subscribe"><code>Replicator.Subscribe</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Subscribe.html" title="org.apa [...]
+<p>The subscriber is automatically removed if the subscriber is terminated. A subscriber can also be deregistered with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Unsubscribe.html" title="org.apache.pekko.cluster.ddata.Replicator.Unsubscribe"><code>Replicator.Unsubscribe</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pe [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1019,7 +1019,7 @@ def receive: Receive = {
</dl>
<h3><a href="#consistency" name="consistency" class="anchor"><span class="anchor-link"></span></a>Consistency</h3>
<p>For the full documentation of this feature and for new projects see <a href="typed/distributed-data.html#consistency">Distributed Data Consistency</a>.</p>
-<p>Here is an example of using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$WriteMajority.html" title="org.apache.pekko.cluster.ddata.Replicator.WriteMajority"><code>Replicator.WriteMajority</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$WriteMajority.html" title="org.apache.pekko.cluster.ddat [...]
+<p>Here is an example of using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$WriteMajority.html" title="org.apache.pekko.cluster.ddata.Replicator.WriteMajority"><code>Replicator.WriteMajority</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$WriteMajority.html" title="org.apache.pekko.cluster.ddat [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1123,7 +1123,7 @@ private void receiveAddItem(AddItem add) {
}
</code></pre></dd>
</dl>
-<p>In some rare cases, when performing an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Update"><code>Replicator.Update</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Upda [...]
+<p>In some rare cases, when performing an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Update"><code>Replicator.Update</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/Replicator$$Update.html" title="org.apache.pekko.cluster.ddata.Replicator.Upda [...]
<p>The following example illustrates how to do that:</p>
<dl>
<dt>Scala</dt>
@@ -1218,7 +1218,7 @@ replicator ! Delete(Set2Key, writeMajority)</code></pre></dd>
}
}</code></pre></dd>
</dl><div class="callout warning "><div class="callout-title">Warning</div>
-<p>As deleted keys continue to be included in the stored data on each node as well as in gossip messages, a continuous series of updates and deletes of top-level entities will result in growing memory usage until an ActorSystem runs out of memory. To use Pekko Distributed Data where frequent adds and removes are required, you should use a fixed number of top-level data types that support both updates and removals, for example <span class="group-scala"><a href="https://doc.akka.io/api/akk [...]
+<p>As deleted keys continue to be included in the stored data on each node as well as in gossip messages, a continuous series of updates and deletes of top-level entities will result in growing memory usage until an ActorSystem runs out of memory. To use Pekko Distributed Data where frequent adds and removes are required, you should use a fixed number of top-level data types that support both updates and removals, for example <span class="group-scala"><a href="https://doc.akka.io/api/akk [...]
<h2><a href="#replicated-data-types" name="replicated-data-types" class="anchor"><span class="anchor-link"></span></a>Replicated data types</h2>
<p>Pekko contains a set of useful replicated data types and it is fully possible to implement custom replicated data types. For the full documentation of this feature and for new projects see <a href="typed/distributed-data.html#replicated-data-types">Distributed Data Replicated data types</a>.</p>
<h3><a href="#delta-crdt" name="delta-crdt" class="anchor"><span class="anchor-link"></span></a>Delta-CRDT</h3>
@@ -1236,7 +1236,7 @@ replicator ! Delete(Set2Key, writeMajority)</code></pre></dd>
<li><a href="https://hal.inria.fr/file/index/docid/555588/filename/techreport.pdf">A comprehensive study of Convergent and Commutative Replicated Data Types</a> paper by Mark Shapiro et. al.</li>
</ul>
<h2><a href="#configuration" name="configuration" class="anchor"><span class="anchor-link"></span></a>Configuration</h2>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/DistributedData.html" title="org.apache.pekko.cluster.ddata.DistributedData"><code>DistributedData</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ddata/DistributedData.html" title="org.apache.pekko.cluster.ddata.DistributedData"><code>DistributedData</code></a></span> ext [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/DistributedData.html" title="org.apache.pekko.cluster.ddata.DistributedData"><code>DistributedData</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ddata/DistributedData.html" title="org.apache.pekko.cluster.ddata.DistributedData"><code>DistributedData</code></a></span> ext [...]
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/distributed-data/src/main/resources/reference.conf#L10-L142" target="_blank" title="Go to snippet source">source</a><code class="language-conf"># Settings for the DistributedData extension
pekko.cluster.distributed-data {
# Actor name of the Replicator actor, /system/ddataReplicator
@@ -1461,7 +1461,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/distributed-pub-sub.html b/content/distributed-pub-sub.html
index 35467b8..444cf6b 100644
--- a/content/distributed-pub-sub.html
+++ b/content/distributed-pub-sub.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the new API see <a href="typed/distributed-pub-sub.html">Distributed Publish Subscribe in Cluster</a> </p>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Distributed Publish Subscribe you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Distributed Publish Subscribe you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersio
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster-tools" % PekkoVersio
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster-tools_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -453,7 +453,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Cluster Tools (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-cluster-tools</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -482,9 +482,9 @@ dependencies {
<p>How do I send messages to all actors in the cluster that have registered interest in a named topic?</p>
-<p>This pattern provides a mediator actor, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator"><code>cluster.pubsub.DistributedPubSubMediator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator.html" titl [...]
+<p>This pattern provides a mediator actor, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator"><code>cluster.pubsub.DistributedPubSubMediator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator.html" titl [...]
-<p>The <code>DistributedPubSubMediator</code> actor is supposed to be started on all nodes, or all nodes with specified role, in the cluster. The mediator can be started with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSub.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSub"><code>DistributedPubSub</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0 [...]
+<p>The <code>DistributedPubSubMediator</code> actor is supposed to be started on all nodes, or all nodes with specified role, in the cluster. The mediator can be started with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSub.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSub"><code>DistributedPubSub</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0 [...]
<p>The registry is eventually consistent, i.e. changes are not immediately visible at other nodes, but typically they will be fully replicated to all other nodes after a few seconds. Changes are only performed in the own part of the registry and those changes are versioned. Deltas are disseminated in a scalable way to other nodes with a gossip protocol.</p>
@@ -500,8 +500,8 @@ dependencies {
<p>This is the true pub/sub mode. A typical usage of this mode is a chat room in an instant messaging application.</p>
<p>Actors are registered to a named topic. This enables many subscribers on each node. The message will be delivered to all subscribers of the topic.</p>
<p>For efficiency the message is sent over the wire only once per node (that has a matching topic), and then delivered to all subscribers of the local topic representation.</p>
-<p>You register actors to the local mediator with <code>DistributedPubSubMediator.Subscribe</code>. Successful <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Subscribe.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Subscribe"><code>DistributedPubSubMediator.Subscribe</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d [...]
-<p>You publish messages by sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Publish.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Publish"><code>DistributedPubSubMediator.Publish</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Publish [...]
+<p>You register actors to the local mediator with <code>DistributedPubSubMediator.Subscribe</code>. Successful <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Subscribe.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Subscribe"><code>DistributedPubSubMediator.Subscribe</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec [...]
+<p>You publish messages by sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Publish.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Publish"><code>DistributedPubSubMediator.Publish</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Publish [...]
<p>Actors are automatically removed from the registry when they are terminated, or you can explicitly remove entries with <code>DistributedPubSubMediator.Unsubscribe</code>.</p>
<p>An example of a subscriber actor:</p>
<dl>
@@ -612,17 +612,17 @@ ActorRef publisher = system.actorOf(Props.create(Publisher.class), "publish
publisher.tell("hello", null);</code></pre></dd>
</dl>
<h3><a href="#topic-groups" name="topic-groups" class="anchor"><span class="anchor-link"></span></a>Topic Groups</h3>
-<p>Actors may also be subscribed to a named topic with a <code>group</code> id. If subscribing with a group id, each message published to a topic with the <code>sendOneMessageToEachGroup</code> flag set to <code>true</code> is delivered via the supplied <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span><span class="group [...]
-<p>If all the subscribed actors have the same group id, then this works just like <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Send.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Send"><code>DistributedPubSubMediator.Send</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pub [...]
-<p>If all the subscribed actors have different group names, then this works like normal <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Publish.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Publish"><code>DistributedPubSubMediator.Publish</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pe [...]
+<p>Actors may also be subscribed to a named topic with a <code>group</code> id. If subscribing with a group id, each message published to a topic with the <code>sendOneMessageToEachGroup</code> flag set to <code>true</code> is delivered via the supplied <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span><span class="group [...]
+<p>If all the subscribed actors have the same group id, then this works just like <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Send.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Send"><code>DistributedPubSubMediator.Send</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pub [...]
+<p>If all the subscribed actors have different group names, then this works like normal <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Publish.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Publish"><code>DistributedPubSubMediator.Publish</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pe [...]
<p>Note that if the group id is used it is part of the topic identifier. Messages published with <code>sendOneMessageToEachGroup=false</code> will not be delivered to subscribers that subscribed with a group id. Messages published with <code>sendOneMessageToEachGroup=true</code> will not be delivered to subscribers that subscribed without a group id.</p></div>
<a id="distributed-pub-sub-send"></a>
<h2><a href="#send" name="send" class="anchor"><span class="anchor-link"></span></a>Send</h2>
<p>This is a point-to-point mode where each message is delivered to one destination, but you still do not have to know where the destination is located. A typical usage of this mode is private chat to one other user in an instant messaging application. It can also be used for distributing tasks to registered workers, like a cluster aware router where the routees dynamically can register themselves.</p>
-<p>The message will be delivered to one recipient with a matching path, if any such exists in the registry. If several entries match the path because it has been registered on several nodes the message will be sent via the supplied <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span><span class="group-java"><a href="https: [...]
-<p>You register actors to the local mediator with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Put.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Put"><code>DistributedPubSubMediator.Put</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Put. [...]
-<p>You send messages by sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Send.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Send"><code>DistributedPubSubMediator.Send</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Send.html" title="o [...]
-<p>Actors are automatically removed from the registry when they are terminated, or you can explicitly remove entries with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Remove.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Remove"><code>DistributedPubSubMediator.Remove</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532- [...]
+<p>The message will be delivered to one recipient with a matching path, if any such exists in the registry. If several entries match the path because it has been registered on several nodes the message will be sent via the supplied <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span><span class="group-java"><a href="https: [...]
+<p>You register actors to the local mediator with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Put.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Put"><code>DistributedPubSubMediator.Put</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Put. [...]
+<p>You send messages by sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Send.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Send"><code>DistributedPubSubMediator.Send</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Send.html" title="o [...]
+<p>Actors are automatically removed from the registry when they are terminated, or you can explicitly remove entries with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Remove.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Remove"><code>DistributedPubSubMediator.Remove</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533- [...]
<p>An example of a destination actor:</p>
<dl>
<dt>Scala</dt>
@@ -727,10 +727,10 @@ ActorRef sender = system.actorOf(Props.create(Publisher.class), "sender&quo
// after a while the destinations are replicated
sender.tell("hello", null);</code></pre></dd>
</dl>
-<p>It is also possible to broadcast messages to the actors that have been registered with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Put.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Put"><code>DistributedPubSubMediator.Put</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluste [...]
+<p>It is also possible to broadcast messages to the actors that have been registered with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSubMediator$$Put.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSubMediator.Put"><code>DistributedPubSubMediator.Put</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluste [...]
<p>Typical usage of this mode is to broadcast messages to all replicas with the same path, e.g. 3 actors on different nodes that all perform the same actions, for redundancy. You can also optionally specify a property (<code>allButSelf</code>) deciding if the message should be sent to a matching path on the self node or not.</p>
<h2><a href="#distributedpubsub-extension" name="distributedpubsub-extension" class="anchor"><span class="anchor-link"></span></a>DistributedPubSub Extension</h2>
-<p>In the example above the mediator is started and accessed with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSub.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSub"><code>cluster.pubsub.DistributedPubSub</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSub.html" title="or [...]
+<p>In the example above the mediator is started and accessed with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSub.html" title="org.apache.pekko.cluster.pubsub.DistributedPubSub"><code>cluster.pubsub.DistributedPubSub</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/pubsub/DistributedPubSub.html" title="or [...]
<p>The <code>DistributedPubSub</code> extension can be configured with the following properties:</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/cluster-tools/src/main/resources/reference.conf#L9-L38" target="_blank" title="Go to snippet source">source</a><code class="language-conf"># Settings for the DistributedPubSub extension
pekko.cluster.pub-sub {
@@ -857,7 +857,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/durable-state/persistence-query.html b/content/durable-state/persistence-query.html
index a10fa92..4b814d6 100644
--- a/content/durable-state/persistence-query.html
+++ b/content/durable-state/persistence-query.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#persistence-query" name="persistence-query" class="anchor"><span class="anchor-link"></span></a>Persistence Query</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Persistence Query, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Persistence Query, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVe
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVe
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-persistence-query_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -492,7 +492,7 @@ source.map(
}
});</code></pre></dd>
</dl>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/DurableStateChange.html" title="org.apache.pekko.persistence.query.DurableStateChange"><code>DurableStateChange</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/DurableStateChange.html" title="org.apache.pekko.persistence.query.DurableStateChange"><code>Durabl [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/DurableStateChange.html" title="org.apache.pekko.persistence.query.DurableStateChange"><code>DurableStateChange</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/DurableStateChange.html" title="org.apache.pekko.persistence.query.DurableStateChange"><code>Durabl [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/durable-state/persistence-query.md">here</a>.
</div>
@@ -579,7 +579,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/event-bus.html b/content/event-bus.html
index 1f7cb7e..db9e0fc 100644
--- a/content/event-bus.html
+++ b/content/event-bus.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -482,7 +482,7 @@ public void publish(Event event);
<h2><a href="#classifiers" name="classifiers" class="anchor"><span class="anchor-link"></span></a>Classifiers</h2>
<p>The classifiers presented here are part of the Pekko distribution, but rolling your own in case you do not find a perfect match is not difficult, check the implementation of the existing ones on <a href="https://github.com/akka/akka/tree/main/pekko-actor/src/main/scala/org/apache/pekko/event/EventBus.scala">github</a> </p>
<h3><a href="#lookup-classification" name="lookup-classification" class="anchor"><span class="anchor-link"></span></a>Lookup Classification</h3>
-<p>The simplest classification is just to extract an arbitrary classifier from each event and maintaining a set of subscribers for each possible classifier. This can be compared to tuning in on a radio station. The <span class="group-scala">trait <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/event/LookupClassification.html" title="pekko.event.LookupClassification"><code>LookupClassification</code></a></span><span class="group-java">abstract class <a href="https://doc.akka.io [...]
+<p>The simplest classification is just to extract an arbitrary classifier from each event and maintaining a set of subscribers for each possible classifier. This can be compared to tuning in on a radio station. The <span class="group-scala">trait <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/event/LookupClassification.html" title="pekko.event.LookupClassification"><code>LookupClassification</code></a></span><span class="group-java">abstract class <a href="https://doc.akka.io [...]
<p>The necessary methods to be implemented are illustrated with the following example:</p>
<dl>
<dt>Scala</dt>
@@ -794,8 +794,8 @@ expectMsgEquals("abc");</code></pre></dd>
</dl>
<p>This classifier takes always a time which is proportional to the number of subscriptions, independent of how many actually match.</p>
<h3><a href="#actor-classification" name="actor-classification" class="anchor"><span class="anchor-link"></span></a>Actor Classification</h3>
-<p>This classification was originally developed specifically for implementing <a href="actors.html#deathwatch">DeathWatch</a>: subscribers as well as classifiers are of type <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/acto [...]
-<p>This classification requires an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> in order to perform book-keepin [...]
+<p>This classification was originally developed specifically for implementing <a href="actors.html#deathwatch">DeathWatch</a>: subscribers as well as classifiers are of type <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/acto [...]
+<p>This classification requires an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> in order to perform book-keepin [...]
<p>The necessary methods to be implemented are illustrated with the following example:</p>
<dl>
<dt>Scala</dt>
@@ -898,7 +898,7 @@ probe1.expectNoMessage(Duration.ofMillis(500));</code></pre></dd>
</dl>
<p>This classifier is still is generic in the event type, and it is efficient for all use cases.</p>
<h2><a href="#event-stream" name="event-stream" class="anchor"><span class="anchor-link"></span></a>Event Stream</h2>
-<p>The event stream is the main event bus of each actor system: it is used for carrying <a href="logging.html">log messages</a> and <a href="event-bus.html#dead-letters">Dead Letters</a> and may be used by the user code for other purposes as well. It uses <a href="event-bus.html#subchannel-classification">Subchannel Classification</a> which enables registering to related sets of channels (as is used for <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297- [...]
+<p>The event stream is the main event bus of each actor system: it is used for carrying <a href="logging.html">log messages</a> and <a href="event-bus.html#dead-letters">Dead Letters</a> and may be used by the user code for other purposes as well. It uses <a href="event-bus.html#subchannel-classification">Subchannel Classification</a> which enables registering to related sets of channels (as is used for <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528- [...]
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/event/LoggingDocSpec.scala#L131-L180" target="_blank" title="Go to snippet source">source</a><code class="language-scala">import org.apache.pekko.actor.{ Actor, DeadLetter, Props }
class DeadLetterListener extends Actor {
@@ -1000,7 +1000,7 @@ static class Listener extends AbstractActor {
system.getEventStream().publish(new Jazz("Sonny Rollins"));
</code></pre></dd>
</dl>
-<p>Similarly to <a href="event-bus.html#actor-classification">Actor Classification</a>, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/EventStream.html" title="org.apache.pekko.event.EventStream"><code>EventStream</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/EventStream.html" title="org.apache.pekko.event.EventStream"><code>EventStr [...]
+<p>Similarly to <a href="event-bus.html#actor-classification">Actor Classification</a>, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/EventStream.html" title="org.apache.pekko.event.EventStream"><code>EventStream</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/EventStream.html" title="org.apache.pekko.event.EventStream"><code>EventStr [...]
<p>The event stream is a <em>local facility</em>, meaning that it will <em>not</em> distribute events to other nodes in a clustered environment (unless you subscribe a Remote Actor to the stream explicitly). If you need to broadcast events in a Pekko cluster, <em>without</em> knowing your recipients explicitly (i.e. obtaining their ActorRefs), you may want to look into: <a href="distributed-pub-sub.html">Distributed Publish Subscribe in Cluster</a>.</p></div>
<h3><a href="#default-handlers" name="default-handlers" class="anchor"><span class="anchor-link"></span></a>Default Handlers</h3>
<p>Upon start-up the actor system creates and subscribes actors to the event stream for logging: these are the handlers which are configured for example in <code>application.conf</code>:</p>
@@ -1021,8 +1021,8 @@ static class Listener extends AbstractActor {
</dl>
<p>This means that log events for a level which will not be logged are typically not dispatched at all (unless manual subscriptions to the respective event class have been done)</p>
<h3><a href="#dead-letters" name="dead-letters" class="anchor"><span class="anchor-link"></span></a>Dead Letters</h3>
-<p>As described at <a href="actors.html#stopping-actors">Stopping actors</a>, messages queued when an actor terminates or sent after its death are re-routed to the dead letter mailbox, which by default will publish the messages wrapped in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/DeadLetter.html" title="org.apache.pekko.actor.DeadLetter"><code>DeadLetter</code></a></span><span class="group-java"><a href="https://d [...]
-<p>Some internal messages (marked with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/DeadLetterSuppression.html" title="org.apache.pekko.actor.DeadLetterSuppression"><code>DeadLetterSuppression</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/DeadLetterSuppression.html" title="org.apache.pekko.actor.DeadLetterSuppression"><code>Dea [...]
+<p>As described at <a href="actors.html#stopping-actors">Stopping actors</a>, messages queued when an actor terminates or sent after its death are re-routed to the dead letter mailbox, which by default will publish the messages wrapped in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/DeadLetter.html" title="org.apache.pekko.actor.DeadLetter"><code>DeadLetter</code></a></span><span class="group-java"><a href="https://d [...]
+<p>Some internal messages (marked with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/DeadLetterSuppression.html" title="org.apache.pekko.actor.DeadLetterSuppression"><code>DeadLetterSuppression</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/DeadLetterSuppression.html" title="org.apache.pekko.actor.DeadLetterSuppression"><code>Dea [...]
<p>However, in case you find yourself in need of debugging these kinds of low level suppressed dead letters, it’s still possible to subscribe to them explicitly:</p>
<dl>
<dt>Scala</dt>
@@ -1130,7 +1130,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/extending-pekko.html b/content/extending-pekko.html
index 22e84be..c9d8c31 100644
--- a/content/extending-pekko.html
+++ b/content/extending-pekko.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,12 +418,12 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#classic-pekko-extensions" name="classic-pekko-extensions" class="anchor"><span class="anchor-link"></span></a>Classic Pekko Extensions</h1>
-<p>If you want to add features to Pekko, there is a very elegant, but powerful mechanism for doing so. It’s called Pekko Extensions and comprises 2 basic components: an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/ [...]
-<p>Extensions will only be loaded once per <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span>, which will be managed [...]
+<p>If you want to add features to Pekko, there is a very elegant, but powerful mechanism for doing so. It’s called Pekko Extensions and comprises 2 basic components: an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/ [...]
+<p>Extensions will only be loaded once per <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span>, which will be managed [...]
<p>Since an extension is a way to hook into Pekko itself, the implementor of the extension needs to ensure the thread safety of his/her extension.</p></div>
<h2><a href="#building-an-extension" name="building-an-extension" class="anchor"><span class="anchor-link"></span></a>Building an Extension</h2>
<p>So let’s create a sample extension that lets us count the number of times something has happened.</p>
-<p>First, we define what our <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span> should do:</p>
+<p>First, we define what our <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span> should do:</p>
<dl>
<dt>Scala</dt>
<dd>
@@ -454,7 +454,7 @@ static class CountExtensionImpl implements Extension {
}
</code></pre></dd>
</dl>
-<p>Then we need to create an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.ExtensionId"><code>ExtensionId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.ExtensionId"><code>ExtensionId</code></a></span> for our extension so we can grab a ho [...]
+<p>Then we need to create an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.ExtensionId"><code>ExtensionId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.ExtensionId"><code>ExtensionId</code></a></span> for our extension so we can grab a ho [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -559,7 +559,7 @@ class MyCounterActor extends Actor with Counting {
<p>That’s all there is to it!</p>
<a id="loading"></a>
<h2><a href="#loading-from-configuration" name="loading-from-configuration" class="anchor"><span class="anchor-link"></span></a>Loading from Configuration</h2>
-<p>To be able to load extensions from your Pekko configuration you must add FQCNs of implementations of either <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.ExtensionId"><code>ExtensionId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.Exte [...]
+<p>To be able to load extensions from your Pekko configuration you must add FQCNs of implementations of either <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.ExtensionId"><code>ExtensionId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ExtensionId.html" title="org.apache.pekko.actor.Exte [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -587,7 +587,7 @@ class MyCounterActor extends Actor with Counting {
timeout = 30 seconds
}
}</code></pre>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span>:</p>
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Extension.html" title="org.apache.pekko.actor.Extension"><code>Extension</code></a></span>:</p>
<dl>
<dt>Scala</dt>
<dd>
@@ -768,7 +768,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/fault-tolerance-sample.html b/content/fault-tolerance-sample.html
index 4efc9dd..dd4b450 100644
--- a/content/fault-tolerance-sample.html
+++ b/content/fault-tolerance-sample.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Diagrams of the Fault Tolerance Sample
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -69,7 +69,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Diagrams of the Fault Tolerance Sample
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -1047,7 +1047,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/fault-tolerance.html b/content/fault-tolerance.html
index cb01b8c..3d3e7f7 100644
--- a/content/fault-tolerance.html
+++ b/content/fault-tolerance.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the full documentation of this feature and for new projects see <a href="typed/fault-tolerance.html">fault tolerance</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>The concept of fault tolerance relates to actors, so in order to use these make sure to depend on actors:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>The concept of fault tolerance relates to actors, so in order to use these make sure to depend on actors:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -1090,7 +1090,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/fsm.html b/content/fsm.html
index 0b6b56d..ec12ace 100644
--- a/content/fsm.html
+++ b/content/fsm.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the documentation of the new API of this feature and for new projects see <a href="typed/fsm.html">fsm</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Finite State Machine actors, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Finite State Machine actors, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -1579,7 +1579,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/futures.html b/content/futures.html
index 40af284..4bb6f9e 100644
--- a/content/futures.html
+++ b/content/futures.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#futures-patterns" name="futures-patterns" class="anchor"><span class="anchor-link"></span></a>Futures patterns</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>Pekko offers tiny helpers for use with <span class="group-scala"><a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/Future.html" title="scala.concurrent.Future"><code>Future</code></a>s</span><span class="group-java"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/CompletionStage.html" title="java.util.concurrent.CompletionStage"><code>CompletionStage</code></a></span>. These are part of Pekko’s core module:</p><dl class="de [...]
+<p>Pekko offers tiny helpers for use with <span class="group-scala"><a href="http://www.scala-lang.org/api/2.13.8/scala/concurrent/Future.html" title="scala.concurrent.Future"><code>Future</code></a>s</span><span class="group-java"><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/CompletionStage.html" title="java.util.concurrent.CompletionStage"><code>CompletionStage</code></a></span>. These are part of Pekko’s core module:</p><dl class="de [...]
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -580,7 +580,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/actor-systems.html b/content/general/actor-systems.html
index 705ee90..6703cf9 100644
--- a/content/general/actor-systems.html
+++ b/content/general/actor-systems.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -442,8 +442,8 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h2><a href="#what-you-should-not-concern-yourself-with" name="what-you-should-not-concern-yourself-with" class="anchor"><span class="anchor-link"></span></a>What you should not concern yourself with</h2>
<p>An actor system manages the resources it is configured to use in order to run the actors which it contains. There may be millions of actors within one such system, after all the mantra is to view them as abundant and they weigh in at an overhead of only roughly 300 bytes per instance. Naturally, the exact order in which messages are processed in large systems is not controllable by the application author, but this is also not intended. Take a step back and relax while Pekko does the h [...]
<h2><a href="#terminating-actorsystem" name="terminating-actorsystem" class="anchor"><span class="anchor-link"></span></a>Terminating ActorSystem</h2>
-<p>When you know everything is done for your application, you can have the user guardian actor stop, or call the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/typed/ActorSystem.html#terminate():Unit" title="pekko.actor.typed.ActorSystem"><code>terminate</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/typed/ActorSystem.html#terminate()" title="pekko.actor.typed.ActorSystem"><code>term [...]
-<p>If you want to execute some operations while terminating <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem< [...]
+<p>When you know everything is done for your application, you can have the user guardian actor stop, or call the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/typed/ActorSystem.html#terminate():Unit" title="pekko.actor.typed.ActorSystem"><code>terminate</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/typed/ActorSystem.html#terminate()" title="pekko.actor.typed.ActorSystem"><code>term [...]
+<p>If you want to execute some operations while terminating <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem< [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/general/actor-systems.md">here</a>.
</div>
@@ -532,7 +532,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/actors.html b/content/general/actors.html
index 5bfebd4..678940a 100644
--- a/content/general/actors.html
+++ b/content/general/actors.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -540,7 +540,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/addressing.html b/content/general/addressing.html
index 8073f47..ee1733e 100644
--- a/content/general/addressing.html
+++ b/content/general/addressing.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p><img src="../images/actor-paths-overview.png" alt="actor-paths-overview.png" /></p>
<p>The above image displays the relationship between the most important entities within an actor system, please read on for the details.</p>
<h2><a href="#what-is-an-actor-reference" name="what-is-an-actor-reference" class="anchor"><span class="anchor-link"></span></a>What is an Actor Reference</h2>
-<p>An actor reference is a subtype of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span>, whose foremost purpos [...]
+<p>An actor reference is a subtype of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span>, whose foremost purpos [...]
<p>There are several different types of actor references that are supported depending on the configuration of the actor system:</p>
<ul>
<li>Purely local actor references are used by actor systems which are not configured to support networking functions. These actor references will not function if sent across a network connection to a remote JVM.</li>
@@ -437,7 +437,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<li>And then there are some one-off internal implementations which you should never really see:
<ul>
<li>There is an actor reference which does not represent an actor but acts only as a pseudo-supervisor for the root guardian, we call it “the one who walks the bubbles of space-time”.</li>
- <li>The first logging service started before actually firing up actor creation facilities is a fake actor reference which accepts log events and prints them directly to standard output; it is <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/Logging$$StandardOutLogger.html" title="org.apache.pekko.event.Logging.StandardOutLogger"><code>Logging.StandardOutLogger</code></a></span><span class="group-java"><a href="http [...]
+ <li>The first logging service started before actually firing up actor creation facilities is a fake actor reference which accepts log events and prints them directly to standard output; it is <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/Logging$$StandardOutLogger.html" title="org.apache.pekko.event.Logging.StandardOutLogger"><code>Logging.StandardOutLogger</code></a></span><span class="group-java"><a href="http [...]
</ul>
</li>
</ul>
@@ -460,8 +460,8 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h2><a href="#how-are-actor-references-obtained-" name="how-are-actor-references-obtained-" class="anchor"><span class="anchor-link"></span></a>How are Actor References obtained?</h2>
<p>There are two general categories to how actor references may be obtained: by <a href="../typed/actor-lifecycle.html#creating-actors">creating actors</a> or by looking them up through the <a href="../typed/actor-discovery.html#receptionist">Receptionist</a>.</p>
<h2><a href="#actor-reference-and-path-equality" name="actor-reference-and-path-equality" class="anchor"><span class="anchor-link"></span></a>Actor Reference and Path Equality</h2>
-<p>Equality of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span> match the intention that an <span class="grou [...]
-<p>If you need to keep track of actor references in a collection and do not care about the exact actor incarnation you can use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekko.actor.ActorPath"><code>ActorPath</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekk [...]
+<p>Equality of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span> match the intention that an <span class="grou [...]
+<p>If you need to keep track of actor references in a collection and do not care about the exact actor incarnation you can use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekko.actor.ActorPath"><code>ActorPath</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekk [...]
<h2><a href="#reusing-actor-paths" name="reusing-actor-paths" class="anchor"><span class="anchor-link"></span></a>Reusing Actor Paths</h2>
<p>When an actor is terminated, its reference will point to the dead letter mailbox, DeathWatch will publish its final transition and in general it is not expected to come back to life again (since the actor life cycle does not allow this).</p>
<h2><a href="#what-is-the-address-part-used-for-" name="what-is-the-address-part-used-for-" class="anchor"><span class="anchor-link"></span></a>What is the Address part used for?</h2>
@@ -470,7 +470,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h2><a href="#top-level-scopes-for-actor-paths" name="top-level-scopes-for-actor-paths" class="anchor"><span class="anchor-link"></span></a>Top-Level Scopes for Actor Paths</h2>
<p>At the root of the path hierarchy resides the root guardian above which all other actors are found; its name is <code>"/"</code>. The next level consists of the following:</p>
<ul>
- <li><code>"/user"</code> is the guardian actor for all user-created top-level actors; actors created using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(props:org.apache.pekko.actor.Props):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorRefFactory"><code>ActorSystem.actorOf</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0 [...]
+ <li><code>"/user"</code> is the guardian actor for all user-created top-level actors; actors created using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(props:org.apache.pekko.actor.Props):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorRefFactory"><code>ActorSystem.actorOf</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0 [...]
<li><code>"/system"</code> is the guardian actor for all system-created top-level actors, e.g. logging listeners or actors automatically deployed by configuration at the start of the actor system.</li>
<li><code>"/deadLetters"</code> is the dead letter actor, which is where all messages sent to stopped or non-existing actors are re-routed (on a best-effort basis: messages may be lost even within the local JVM).</li>
<li><code>"/temp"</code> is the guardian for all short-lived system-created actors, e.g. those which are used in the implementation of <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/pattern/AskableActorRef.html#ask(message:Any)(implicittimeout:org.apache.pekko.util.Timeout,implicitsender:org.apache.pekko.actor.ActorRef):scala.concurrent.Future[Any]" title="pekko.pattern.AskableActorRef"><code>ActorRef.ask</code></a></span><span class="gro [...]
@@ -567,7 +567,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/configuration-reference.html b/content/general/configuration-reference.html
index 7cfc1cb..f7dbc86 100644
--- a/content/general/configuration-reference.html
+++ b/content/general/configuration-reference.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -6101,7 +6101,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/configuration.html b/content/general/configuration.html
index 9a0586f..9454256 100644
--- a/content/general/configuration.html
+++ b/content/general/configuration.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -426,7 +426,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
</ul>
<p>Pekko uses the <a href="https://github.com/lightbend/config">Typesafe Config Library</a>, which might also be a good choice for the configuration of your own application or library built with or without Pekko. This library is implemented in Java with no external dependencies; This is only a summary of the most important parts for more details see <a href="https://github.com/lightbend/config/blob/master/README.md">the config library docs</a>.</p>
<h2><a href="#where-configuration-is-read-from" name="where-configuration-is-read-from" class="anchor"><span class="anchor-link"></span></a>Where configuration is read from</h2>
-<p>All configuration for Pekko is held within instances of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</ [...]
+<p>All configuration for Pekko is held within instances of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</ [...]
<pre class="prettyprint"><code class="language-scala">appConfig.withFallback(ConfigFactory.defaultReference(classLoader))
</code></pre>
<p>The philosophy is that code never contains default values, but instead relies upon their presence in the <code>reference.conf</code> supplied with the library in question.</p>
@@ -525,11 +525,11 @@ system.logConfiguration()</code></pre></dd>
system.logConfiguration();</code></pre></dd>
</dl>
<h2><a href="#a-word-about-classloaders" name="a-word-about-classloaders" class="anchor"><span class="anchor-link"></span></a>A Word About ClassLoaders</h2>
-<p>In several places of the configuration file it is possible to specify the fully-qualified class name of something to be instantiated by Pekko. This is done using Java reflection, which in turn uses a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/ClassLoader.html" title="java.lang.ClassLoader"><code>ClassLoader</code></a>. Getting the right one in challenging environments like application containers or OSGi bundles is not always trivial, the current ap [...]
+<p>In several places of the configuration file it is possible to specify the fully-qualified class name of something to be instantiated by Pekko. This is done using Java reflection, which in turn uses a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/ClassLoader.html" title="java.lang.ClassLoader"><code>ClassLoader</code></a>. Getting the right one in challenging environments like application containers or OSGi bundles is not always trivial, the current ap [...]
<h2><a href="#application-specific-settings" name="application-specific-settings" class="anchor"><span class="anchor-link"></span></a>Application specific settings</h2>
<p>The configuration can also be used for application specific settings. A good practice is to place those settings in an <a href="../extending-pekko.html#extending-pekko-settings">Extension</a>.</p>
<h2><a href="#configuring-multiple-actorsystem" name="configuring-multiple-actorsystem" class="anchor"><span class="anchor-link"></span></a>Configuring multiple ActorSystem</h2>
-<p>If you have more than one <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span> (or you&rsquo [...]
+<p>If you have more than one <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span> (or you&rsquo [...]
<p>Given that <a href="https://lightbend.github.io/config/latest/api/com/typesafe/config/ConfigFactory.html#load--">ConfigFactory.load()</a> merges all resources with matching name from the whole class path, it is easiest to utilize that functionality and differentiate actor systems within the hierarchy of the configuration:</p>
<pre><code>myapp1 {
pekko.loglevel = "WARNING"
@@ -573,7 +573,7 @@ my.other.setting = "hello"
// plus myapp1 and myapp2 subtrees
</code></pre><div class="callout note "><div class="callout-title">Note</div>
<p>The configuration library is really powerful, explaining all features exceeds the scope affordable here. In particular not covered are how to include other configuration files within other files (see a small example at <a href="#including-files">Including files</a>) and copying parts of the configuration tree by way of path substitutions.</p></div>
-<p>You may also specify and parse the configuration programmatically in other ways when instantiating the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pek [...]
+<p>You may also specify and parse the configuration programmatically in other ways when instantiating the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pekko.actor.typed.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorSystem.html" title="org.apache.pek [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -748,7 +748,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/index.html b/content/general/index.html
index df698db..2e3de07 100644
--- a/content/general/index.html
+++ b/content/general/index.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -595,7 +595,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/jmm.html b/content/general/jmm.html
index a71ac91..08ae643 100644
--- a/content/general/jmm.html
+++ b/content/general/jmm.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -713,7 +713,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/message-delivery-reliability.html b/content/general/message-delivery-reliability.html
index ce8246c..cd61f50 100644
--- a/content/general/message-delivery-reliability.html
+++ b/content/general/message-delivery-reliability.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -488,7 +488,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h3><a href="#be-careful-what-you-do-with-this-section-" name="be-careful-what-you-do-with-this-section-" class="anchor"><span class="anchor-link"></span></a>Be careful what you do with this section!</h3>
<p>Relying on the stronger reliability in this section is not recommended since it will bind your application to local-only deployment: an application may have to be designed differently (as opposed to just employing some message exchange patterns local to some actors) in order to be fit for running on a cluster of machines. Our credo is “design once, deploy any way you wish”, and to achieve this you should only rely on <a href="message-delivery-reliability.html#the-general-rules">The Ge [...]
<h3><a href="#reliability-of-local-message-sends" name="reliability-of-local-message-sends" class="anchor"><span class="anchor-link"></span></a>Reliability of Local Message Sends</h3>
-<p>The Pekko test suite relies on not losing messages in the local context (and for non-error condition tests also for remote deployment), meaning that we actually do apply the best effort to keep our tests stable. A local <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html#tell(msg:Any,sender:org.apache.pekko.actor.ActorRef):Unit" title="org.apache.pekko.actor.ActorRef"><code>tell</code></a></span><span class [...]
+<p>The Pekko test suite relies on not losing messages in the local context (and for non-error condition tests also for remote deployment), meaning that we actually do apply the best effort to keep our tests stable. A local <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html#tell(msg:Any,sender:org.apache.pekko.actor.ActorRef):Unit" title="org.apache.pekko.actor.ActorRef"><code>tell</code></a></span><span class [...]
<ul>
<li><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/StackOverflowError.html" title="java.lang.StackOverflowError"><code>StackOverflowError</code></a></li>
<li><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/OutOfMemoryError.html" title="java.lang.OutOfMemoryError"><code>OutOfMemoryError</code></a></li>
@@ -496,7 +496,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
</ul>
<p>In addition, local sends can fail in Pekko-specific ways:</p>
<ul>
- <li>if the mailbox does not accept the message (e.g. full <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/BoundedMailbox.html" title="org.apache.pekko.dispatch.BoundedMailbox"><code>BoundedMailbox</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/BoundedMailbox.html" title="org.apache.pekko.dispatch.BoundedMailbox"><code>BoundedMa [...]
+ <li>if the mailbox does not accept the message (e.g. full <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/BoundedMailbox.html" title="org.apache.pekko.dispatch.BoundedMailbox"><code>BoundedMailbox</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/BoundedMailbox.html" title="org.apache.pekko.dispatch.BoundedMailbox"><code>BoundedMa [...]
<li>if the receiving actor fails while processing the message or is already terminated</li>
</ul>
<p>While the first is a matter of configuration the second deserves some thought: the sender of a message does not get feedback if there was an exception while processing, that notification goes to the supervisor instead. This is in general not distinguishable from a lost message for an outside observer.</p>
@@ -542,9 +542,9 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>The main use of this facility is for debugging, especially if an actor send does not arrive consistently (where usually inspecting the dead letters will tell you that the sender or recipient was set wrong somewhere along the way). In order to be useful for this purpose it is good practice to avoid sending to deadLetters where possible, i.e. run your application with a suitable dead letter logger (see more below) from time to time and clean up the log output. This exercise—like all els [...]
<p>The dead letter service follows the same rules with respect to delivery guarantees as all other message sends, hence it cannot be used to implement guaranteed delivery.</p>
<h3><a href="#how-do-i-receive-dead-letters-" name="how-do-i-receive-dead-letters-" class="anchor"><span class="anchor-link"></span></a>How do I Receive Dead Letters?</h3>
-<p>An actor can subscribe to class <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/DeadLetter.html" title="org.apache.pekko.actor.DeadLetter"><code>actor.DeadLetter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/DeadLetter.html" title="org.apache.pekko.actor.DeadLetter"><code>actor.DeadLetter</code></a></span> on the event stream, see [...]
+<p>An actor can subscribe to class <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/DeadLetter.html" title="org.apache.pekko.actor.DeadLetter"><code>actor.DeadLetter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/DeadLetter.html" title="org.apache.pekko.actor.DeadLetter"><code>actor.DeadLetter</code></a></span> on the event stream, see [...]
<h3><a href="#dead-letters-which-are-usually-not-worrisome" name="dead-letters-which-are-usually-not-worrisome" class="anchor"><span class="anchor-link"></span></a>Dead Letters Which are (Usually) not Worrisome</h3>
-<p>Every time an actor does not terminate by its own decision, there is a chance that some messages which it sends to itself are lost. There is one which happens quite easily in complex shutdown scenarios that is usually benign: seeing instances of a graceful stop command for an actor being dropped means that two stop requests were given, but only one can succeed. In the same vein, you might see <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT [...]
+<p>Every time an actor does not terminate by its own decision, there is a chance that some messages which it sends to itself are lost. There is one which happens quite easily in complex shutdown scenarios that is usually benign: seeing instances of a graceful stop command for an actor being dropped means that two stop requests were given, but only one can succeed. In the same vein, you might see <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/general/message-delivery-reliability.md">here</a>.
</div>
@@ -632,7 +632,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/remoting.html b/content/general/remoting.html
index 071a555..e87a1c0 100644
--- a/content/general/remoting.html
+++ b/content/general/remoting.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -521,7 +521,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/stream/stream-configuration.html b/content/general/stream/stream-configuration.html
index 4fc773c..ce7db8a 100644
--- a/content/general/stream/stream-configuration.html
+++ b/content/general/stream/stream-configuration.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -688,7 +688,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/stream/stream-design.html b/content/general/stream/stream-design.html
index c60f78f..6ae5deb 100644
--- a/content/general/stream/stream-design.html
+++ b/content/general/stream/stream-design.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -441,16 +441,16 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Compositionality entails reusability of partial stream topologies, which led us to the lifted approach of describing data flows as (partial) graphs that can act as composite sources, flows (a.k.a. pipes) and sinks of data. These building blocks shall then be freely shareable, with the ability to combine them freely to form larger graphs. The representation of these pieces must therefore be an immutable blueprint that is materialized in an explicit step in order to start the stream pro [...]
<p>The process of materialization will often create specific objects that are useful to interact with the processing engine once it is running, for example for shutting it down or for extracting metrics. This means that the materialization function produces a result termed the <em>materialized value of a graph</em>.</p>
<h2><a href="#interoperation-with-other-reactive-streams-implementations" name="interoperation-with-other-reactive-streams-implementations" class="anchor"><span class="anchor-link"></span></a>Interoperation with other Reactive Streams implementations</h2>
-<p>Pekko Streams fully implement the Reactive Streams specification and interoperate with all other conformant implementations. We chose to completely separate the Reactive Streams interfaces from the user-level API because we regard them to be an SPI that is not targeted at endusers. In order to obtain a <a href="https://javadoc.io/doc/org.reactivestreams/reactive-streams/latest/org/reactivestreams/Publisher.html">Publisher</a> or <a href="https://javadoc.io/doc/org.reactivestreams/reac [...]
-<p>All stream Processors produced by the default materialization of Pekko Streams are restricted to having a single Subscriber, additional Subscribers will be rejected. The reason for this is that the stream topologies described using our DSL never require fan-out behavior from the Publisher sides of the elements, all fan-out is done using explicit elements like <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Br [...]
+<p>Pekko Streams fully implement the Reactive Streams specification and interoperate with all other conformant implementations. We chose to completely separate the Reactive Streams interfaces from the user-level API because we regard them to be an SPI that is not targeted at endusers. In order to obtain a <a href="https://javadoc.io/doc/org.reactivestreams/reactive-streams/latest/org/reactivestreams/Publisher.html">Publisher</a> or <a href="https://javadoc.io/doc/org.reactivestreams/reac [...]
+<p>All stream Processors produced by the default materialization of Pekko Streams are restricted to having a single Subscriber, additional Subscribers will be rejected. The reason for this is that the stream topologies described using our DSL never require fan-out behavior from the Publisher sides of the elements, all fan-out is done using explicit elements like <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Br [...]
<p>This means that <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/stream/scaladsl/Sink$.html#asPublisher[T](fanout:Boolean):org.apache.pekko.stream.scaladsl.Sink[T,org.reactivestreams.Publisher[T]]" title="pekko.stream.scaladsl.Sink"><code>Sink.asPublisher(true)</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/stream/javadsl/Sink.html#asPublisher(org.apache.pekko.stream.javadsl.AsPublisher)" title= [...]
<h3><a href="#rationale-and-benefits-from-sink-source-flow-not-directly-extending-reactive-streams-interfaces" name="rationale-and-benefits-from-sink-source-flow-not-directly-extending-reactive-streams-interfaces" class="anchor"><span class="anchor-link"></span></a>Rationale and benefits from Sink/Source/Flow not directly extending Reactive Streams interfaces</h3>
<p>A sometimes overlooked crucial piece of information about <a href="https://github.com/reactive-streams/reactive-streams-jvm/">Reactive Streams</a> is that they are a <a href="https://en.m.wikipedia.org/wiki/Service_provider_interface">Service Provider Interface</a>, as explained in depth in one of the <a href="https://github.com/reactive-streams/reactive-streams-jvm/pull/25">early discussions</a> about the specification. Pekko Streams was designed during the development of Reactive St [...]
<p>It may be enlightening to learn that even within the Reactive Specification the types had initially attempted to hide <code>Publisher</code>, <code>Subscriber</code> and the other SPI types from users of the API. Though since those internal SPI types would end up surfacing to end users of the standard in some cases, it was decided to <a href="https://github.com/reactive-streams/reactive-streams-jvm/pull/25">remove the API types, and only keep the SPI types</a> which are the <code>Publ [...]
<p>With this historical knowledge and context about the purpose of the standard – being an internal detail of interoperable libraries - we can with certainty say that it can’t be really said that a direct <em>inheritance</em> relationship with these types can be considered some form of advantage or meaningful differentiator between libraries. Rather, it could be seen that APIs which expose those SPI types to end-users are leaking internal implementation details accidentally. </p>
-<p>The <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span>, <span class="group-java"><a href="https://doc.akka [...]
+<p>The <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span>, <span class="group-java"><a href="https://doc.akka [...]
<p>Another not obvious gain from hiding the Reactive Streams interfaces comes from the fact that <code>org.reactivestreams.Subscriber</code> (et al) have now been included in Java 9+, and thus become part of Java itself, so libraries should migrate to using the <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/Flow.Subscriber.html" title="java.util.concurrent.Flow.Subscriber"><code>java.util.concurrent.Flow.Subscriber</code></a> instead of <code>o [...]
-<p>The other, and perhaps more important reason for hiding the Reactive Streams interfaces comes back to the first points of this explanation: the fact of Reactive Streams being an SPI, and as such is hard to “get right” in ad-hoc implementations. Thus Pekko Streams discourages the use of the hard to implement pieces of the underlying infrastructure, and offers simpler, more type-safe, yet more powerful abstractions for users to work with: <span class="group-scala"><a href="h [...]
+<p>The other, and perhaps more important reason for hiding the Reactive Streams interfaces comes back to the first points of this explanation: the fact of Reactive Streams being an SPI, and as such is hard to “get right” in ad-hoc implementations. Thus Pekko Streams discourages the use of the hard to implement pieces of the underlying infrastructure, and offers simpler, more type-safe, yet more powerful abstractions for users to work with: <span class="group-scala"><a href="h [...]
<h2><a href="#what-shall-users-of-streaming-libraries-expect-" name="what-shall-users-of-streaming-libraries-expect-" class="anchor"><span class="anchor-link"></span></a>What shall users of streaming libraries expect?</h2>
<p>We expect libraries to be built on top of Pekko Streams, in fact Pekko HTTP is one such example that lives within the Pekko project itself. In order to allow users to profit from the principles that are described for Pekko Streams above, the following rules are established:</p>
<ul>
@@ -464,11 +464,11 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h3><a href="#resulting-implementation-constraints" name="resulting-implementation-constraints" class="anchor"><span class="anchor-link"></span></a>Resulting Implementation Constraints</h3>
<p>Pekko Streams must enable a library to express any stream processing utility in terms of immutable blueprints. The most common building blocks are</p>
<ul>
- <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span>: something with exactly one output stream</li>
- <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span>: something with exactly one input stream</li>
- <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span>: something with exactly one input and one output stream</li>
- <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/BidiFlow.html" title="org.apache.pekko.stream.javadsl.BidiFlow"><code>BidiFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/BidiFlow.html" title="org.apache.pekko.stream.scaladsl.BidiFlow"><code>BidiFlow</code></a></span>: something with exactly two input stream [...]
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/Graph.html" title="org.apache.pekko.stream.Graph"><code>Graph</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/Graph.html" title="org.apache.pekko.stream.Graph"><code>Graph</code></a></span>: a packaged stream processing topology that exposes a certain set of input and output ports, [...]
+ <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span>: something with exactly one output stream</li>
+ <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span>: something with exactly one input stream</li>
+ <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span>: something with exactly one input and one output stream</li>
+ <li><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/BidiFlow.html" title="org.apache.pekko.stream.javadsl.BidiFlow"><code>BidiFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/BidiFlow.html" title="org.apache.pekko.stream.scaladsl.BidiFlow"><code>BidiFlow</code></a></span>: something with exactly two input stream [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/Graph.html" title="org.apache.pekko.stream.Graph"><code>Graph</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/Graph.html" title="org.apache.pekko.stream.Graph"><code>Graph</code></a></span>: a packaged stream processing topology that exposes a certain set of input and output ports, [...]
</ul><div class="callout note "><div class="callout-title">Note</div>
<p>A source that emits a stream of streams is still a normal Source, the kind of elements that are produced does not play a role in the static stream topology that is being expressed.</p></div>
<h2><a href="#the-difference-between-error-and-failure" name="the-difference-between-error-and-failure" class="anchor"><span class="anchor-link"></span></a>The difference between Error and Failure</h2>
@@ -566,7 +566,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/supervision.html b/content/general/supervision.html
index 973b883..0f96f42 100644
--- a/content/general/supervision.html
+++ b/content/general/supervision.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -448,11 +448,11 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<li>(Transient) failure of some external resource used during processing the message</li>
<li>Corrupt internal state of the actor</li>
</ul>
-<p>Unless the failure is specifically recognizable, the third cause cannot be ruled out, which leads to the conclusion that the internal state needs to be cleared out. If the supervisor decides that its other children or itself is not affected by the corruption—e.g. because of conscious application of the error kernel pattern—it is therefore best to restart the actor. This is carried out by creating a new instance of the underlying <span class="group-scala"><a href="https://doc.akka.io/a [...]
+<p>Unless the failure is specifically recognizable, the third cause cannot be ruled out, which leads to the conclusion that the internal state needs to be cleared out. If the supervisor decides that its other children or itself is not affected by the corruption—e.g. because of conscious application of the error kernel pattern—it is therefore best to restart the actor. This is carried out by creating a new instance of the underlying <span class="group-scala"><a href="https://doc.akka.io/a [...]
<h2><a href="#what-lifecycle-monitoring-means" name="what-lifecycle-monitoring-means" class="anchor"><span class="anchor-link"></span></a>What Lifecycle Monitoring Means</h2><div class="callout note "><div class="callout-title">Note</div>
<p>Lifecycle Monitoring in Pekko is usually referred to as <code>DeathWatch</code></p></div>
<p>In contrast to the special relationship between parent and child described above, each actor may monitor any other actor. Since actors emerge from creation fully alive and restarts are not visible outside of the affected supervisors, the only state change available for monitoring is the transition from alive to dead. Monitoring is thus used to tie one actor to another so that it may react to the other actor’s termination, in contrast to supervision which reacts to failure.</p>
-<p>Lifecycle monitoring is implemented using a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/Terminated.html" title="org.apache.pekko.actor.typed.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/Terminated.html" title="org.apache.pekko.actor.typed.Terminated"><code>Terminated</code></a></span> m [...]
+<p>Lifecycle monitoring is implemented using a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/Terminated.html" title="org.apache.pekko.actor.typed.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/Terminated.html" title="org.apache.pekko.actor.typed.Terminated"><code>Terminated</code></a></span> m [...]
<h2><a href="#actors-and-exceptions" name="actors-and-exceptions" class="anchor"><span class="anchor-link"></span></a>Actors and exceptions</h2>
<p>It can happen that while a message is being processed by an actor, that some kind of exception is thrown, e.g. a database exception.</p>
<h3><a href="#what-happens-to-the-message" name="what-happens-to-the-message" class="anchor"><span class="anchor-link"></span></a>What happens to the Message</h3>
@@ -549,7 +549,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/general/terminology.html b/content/general/terminology.html
index 9293dbe..c77ec82 100644
--- a/content/general/terminology.html
+++ b/content/general/terminology.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -539,7 +539,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/index-actors.html b/content/index-actors.html
index 9273fb9..adf64d3 100644
--- a/content/index-actors.html
+++ b/content/index-actors.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -419,7 +419,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h1><a href="#classic-actors" name="classic-actors" class="anchor"><span class="anchor-link"></span></a>Classic Actors</h1><div class="callout note "><div class="callout-title">Note</div>
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Classic Pekko Actors, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Classic Pekko Actors, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies ++= Seq(
"org.apache.pekko" %% "pekko-actor" % PekkoVersion,
"org.apache.pekko" %% "pekko-testkit" % PekkoVersion % Test
@@ -431,7 +431,7 @@ libraryDependencies ++= Seq(
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -451,7 +451,7 @@ libraryDependencies ++= Seq(
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
testImplementation "org.apache.pekko:pekko-testkit_${versions.ScalaBinary}"
@@ -647,7 +647,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/index-classic.html b/content/index-classic.html
index 118f4e0..a8ef934 100644
--- a/content/index-classic.html
+++ b/content/index-classic.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -534,7 +534,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/index-cluster.html b/content/index-cluster.html
index 47ab5d0..2ad3f0a 100644
--- a/content/index-cluster.html
+++ b/content/index-cluster.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -600,7 +600,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/index-network.html b/content/index-network.html
index 5a41e6d..45e4488 100644
--- a/content/index-network.html
+++ b/content/index-network.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -526,7 +526,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/index-utilities-classic.html b/content/index-utilities-classic.html
index 7a7f4f1..9cc2591 100644
--- a/content/index-utilities-classic.html
+++ b/content/index-utilities-classic.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#classic-utilities" name="classic-utilities" class="anchor"><span class="anchor-link"></span></a>Classic Utilities</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Utilities, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Utilities, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies ++= Seq(
"org.apache.pekko" %% "pekko-actor" % PekkoVersion,
"org.apache.pekko" %% "pekko-testkit" % PekkoVersion % Test
@@ -430,7 +430,7 @@ libraryDependencies ++= Seq(
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -450,7 +450,7 @@ libraryDependencies ++= Seq(
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
testImplementation "org.apache.pekko:pekko-testkit_${versions.ScalaBinary}"
@@ -573,7 +573,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/index-utilities.html b/content/index-utilities.html
index 32be638..b311b3c 100644
--- a/content/index-utilities.html
+++ b/content/index-utilities.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -518,7 +518,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/index.html b/content/index.html
index 1bc1ea8..5fc9dfd 100644
--- a/content/index.html
+++ b/content/index.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -671,7 +671,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/io-dns.html b/content/io-dns.html
index 06d8513..7c8c1e2 100644
--- a/content/io-dns.html
+++ b/content/io-dns.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -586,7 +586,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/io-tcp.html b/content/io-tcp.html
index 3a5b3fa..ac76144 100644
--- a/content/io-tcp.html
+++ b/content/io-tcp.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -419,7 +419,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#using-tcp" name="using-tcp" class="anchor"><span class="anchor-link"></span></a>Using TCP</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use TCP, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use TCP, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -428,7 +428,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -443,7 +443,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -1820,7 +1820,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/io-udp.html b/content/io-udp.html
index c82c0e8..141660e 100644
--- a/content/io-udp.html
+++ b/content/io-udp.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -419,7 +419,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#using-udp" name="using-udp" class="anchor"><span class="anchor-link"></span></a>Using UDP</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use UDP, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use UDP, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -428,7 +428,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -443,7 +443,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -819,7 +819,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/io.html b/content/io.html
index 9a51828..f4c3f99 100644
--- a/content/io.html
+++ b/content/io.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -419,7 +419,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#i-o" name="i-o" class="anchor"><span class="anchor-link"></span></a>I/O</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use I/O, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use I/O, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -428,7 +428,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -443,7 +443,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -451,7 +451,7 @@ dependencies {
<p>The <code>pekko.io</code> package design combines experiences from the <code>spray-io</code> module with improvements that were jointly developed for more general consumption as an actor-based service.</p>
<p>The guiding design goal for this I/O implementation was to reach extreme scalability, make no compromises in providing an API correctly matching the underlying transport mechanism and to be fully event-driven, non-blocking and asynchronous. The API is meant to be a solid foundation for the implementation of network protocols and building higher abstractions; it is not meant to be a full-service high-level NIO wrapper for end users.</p>
<h2><a href="#terminology-concepts" name="terminology-concepts" class="anchor"><span class="anchor-link"></span></a>Terminology, Concepts</h2>
-<p>The I/O API is completely actor based, meaning that all operations are implemented with message passing instead of direct method calls. Every I/O driver (TCP, UDP) has a special actor, called a <em>manager</em> that serves as an entry point for the API. I/O is broken into several drivers. The manager for a particular driver is accessible <span class="group-scala">through the <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/io/IO$.html" title="pekko.io.IO"><code>IO</code></a> [...]
+<p>The I/O API is completely actor based, meaning that all operations are implemented with message passing instead of direct method calls. Every I/O driver (TCP, UDP) has a special actor, called a <em>manager</em> that serves as an entry point for the API. I/O is broken into several drivers. The manager for a particular driver is accessible <span class="group-scala">through the <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/io/IO$.html" title="pekko.io.IO"><code>IO</code></a> [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -463,7 +463,7 @@ val manager = IO(Tcp)</code></pre></dd>
<dd>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/io/japi/EchoManager.java#L48" target="_blank" title="Go to snippet source">source</a><code class="language-java">final ActorRef tcpManager = Tcp.get(getContext().getSystem()).manager();</code></pre></dd>
</dl>
-<p>The manager receives I/O command messages and instantiates worker actors in response. The worker actors present themselves to the API user in the reply to the command that was sent. For example after a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/io/Tcp$$Connect.html" title="org.apache.pekko.io.Tcp.Connect"><code>Connect</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297 [...]
+<p>The manager receives I/O command messages and instantiates worker actors in response. The worker actors present themselves to the API user in the reply to the command that was sent. For example after a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/io/Tcp$$Connect.html" title="org.apache.pekko.io.Tcp.Connect"><code>Connect</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528 [...]
<h3><a href="#deathwatch-and-resource-management" name="deathwatch-and-resource-management" class="anchor"><span class="anchor-link"></span></a>DeathWatch and Resource Management</h3>
<p>I/O worker actors receive commands and also send out events. They usually need a user-side counterpart actor listening for these events (such events could be inbound connections, incoming bytes or acknowledgements for writes). These worker actors <em>watch</em> their listener counterparts. If the listener stops then the worker will automatically release any resources that it holds. This design makes the API more robust against resource leaks.</p>
<p>Thanks to the completely actor based approach of the I/O API the opposite direction works as well: a user actor responsible for handling a connection can watch the connection actor to be notified if it unexpectedly terminates.</p>
@@ -475,16 +475,16 @@ val manager = IO(Tcp)</code></pre></dd>
<li><em>Nack-based</em>, where the driver notifies the writer when writes have failed.</li>
</ul>
<p>Each of these models is available in both the TCP and the UDP implementations of Pekko I/O.</p>
-<p>Individual writes can be acknowledged by providing an ack object in the write message (<span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/io/Tcp$$Write.html" title="org.apache.pekko.io.Tcp.Write"><code>Write</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/io/Tcp$$Write.html" title="org.apache.pekko.io.Tcp.Write"><code>Write</code></a></span> in the [...]
+<p>Individual writes can be acknowledged by providing an ack object in the write message (<span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/io/Tcp$$Write.html" title="org.apache.pekko.io.Tcp.Write"><code>Write</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/io/Tcp$$Write.html" title="org.apache.pekko.io.Tcp.Write"><code>Write</code></a></span> in the [...]
<p>If a write (or any other command) fails, the driver notifies the actor that sent the command with a special message (<code>CommandFailed</code> in the case of UDP and TCP). This message will also notify the writer of a failed write, serving as a nack for that write. Please note, that in a nack-based flow-control setting the writer has to be prepared for the fact that the failed write might not be the most recent write it sent. For example, the failure notification for a write <code>W1 [...]
<p>An acknowledged write does not mean acknowledged delivery or storage; receiving an ack for a write signals that the I/O driver has successfully processed the write. The Ack/Nack protocol described here is a means of flow control not error handling. In other words, data may still be lost, even if every write is acknowledged.</p></div>
<h3><a href="#bytestring" name="bytestring" class="anchor"><span class="anchor-link"></span></a>ByteString</h3>
-<p>To maintain isolation, actors should communicate with immutable objects only. <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></s [...]
-<p><code>ByteString</code> is a <a href="https://en.wikipedia.org/wiki/Rope_(computer_science)">rope-like</a> data structure that is immutable and provides fast concatenation and slicing operations (perfect for I/O). When two <code>ByteString</code>s are concatenated together they are both stored within the resulting <code>ByteString</code> instead of copying both to a new <span class="group-scala"><code>Array</code></span><span class="group-java">array</span>. Operations such as <span c [...]
-<p><code>ByteString</code> inherits all methods from <a href="http://www.scala-lang.org/api/2.13.8/scala/collection/immutable/IndexedSeq.html" title="scala.collection.immutable.IndexedSeq"><code>IndexedSeq</code></a>, and it also has some new ones. For more information, look up the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>util.ByteString</code></a></s [...]
-<p><code>ByteString</code> also comes with its own optimized builder and iterator classes <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteStringBuilder"><code>ByteStringBuilder</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteS [...]
+<p>To maintain isolation, actors should communicate with immutable objects only. <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></s [...]
+<p><code>ByteString</code> is a <a href="https://en.wikipedia.org/wiki/Rope_(computer_science)">rope-like</a> data structure that is immutable and provides fast concatenation and slicing operations (perfect for I/O). When two <code>ByteString</code>s are concatenated together they are both stored within the resulting <code>ByteString</code> instead of copying both to a new <span class="group-scala"><code>Array</code></span><span class="group-java">array</span>. Operations such as <span c [...]
+<p><code>ByteString</code> inherits all methods from <a href="http://www.scala-lang.org/api/2.13.8/scala/collection/immutable/IndexedSeq.html" title="scala.collection.immutable.IndexedSeq"><code>IndexedSeq</code></a>, and it also has some new ones. For more information, look up the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>util.ByteString</code></a></s [...]
+<p><code>ByteString</code> also comes with its own optimized builder and iterator classes <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteStringBuilder"><code>ByteStringBuilder</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteS [...]
<h4><a href="#compatibility-with-java-io" name="compatibility-with-java-io" class="anchor"><span class="anchor-link"></span></a>Compatibility with java.io</h4>
-<p>A <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteStringBuilder"><code>ByteStringBuilder</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteStringBuilder"><code>ByteStringBuilder</code></a></span> can be wrapped in a <a href=" [...]
+<p>A <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteStringBuilder"><code>ByteStringBuilder</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteStringBuilder.html" title="org.apache.pekko.util.ByteStringBuilder"><code>ByteStringBuilder</code></a></span> can be wrapped in a <a href=" [...]
<h2><a href="#architecture-in-depth" name="architecture-in-depth" class="anchor"><span class="anchor-link"></span></a>Architecture in-depth</h2>
<p>For further details on the design and internal architecture see <a href="common/io-layer.html">I/O Layer Design</a>.</p>
<div class="toc ">
@@ -585,7 +585,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/logging.html b/content/logging.html
index d6778d9..3f7cd52 100644
--- a/content/logging.html
+++ b/content/logging.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the new API see <a href="typed/logging.html">Logging</a>.</p>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Logging, you must at least use the Pekko actors dependency in your project, and will most likely want to configure logging via the SLF4J module (<a href="logging.html#slf4j">see below</a>).</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Logging, you must at least use the Pekko actors dependency in your project, and will most likely want to configure logging via the SLF4J module (<a href="logging.html#slf4j">see below</a>).</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -453,7 +453,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Logging (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-slf4j</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -482,7 +482,7 @@ dependencies {
<h2><a href="#how-to-log" name="how-to-log" class="anchor"><span class="anchor-link"></span></a>How to Log</h2>
-<p>Create a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span> and use the <code>error</code>, <cod [...]
+<p>Create a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span> and use the <code>error</code>, <cod [...]
<dl>
<dt>Scala</dt>
@@ -540,7 +540,7 @@ import org.apache.pekko.event.LoggingAdapter;
...
}
</code></pre></div>
-<p>The first parameter to <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/event/Logging$.html#apply[T](bus:org.apache.pekko.event.LoggingBus,logSource:T)(implicitevidence$5:org.apache.pekko.event.LogSource[T]):org.apache.pekko.event.LoggingAdapter" title="pekko.event.Logging"><code>Logging</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/event/Logging.html#getLogger(org.apache.pekko.event.LoggingBu [...]
+<p>The first parameter to <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/event/Logging$.html#apply[T](bus:org.apache.pekko.event.LoggingBus,logSource:T)(implicitevidence$5:org.apache.pekko.event.LogSource[T]):org.apache.pekko.event.LoggingAdapter" title="pekko.event.Logging"><code>Logging</code></a></span> <span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/event/Logging.html#getLogger(org.apache.pekko.event.LoggingBu [...]
<ul>
<li>if it is an Actor or ActorRef, its path is used</li>
<li>in case of a String it is used as is</li>
@@ -558,7 +558,7 @@ system.log.debug("five parameters: {}, {}, {}, {}, {}", args)</code></
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/event/LoggingDocTest.java#L160-L161" target="_blank" title="Go to snippet source">source</a><code class="language-java">final Object[] args = new Object[] {"The", "brown", "fox", "jumps", 42};
system.log().debug("five parameters: {}, {}, {}, {}, {}", args);</code></pre></dd>
</dl>
-<p>The Java <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Class.html" title="java.lang.Class"><code>Class</code></a> of the log source is also included in the generated <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/Logging$$LogEvent.html" title="org.apache.pekko.event.Logging.LogEvent"><code>Logging.LogEvent</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/ak [...]
+<p>The Java <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Class.html" title="java.lang.Class"><code>Class</code></a> of the log source is also included in the generated <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/Logging$$LogEvent.html" title="org.apache.pekko.event.Logging.LogEvent"><code>Logging.LogEvent</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/ak [...]
<h3><a href="#logging-of-dead-letters" name="logging-of-dead-letters" class="anchor"><span class="anchor-link"></span></a>Logging of Dead Letters</h3>
<p>By default messages sent to dead letters are logged at <code>INFO</code> level. Existence of dead letters does not necessarily indicate a problem, but they are logged by default for the sake of caution. After a few messages this logging is turned off, to avoid flooding the logs. You can disable this logging completely or adjust how many dead letters are logged. During system shutdown it is likely that you see dead letters, since pending messages in the actor mailboxes are sent to dead [...]
<pre class="prettyprint"><code class="language-ruby">pekko {
@@ -692,7 +692,7 @@ class MyType(system: ActorSystem) {
<h2><a href="#loggers" name="loggers" class="anchor"><span class="anchor-link"></span></a>Loggers</h2>
<p>Logging is performed asynchronously through an event bus. Log events are processed by an event handler actor that receives the log events in the same order they were emitted.</p><div class="callout note "><div class="callout-title">Note</div>
<p>The event handler actor does not have a bounded inbox and is run on the default dispatcher. This means that logging extreme amounts of data may affect your application badly. This can be somewhat mitigated by using an async logging backend though. (See <a href="logging.html#slf4j-directly">Using the SLF4J API directly</a>)</p></div>
-<p>You can configure which event handlers are created at system start-up and listen to logging events. That is done using the <code>loggers</code> element in the <a href="general/configuration.html">configuration</a>. Here you can also define the log level. More fine grained filtering based on the log source can be implemented in a custom <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/LoggingFilter.html" title="org.apa [...]
+<p>You can configure which event handlers are created at system start-up and listen to logging events. That is done using the <code>loggers</code> element in the <a href="general/configuration.html">configuration</a>. Here you can also define the log level. More fine grained filtering based on the log source can be implemented in a custom <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/LoggingFilter.html" title="org.apa [...]
<pre class="prettyprint"><code class="language-ruby">pekko {
# Loggers to register at boot time (org.apache.pekko.event.Logging$DefaultLogger logs
# to STDOUT)
@@ -772,7 +772,7 @@ import org.apache.pekko.event.Logging.Debug;
<h2><a href="#logging-to-stdout-during-startup-and-shutdown" name="logging-to-stdout-during-startup-and-shutdown" class="anchor"><span class="anchor-link"></span></a>Logging to stdout during startup and shutdown</h2>
<p>When the actor system is starting up and shutting down the configured <code>loggers</code> are not used. Instead log messages are printed to stdout (System.out). The default log level for this stdout logger is <code>WARNING</code> and it can be silenced completely by setting <code>pekko.stdout-loglevel=OFF</code>.</p>
<h2><a href="#slf4j" name="slf4j" class="anchor"><span class="anchor-link"></span></a>SLF4J</h2>
-<p>Pekko provides a logger for <a href="https://www.slf4j.org/">SLF4J</a>. This module is available in the ‘pekko-slf4j.jar’. It has a single dependency: the slf4j-api jar. In your runtime, you also need a SLF4J backend. We recommend <a href="https://logback.qos.ch/">Logback</a>:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>Pekko provides a logger for <a href="https://www.slf4j.org/">SLF4J</a>. This module is available in the ‘pekko-slf4j.jar’. It has a single dependency: the slf4j-api jar. In your runtime, you also need a SLF4J backend. We recommend <a href="https://logback.qos.ch/">Logback</a>:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies ++= Seq(
"org.apache.pekko" %% "pekko-slf4j" % PekkoVersion,
"ch.qos.logback" % "logback-classic" % "1.2.11"
@@ -784,7 +784,7 @@ libraryDependencies ++= Seq(
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -804,12 +804,12 @@ libraryDependencies ++= Seq(
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-slf4j_${versions.ScalaBinary}"
implementation "ch.qos.logback:logback-classic:1.2.11"
}</code></pre></dd></dl>
-<p>You need to enable the Slf4jLogger in the <code>loggers</code> element in the <a href="general/configuration.html">configuration</a>. Here you can also define the log level of the event bus. More fine grained log levels can be defined in the configuration of the SLF4J backend (e.g. logback.xml). You should also define <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/slf4j/Slf4jLoggingFilter.html" title="org.apache.pek [...]
+<p>You need to enable the Slf4jLogger in the <code>loggers</code> element in the <a href="general/configuration.html">configuration</a>. Here you can also define the log level of the event bus. More fine grained log levels can be defined in the configuration of the SLF4J backend (e.g. logback.xml). You should also define <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/slf4j/Slf4jLoggingFilter.html" title="org.apache.pek [...]
<p>If you set the <code>loglevel</code> to a higher level than <code>DEBUG</code>, any <code>DEBUG</code> events will be filtered out already at the source and will never reach the logging backend, regardless of how the backend is configured.</p>
<p>You can enable <code>DEBUG</code> level for <code>pekko.loglevel</code> and control the actual level in the SLF4J backend without any significant overhead, also for production.</p></div>
<pre class="prettyprint"><code class="language-ruby">pekko {
@@ -819,8 +819,8 @@ dependencies {
}
</code></pre>
<p>One gotcha is that the timestamp is attributed in the event handler, not when actually doing the logging.</p>
-<p>The SLF4J logger selected for each log event is chosen based on the <span class="group-scala"><code>Class[_]</code></span> <span class="group-java"><code>Class</code></span> of the log source specified when creating the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.a [...]
-<p>Beware that the actor system’s name is appended to a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="java.lang.String"><code>String</code></a> log source if the LoggingAdapter was created giving an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java">< [...]
+<p>The SLF4J logger selected for each log event is chosen based on the <span class="group-scala"><code>Class[_]</code></span> <span class="group-java"><code>Class</code></span> of the log source specified when creating the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.a [...]
+<p>Beware that the actor system’s name is appended to a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="java.lang.String"><code>String</code></a> log source if the LoggingAdapter was created giving an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java">< [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -837,7 +837,7 @@ dependencies {
<p>This can be avoided by configuring the logging implementation to use a non-blocking appender. Logback provides <a href="https://logback.qos.ch/manual/appenders.html#AsyncAppender">AsyncAppender</a> that does this.</p>
<h3><a href="#logback-configuration" name="logback-configuration" class="anchor"><span class="anchor-link"></span></a>Logback configuration</h3>
<p>Logback has flexible configuration options and details can be found in the <a href="https://logback.qos.ch/manual/configuration.html">Logback manual</a> and other external resources.</p>
-<p>One part that is important to highlight is the importance of configuring an <a href="https://logback.qos.ch/manual/appenders.html#AsyncAppender">AsyncAppender</a>, because it offloads rendering of logging events to a background thread, increasing performance. It doesn’t block the threads of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>Act [...]
+<p>One part that is important to highlight is the importance of configuring an <a href="https://logback.qos.ch/manual/appenders.html#AsyncAppender">AsyncAppender</a>, because it offloads rendering of logging events to a background thread, increasing performance. It doesn’t block the threads of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>Act [...]
<p>A starting point for configuration of <code>logback.xml</code> for production:</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/actor-typed-tests/src/test/resources/logback-doc-prod.xml" target="_blank" title="Go to snippet source">source</a><code class="language-xml"><?xml version="1.0" encoding="UTF-8"?>
<configuration>
@@ -909,7 +909,7 @@ dependencies {
<h3><a href="#more-accurate-timestamps-for-log-output-in-mdc" name="more-accurate-timestamps-for-log-output-in-mdc" class="anchor"><span class="anchor-link"></span></a>More accurate timestamps for log output in MDC</h3>
<p>Pekko’s logging is asynchronous which means that the timestamp of a log entry is taken from when the underlying logger implementation is called, which can be surprising at first. If you want to more accurately output the timestamp, use the MDC attribute <code>pekkoTimestamp</code>.</p>
<h3><a href="#mdc-values-defined-by-the-application" name="mdc-values-defined-by-the-application" class="anchor"><span class="anchor-link"></span></a>MDC values defined by the application</h3>
-<p>One useful feature available in Slf4j is <a href="https://logback.qos.ch/manual/mdc.html">MDC</a>, Pekko has a way to let the application specify custom values, for this you need to use a specialized <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0. [...]
+<p>One useful feature available in Slf4j is <a href="https://logback.qos.ch/manual/mdc.html">MDC</a>, Pekko has a way to let the application specify custom values, for this you need to use a specialized <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0. [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -923,7 +923,7 @@ final DiagnosticLoggingAdapter log = Logging.getLogger(this);
</code></pre></dd>
</dl>
<p>Once you have the logger, you need to add the custom values before you log something. This way, the values will be put in the SLF4J MDC right before appending the log and removed after.</p><div class="callout note "><div class="callout-title">Note</div>
-<p>The cleanup (removal) should be done in the actor at the end, otherwise, next message will log with same MDC values, if it is not set to a new map. Use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/DiagnosticLoggingAdapter.html#clearMDC():Unit" title="org.apache.pekko.event.DiagnosticLoggingAdapter"><code>log.clearMDC()</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93 [...]
+<p>The cleanup (removal) should be done in the actor at the end, otherwise, next message will log with same MDC values, if it is not set to a new map. Use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/DiagnosticLoggingAdapter.html#clearMDC():Unit" title="org.apache.pekko.event.DiagnosticLoggingAdapter"><code>log.clearMDC()</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68 [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1004,15 +1004,15 @@ class MdcActorMixin extends Actor with pekko.actor.DiagnosticActorLogging {
</code></pre>
<h3><a href="#using-markers" name="using-markers" class="anchor"><span class="anchor-link"></span></a>Using Markers</h3>
<p>Some logging libraries allow, in addition to MDC data, attaching so called “markers” to log statements. These are used to filter out rare and special events, for example you might want to mark logs that detect some malicious activity and mark them with a <code>SECURITY</code> tag, and in your appender configuration make these trigger emails and other notifications immediately.</p>
-<p>Markers are available through the LoggingAdapters, when obtained via <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/Logging$.html#withMarker(logSource:org.apache.pekko.actor.Actor):org.apache.pekko.event.DiagnosticMarkerBusLoggingAdapter" title="org.apache.pekko.event.Logging"><code>Logging.withMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/ap [...]
+<p>Markers are available through the LoggingAdapters, when obtained via <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/Logging$.html#withMarker(logSource:org.apache.pekko.actor.Actor):org.apache.pekko.event.DiagnosticMarkerBusLoggingAdapter" title="org.apache.pekko.event.Logging"><code>Logging.withMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/ap [...]
<p>The slf4j bridge provided by Pekko in <code>pekko-slf4j</code> will automatically pick up this marker value and make it available to SLF4J.</p>
<p>Pekko is logging some events with markers. Some of these events also include structured MDC properties. </p>
<ul>
<li>The “SECURITY” marker is used for highlighting security related events or incidents.</li>
- <li>Pekko Actor is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorLogMarker$.html" title="org.apache.pekko.actor.ActorLogMarker"><code>ActorLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorLogMarker$.html" title="org.apache.pekko.actor.ActorLogMarker"><code>ActorLogMarker</code></a></sp [...]
- <li>Pekko Cluster is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ClusterLogMarker$.html" title="org.apache.pekko.cluster.ClusterLogMarker"><code>ClusterLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/ClusterLogMarker$.html" title="org.apache.pekko.cluster.ClusterLogMarker"><code>ClusterLo [...]
- <li>Pekko Remoting is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/RemoteLogMarker$.html" title="org.apache.pekko.remote.RemoteLogMarker"><code>RemoteLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/RemoteLogMarker$.html" title="org.apache.pekko.remote.RemoteLogMarker"><code>RemoteLogMarker</ [...]
- <li>Pekko Cluster Sharding is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/sharding/ShardingLogMarker$.html" title="org.apache.pekko.cluster.sharding.ShardingLogMarker"><code>ShardingLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/cluster/sharding/ShardingLogMarker$.html" title="org.apache.pekko.c [...]
+ <li>Pekko Actor is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorLogMarker$.html" title="org.apache.pekko.actor.ActorLogMarker"><code>ActorLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorLogMarker$.html" title="org.apache.pekko.actor.ActorLogMarker"><code>ActorLogMarker</code></a></sp [...]
+ <li>Pekko Cluster is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ClusterLogMarker$.html" title="org.apache.pekko.cluster.ClusterLogMarker"><code>ClusterLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/ClusterLogMarker$.html" title="org.apache.pekko.cluster.ClusterLogMarker"><code>ClusterLo [...]
+ <li>Pekko Remoting is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/RemoteLogMarker$.html" title="org.apache.pekko.remote.RemoteLogMarker"><code>RemoteLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/RemoteLogMarker$.html" title="org.apache.pekko.remote.RemoteLogMarker"><code>RemoteLogMarker</ [...]
+ <li>Pekko Cluster Sharding is using the markers defined in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/sharding/ShardingLogMarker$.html" title="org.apache.pekko.cluster.sharding.ShardingLogMarker"><code>ShardingLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/cluster/sharding/ShardingLogMarker$.html" title="org.apache.pekko.c [...]
</ul>
<p>Markers and MDC properties are automatically picked up by the <a href="https://github.com/logstash/logstash-logback-encoder">Logstash Logback encoder</a>.</p>
<p>The marker can be included in the Logback output with <code>%marker</code> and all MDC properties as key-value entries with <code>%mdc</code>.</p>
@@ -1021,8 +1021,8 @@ class MdcActorMixin extends Actor with pekko.actor.DiagnosticActorLogging {
</encoder>
</code></pre>
<h4><a href="#using-slf4js-markers" name="using-slf4js-markers" class="anchor"><span class="anchor-link"></span></a>Using SLF4J’s Markers</h4>
-<p>It is also possible to use the <a href="https://www.javadoc.io/doc/org.slf4j/slf4j-api/latest/org.slf4j/org/slf4j/Marker.html" title="org.slf4j.Marker"><code>org.slf4j.Marker</code></a> with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+265 [...]
-<p>Since the pekko-actor library avoids depending on any specific logging library, the support for this is included in <code>pekko-slf4j</code>, which provides the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/event/slf4j/Slf4jLogMarker.html" title="org.apache.pekko.event.slf4j.Slf4jLogMarker"><code>Slf4jLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/o [...]
+<p>It is also possible to use the <a href="https://www.javadoc.io/doc/org.slf4j/slf4j-api/latest/org.slf4j/org/slf4j/Marker.html" title="org.slf4j.Marker"><code>org.slf4j.Marker</code></a> with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/LoggingAdapter.html" title="org.apache.pekko.event.LoggingAdapter"><code>LoggingAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+265 [...]
+<p>Since the pekko-actor library avoids depending on any specific logging library, the support for this is included in <code>pekko-slf4j</code>, which provides the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/event/slf4j/Slf4jLogMarker.html" title="org.apache.pekko.event.slf4j.Slf4jLogMarker"><code>Slf4jLogMarker</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/o [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/logging.md">here</a>.
</div>
@@ -1112,7 +1112,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/mailboxes.html b/content/mailboxes.html
index 24eac16..a36f46d 100644
--- a/content/mailboxes.html
+++ b/content/mailboxes.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the full documentation of this feature and for new projects see <a href="typed/mailboxes.html">mailboxes</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Mailboxes, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Mailboxes, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,24 +445,24 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#introduction" name="introduction" class="anchor"><span class="anchor-link"></span></a>Introduction</h2>
-<p>A Pekko <code>Mailbox</code> holds the messages that are destined for an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span>. Normally each <code>Actor [...]
+<p>A Pekko <code>Mailbox</code> holds the messages that are destined for an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Actor.html" title="org.apache.pekko.actor.Actor"><code>Actor</code></a></span>. Normally each <code>Actor [...]
<p>For more details on advanced mailbox config and custom mailbox implementations, see <a href="typed/mailboxes.html#mailbox-implementations">Mailboxes</a>.</p>
<h2><a href="#mailbox-selection" name="mailbox-selection" class="anchor"><span class="anchor-link"></span></a>Mailbox Selection</h2>
<h3><a href="#default-mailbox" name="default-mailbox" class="anchor"><span class="anchor-link"></span></a>Default Mailbox</h3>
<p>The default mailbox is used when the mailbox is not specified. This is an unbounded mailbox, backed by a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/ConcurrentLinkedQueue.html" title="java.util.concurrent.ConcurrentLinkedQueue"><code>java.util.concurrent.ConcurrentLinkedQueue</code></a>.</p>
-<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/SingleConsumerOnlyUnboundedMailbox.html" title="org.apache.pekko.dispatch.SingleConsumerOnlyUnboundedMailbox"><code>SingleConsumerOnlyUnboundedMailbox</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/SingleConsumerOnlyUnboundedMailbox.html" title="org.apache.pekko.dispatch.SingleCo [...]
+<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/SingleConsumerOnlyUnboundedMailbox.html" title="org.apache.pekko.dispatch.SingleConsumerOnlyUnboundedMailbox"><code>SingleConsumerOnlyUnboundedMailbox</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/SingleConsumerOnlyUnboundedMailbox.html" title="org.apache.pekko.dispatch.SingleCo [...]
<p>Configuration of <code>SingleConsumerOnlyUnboundedMailbox</code> as default mailbox:</p>
<pre><code>pekko.actor.default-mailbox {
mailbox-type = "org.apache.pekko.dispatch.SingleConsumerOnlyUnboundedMailbox"
}
</code></pre>
<h3><a href="#requiring-a-message-queue-type-for-an-actor" name="requiring-a-message-queue-type-for-an-actor" class="anchor"><span class="anchor-link"></span></a>Requiring a Message Queue Type for an Actor</h3>
-<p>It is possible to require a certain type of message queue for a certain type of actor by having that actor <span class="group-scala">extend</span><span class="group-java">implement</span> the parameterized <span class="group-scala">trait</span><span class="group-java">interface</span> <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/RequiresMessageQueue.html" title="org.apache.pekko.dispatch.RequiresMessageQueue">< [...]
+<p>It is possible to require a certain type of message queue for a certain type of actor by having that actor <span class="group-scala">extend</span><span class="group-java">implement</span> the parameterized <span class="group-scala">trait</span><span class="group-java">interface</span> <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/RequiresMessageQueue.html" title="org.apache.pekko.dispatch.RequiresMessageQueue">< [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -498,10 +498,10 @@ pekko.actor.mailbox.requirements {
</code></pre>
<p>The given requirement names a class or interface which will then be ensured to be a supertype of the message queue’s implementation. In case of a conflict—e.g. if the actor requires a mailbox type which does not satisfy this requirement—then actor creation will fail.</p>
<h3><a href="#how-the-mailbox-type-is-selected" name="how-the-mailbox-type-is-selected" class="anchor"><span class="anchor-link"></span></a>How the Mailbox Type is Selected</h3>
-<p>When an actor is created, the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefProvider.html" title="org.apache.pekko.actor.ActorRefProvider"><code>ActorRefProvider</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefProvider.html" title="org.apache.pekko.actor.ActorRefProvider"><code>ActorRefProvider</code></a></span> fir [...]
+<p>When an actor is created, the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefProvider.html" title="org.apache.pekko.actor.ActorRefProvider"><code>ActorRefProvider</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefProvider.html" title="org.apache.pekko.actor.ActorRefProvider"><code>ActorRefProvider</code></a></span> fir [...]
<ol>
<li>If the actor’s deployment configuration section contains a <code>mailbox</code> key, this refers to a configuration section describing the mailbox type.</li>
- <li>If the actor’s <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> contains a mailbox selection then that names a configuration section descri [...]
+ <li>If the actor’s <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> contains a mailbox selection then that names a configuration section descri [...]
<li>If the dispatcher’s configuration section contains a <code>mailbox-type</code> key the same section will be used to configure the mailbox type.</li>
<li>If the actor requires a mailbox type as described above then the mapping for that requirement will be used to determine the mailbox type to be used; if that fails then the dispatcher’s requirement—if any—will be tried instead.</li>
<li>If the dispatcher requires a mailbox type as described above then the mapping for that requirement will be used to determine the mailbox type to be used.</li>
@@ -698,7 +698,7 @@ val myActor = context.actorOf(Props[MyActor]().withMailbox("prio-mailbox&qu
mailbox-type = "org.apache.pekko.dispatch.UnboundedControlAwareMailbox"
//Other dispatcher configuration goes here
}</code></pre>
-<p>Control messages need to extend the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/ControlMessage.html" title="org.apache.pekko.dispatch.ControlMessage"><code>ControlMessage</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/ControlMessage.html" title="org.apache.pekko.dispatch.ControlMessage"><code>ControlMessage</code></a></spa [...]
+<p>Control messages need to extend the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/ControlMessage.html" title="org.apache.pekko.dispatch.ControlMessage"><code>ControlMessage</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/ControlMessage.html" title="org.apache.pekko.dispatch.ControlMessage"><code>ControlMessage</code></a></spa [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -769,7 +769,7 @@ Logs:
*/</code></pre></dd>
</dl>
<h2><a href="#special-semantics-of-system-actorof" name="special-semantics-of-system-actorof" class="anchor"><span class="anchor-link"></span></a>Special Semantics of <code>system.actorOf</code></h2>
-<p>In order to make <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(props:org.apache.pekko.actor.Props):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorRefFactory"><code>system.actorOf</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(org.apache.pekko.actor.Prop [...]
+<p>In order to make <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(props:org.apache.pekko.actor.Props):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorRefFactory"><code>system.actorOf</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(org.apache.pekko.actor.Prop [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -875,7 +875,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/multi-jvm-testing.html b/content/multi-jvm-testing.html
index ea5470e..adb7923 100644
--- a/content/multi-jvm-testing.html
+++ b/content/multi-jvm-testing.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -634,7 +634,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/multi-node-testing.html b/content/multi-node-testing.html
index b76c801..22c5cba 100644
--- a/content/multi-node-testing.html
+++ b/content/multi-node-testing.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#multi-node-testing" name="multi-node-testing" class="anchor"><span class="anchor-link"></span></a>Multi Node Testing</h1>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Multi Node Testing, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Multi Node Testing, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-multi-node-testkit" % PekkoVersion % Test</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-multi-node-testkit" % PekkoV
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -443,7 +443,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-multi-node-testkit" % PekkoV
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
testImplementation "org.apache.pekko:pekko-multi-node-testkit_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -451,7 +451,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Multi-node Testkit</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-multi-node-testkit</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -480,11 +480,11 @@ dependencies {
<ul>
<li><a href="multi-node-testing.html#the-test-conductor">The Test Conductor</a>. that coordinates and controls the nodes under test.</li>
- <li><a href="multi-node-testing.html#the-multi-node-spec">The Multi Node Spec</a>. that is a convenience wrapper for starting the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testconductor/TestConductor$.html" title="org.apache.pekko.remote.testconductor.TestConductor"><code>TestConductor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/ [...]
+ <li><a href="multi-node-testing.html#the-multi-node-spec">The Multi Node Spec</a>. that is a convenience wrapper for starting the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testconductor/TestConductor$.html" title="org.apache.pekko.remote.testconductor.TestConductor"><code>TestConductor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/ [...]
<li><a href="multi-node-testing.html#the-sbtmultijvm-plugin">The SbtMultiJvm Plugin</a>. that starts tests in multiple JVMs possibly on multiple machines.</li>
</ul>
<h2><a href="#the-test-conductor" name="the-test-conductor" class="anchor"><span class="anchor-link"></span></a>The Test Conductor</h2>
-<p>The basis for the multi node testing is the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testconductor/TestConductor$.html" title="org.apache.pekko.remote.testconductor.TestConductor"><code>TestConductor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testconductor/TestConductor$.html" title="org.apache.pekko.remote.testconducto [...]
+<p>The basis for the multi node testing is the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testconductor/TestConductor$.html" title="org.apache.pekko.remote.testconductor.TestConductor"><code>TestConductor</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testconductor/TestConductor$.html" title="org.apache.pekko.remote.testconducto [...]
<ul>
<li>Node Address Lookup: Finding out the full path to another test node (No need to share configuration between test nodes)</li>
<li>Node Barrier Coordination: Waiting for other nodes at named barriers.</li>
@@ -492,9 +492,9 @@ dependencies {
</ul>
<p>This is a schematic overview of the test conductor.</p>
<p><img src="./images/pekko-remote-testconductor.png" alt="pekko-remote-testconductor.png" /></p>
-<p>The test conductor server is responsible for coordinating barriers and sending commands to the test conductor clients that act upon them, e.g. throttling network traffic to/from another client. More information on the possible operations is available in the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testconductor/Conductor.html" title="org.apache.pekko.remote.testconductor.Conductor"><code>remote.testconductor. [...]
+<p>The test conductor server is responsible for coordinating barriers and sending commands to the test conductor clients that act upon them, e.g. throttling network traffic to/from another client. More information on the possible operations is available in the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testconductor/Conductor.html" title="org.apache.pekko.remote.testconductor.Conductor"><code>remote.testconductor. [...]
<h2><a href="#the-multi-node-spec" name="the-multi-node-spec" class="anchor"><span class="anchor-link"></span></a>The Multi Node Spec</h2>
-<p>The Multi Node Spec consists of two parts. The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeConfig.html" title="org.apache.pekko.remote.testkit.MultiNodeConfig"><code>MultiNodeConfig</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeConfig.html" title="org.apache.pekko.remote.testkit.MultiNodeConf [...]
+<p>The Multi Node Spec consists of two parts. The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeConfig.html" title="org.apache.pekko.remote.testkit.MultiNodeConfig"><code>MultiNodeConfig</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeConfig.html" title="org.apache.pekko.remote.testkit.MultiNodeConf [...]
<p>The setup of the <code>MultiNodeSpec</code> is configured through java system properties that you set on all JVMs that’s going to run a node under test. These can be set on the JVM command line with <code>-Dproperty=value</code>.</p>
<dl>
<dt>These are the available properties</dt>
@@ -549,7 +549,7 @@ dependencies {
</code></pre>
<p>More than one test name can be listed to run multiple specific tests. Tab completion in sbt makes it easy to complete the test names.</p>
<h2><a href="#a-multi-node-testing-example" name="a-multi-node-testing-example" class="anchor"><span class="anchor-link"></span></a>A Multi Node Testing Example</h2>
-<p>First we need some scaffolding to hook up the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeSpec.html" title="org.apache.pekko.remote.testkit.MultiNodeSpec"><code>MultiNodeSpec</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeSpec.html" title="org.apache.pekko.remote.testkit.MultiNodeSpec"><code>M [...]
+<p>First we need some scaffolding to hook up the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeSpec.html" title="org.apache.pekko.remote.testkit.MultiNodeSpec"><code>MultiNodeSpec</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/testkit/MultiNodeSpec.html" title="org.apache.pekko.remote.testkit.MultiNodeSpec"><code>M [...]
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/remote-tests/src/test/scala/org/apache/pekko/remote/testkit/STMultiNodeSpec.scala#L15-L36" target="_blank" title="Go to snippet source">source</a><code class="language-scala">package org.apache.pekko.remote.testkit
import scala.language.implicitConversions
@@ -733,7 +733,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/paradox.json b/content/paradox.json
index dc6f97b..f9cccdc 100644
--- a/content/paradox.json
+++ b/content/paradox.json
@@ -1,4 +1,4 @@
{
"name" : "Pekko",
- "version" : "0.0.0+26532-3d93c297-SNAPSHOT"
+ "version" : "0.0.0+26533-ec68a528-SNAPSHOT"
}
\ No newline at end of file
diff --git a/content/persistence-fsm.html b/content/persistence-fsm.html
index ced569e..65a4c4d 100644
--- a/content/persistence-fsm.html
+++ b/content/persistence-fsm.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -420,7 +420,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h1><a href="#classic-persistent-fsm" name="classic-persistent-fsm" class="anchor"><span class="anchor-link"></span></a>Classic Persistent FSM</h1><div class="callout note "><div class="callout-title">Note</div>
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>Persistent FSMs are part of Pekko persistence, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>Persistent FSMs are part of Pekko persistence, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-persistence" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -429,7 +429,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence" % PekkoVersion<
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -444,7 +444,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence" % PekkoVersion<
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-persistence_${versions.ScalaBinary}"
}</code></pre></dd></dl><div class="callout warning "><div class="callout-title">Warning</div>
@@ -829,16 +829,16 @@ public ShoppingCart applyEvent(DomainEvent event, ShoppingCart currentData) {
</dl>
<p>On recovery state data is initialized according to the latest available snapshot, then the remaining domain events are replayed, triggering the <code>applyEvent</code> method.</p>
<h2><a href="#migration-to-eventsourcedbehavior" name="migration-to-eventsourcedbehavior" class="anchor"><span class="anchor-link"></span></a>Migration to EventSourcedBehavior</h2>
-<p>Persistent FSMs can be represented using <a href="typed/persistence.html">Persistence Typed</a>. The data stored by Persistence FSM can be read by an <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/javadsl/EventSourcedBehavior.html" title="org.apache.pekko.persistence.typed.javadsl.EventSourcedBehavior"><code>EventSourcedBehavior</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/a [...]
+<p>Persistent FSMs can be represented using <a href="typed/persistence.html">Persistence Typed</a>. The data stored by Persistence FSM can be read by an <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/javadsl/EventSourcedBehavior.html" title="org.apache.pekko.persistence.typed.javadsl.EventSourcedBehavior"><code>EventSourcedBehavior</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/a [...]
<p>Before reading the migration guide it is advised to understand <a href="typed/persistence.html">Persistence Typed</a>. </p>
<h3><a href="#migration-steps" name="migration-steps" class="anchor"><span class="anchor-link"></span></a>Migration steps</h3>
<ol>
- <li>Modify or create new commands to include <code>replyTo</code> <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a> [...]
+ <li>Modify or create new commands to include <code>replyTo</code> <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRef.html" title="org.apache.pekko.actor.typed.ActorRef"><code>ActorRef</code></a> [...]
<li>Typically persisted events will remain the same</li>
<li>Create an <code>EventSourcedBehavior</code> that mimics the old <code>PersistentFSM</code></li>
<li>Replace any state timeouts with <code>Behaviors.withTimers</code> either hard coded or stored in the state</li>
- <li>Add an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/EventAdapter.html" title="org.apache.pekko.persistence.typed.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/EventAdapter.html" title="org.apache.pekko.persistence.typed.EventAdapter"><code>EventAdapter</code></a></span> [...]
- <li>If snapshots are used add a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/SnapshotAdapter.html" title="org.apache.pekko.persistence.typed.SnapshotAdapter"><code>SnapshotAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/SnapshotAdapter.html" title="org.apache.pekko.persistence.typed.SnapshotAdapter"> [...]
+ <li>Add an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/EventAdapter.html" title="org.apache.pekko.persistence.typed.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/EventAdapter.html" title="org.apache.pekko.persistence.typed.EventAdapter"><code>EventAdapter</code></a></span> [...]
+ <li>If snapshots are used add a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/SnapshotAdapter.html" title="org.apache.pekko.persistence.typed.SnapshotAdapter"><code>SnapshotAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/SnapshotAdapter.html" title="org.apache.pekko.persistence.typed.SnapshotAdapter"> [...]
</ol>
<p>The following is the shopping cart example above converted to an <code>EventSourcedBehavior</code>. </p>
<p>The new commands, note the replyTo field for getting the current cart.</p>
@@ -1081,7 +1081,7 @@ public EventHandler<State, DomainEvent> eventHandler() {
return eventHandlerBuilder.build();
}</code></pre></dd>
</dl>
-<p>The last step is the adapters that will allow the new <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/javadsl/EventSourcedBehavior.html" title="org.apache.pekko.persistence.typed.javadsl.EventSourcedBehavior"><code>EventSourcedBehavior</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/scaladsl/EventSourcedBehavi [...]
+<p>The last step is the adapters that will allow the new <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/javadsl/EventSourcedBehavior.html" title="org.apache.pekko.persistence.typed.javadsl.EventSourcedBehavior"><code>EventSourcedBehavior</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/scaladsl/EventSourcedBehavi [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1134,7 +1134,7 @@ public EventHandler<State, DomainEvent> eventHandler() {
}
}</code></pre></dd>
</dl>
-<p>The snapshot adapter needs to adapt an internal type of PersistentFSM so a helper function is provided to build the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/SnapshotAdapter.html" title="org.apache.pekko.persistence.typed.SnapshotAdapter"><code>SnapshotAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/ty [...]
+<p>The snapshot adapter needs to adapt an internal type of PersistentFSM so a helper function is provided to build the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/SnapshotAdapter.html" title="org.apache.pekko.persistence.typed.SnapshotAdapter"><code>SnapshotAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/ty [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1171,7 +1171,7 @@ public SnapshotAdapter<State> snapshotAdapter() {
});
}</code></pre></dd>
</dl>
-<p>That concludes all the steps to allow an <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/javadsl/EventSourcedBehavior.html" title="org.apache.pekko.persistence.typed.javadsl.EventSourcedBehavior"><code>EventSourcedBehavior</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/typed/scaladsl/EventSourcedBehavior.html" titl [...]
+<p>That concludes all the steps to allow an <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/javadsl/EventSourcedBehavior.html" title="org.apache.pekko.persistence.typed.javadsl.EventSourcedBehavior"><code>EventSourcedBehavior</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/typed/scaladsl/EventSourcedBehavior.html" titl [...]
<p>There is one case where <a href="additional/rolling-updates.html#migrating-from-persistentfsm-to-eventsourcedbehavior">a full shutdown and startup is required</a>.</p></div>
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/persistence-fsm.md">here</a>.
@@ -1258,7 +1258,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/persistence-journals.html b/content/persistence-journals.html
index d687e69..6abcd7a 100644
--- a/content/persistence-journals.html
+++ b/content/persistence-journals.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -848,7 +848,7 @@ my-snapshot-store {
<p>Don’t run snapshot store tasks/futures on the system default dispatcher, since that might starve other tasks.</p>
<h2><a href="#plugin-tck" name="plugin-tck" class="anchor"><span class="anchor-link"></span></a>Plugin TCK</h2>
<p>In order to help developers build correct and high quality storage plugins, we provide a Technology Compatibility Kit (<a href="https://en.wikipedia.org/wiki/Technology_Compatibility_Kit">TCK</a> for short).</p>
-<p>The TCK is usable from Java as well as Scala projects. To test your implementation (independently of language) you need to include the pekko-persistence-tck dependency:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>The TCK is usable from Java as well as Scala projects. To test your implementation (independently of language) you need to include the pekko-persistence-tck dependency:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-persistence-tck" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -857,7 +857,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-tck" % PekkoVers
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -872,7 +872,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-tck" % PekkoVers
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-persistence-tck_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -1096,7 +1096,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/persistence-plugins.html b/content/persistence-plugins.html
index c25d412..af61aec 100644
--- a/content/persistence-plugins.html
+++ b/content/persistence-plugins.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -654,7 +654,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/persistence-query-leveldb.html b/content/persistence-query-leveldb.html
index 82ed970..47495bf 100644
--- a/content/persistence-query-leveldb.html
+++ b/content/persistence-query-leveldb.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -419,7 +419,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<h1><a href="#persistence-query-for-leveldb" name="persistence-query-for-leveldb" class="anchor"><span class="anchor-link"></span></a>Persistence Query for LevelDB</h1>
<p>The LevelDB journal and query plugin is deprecated and it is not advised to build new applications with it. As a replacement we recommend using <a href="https://doc.akka.io/docs/akka-persistence-jdbc/current/index.html">Pekko Persistence JDBC</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Persistence Query, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Persistence Query, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -428,7 +428,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVe
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -443,7 +443,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVe
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-persistence-query_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -695,7 +695,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/persistence-query.html b/content/persistence-query.html
index d0e43ab..241722e 100644
--- a/content/persistence-query.html
+++ b/content/persistence-query.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#persistence-query" name="persistence-query" class="anchor"><span class="anchor-link"></span></a>Persistence Query</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Persistence Query, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Persistence Query, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVe
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-persistence-query" % PekkoVe
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-persistence-query_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -457,7 +457,7 @@ dependencies {
<p><strong>Each read journal must explicitly document which types of queries it supports.</strong> Refer to your journal’s plugins documentation for details on which queries and semantics it supports.</p>
<p>While Pekko Persistence Query does not provide actual implementations of ReadJournals, it defines a number of pre-defined query types for the most common query scenarios, that most journals are likely to implement (however they are not required to).</p>
<h2><a href="#read-journals" name="read-journals" class="anchor"><span class="anchor-link"></span></a>Read Journals</h2>
-<p>In order to issue queries one has to first obtain an instance of a <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/ReadJournal.html" title="org.apache.pekko.persistence.query.javadsl.ReadJournal"><code>ReadJournal</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/ReadJournal.html" title="org.apa [...]
+<p>In order to issue queries one has to first obtain an instance of a <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/ReadJournal.html" title="org.apache.pekko.persistence.query.javadsl.ReadJournal"><code>ReadJournal</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/ReadJournal.html" title="org.apa [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -492,10 +492,10 @@ source.runForeach(event -> System.out.println("Event: " + event), s
<p>Read journal implementations are available as <a href="https://akka.io/community/#plugins-to-akka-persistence-query">Community plugins</a>.</p>
<h3><a href="#predefined-queries" name="predefined-queries" class="anchor"><span class="anchor-link"></span></a>Predefined queries</h3>
<p>Pekko persistence query comes with a number of query interfaces built in and suggests Journal implementors to implement them according to the semantics described below. It is important to notice that while these query types are very common a journal is not obliged to implement all of them - for example because in a given journal such query would be significantly inefficient.</p><div class="callout note "><div class="callout-title">Note</div>
-<p>Refer to the documentation of the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/ReadJournal.html" title="org.apache.pekko.persistence.query.javadsl.ReadJournal"><code>ReadJournal</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/ReadJournal.html" title="org.apache.pekko.persistence.query.scala [...]
+<p>Refer to the documentation of the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/ReadJournal.html" title="org.apache.pekko.persistence.query.javadsl.ReadJournal"><code>ReadJournal</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/ReadJournal.html" title="org.apache.pekko.persistence.query.scala [...]
<p>The predefined queries are:</p>
<h4><a href="#persistenceidsquery-and-currentpersistenceidsquery" name="persistenceidsquery-and-currentpersistenceidsquery" class="anchor"><span class="anchor-link"></span></a>PersistenceIdsQuery and CurrentPersistenceIdsQuery</h4>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/PersistenceIdsQuery.html" title="org.apache.pekko.persistence.query.javadsl.PersistenceIdsQuery"><code>persistenceIds</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/PersistenceIdsQuery.html" title="org.apache.pekko.persistence.query.scaladsl.Per [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/PersistenceIdsQuery.html" title="org.apache.pekko.persistence.query.javadsl.PersistenceIdsQuery"><code>persistenceIds</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/PersistenceIdsQuery.html" title="org.apache.pekko.persistence.query.scaladsl.Per [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -504,7 +504,7 @@ source.runForeach(event -> System.out.println("Event: " + event), s
<dd>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/persistence/PersistenceQueryDocTest.java#L237" target="_blank" title="Go to snippet source">source</a><code class="language-java">readJournal.persistenceIds();</code></pre></dd>
</dl>
-<p>If your usage does not require a live stream, you can use the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/CurrentPersistenceIdsQuery.html" title="org.apache.pekko.persistence.query.javadsl.CurrentPersistenceIdsQuery"><code>currentPersistenceIds</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scalad [...]
+<p>If your usage does not require a live stream, you can use the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/CurrentPersistenceIdsQuery.html" title="org.apache.pekko.persistence.query.javadsl.CurrentPersistenceIdsQuery"><code>currentPersistenceIds</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scalad [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -514,7 +514,7 @@ source.runForeach(event -> System.out.println("Event: " + event), s
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/persistence/PersistenceQueryDocTest.java#L250" target="_blank" title="Go to snippet source">source</a><code class="language-java">readJournal.currentPersistenceIds();</code></pre></dd>
</dl>
<h4><a href="#eventsbypersistenceidquery-and-currenteventsbypersistenceidquery" name="eventsbypersistenceidquery-and-currenteventsbypersistenceidquery" class="anchor"><span class="anchor-link"></span></a>EventsByPersistenceIdQuery and CurrentEventsByPersistenceIdQuery</h4>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByPersistenceIdQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByPersistenceIdQuery"><code>eventsByPersistenceId</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/EventsByPersistenceIdQuery.html" title="org.apache.pekko.pe [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByPersistenceIdQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByPersistenceIdQuery"><code>eventsByPersistenceId</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/EventsByPersistenceIdQuery.html" title="org.apache.pekko.pe [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -525,10 +525,10 @@ source.runForeach(event -> System.out.println("Event: " + event), s
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/persistence/PersistenceQueryDocTest.java#L263" target="_blank" title="Go to snippet source">source</a><code class="language-java">readJournal.eventsByPersistenceId("user-us-1337", 0L, Long.MAX_VALUE);</code></pre></dd>
</dl>
<p>Most journals will have to revert to polling in order to achieve this, which can typically be configured with a <code>refresh-interval</code> configuration property.</p>
-<p>If your usage does not require a live stream, you can use the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/CurrentEventsByPersistenceIdQuery.html" title="org.apache.pekko.persistence.query.javadsl.CurrentEventsByPersistenceIdQuery"><code>currentEventsByPersistenceId</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/per [...]
+<p>If your usage does not require a live stream, you can use the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/CurrentEventsByPersistenceIdQuery.html" title="org.apache.pekko.persistence.query.javadsl.CurrentEventsByPersistenceIdQuery"><code>currentEventsByPersistenceId</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/per [...]
<h4><a href="#eventsbytag-and-currenteventsbytag" name="eventsbytag-and-currenteventsbytag" class="anchor"><span class="anchor-link"></span></a>EventsByTag and CurrentEventsByTag</h4>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByTagQuery"><code>eventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.scaladsl.EventsByTagQuer [...]
-<p>Some journals may support <a href="typed/persistence.html#tagging">tagging of events</a> or <a href="persistence.html#event-adapters">Event Adapters</a> that wraps the events in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/Tagged.html" title="org.apache.pekko.persistence.journal.Tagged"><code>persistence.journal.Tagged</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/ [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByTagQuery"><code>eventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.scaladsl.EventsByTagQuer [...]
+<p>Some journals may support <a href="typed/persistence.html#tagging">tagging of events</a> or <a href="persistence.html#event-adapters">Event Adapters</a> that wraps the events in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/Tagged.html" title="org.apache.pekko.persistence.journal.Tagged"><code>persistence.journal.Tagged</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/ [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -565,7 +565,7 @@ public Set<String> tagsFor(Event event) {
return tags;
}</code></pre></dd>
</dl><div class="callout note "><div class="callout-title">Note</div>
-<p>A very important thing to keep in mind when using queries spanning multiple persistenceIds, such as <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByTagQuery"><code>EventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/quer [...]
+<p>A very important thing to keep in mind when using queries spanning multiple persistenceIds, such as <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByTagQuery"><code>EventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/quer [...]
<p>Journals <em>may</em> choose to opt for strict ordering of the events, and should then document explicitly what kind of ordering guarantee they provide - for example “<em>ordered by timestamp ascending, independently of persistenceId</em>” is easy to achieve on relational databases, yet may be hard to implement efficiently on plain key-value datastores.</p></div>
<p>In the example below we query all events which have been tagged (we assume this was performed by the write-side using <a href="typed/persistence.html#tagging">tagging of events</a> or <a href="persistence.html#event-adapters">Event Adapters</a>, or that the journal is smart enough that it can figure out what we mean by this tag - for example if the journal stored the events as json it may try to find those with the field <code>tag</code> set to this value etc.).</p>
<dl>
@@ -611,13 +611,13 @@ Source<EventEnvelope, NotUsed> furtherOrders =
readJournal.eventsByTag("order-completed", new Sequence(10));</code></pre></dd>
</dl>
<p>As you can see, we can use all the usual stream operators available from <a href="stream/index.html">Streams</a> on the resulting query stream, including for example taking the first 10 and cancelling the stream. It is worth pointing out that the built-in <code>EventsByTag</code> query has an optionally supported offset parameter (of type <code>Long</code>) which the journals can use to implement resumable-streams. For example a journal may be able to use a WHERE clause to begin the r [...]
-<p>If your usage does not require a live stream, you can use the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/CurrentEventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.CurrentEventsByTagQuery"><code>currentEventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/Curren [...]
+<p>If your usage does not require a live stream, you can use the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/CurrentEventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.CurrentEventsByTagQuery"><code>currentEventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/Curren [...]
<h4><a href="#eventsbyslice-and-currenteventsbyslice" name="eventsbyslice-and-currenteventsbyslice" class="anchor"><span class="anchor-link"></span></a>EventsBySlice and CurrentEventsBySlice</h4>
<p>Query events for given entity type and slices. A slice is deterministically defined based on the persistence id. The purpose is to evenly distribute all persistence ids over the slices.</p>
-<p>See <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/typed/javadsl/EventsBySliceQuery.html" title="org.apache.pekko.persistence.query.typed.javadsl.EventsBySliceQuery"><code>EventsBySliceQuery</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/typed/scaladsl/EventsBySliceQuery.html" title="org.apache.pekko.persist [...]
+<p>See <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/typed/javadsl/EventsBySliceQuery.html" title="org.apache.pekko.persistence.query.typed.javadsl.EventsBySliceQuery"><code>EventsBySliceQuery</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/typed/scaladsl/EventsBySliceQuery.html" title="org.apache.pekko.persist [...]
<h3><a href="#materialized-values-of-queries" name="materialized-values-of-queries" class="anchor"><span class="anchor-link"></span></a>Materialized values of queries</h3>
<p>Journals are able to provide additional information related to a query by exposing <a href="stream/stream-quickstart.html#materialized-values-quick">Materialized values</a>, which are a feature of <a href="stream/index.html">Streams</a> that allows to expose additional values at stream materialization time.</p>
-<p>More advanced query journals may use this technique to expose information about the character of the materialized stream, for example if it’s finite or infinite, strictly ordered or not ordered at all. The materialized value type is defined as the second type parameter of the returned <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source [...]
+<p>More advanced query journals may use this technique to expose information about the character of the materialized stream, for example if it’s finite or infinite, strictly ordered or not ordered at all. The materialized value type is defined as the second type parameter of the returned <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -779,11 +779,11 @@ readJournal
<p>Sometimes you may need to use “resumable” projections, which will not start from the beginning of time each time when run. In such case, the sequence number (or <code>offset</code>) of the processed event will be stored and used the next time this projection is started. This pattern is implemented in the <a href="https://doc.akka.io/docs/akka-projection/current/">Pekko Projections</a> module.</p>
<a id="read-journal-plugin-api"></a>
<h2><a href="#query-plugins" name="query-plugins" class="anchor"><span class="anchor-link"></span></a>Query plugins</h2>
-<p>Query plugins are various (mostly community driven) <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/ReadJournal.html" title="org.apache.pekko.persistence.query.javadsl.ReadJournal"><code>ReadJournal</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/ReadJournal.html" title="org.apache.pekko.persi [...]
+<p>Query plugins are various (mostly community driven) <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/ReadJournal.html" title="org.apache.pekko.persistence.query.javadsl.ReadJournal"><code>ReadJournal</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/ReadJournal.html" title="org.apache.pekko.persi [...]
<p>This section aims to provide tips and guide plugin developers through implementing a custom query plugin. Most users will not need to implement journals themselves, except if targeting a not yet supported datastore.</p><div class="callout note "><div class="callout-title">Note</div>
<p>Since different data stores provide different query capabilities journal plugins <strong>must extensively document</strong> their exposed semantics as well as handled query scenarios.</p></div>
<h3><a href="#readjournal-plugin-api" name="readjournal-plugin-api" class="anchor"><span class="anchor-link"></span></a>ReadJournal plugin API</h3>
-<p>A read journal plugin must implement <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.persistence.query.ReadJournalProvider"><code>pekko.query.ReadJournalProvider</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.p [...]
+<p>A read journal plugin must implement <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.persistence.query.ReadJournalProvider"><code>pekko.query.ReadJournalProvider</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.p [...]
<p>Below is a simple journal implementation:</p>
<dl>
<dt>Scala</dt>
@@ -1016,7 +1016,7 @@ static class MyScaladslReadJournal
}
}</code></pre></dd>
</dl>
-<p>And the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByTagQuery"><code>eventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.scaladsl.EventsB [...]
+<p>And the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/javadsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.javadsl.EventsByTagQuery"><code>eventsByTag</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/scaladsl/EventsByTagQuery.html" title="org.apache.pekko.persistence.query.scaladsl.EventsB [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1223,9 +1223,9 @@ static class MyScaladslReadJournal
}
}</code></pre></dd>
</dl>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.persistence.query.ReadJournalProvider"><code>ReadJournalProvider</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.persistence.query.ReadJournalProvider"><code>R [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.persistence.query.ReadJournalProvider"><code>ReadJournalProvider</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/query/ReadJournalProvider.html" title="org.apache.pekko.persistence.query.ReadJournalProvider"><code>R [...]
<ul>
- <li>constructor with a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ExtendedActorSystem.html" title="org.apache.pekko.actor.ExtendedActorSystem"><code>ExtendedActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ExtendedActorSystem.html" title="org.apache.pekko.actor.ExtendedActorSystem"><code>ExtendedActorSystem</code></a>< [...]
+ <li>constructor with a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ExtendedActorSystem.html" title="org.apache.pekko.actor.ExtendedActorSystem"><code>ExtendedActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ExtendedActorSystem.html" title="org.apache.pekko.actor.ExtendedActorSystem"><code>ExtendedActorSystem</code></a>< [...]
<li>constructor with a <code>ExtendedActorSystem</code> parameter, and a <code>com.typesafe.config.Config</code> parameter</li>
<li>constructor with one <code>ExtendedActorSystem</code> parameter</li>
<li>constructor without parameters</li>
@@ -1327,7 +1327,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/persistence-schema-evolution.html b/content/persistence-schema-evolution.html
index e2a589e..373770f 100644
--- a/content/persistence-schema-evolution.html
+++ b/content/persistence-schema-evolution.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#schema-evolution-for-event-sourced-actors" name="schema-evolution-for-event-sourced-actors" class="anchor"><span class="anchor-link"></span></a>Schema Evolution for Event Sourced Actors</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This documentation page touches upon <a href="persistence.html">Pekko Persistence</a>, so to follow those examples you will want to depend on:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This documentation page touches upon <a href="persistence.html">Pekko Persistence</a>, so to follow those examples you will want to depend on:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies ++= Seq(
"org.apache.pekko" %% "pekko-persistence" % PekkoVersion,
"org.apache.pekko" %% "pekko-persistence-testkit" % PekkoVersion % Test
@@ -430,7 +430,7 @@ libraryDependencies ++= Seq(
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -450,7 +450,7 @@ libraryDependencies ++= Seq(
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-persistence_${versions.ScalaBinary}"
testImplementation "org.apache.pekko:pekko-persistence-testkit_${versions.ScalaBinary}"
@@ -490,7 +490,7 @@ dependencies {
<p>Binary serialization formats that we have seen work well for long-lived applications include the very flexible IDL based: <a href="https://developers.google.com/protocol-buffers">Google Protocol Buffers</a>, <a href="https://thrift.apache.org/">Apache Thrift</a> or <a href="https://avro.apache.org">Apache Avro</a>. Avro schema evolution is more “entire schema” based, instead of single fields focused like in protobuf or thrift, and usually requires using some kind of schema [...]
<p>There are plenty excellent blog posts explaining the various trade-offs between popular serialization formats, one post we would like to highlight is the very well illustrated <a href="https://martin.kleppmann.com/2012/12/05/schema-evolution-in-avro-protocol-buffers-thrift.html">Schema evolution in Avro, Protocol Buffers and Thrift</a> by Martin Kleppmann.</p>
<h3><a href="#provided-default-serializers" name="provided-default-serializers" class="anchor"><span class="anchor-link"></span></a>Provided default serializers</h3>
-<p>Pekko Persistence provides <a href="https://developers.google.com/protocol-buffers/">Google Protocol Buffers</a> based serializers (using <a href="serialization.html">Pekko Serialization</a>) for its own message types such as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/PersistentRepr.html" title="org.apache.pekko.persistence.PersistentRepr"><code>PersistentRepr</code></a></span><span class="group-java"><a h [...]
+<p>Pekko Persistence provides <a href="https://developers.google.com/protocol-buffers/">Google Protocol Buffers</a> based serializers (using <a href="serialization.html">Pekko Serialization</a>) for its own message types such as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/PersistentRepr.html" title="org.apache.pekko.persistence.PersistentRepr"><code>PersistentRepr</code></a></span><span class="group-java"><a h [...]
<p>Serialization is <strong>NOT</strong> handled automatically by Pekko Persistence itself. Instead, it only provides the above described serializers, and in case a <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/journal/AsyncWriteJournal.html" title="pekko.persistence.journal.AsyncWriteJournal"><code>AsyncWriteJournal</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/journal/ [...]
<p>Please refer to your write journal’s documentation to learn more about how it handles serialization!</p>
<p>For example, some journals may choose to not use Pekko Serialization <em>at all</em> and instead store the data in a format that is more “native” for the underlying datastore, e.g. using JSON or some other kind of format that the target datastore understands directly.</p></div>
@@ -916,16 +916,16 @@ message SeatReserved {
<p><strong>Naive solution - drop events in EventAdapter:</strong></p>
<p>The problem of removing an event type from the domain model is not as much its removal, as the implications for the recovery mechanisms that this entails. For example, a naive way of filtering out certain kinds of events from being delivered to a recovering <code>PersistentActor</code> is pretty simple, as one can filter them out in an <a href="persistence.html#event-adapters">EventAdapter</a>:</p>
<p><img src="./images/persistence-drop-event.png" alt="persistence-drop-event.png" /></p>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></spa [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></spa [...]
<p>This however does not address the underlying cost of having to deserialize all the events during recovery, even those which will be filtered out by the adapter. In the next section we will improve the above explained mechanism to avoid deserializing events which would be filtered out by the adapter anyway, thus allowing to save precious time during a recovery containing lots of such events (without actually having to delete them).</p>
<p><strong>Improved solution - deserialize into tombstone:</strong></p>
-<p>In the just described technique we have saved the PersistentActor from receiving un-wanted events by filtering them out in the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persiste [...]
+<p>In the just described technique we have saved the PersistentActor from receiving un-wanted events by filtering them out in the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persiste [...]
<ul>
<li>first, that the deserialization was actually performed, so we spent some of our time budget on the deserialization, even though the event does not contribute anything to the persistent actors state.</li>
<li>second, that we are <em>unable to remove the event class</em> from the system – since the serializer still needs to create the actual instance of it, as it does not know it will not be used.</li>
</ul>
<p>The solution to these problems is to use a serializer that is aware of that event being no longer needed, and can notice this before starting to deserialize the object.</p>
-<p>This approach allows us to <em>remove the original class from our classpath</em>, which makes for less “old” classes lying around in the project. This can for example be implemented by using an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org.apache.pekko.serialization.SerializerWithStringManifest"><code>SerializerWithStringManifest</code></a></span><sp [...]
+<p>This approach allows us to <em>remove the original class from our classpath</em>, which makes for less “old” classes lying around in the project. This can for example be implemented by using an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org.apache.pekko.serialization.SerializerWithStringManifest"><code>SerializerWithStringManifest</code></a></span><sp [...]
<p><img src="./images/persistence-drop-event-serializer.png" alt="persistence-drop-event-serializer.png" /></p>
<p>The serializer is aware of the old event types that need to be skipped (**O**), and can skip deserializing them altogether by returning a “tombstone” (**T**), which the EventAdapter converts into an empty EventSeq. Other events (**E**) can just be passed through.</p>
<p>The serializer detects that the string manifest points to a removed event type and skips attempting to deserialize it:</p>
@@ -1094,7 +1094,7 @@ static class SeatBookedData {
}
}</code></pre></dd>
</dl>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></spa [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></spa [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1145,7 +1145,7 @@ static class SeatBookedData {
<p><strong>Situation:</strong> You want to keep your persisted events in a human-readable format, for example JSON.</p>
<p><strong>Solution:</strong> This is a special case of the <a href="persistence-schema-evolution.html#detach-domain-from-data-model">Detach domain model from data model</a> pattern, and thus requires some co-operation from the Journal implementation to achieve this.</p>
<p>An example of a Journal which may implement this pattern is MongoDB, however other databases such as PostgreSQL and Cassandra could also do it because of their built-in JSON capabilities.</p>
-<p>In this approach, the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapt [...]
+<p>In this approach, the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapt [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1196,7 +1196,7 @@ static class SeatBookedData {
<p>This technique only applies if the Pekko Persistence plugin you are using provides this capability. Check the documentation of your favourite plugin to see if it supports this style of persistence.</p>
<p>If it doesn’t, you may want to skim the <a href="https://akka.io/community/#journal-plugins">list of existing journal plugins</a>, just in case some other plugin for your favourite datastore <em>does</em> provide this capability.</p></div>
<p><strong>Alternative solution:</strong></p>
-<p>In fact, an AsyncWriteJournal implementation could natively decide to not use binary serialization at all, and <em>always</em> serialize the incoming messages as JSON - in which case the <code>toJournal</code> implementation of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class=" [...]
+<p>In fact, an AsyncWriteJournal implementation could natively decide to not use binary serialization at all, and <em>always</em> serialize the incoming messages as JSON - in which case the <code>toJournal</code> implementation of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/EventAdapter.html" title="org.apache.pekko.persistence.journal.EventAdapter"><code>EventAdapter</code></a></span><span class=" [...]
<p>If in need of human-readable events on the <em>write-side</em> of your application reconsider whether preparing materialized views using <a href="persistence-query.html">Persistence Query</a> would not be an efficient way to go about this, without compromising the write-side’s throughput characteristics.</p>
<p>If indeed you want to use a human-readable representation on the write-side, pick a Persistence plugin that provides that functionality, or – implement one yourself.</p></div>
<a id="split-large-event-into-smaller"></a>
@@ -1381,7 +1381,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/persistence.html b/content/persistence.html
index c81748c..f173661 100644
--- a/content/persistence.html
+++ b/content/persistence.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the full documentation of this feature and for new projects see <a href="typed/persistence.html">Event Sourcing</a>.</p>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Pekko Persistence, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Persistence, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies ++= Seq(
"org.apache.pekko" %% "pekko-persistence" % PekkoVersion,
"org.apache.pekko" %% "pekko-persistence-testkit" % PekkoVersion % Test
@@ -433,7 +433,7 @@ libraryDependencies ++= Seq(
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -453,7 +453,7 @@ libraryDependencies ++= Seq(
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-persistence_${versions.ScalaBinary}"
testImplementation "org.apache.pekko:pekko-persistence-testkit_${versions.ScalaBinary}"
@@ -463,7 +463,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Persistence (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-persistence</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -688,10 +688,10 @@ public String persistenceId() {
<p>The number of concurrent recoveries that can be in progress at the same time is limited to not overload the system and the backend data store. When exceeding the limit the actors will wait until other recoveries have been completed. This is configured by:</p>
<pre><code>pekko.persistence.max-concurrent-recoveries = 50
</code></pre><div class="callout note "><div class="callout-title">Note</div>
-<p>Accessing the <span class="group-scala"><code>sender()</code></span><span class="group-java">sender with <code>getSender()</code></span> for replayed messages will always result in a <code>deadLetters</code> reference, as the original sender is presumed to be long gone. If you indeed have to notify an actor during recovery in the future, store its <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title= [...]
+<p>Accessing the <span class="group-scala"><code>sender()</code></span><span class="group-java">sender with <code>getSender()</code></span> for replayed messages will always result in a <code>deadLetters</code> reference, as the original sender is presumed to be long gone. If you indeed have to notify an actor during recovery in the future, store its <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title= [...]
<a id="recovery-custom"></a>
<h4><a href="#recovery-customization" name="recovery-customization" class="anchor"><span class="anchor-link"></span></a>Recovery customization</h4>
-<p>Applications may also customise how recovery is performed by returning a customised <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/Recovery$.html" title="org.apache.pekko.persistence.Recovery"><code>Recovery</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/Recovery$.html" title="org.apache.pekko.persistence.Recovery"><cod [...]
+<p>Applications may also customise how recovery is performed by returning a customised <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/Recovery$.html" title="org.apache.pekko.persistence.Recovery"><code>Recovery</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/Recovery$.html" title="org.apache.pekko.persistence.Recovery"><cod [...]
<p>To skip loading snapshots and replay all events you can use <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/SnapshotSelectionCriteria$.html#None:org.apache.pekko.persistence.SnapshotSelectionCriteria" title="pekko.persistence.SnapshotSelectionCriteria"><code>SnapshotSelectionCriteria.None</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/SnapshotSelectionCriteria.html#none( [...]
<dl>
<dt>Scala</dt>
@@ -742,7 +742,7 @@ def recoveryFinished: Boolean</code></pre></dd>
public boolean recoveryFinished();</code></pre></dd>
</dl>
-<p>Sometimes there is a need for performing additional initialization when the recovery has completed before processing any other message sent to the persistent actor. The persistent actor will receive a special <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/RecoveryCompleted$.html" title="org.apache.pekko.persistence.RecoveryCompleted"><code>RecoveryCompleted</code></a></span><span class="group-java"><a href="ht [...]
+<p>Sometimes there is a need for performing additional initialization when the recovery has completed before processing any other message sent to the persistent actor. The persistent actor will receive a special <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/RecoveryCompleted$.html" title="org.apache.pekko.persistence.RecoveryCompleted"><code>RecoveryCompleted</code></a></span><span class="group-java"><a href="ht [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -794,15 +794,15 @@ override def receiveCommand: Receive = {
<p>The actor will always receive a <code>RecoveryCompleted</code> message, even if there are no events in the journal and the snapshot store is empty, or if it’s a new persistent actor with a previously unused <code>persistenceId</code>.</p>
<p>If there is a problem with recovering the state of the actor from the journal, <code>onRecoveryFailure</code> is called (logging the error by default) and the actor will be stopped.</p>
<h3><a href="#internal-stash" name="internal-stash" class="anchor"><span class="anchor-link"></span></a>Internal stash</h3>
-<p>The persistent actor has a private <a href="actors.html#stash">stash</a> for internally caching incoming messages during <a href="#recovery">recovery</a> or the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/PersistentActor.html#persist[A](event:A)(handler:A=%3EUnit):Unit" title="pekko.persistence.PersistentActor"><code>persist</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persist [...]
+<p>The persistent actor has a private <a href="actors.html#stash">stash</a> for internally caching incoming messages during <a href="#recovery">recovery</a> or the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/PersistentActor.html#persist[A](event:A)(handler:A=%3EUnit):Unit" title="pekko.persistence.PersistentActor"><code>persist</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persist [...]
<p>You should be careful to not send more messages to a persistent actor than it can keep up with, otherwise the number of stashed messages will grow without bounds. It can be wise to protect against <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/OutOfMemoryError.html" title="java.lang.OutOfMemoryError"><code>OutOfMemoryError</code></a> by defining a maximum stash capacity in the mailbox configuration:</p>
<pre><code>pekko.actor.default-mailbox.stash-capacity=10000
</code></pre>
-<p>Note that the stash capacity is per actor. If you have many persistent actors, e.g. when using cluster sharding, you may need to define a small stash capacity to ensure that the total number of stashed messages in the system doesn’t consume too much memory. Additionally, the persistent actor defines three strategies to handle failure when the internal stash capacity is exceeded. The default overflow strategy is the <span class="group-scala"><a href="https://doc.akka.io/api/akka/ [...]
+<p>Note that the stash capacity is per actor. If you have many persistent actors, e.g. when using cluster sharding, you may need to define a small stash capacity to ensure that the total number of stashed messages in the system doesn’t consume too much memory. Additionally, the persistent actor defines three strategies to handle failure when the internal stash capacity is exceeded. The default overflow strategy is the <span class="group-scala"><a href="https://doc.akka.io/api/akka/ [...]
<pre><code>pekko.persistence.internal-stash-overflow-strategy=
"org.apache.pekko.persistence.ThrowExceptionConfigurator"
</code></pre>
-<p>The <code>DiscardToDeadLetterStrategy</code> strategy also has a pre-packaged companion configurator <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/DiscardConfigurator.html" title="org.apache.pekko.persistence.DiscardConfigurator"><code>DiscardConfigurator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/DiscardConfigurat [...]
+<p>The <code>DiscardToDeadLetterStrategy</code> strategy also has a pre-packaged companion configurator <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/DiscardConfigurator.html" title="org.apache.pekko.persistence.DiscardConfigurator"><code>DiscardConfigurator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/DiscardConfigurat [...]
<p>You can also query the default strategy via the Pekko persistence extension singleton: </p>
<dl>
<dt>Scala</dt>
@@ -1250,7 +1250,7 @@ persistentActor.tell("b", getSelf());
<p>While it is possible to nest <code>persist</code> calls within one another, it is <em>not</em> legal call <code>persist</code> from any other Thread than the Actors message processing Thread. For example, it is not legal to call <code>persist</code> from Futures! Doing so will break the guarantees that the persist methods aim to provide. Always call <code>persist</code> and <code>persistAsync</code> from within the Actor’s receive block (or methods synchronously invoked from the [...]
<h3><a href="#failures" name="failures" class="anchor"><span class="anchor-link"></span></a>Failures</h3>
<p>If persistence of an event fails, <code>onPersistFailure</code> will be invoked (logging the error by default), and the actor will unconditionally be stopped.</p>
-<p>The reason that it cannot resume when persist fails is that it is unknown if the event was actually persisted or not, and therefore it is in an inconsistent state. Restarting on persistent failures will most likely fail anyway since the journal is probably unavailable. It is better to stop the actor and after a back-off timeout start it again. The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffSupervisor$.h [...]
+<p>The reason that it cannot resume when persist fails is that it is unknown if the event was actually persisted or not, and therefore it is in an inconsistent state. Restarting on persistent failures will most likely fail anyway since the journal is probably unavailable. It is better to stop the actor and after a back-off timeout start it again. The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffSupervisor$.h [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1284,7 +1284,7 @@ public void preStart() throws Exception {
<p>It is possible to delete all messages (journaled by a single persistent actor) up to a specified sequence number; Persistent actors may call the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/PersistentActor.html#deleteMessages(toSequenceNr:Long):Unit" title="pekko.persistence.PersistentActor"><code>deleteMessages</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/AbstractP [...]
<p>Deleting messages in Event Sourcing based applications is typically either not used at all, or used in conjunction with <a href="#snapshots">snapshotting</a>, i.e. after a snapshot has been successfully stored, a <code>deleteMessages(toSequenceNr)</code> up until the sequence number of the data held by that snapshot can be issued to safely delete the previous events while still having access to the accumulated state during replays - by loading the snapshot.</p><div class="callout warn [...]
<p>If you are using <a href="persistence-query.html">Persistence Query</a>, query results may be missing deleted messages in a journal, depending on how deletions are implemented in the journal plugin. Unless you use a plugin which still shows deleted messages in persistence query results, you have to design your application so that it is not affected by missing messages.</p></div>
-<p>The result of the <code>deleteMessages</code> request is signaled to the persistent actor with a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/DeleteMessagesSuccess.html" title="org.apache.pekko.persistence.DeleteMessagesSuccess"><code>DeleteMessagesSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/DeleteMessagesS [...]
+<p>The result of the <code>deleteMessages</code> request is signaled to the persistent actor with a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/DeleteMessagesSuccess.html" title="org.apache.pekko.persistence.DeleteMessagesSuccess"><code>DeleteMessagesSuccess</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/DeleteMessagesS [...]
<p>Message deletion doesn’t affect the highest sequence number of the journal, even if all messages were deleted from it after <code>deleteMessages</code> invocation.</p>
<h3><a href="#persistence-status-handling" name="persistence-status-handling" class="anchor"><span class="anchor-link"></span></a>Persistence status handling</h3>
<p>Persisting, deleting, and replaying messages can either succeed or fail.</p>
@@ -1315,7 +1315,7 @@ public void preStart() throws Exception {
</tbody>
</table>
<p>The most important operations (<code>persist</code> and <code>recovery</code>) have failure handlers modelled as explicit callbacks which the user can override in the <code>PersistentActor</code>. The default implementations of these handlers emit a log message (<code>error</code> for persist/recovery failures, and <code>warning</code> for others), logging the failure cause and information about which message caused the failure.</p>
-<p>For critical failures, such as recovery or persisting events failing, the persistent actor will be stopped after the failure handler is invoked. This is because if the underlying journal implementation is signalling persistence failures it is most likely either failing completely or overloaded and restarting right-away and trying to persist the event again will most likely not help the journal recover – as it would likely cause a <a href="https://en.wikipedia.org/wiki/Thundering_herd_ [...]
+<p>For critical failures, such as recovery or persisting events failing, the persistent actor will be stopped after the failure handler is invoked. This is because if the underlying journal implementation is signalling persistence failures it is most likely either failing completely or overloaded and restarting right-away and trying to persist the event again will most likely not help the journal recover – as it would likely cause a <a href="https://en.wikipedia.org/wiki/Thundering_herd_ [...]
<p>Journal implementations may choose to implement a retry mechanism, e.g. such that only after a write fails N number of times a persistence failure is signalled back to the user. In other words, once a journal returns a failure, it is considered <em>fatal</em> by Pekko Persistence, and the persistent actor which caused the failure will be stopped.</p>
<p>Check the documentation of the journal implementation you are using for details if/how it is using this technique.</p></div>
<a id="safe-shutdown"></a>
@@ -1445,7 +1445,7 @@ persistentActor.tell(new Shutdown(), ActorRef.noSender());
<p>See <a href="typed/persistence.html#replay-filter">Replay filter</a> in the documentation of the new API.</p>
<h2><a href="#snapshots" name="snapshots" class="anchor"><span class="anchor-link"></span></a>Snapshots</h2>
<p>As you model your domain using actors, you may notice that some actors may be prone to accumulating extremely long event logs and experiencing long recovery times. Sometimes, the right approach may be to split out into a set of shorter lived actors. However, when this is not an option, you can use snapshots to reduce recovery times drastically.</p>
-<p>Persistent actors can save snapshots of internal state by calling the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#saveSnapshot(snapshot:Any):Unit" title="org.apache.pekko.persistence.Snapshotter"><code>saveSnapshot</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#saveSnapshot(java.lang [...]
+<p>Persistent actors can save snapshots of internal state by calling the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#saveSnapshot(snapshot:Any):Unit" title="org.apache.pekko.persistence.Snapshotter"><code>saveSnapshot</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#saveSnapshot(java.lang [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1496,13 +1496,13 @@ public Receive createReceive() {
.build();
}</code></pre></dd>
</dl>
-<p>where <code>metadata</code> is of type <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/SnapshotMetadata.html" title="org.apache.pekko.persistence.SnapshotMetadata"><code>SnapshotMetadata</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/SnapshotMetadata.html" title="org.apache.pekko.persistence.SnapshotMetadata"><code>Snaps [...]
+<p>where <code>metadata</code> is of type <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/SnapshotMetadata.html" title="org.apache.pekko.persistence.SnapshotMetadata"><code>SnapshotMetadata</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/SnapshotMetadata.html" title="org.apache.pekko.persistence.SnapshotMetadata"><code>Snaps [...]
<ul>
<li>persistenceId</li>
<li>sequenceNr</li>
<li>timestamp</li>
</ul>
-<p>During recovery, the persistent actor is offered the latest saved snapshot via a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/SnapshotOffer.html" title="org.apache.pekko.persistence.SnapshotOffer"><code>SnapshotOffer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/SnapshotOffer.html" title="org.apache.pekko.persistence [...]
+<p>During recovery, the persistent actor is offered the latest saved snapshot via a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/SnapshotOffer.html" title="org.apache.pekko.persistence.SnapshotOffer"><code>SnapshotOffer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/SnapshotOffer.html" title="org.apache.pekko.persistence [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1535,7 +1535,7 @@ public Receive createReceiveRecover() {
}</code></pre></dd>
</dl>
<p>The replayed messages that follow the <code>SnapshotOffer</code> message, if any, are younger than the offered snapshot. They finally recover the persistent actor to its current (i.e. latest) state.</p>
-<p>In general, a persistent actor is only offered a snapshot if that persistent actor has previously saved one or more snapshots and at least one of these snapshots matches the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/SnapshotSelectionCriteria.html" title="org.apache.pekko.persistence.SnapshotSelectionCriteria"><code>SnapshotSelectionCriteria</code></a></span><span class="group-java"><a href="https://doc.ak [...]
+<p>In general, a persistent actor is only offered a snapshot if that persistent actor has previously saved one or more snapshots and at least one of these snapshots matches the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/SnapshotSelectionCriteria.html" title="org.apache.pekko.persistence.SnapshotSelectionCriteria"><code>SnapshotSelectionCriteria</code></a></span><span class="group-java"><a href="https://doc.ak [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1552,11 +1552,11 @@ public Recovery recovery() {
</dl>
<p>If not specified, they default to <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/SnapshotSelectionCriteria$.html#Latest:org.apache.pekko.persistence.SnapshotSelectionCriteria" title="pekko.persistence.SnapshotSelectionCriteria"><code>SnapshotSelectionCriteria.Latest</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/SnapshotSelectionCriteria.html#latest()" title="pekko.pers [...]
<p>In order to use snapshots, a default snapshot-store (<code>pekko.persistence.snapshot-store.plugin</code>) must be configured, or the <span class="group-scala"><code>PersistentActor</code></span><span class="group-java">persistent actor</span> can pick a snapshot store explicitly by overriding <span class="group-scala"><code>def snapshotPluginId: String</code></span><span class="group-java"><code>String snapshotPluginId()</code></span>.</p>
-<p>Because some use cases may not benefit from or need snapshots, it is perfectly valid not to not configure a snapshot store. However, Pekko will log a warning message when this situation is detected and then continue to operate until an actor tries to store a snapshot, at which point the operation will fail (by replying with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/SaveSnapshotFailure.html" title="org. [...]
+<p>Because some use cases may not benefit from or need snapshots, it is perfectly valid not to not configure a snapshot store. However, Pekko will log a warning message when this situation is detected and then continue to operate until an actor tries to store a snapshot, at which point the operation will fail (by replying with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/SaveSnapshotFailure.html" title="org. [...]
<p>Note that the “persistence mode” of <a href="cluster-sharding.html">Cluster Sharding</a> makes use of snapshots. If you use that mode, you’ll need to define a snapshot store plugin.</p></div>
<h3><a href="#snapshot-deletion" name="snapshot-deletion" class="anchor"><span class="anchor-link"></span></a>Snapshot deletion</h3>
-<p>A persistent actor can delete individual snapshots by calling the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#deleteSnapshot(sequenceNr:Long):Unit" title="org.apache.pekko.persistence.Snapshotter"><code>deleteSnapshot</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#deleteSnapshot(long [...]
-<p>To bulk-delete a range of snapshots matching scala/org/apache/pekko/persistence.SnapshotSelectionCriteria], persistent actors should use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#deleteSnapshots(criteria:org.apache.pekko.persistence.SnapshotSelectionCriteria):Unit" title="org.apache.pekko.persistence.Snapshotter"><code>deleteSnapshots</code></a></span><span class="group-java"><a href= [...]
+<p>A persistent actor can delete individual snapshots by calling the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#deleteSnapshot(sequenceNr:Long):Unit" title="org.apache.pekko.persistence.Snapshotter"><code>deleteSnapshot</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#deleteSnapshot(long [...]
+<p>To bulk-delete a range of snapshots matching scala/org/apache/pekko/persistence.SnapshotSelectionCriteria], persistent actors should use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/Snapshotter.html#deleteSnapshots(criteria:org.apache.pekko.persistence.SnapshotSelectionCriteria):Unit" title="org.apache.pekko.persistence.Snapshotter"><code>deleteSnapshots</code></a></span><span class="group-java"><a href= [...]
<h3><a href="#snapshot-status-handling" name="snapshot-status-handling" class="anchor"><span class="anchor-link"></span></a>Snapshot status handling</h3>
<p>Saving or deleting snapshots can either succeed or fail – this information is reported back to the persistent actor via status messages as illustrated in the following table.</p>
<table>
@@ -1595,14 +1595,14 @@ public Recovery recovery() {
<h2><a href="#at-least-once-delivery" name="at-least-once-delivery" class="anchor"><span class="anchor-link"></span></a>At-Least-Once Delivery</h2>
<p>To send messages with at-least-once delivery semantics to destinations you can <span class="group-scala">mix-in <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/AtLeastOnceDelivery.html" title="pekko.persistence.AtLeastOnceDelivery"><code>AtLeastOnceDelivery</code></a> trait to your <a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/PersistentActor.html" title="pekko.persistence.PersistentActor"><code>PersistentActor</code></a></span><span cla [...]
<p>The state of the sending actor, including which messages have been sent that have not been confirmed by the recipient must be persistent so that it can survive a crash of the sending actor or JVM. The <span class="group-scala"><code>AtLeastOnceDelivery</code> trait</span><span class="group-java"><code>AbstractPersistentActorWithAtLeastOnceDelivery</code> class</span> does not persist anything by itself. It is your responsibility to persist the intent that a message is sent and that a [...]
-<p>At-least-once delivery implies that original message sending order is not always preserved, and the destination may receive duplicate messages. Semantics do not match those of a normal <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apa [...]
+<p>At-least-once delivery implies that original message sending order is not always preserved, and the destination may receive duplicate messages. Semantics do not match those of a normal <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apa [...]
<ul>
<li>it is not at-most-once delivery</li>
<li>message order for the same sender–receiver pair is not preserved due to possible resends</li>
<li>after a crash and restart of the destination messages are still delivered to the new actor incarnation</li>
</ul>
-<p>These semantics are similar to what an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekko.actor.ActorPath"><code>ActorPath</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekko.actor.ActorPath"><code>ActorPath</code></a></span> represents (see <a href="actors.html [...]
-<p>Use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/persistence/AtLeastOnceDelivery.html#deliver(destination:org.apache.pekko.actor.ActorPath)(deliveryIdToMessage:Long=%3EAny):Unit" title="persistence.AtLeastOnceDelivery"><code>deliver</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/AbstractPersistentActorWithAtLeastOnceDelivery.html#deliver(org.apache.pekko.actor.ActorP [...]
+<p>These semantics are similar to what an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekko.actor.ActorPath"><code>ActorPath</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorPath.html" title="org.apache.pekko.actor.ActorPath"><code>ActorPath</code></a></span> represents (see <a href="actors.html [...]
+<p>Use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/persistence/AtLeastOnceDelivery.html#deliver(destination:org.apache.pekko.actor.ActorPath)(deliveryIdToMessage:Long=%3EAny):Unit" title="persistence.AtLeastOnceDelivery"><code>deliver</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/AbstractPersistentActorWithAtLeastOnceDelivery.html#deliver(org.apache.pekko.actor.ActorP [...]
<h3><a href="#relationship-between-deliver-and-confirmdelivery" name="relationship-between-deliver-and-confirmdelivery" class="anchor"><span class="anchor-link"></span></a>Relationship between deliver and confirmDelivery</h3>
<p>To send messages to the destination path, use the <code>deliver</code> method after you have persisted the intent to send the message.</p>
<p>The destination actor must send back a confirmation message. When the sending actor receives this confirmation message you should persist the fact that the message was delivered successfully and then call the <code>confirmDelivery</code> method.</p>
@@ -1750,16 +1750,16 @@ class MyDestination extends AbstractActor {
</dl>
<p>The <code>deliveryId</code> generated by the persistence module is a strictly monotonically increasing sequence number without gaps. The same sequence is used for all destinations of the actor, i.e. when sending to multiple destinations the destinations will see gaps in the sequence. It is not possible to use custom <code>deliveryId</code>. However, you can send a custom correlation identifier in the message to the destination. You must then retain a mapping between the internal <code [...]
<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/AtLeastOnceDelivery.html" title="pekko.persistence.AtLeastOnceDelivery"><code>AtLeastOnceDelivery</code></a> trait</span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/AbstractPersistentActorWithAtLeastOnceDelivery.html" title="pekko.persistence.AbstractPersistentActorWithAtLeastOnceDelivery"><code>AbstractPersistentActorWithAtLeastOnce [...]
-<p>Support for snapshots is provided by <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDeliveryLike.html#getDeliverySnapshot:org.apache.pekko.persistence.AtLeastOnceDelivery.AtLeastOnceDeliverySnapshot" title="org.apache.pekko.persistence.AtLeastOnceDeliveryLike"><code>getDeliverySnapshot</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/a [...]
-<p>The interval between redelivery attempts is defined by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDeliveryLike.html#redeliverInterval:scala.concurrent.duration.FiniteDuration" title="org.apache.pekko.persistence.AtLeastOnceDeliveryLike"><code>redeliverInterval</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persis [...]
-<p>The maximum number of messages that will be sent at each redelivery burst is defined by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDeliveryLike.html#redeliveryBurstLimit:Int" title="org.apache.pekko.persistence.AtLeastOnceDeliveryLike"><code>redeliverBurstLimit</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persi [...]
-<p>After a number of delivery attempts a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDelivery$$UnconfirmedWarning.html" title="org.apache.pekko.persistence.AtLeastOnceDelivery.UnconfirmedWarning"><code>AtLeastOnceDelivery.UnconfirmedWarning</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDelivery$$U [...]
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/AtLeastOnceDelivery.html" title="pekko.persistence.AtLeastOnceDelivery"><code>AtLeastOnceDelivery</code></a> trait</span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/AbstractPersistentActorWithAtLeastOnceDelivery.html" title="pekko.persistence.AbstractPersistentActorWithAtLeastOnceDelivery"><code>AbstractPersistentActorWithAtLeastOnce [...]
+<p>Support for snapshots is provided by <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDeliveryLike.html#getDeliverySnapshot:org.apache.pekko.persistence.AtLeastOnceDelivery.AtLeastOnceDeliverySnapshot" title="org.apache.pekko.persistence.AtLeastOnceDeliveryLike"><code>getDeliverySnapshot</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/a [...]
+<p>The interval between redelivery attempts is defined by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDeliveryLike.html#redeliverInterval:scala.concurrent.duration.FiniteDuration" title="org.apache.pekko.persistence.AtLeastOnceDeliveryLike"><code>redeliverInterval</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persis [...]
+<p>The maximum number of messages that will be sent at each redelivery burst is defined by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDeliveryLike.html#redeliveryBurstLimit:Int" title="org.apache.pekko.persistence.AtLeastOnceDeliveryLike"><code>redeliverBurstLimit</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persi [...]
+<p>After a number of delivery attempts a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDelivery$$UnconfirmedWarning.html" title="org.apache.pekko.persistence.AtLeastOnceDelivery.UnconfirmedWarning"><code>AtLeastOnceDelivery.UnconfirmedWarning</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/AtLeastOnceDelivery$$U [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/persistence/AtLeastOnceDelivery.html" title="pekko.persistence.AtLeastOnceDelivery"><code>AtLeastOnceDelivery</code></a> trait</span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/persistence/AbstractPersistentActorWithAtLeastOnceDelivery.html" title="pekko.persistence.AbstractPersistentActorWithAtLeastOnceDelivery"><code>AbstractPersistentActorWithAtLeastOnce [...]
<h2><a href="#event-adapters" name="event-adapters" class="anchor"><span class="anchor-link"></span></a>Event Adapters</h2>
<p>In long running projects using Event Sourcing sometimes the need arises to detach the data model from the domain model completely.</p>
<p>Event Adapters help in situations where:</p>
<ul>
- <li><strong>Version Migrations</strong> – existing events stored in <em>Version 1</em> should be “upcasted” to a new <em>Version 2</em> representation, and the process of doing so involves actual code, not just changes on the serialization layer. For these scenarios the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/journal/WriteEventAdapter.html#toJournal(event:Any):Any" title="org.apache.pekko.per [...]
+ <li><strong>Version Migrations</strong> – existing events stored in <em>Version 1</em> should be “upcasted” to a new <em>Version 2</em> representation, and the process of doing so involves actual code, not just changes on the serialization layer. For these scenarios the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/journal/WriteEventAdapter.html#toJournal(event:Any):Any" title="org.apache.pekko.per [...]
<li><strong>Separating Domain and Data models</strong> – thanks to EventAdapters it is possible to completely separate the domain model from the model used to persist data in the Journals. For example one may want to use case classes in the domain model, however persist their protocol-buffer (or any other binary serialization format) counter-parts to the Journal. A simple <code>toJournal:MyModel=>MyDataModel</code> and <code>fromJournal:MyDataModel=>MyModel</code> adapter can be [...]
<li><strong>Journal Specialized Data Types</strong> – exposing data types understood by the underlying Journal, for example for data stores which understand JSON it is possible to write an EventAdapter <code>toJournal:Any=>JSON</code> such that the Journal can <em>directly</em> store the json instead of serializing the object to its binary representation.</li>
</ul>
@@ -1812,7 +1812,7 @@ class MyDestination extends AbstractActor {
}
}
}</code></pre>
-<p>It is possible to bind multiple adapters to one class <em>for recovery</em>, in which case the <code>fromJournal</code> methods of all bound adapters will be applied to a given matching event (in order of definition in the configuration). Since each adapter may return from <code>0</code> to <code>n</code> adapted events (called as <code>EventSeq</code>), each adapter can investigate the event and if it should indeed adapt it return the adapted event(s) for it. Other adapters which do [...]
+<p>It is possible to bind multiple adapters to one class <em>for recovery</em>, in which case the <code>fromJournal</code> methods of all bound adapters will be applied to a given matching event (in order of definition in the configuration). Since each adapter may return from <code>0</code> to <code>n</code> adapted events (called as <code>EventSeq</code>), each adapter can investigate the event and if it should indeed adapt it return the adapted event(s) for it. Other adapters which do [...]
<p>For more advanced schema evolution techniques refer to the <a href="persistence-schema-evolution.html">Persistence - Schema Evolution</a> documentation.</p></div>
<h2><a href="#custom-serialization" name="custom-serialization" class="anchor"><span class="anchor-link"></span></a>Custom serialization</h2>
<p>Serialization of snapshots and payloads of <code>Persistent</code> messages is configurable with Pekko’s <a href="serialization.html">Serialization</a> infrastructure. For example, if an application wants to serialize</p>
@@ -1848,7 +1848,7 @@ class MyDestination extends AbstractActor {
</dependencies></code></pre></dd><dt>Gradle</dt><dd><pre class="prettyprint"><code class="language-gradle">dependencies {
implementation "org.iq80.leveldb:leveldb:0.9"
}</code></pre></dd></dl><div class="callout warning "><div class="callout-title">Warning</div>
-<p>It is not possible to test persistence provided classes (i.e. <code>PersistentActor</code> and <a href="persistence.html#at-least-once-delivery">AtLeastOnceDelivery</a>) using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/testkit/TestActorRef.html" title="org.apache.pekko.testkit.TestActorRef"><code>TestActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/ [...]
+<p>It is not possible to test persistence provided classes (i.e. <code>PersistentActor</code> and <a href="persistence.html#at-least-once-delivery">AtLeastOnceDelivery</a>) using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/testkit/TestActorRef.html" title="org.apache.pekko.testkit.TestActorRef"><code>TestActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/ [...]
<p>When testing Persistence based projects always rely on <a href="testing.html#async-integration-testing">asynchronous messaging using the TestKit</a>.</p></div>
<h2><a href="#configuration" name="configuration" class="anchor"><span class="anchor-link"></span></a>Configuration</h2>
<p>There are several configuration properties for the persistence module, please refer to the <a href="general/configuration-reference.html#config-pekko-persistence">reference configuration</a>.</p>
@@ -1859,7 +1859,7 @@ class MyDestination extends AbstractActor {
pekko.persistence.journal.plugin = "pekko.persistence.journal.inmem"
# Absolute path to the default snapshot store plugin configuration entry.
pekko.persistence.snapshot-store.plugin = "pekko.persistence.snapshot-store.local"</code></pre>
-<p>Note that in this case the actor overrides only the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#persistenceId:String" title="org.apache.pekko.persistence.PersistenceIdentity"><code>persistenceId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#persistenceId()" title="or [...]
+<p>Note that in this case the actor overrides only the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#persistenceId:String" title="org.apache.pekko.persistence.PersistenceIdentity"><code>persistenceId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#persistenceId()" title="or [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1876,7 +1876,7 @@ pekko.persistence.snapshot-store.plugin = "pekko.persistence.snapshot-store
}
}</code></pre></dd>
</dl>
-<p>When the persistent actor overrides the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#journalPluginId:String" title="org.apache.pekko.persistence.PersistenceIdentity"><code>journalPluginId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#journalPluginId()" title="org.apac [...]
+<p>When the persistent actor overrides the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#journalPluginId:String" title="org.apache.pekko.persistence.PersistenceIdentity"><code>journalPluginId</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/PersistenceIdentity.html#journalPluginId()" title="org.apac [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1927,8 +1927,8 @@ pekko.persistence.chronicle.snapshot-store {
folder = $${user.dir}/store/snapshot
}</code></pre>
<h2><a href="#give-persistence-plugin-configurations-at-runtime" name="give-persistence-plugin-configurations-at-runtime" class="anchor"><span class="anchor-link"></span></a>Give persistence plugin configurations at runtime</h2>
-<p>By default, a persistent actor will use the configuration loaded at <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></s [...]
-<p>When the persistent actor overrides the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/RuntimePluginConfig.html#journalPluginConfig:com.typesafe.config.Config" title="org.apache.pekko.persistence.RuntimePluginConfig"><code>journalPluginConfig</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/persistence/RuntimePluginConfig.html#journa [...]
+<p>By default, a persistent actor will use the configuration loaded at <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></s [...]
+<p>When the persistent actor overrides the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/RuntimePluginConfig.html#journalPluginConfig:com.typesafe.config.Config" title="org.apache.pekko.persistence.RuntimePluginConfig"><code>journalPluginConfig</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/persistence/RuntimePluginConfig.html#journa [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -2125,7 +2125,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/downstream-upgrade-strategy.html b/content/project/downstream-upgrade-strategy.html
index a413dcf..aaa54bc 100644
--- a/content/project/downstream-upgrade-strategy.html
+++ b/content/project/downstream-upgrade-strategy.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -510,7 +510,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/examples.html b/content/project/examples.html
index 0226833..9e57a18 100644
--- a/content/project/examples.html
+++ b/content/project/examples.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -549,7 +549,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/immutable.html b/content/project/immutable.html
index 263d2e8..e9e7c2f 100644
--- a/content/project/immutable.html
+++ b/content/project/immutable.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -560,7 +560,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/index.html b/content/project/index.html
index 211f418..b544e69 100644
--- a/content/project/index.html
+++ b/content/project/index.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -578,7 +578,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/issue-tracking.html b/content/project/issue-tracking.html
index 051564b..70b18b4 100644
--- a/content/project/issue-tracking.html
+++ b/content/project/issue-tracking.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -514,7 +514,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/licenses.html b/content/project/licenses.html
index 4306d96..52ec644 100644
--- a/content/project/licenses.html
+++ b/content/project/licenses.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -490,7 +490,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/links.html b/content/project/links.html
index b69b926..bbf68d5 100644
--- a/content/project/links.html
+++ b/content/project/links.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -539,7 +539,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/migration-guides.html b/content/project/migration-guides.html
index 0cda95a..12a789e 100644
--- a/content/project/migration-guides.html
+++ b/content/project/migration-guides.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -492,7 +492,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/rolling-update.html b/content/project/rolling-update.html
index bf8ffe4..f543c50 100644
--- a/content/project/rolling-update.html
+++ b/content/project/rolling-update.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -505,7 +505,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/project/scala3.html b/content/project/scala3.html
index 8f3e4c2..da09430 100644
--- a/content/project/scala3.html
+++ b/content/project/scala3.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -508,7 +508,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/remoting-artery.html b/content/remoting-artery.html
index 1aacbeb..825b7a7 100644
--- a/content/remoting-artery.html
+++ b/content/remoting-artery.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>When building an Pekko application, you would usually not use the Remoting concepts directly, but instead use the more high-level <a href="index-cluster.html">Pekko Cluster</a> utilities or technology-agnostic protocols such as <a href="https://doc.akka.io/docs/akka-http/current/">HTTP</a>, <a href="https://doc.akka.io/docs/akka-grpc/current/">gRPC</a> etc.</p></div>
<p>If migrating from classic remoting see <a href="remoting-artery.html#what-is-new-in-artery">what’s new in Artery</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Artery Remoting, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Artery Remoting, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-remote" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-remote" % PekkoVersion</code
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-remote" % PekkoVersion</code
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-remote_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -495,7 +495,7 @@ dependencies {
<h2><a href="#introduction" name="introduction" class="anchor"><span class="anchor-link"></span></a>Introduction</h2>
<p>We recommend <a href="cluster-usage.html">Pekko Cluster</a> over using remoting directly. As remoting is the underlying module that allows for Cluster, it is still useful to understand details about it though.</p><div class="callout note "><div class="callout-title">Note</div>
<p>This page describes the remoting subsystem, codenamed <em>Artery</em> that has replaced the <a href="remoting.html">classic remoting implementation</a>.</p></div>
-<p>Remoting enables Actor systems on different hosts or JVMs to communicate with each other. By enabling remoting the system will start listening on a provided network address and also gains the ability to connect to other systems through the network. From the application’s perspective there is no API difference between local or remote systems, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title=" [...]
+<p>Remoting enables Actor systems on different hosts or JVMs to communicate with each other. By enabling remoting the system will start listening on a provided network address and also gains the ability to connect to other systems through the network. From the application’s perspective there is no API difference between local or remote systems, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title=" [...]
<p>You need to enable <a href="serialization.html">serialization</a> for your actor messages. <a href="serialization-jackson.html">Serialization with Jackson</a> is a good choice in many cases and our recommendation if you don’t have other preference.</p>
<p>Remoting is not a server-client technology. All systems using remoting can contact any other system on the network if they possess an <code>ActorRef</code> pointing to those system. This means that every system that is remoting enabled acts as a “server” to which arbitrary systems on the same network can connect to.</p>
<h2><a href="#selecting-a-transport" name="selecting-a-transport" class="anchor"><span class="anchor-link"></span></a>Selecting a transport</h2>
@@ -511,21 +511,21 @@ dependencies {
<p>Aeron requires 64bit JVM to work reliably and is only officially supported on Linux, Mac and Windows. It may work on other Unixes e.g. Solaris but insufficient testing has taken place for it to be officially supported. If you’re on a Big Endian processor, such as Sparc, it is recommended to use TCP.</p><div class="callout note "><div class="callout-title">Note</div>
<p><a href="additional/rolling-updates.html">Rolling update</a> is not supported when changing from one transport to another.</p></div>
<h2><a href="#canonical-address" name="canonical-address" class="anchor"><span class="anchor-link"></span></a>Canonical address</h2>
-<p>In order for remoting to work properly, where each system can send messages to any other system on the same network (for example a system forwards a message to a third system, and the third replies directly to the sender system) it is essential for every system to have a <em>unique, globally reachable</em> address and port. This address is part of the unique name of the system and will be used by other systems to open a connection to it and send messages. This means that if a host has [...]
+<p>In order for remoting to work properly, where each system can send messages to any other system on the same network (for example a system forwards a message to a third system, and the third replies directly to the sender system) it is essential for every system to have a <em>unique, globally reachable</em> address and port. This address is part of the unique name of the system and will be used by other systems to open a connection to it and send messages. This means that if a host has [...]
<p>In cases, where Network Address Translation (NAT) is used or other network bridging is involved, it is important to configure the system so that it understands that there is a difference between his externally visible, canonical address and between the host-port pair that is used to listen for connections. See <a href="remoting-artery.html#remote-configuration-nat-artery">Pekko behind NAT or in a Docker container</a> for details.</p>
<h2><a href="#acquiring-references-to-remote-actors" name="acquiring-references-to-remote-actors" class="anchor"><span class="anchor-link"></span></a>Acquiring references to remote actors</h2>
-<p>In order to communicate with an actor, it is necessary to have its <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span>. In the local [...]
+<p>In order to communicate with an actor, it is necessary to have its <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span>. In the local [...]
<ul>
<li>An Actor can get a remote Actor’s reference by receiving a message from it (as it’s available as <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#sender():org.apache.pekko.actor.ActorRef" title="pekko.actor.Actor"><code>sender()</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/AbstractActor.html#getSender()" title="pekko.actor.AbstractActor"><code>getSender()< [...]
</ul>
-<p>Alternatively, an actor can look up another located at a known path using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>Acto [...]
+<p>Alternatively, an actor can look up another located at a known path using <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>Acto [...]
<ul>
- <li>Remote Lookup : used to look up an actor on a remote node with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorSelection(path:String):org.apache.pekko.actor.ActorSelection" title="org.apache.pekko.actor.ActorRefFactory"><code>actorSelection(path)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFac [...]
- <li>Remote Creation : used to create an actor on a remote node with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(props:org.apache.pekko.actor.Props,name:String):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorRefFactory"><code>actorOf(Props(...), actorName)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/o [...]
+ <li>Remote Lookup : used to look up an actor on a remote node with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorSelection(path:String):org.apache.pekko.actor.ActorSelection" title="org.apache.pekko.actor.ActorRefFactory"><code>actorSelection(path)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFac [...]
+ <li>Remote Creation : used to create an actor on a remote node with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorOf(props:org.apache.pekko.actor.Props,name:String):org.apache.pekko.actor.ActorRef" title="org.apache.pekko.actor.ActorRefFactory"><code>actorOf(Props(...), actorName)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/o [...]
</ul>
<p>In the next sections the two alternatives are described in detail.</p>
<h3><a href="#looking-up-remote-actors" name="looking-up-remote-actors" class="anchor"><span class="anchor-link"></span></a>Looking up Remote Actors</h3>
-<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorSelection(path:String):org.apache.pekko.actor.ActorSelection" title="org.apache.pekko.actor.ActorRefFactory"><code>actorSelection(path)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorSelection(java.lang.String)" title="org.apache.pekk [...]
+<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorSelection(path:String):org.apache.pekko.actor.ActorSelection" title="org.apache.pekko.actor.ActorRefFactory"><code>actorSelection(path)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#actorSelection(java.lang.String)" title="org.apache.pekk [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -553,12 +553,12 @@ dependencies {
<pre><code>selection.tell("Pretty awesome feature", getSelf());
</code></pre></dd>
</dl>
-<p>To acquire an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> for an <span class="group-scala"><a href="https://doc.akka.io/api/a [...]
+<p>To acquire an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> for an <span class="group-scala"><a href="https://doc.akka.io/api/a [...]
<p>For more details on how actor addresses and paths are formed and used, please refer to <a href="general/addressing.html">Actor References, Paths and Addresses</a>.</p><div class="callout note "><div class="callout-title">Note</div>
<p>Message sends to actors that are actually in the sending actor system do not get delivered via the remote actor ref provider. They’re delivered directly, by the local actor ref provider.</p>
<p>Aside from providing better performance, this also means that if the hostname you configure remoting to listen as cannot actually be resolved from within the very same actor system, such messages will (perhaps counterintuitively) be delivered just fine.</p></div>
<h2><a href="#remote-security" name="remote-security" class="anchor"><span class="anchor-link"></span></a>Remote Security</h2>
-<p>An <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> should not be exposed via Pekko Remote (Artery) over plain A [...]
+<p>An <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> should not be exposed via Pekko Remote (Artery) over plain A [...]
<p>Best practice is that Pekko remoting nodes should only be accessible from the adjacent network. Note that if TLS is enabled with mutual authentication there is still a risk that an attacker can gain access to a valid certificate by compromising any node with certificates issued by the same internal PKI tree.</p>
<p>By default, <a href="serialization.html#java-serialization">Java serialization</a> is disabled in Pekko. That is also security best-practice because of its multiple <a href="https://community.microfocus.com/cyberres/fortify/f/fortify-discussions/317555/the-perils-of-java-deserialization">known attack surfaces</a>.</p>
<a id="remote-tls"></a>
@@ -632,10 +632,10 @@ dependencies {
<p>See also a description of the settings in the <a href="remoting-artery.html#remote-configuration-artery">Remote Configuration</a> section.</p><div class="callout note "><div class="callout-title">Note</div>
<p>When using SHA1PRNG on Linux it’s recommended specify <code>-Djava.security.egd=file:/dev/urandom</code> as argument to the JVM to prevent blocking. It is NOT as secure because it reuses the seed.</p></div>
<h3><a href="#untrusted-mode" name="untrusted-mode" class="anchor"><span class="anchor-link"></span></a>Untrusted Mode</h3>
-<p>As soon as an actor system can connect to another remotely, it may in principle send any possible message to any actor contained within that remote system. One example may be sending a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/o [...]
+<p>As soon as an actor system can connect to another remotely, it may in principle send any possible message to any actor contained within that remote system. One example may be sending a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/o [...]
<pre><code>pekko.remote.artery.untrusted-mode = on
</code></pre>
-<p>This disallows sending of system messages (actor life-cycle commands, DeathWatch, etc.) and any message extending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.apache.pekko.actor.PossiblyHarmful"><code>PossiblyHarmful</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.a [...]
+<p>This disallows sending of system messages (actor life-cycle commands, DeathWatch, etc.) and any message extending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.apache.pekko.actor.PossiblyHarmful"><code>PossiblyHarmful</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.a [...]
<p>Untrusted mode does not give full protection against attacks by itself. It makes it slightly harder to perform malicious or unintended actions but it should be noted that <a href="serialization.html#java-serialization">Java serialization</a> should still not be enabled. Additional protection can be achieved when running in an untrusted network by network security (e.g. firewalls) and/or enabling <a href="remoting-artery.html#remote-tls">TLS with mutual authentication</a>.</p></div>
<p>Messages sent with actor selection are by default discarded in untrusted mode, but permission to receive actor selection messages can be granted to specific actors defined in configuration:</p>
<pre><code>pekko.remote.artery.trusted-selection-paths = ["/user/receptionist", "/user/namingService"]
@@ -645,11 +645,11 @@ dependencies {
<ul>
<li>remote deployment (which also means no remote supervision)</li>
<li>remote DeathWatch</li>
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#stop(actor:org.apache.pekko.actor.ActorRef):Unit" title="org.apache.pekko.actor.ActorRefFactory"><code>system.stop()</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#stop(org.apache.pekko.actor.ActorRef)" title="org.apache.pekko.actor.ActorRef [...]
- <li>sending any message which extends from the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.apache.pekko.actor.PossiblyHarmful"><code>PossiblyHarmful</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.apache.pekko.actor.PossiblyHarmful"><code>PossiblyHarmful</code></a>< [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#stop(actor:org.apache.pekko.actor.ActorRef):Unit" title="org.apache.pekko.actor.ActorRefFactory"><code>system.stop()</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRefFactory.html#stop(org.apache.pekko.actor.ActorRef)" title="org.apache.pekko.actor.ActorRef [...]
+ <li>sending any message which extends from the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.apache.pekko.actor.PossiblyHarmful"><code>PossiblyHarmful</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PossiblyHarmful.html" title="org.apache.pekko.actor.PossiblyHarmful"><code>PossiblyHarmful</code></a>< [...]
<li>messages sent with actor selection, unless destination defined in <code>trusted-selection-paths</code>.</li>
</ul><div class="callout note "><div class="callout-title">Note</div>
-<p>Enabling the untrusted mode does not remove the capability of the client to freely choose the target of its message sends, which means that messages not prohibited by the above rules can be sent to any actor in the remote system. It is good practice for a client-facing system to only contain a well-defined set of entry point actors, which then forward requests (possibly after performing validation) to another actor system containing the actual worker actors. If messaging between these [...]
+<p>Enabling the untrusted mode does not remove the capability of the client to freely choose the target of its message sends, which means that messages not prohibited by the above rules can be sent to any actor in the remote system. It is good practice for a client-facing system to only contain a well-defined set of entry point actors, which then forward requests (possibly after performing validation) to another actor system containing the actual worker actors. If messaging between these [...]
<h2><a href="#quarantine" name="quarantine" class="anchor"><span class="anchor-link"></span></a>Quarantine</h2>
<p>Pekko remoting is using TCP or Aeron as underlying message transport. Aeron is using UDP and adds among other things reliable delivery and session semantics, very similar to TCP. This means that the order of the messages are preserved, which is needed for the <a href="general/message-delivery-reliability.html#message-ordering">Actor message ordering guarantees</a>. Under normal circumstances all messages will be delivered but there are cases when messages may not be delivered to the d [...]
<ul>
@@ -660,7 +660,7 @@ dependencies {
</ul>
<p>In short, Actor message delivery is “at-most-once” as described in <a href="general/message-delivery-reliability.html">Message Delivery Reliability</a></p>
<p>Some messages in Pekko are called system messages and those cannot be dropped because that would result in an inconsistent state between the systems. Such messages are used for essentially two features; remote death watch and remote deployment. These messages are delivered by Pekko remoting with “exactly-once” guarantee by confirming each message and resending unconfirmed messages. If a system message anyway cannot be delivered the association with the destination system is irrecovera [...]
-<p>Each <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> instance has an unique identifier (UID), which is importan [...]
+<p>Each <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> instance has an unique identifier (UID), which is importan [...]
<p>Messages that are sent to and received from a quarantined system will be dropped. However, it is possible to send messages with <code>actorSelection</code> to the address of a quarantined system, which is useful to probe if the system has been restarted.</p>
<p>An association will be quarantined when:</p>
<ul>
@@ -669,12 +669,12 @@ dependencies {
<li>Overflow of the system message delivery buffer, e.g. because of too many <code>watch</code> requests at the same time (<code>system-message-buffer-size</code> config).</li>
<li>Unexpected exception occurs in the control subchannel of the remoting infrastructure.</li>
</ul>
-<p>The UID of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> is exchanged in a two-way handshake when the fir [...]
+<p>The UID of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> is exchanged in a two-way handshake when the fir [...]
<p>Handshake requests are actually also sent periodically to be able to establish a working connection when the destination system has been restarted.</p>
<h3><a href="#watching-remote-actors" name="watching-remote-actors" class="anchor"><span class="anchor-link"></span></a>Watching Remote Actors</h3>
<p>Watching a remote actor is API wise not different than watching a local actor, as described in <a href="actors.html#deathwatch">Lifecycle Monitoring aka DeathWatch</a>. However, it is important to note, that unlike in the local case, remoting has to handle when a remote actor does not terminate in a graceful way sending a system message to notify the watcher actor about the event, but instead being hosted on a system which stopped abruptly (crashed). These situations are handled by th [...]
<h3><a href="#failure-detector" name="failure-detector" class="anchor"><span class="anchor-link"></span></a>Failure Detector</h3>
-<p>Under the hood remote death watch uses heartbeat messages and a failure detector to generate <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Termi [...]
+<p>Under the hood remote death watch uses heartbeat messages and a failure detector to generate <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Terminated</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Terminated.html" title="org.apache.pekko.actor.Terminated"><code>Termi [...]
<p>The heartbeat arrival times is interpreted by an implementation of <a href="http://www.jaist.ac.jp/~defago/files/pdf/IS_RR_2004_010.pdf">The Phi Accrual Failure Detector</a>.</p>
<p>The suspicion level of failure is given by a value called <em>phi</em>. The basic idea of the phi failure detector is to express the value of <em>phi</em> on a scale that is dynamically adjusted to reflect current network conditions.</p>
<p>The value of <em>phi</em> is calculated as:</p>
@@ -693,7 +693,7 @@ dependencies {
<p>You need to enable <a href="serialization.html">serialization</a> for your actor messages. <a href="serialization-jackson.html">Serialization with Jackson</a> is a good choice in many cases and our recommendation if you don’t have other preference.</p>
<a id="remote-bytebuffer-serialization"></a>
<h3><a href="#bytebuffer-based-serialization" name="bytebuffer-based-serialization" class="anchor"><span class="anchor-link"></span></a>ByteBuffer based serialization</h3>
-<p>Artery introduces a new serialization mechanism which allows the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/ByteBufferSerializer.html" title="org.apache.pekko.serialization.ByteBufferSerializer"><code>ByteBufferSerializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/ByteBufferSerializer.html" title="org.apache [...]
+<p>Artery introduces a new serialization mechanism which allows the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/ByteBufferSerializer.html" title="org.apache.pekko.serialization.ByteBufferSerializer"><code>ByteBufferSerializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/ByteBufferSerializer.html" title="org.apache [...]
<p>This new API also plays well with new versions of Google Protocol Buffers and other serialization libraries, which gained the ability to serialize directly into and from ByteBuffers.</p>
<p>As the new feature only changes how bytes are read and written, and the rest of the serialization infrastructure remained the same, we recommend reading the <a href="serialization.html">Serialization</a> documentation first.</p>
<p>Implementing an <code>org.apache.pekko.serialization.ByteBufferSerializer</code> works the same way as any other serializer,</p>
@@ -729,7 +729,7 @@ dependencies {
}</code></pre></dd>
</dl>
<p>Implementing a serializer for Artery is therefore as simple as implementing this interface, and binding the serializer as usual (which is explained in <a href="serialization.html">Serialization</a>).</p>
-<p>Implementations should typically extend <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org.apache.pekko.serialization.SerializerWithStringManifest"><code>SerializerWithStringManifest</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org [...]
+<p>Implementations should typically extend <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org.apache.pekko.serialization.SerializerWithStringManifest"><code>SerializerWithStringManifest</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org [...]
<p>Note that the array based methods can be implemented by delegation like this:</p>
<dl>
<dt>Scala</dt>
@@ -846,7 +846,7 @@ class ExampleByteBufSerializer extends SerializerWithStringManifest
<li>Built-in Java Flight Recorder (JFR) to help debugging implementation issues without polluting users logs with implementation specific events</li>
<li>Providing protocol stability across major Pekko versions to support rolling updates of large-scale systems</li>
</ul>
-<p>The main incompatible change from the previous implementation that the protocol field of the string representation of an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.Act [...]
+<p>The main incompatible change from the previous implementation that the protocol field of the string representation of an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.Act [...]
<h2><a href="#performance-tuning" name="performance-tuning" class="anchor"><span class="anchor-link"></span></a>Performance tuning</h2>
<h3><a href="#lanes" name="lanes" class="anchor"><span class="anchor-link"></span></a>Lanes</h3>
<p>Message serialization and deserialization can be a bottleneck for remote communication. Therefore there is support for parallel inbound and outbound lanes to perform serialization and other tasks for different destination actors in parallel. Using multiple lanes is of most value for the inbound messages, since all inbound messages from all remote systems share the same inbound stream. For outbound messages there is already one stream per remote destination system, so multiple outbound [...]
@@ -1083,7 +1083,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/remoting.html b/content/remoting.html
index 32311eb..ed7d600 100644
--- a/content/remoting.html
+++ b/content/remoting.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Remoting is the mechanism by which Actors on different nodes talk to each other internally.</p>
<p>When building an Pekko application, you would usually not use the Remoting concepts directly, but instead use the more high-level <a href="index-cluster.html">Pekko Cluster</a> utilities or technology-agnostic protocols such as <a href="https://doc.akka.io/docs/akka-http/current/">HTTP</a>, <a href="https://doc.akka.io/docs/akka-grpc/current/">gRPC</a> etc.</p></div>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Pekko Remoting, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Remoting, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-remote" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-remote" % PekkoVersion</code
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-remote" % PekkoVersion</code
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-remote_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -453,7 +453,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Remoting</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-remote</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -886,7 +886,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/routing.html b/content/routing.html
index 4b83102..66a3e9a 100644
--- a/content/routing.html
+++ b/content/routing.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the documentation of the new API of this feature and for new projects see <a href="typed/routers.html">routers</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Routing, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Routing, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,12 +445,12 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#introduction" name="introduction" class="anchor"><span class="anchor-link"></span></a>Introduction</h2>
-<p>Messages can be sent via a router to efficiently route them to destination actors, known as its <em>routees</em>. A <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Router.html" title="org.apache.pekko.routing.Router"><code>Router</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Router.html" title="org.apache.pekko.routing.Router"> [...]
+<p>Messages can be sent via a router to efficiently route them to destination actors, known as its <em>routees</em>. A <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Router.html" title="org.apache.pekko.routing.Router"><code>Router</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Router.html" title="org.apache.pekko.routing.Router"> [...]
<p>Different routing strategies can be used, according to your application’s needs. Pekko comes with several useful routing strategies right out of the box. But, as you will see in this chapter, it is also possible to <a href="routing.html#custom-router">create your own</a>.</p>
<a id="simple-router"></a>
<h2><a href="#a-simple-router" name="a-simple-router" class="anchor"><span class="anchor-link"></span></a>A Simple Router</h2>
@@ -526,20 +526,20 @@ static class Master extends AbstractActor {
}
</code></pre></dd>
</dl>
-<p>We create a <code>Router</code> and specify that it should use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routi [...]
+<p>We create a <code>Router</code> and specify that it should use <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routi [...]
<p>The routing logic shipped with Pekko are:</p>
<ul>
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</cod [...]
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RandomRoutingLogic.html" title="org.apache.pekko.routing.RandomRoutingLogic"><code>RandomRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RandomRoutingLogic.html" title="org.apache.pekko.routing.RandomRoutingLogic"><code>RandomRoutingLogic</code></a></span></li>
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/SmallestMailboxRoutingLogic.html" title="org.apache.pekko.routing.SmallestMailboxRoutingLogic"><code>SmallestMailboxRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/SmallestMailboxRoutingLogic.html" title="org.apache.pekko.routing.SmallestMailboxRoutingLogic"><code>Sm [...]
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/BroadcastRoutingLogic.html" title="org.apache.pekko.routing.BroadcastRoutingLogic"><code>BroadcastRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/BroadcastRoutingLogic.html" title="org.apache.pekko.routing.BroadcastRoutingLogic"><code>BroadcastRoutingLogic</code></a> [...]
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ScatterGatherFirstCompletedRoutingLogic.html" title="org.apache.pekko.routing.ScatterGatherFirstCompletedRoutingLogic"><code>ScatterGatherFirstCompletedRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ScatterGatherFirstCompletedRoutingLogic.html" title="org.apache.pek [...]
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/TailChoppingRoutingLogic.html" title="org.apache.pekko.routing.TailChoppingRoutingLogic"><code>TailChoppingRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/TailChoppingRoutingLogic.html" title="org.apache.pekko.routing.TailChoppingRoutingLogic"><code>TailChoppingRouti [...]
- <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRoutingLogic.html" title="org.apache.pekko.routing.ConsistentHashingRoutingLogic"><code>ConsistentHashingRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRoutingLogic.html" title="org.apache.pekko.routing.ConsistentHashingRoutingLogic [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</cod [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RandomRoutingLogic.html" title="org.apache.pekko.routing.RandomRoutingLogic"><code>RandomRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RandomRoutingLogic.html" title="org.apache.pekko.routing.RandomRoutingLogic"><code>RandomRoutingLogic</code></a></span></li>
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/SmallestMailboxRoutingLogic.html" title="org.apache.pekko.routing.SmallestMailboxRoutingLogic"><code>SmallestMailboxRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/SmallestMailboxRoutingLogic.html" title="org.apache.pekko.routing.SmallestMailboxRoutingLogic"><code>Sm [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/BroadcastRoutingLogic.html" title="org.apache.pekko.routing.BroadcastRoutingLogic"><code>BroadcastRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/BroadcastRoutingLogic.html" title="org.apache.pekko.routing.BroadcastRoutingLogic"><code>BroadcastRoutingLogic</code></a> [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ScatterGatherFirstCompletedRoutingLogic.html" title="org.apache.pekko.routing.ScatterGatherFirstCompletedRoutingLogic"><code>ScatterGatherFirstCompletedRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ScatterGatherFirstCompletedRoutingLogic.html" title="org.apache.pek [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/TailChoppingRoutingLogic.html" title="org.apache.pekko.routing.TailChoppingRoutingLogic"><code>TailChoppingRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/TailChoppingRoutingLogic.html" title="org.apache.pekko.routing.TailChoppingRoutingLogic"><code>TailChoppingRouti [...]
+ <li><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRoutingLogic.html" title="org.apache.pekko.routing.ConsistentHashingRoutingLogic"><code>ConsistentHashingRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRoutingLogic.html" title="org.apache.pekko.routing.ConsistentHashingRoutingLogic [...]
</ul>
-<p>We create the routees as ordinary child actors wrapped in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ActorRefRoutee.html" title="org.apache.pekko.routing.ActorRefRoutee"><code>ActorRefRoutee</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ActorRefRoutee.html" title="org.apache.pekko.routing.ActorRefRoutee"><code>ActorRefRout [...]
-<p>Sending messages via the router is done with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Router.html#route(message:Any,sender:org.apache.pekko.actor.ActorRef):Unit" title="org.apache.pekko.routing.Router"><code>route</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Router.html#route(java.lang.Object,org.apache.pekko.actor. [...]
-<p>The <code>Router</code> is immutable and the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span> is t [...]
+<p>We create the routees as ordinary child actors wrapped in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ActorRefRoutee.html" title="org.apache.pekko.routing.ActorRefRoutee"><code>ActorRefRoutee</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ActorRefRoutee.html" title="org.apache.pekko.routing.ActorRefRoutee"><code>ActorRefRout [...]
+<p>Sending messages via the router is done with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Router.html#route(message:Any,sender:org.apache.pekko.actor.ActorRef):Unit" title="org.apache.pekko.routing.Router"><code>route</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Router.html#route(java.lang.Object,org.apache.pekko.actor. [...]
+<p>The <code>Router</code> is immutable and the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoutingLogic.html" title="org.apache.pekko.routing.RoutingLogic"><code>RoutingLogic</code></a></span> is t [...]
<p>In general, any message sent to a router will be sent onwards to its routees, but there is one exception. The special <a href="routing.html#broadcast-messages">Broadcast Messages</a> will send to <em>all</em> of a router’s routees. However, do not use <a href="routing.html#broadcast-messages">Broadcast Messages</a> when you use <a href="routing.html#balancing-pool">BalancingPool</a> for routees as described in <a href="routing.html#router-special-messages">Specially Handled Mess [...]
<h2><a href="#a-router-actor" name="a-router-actor" class="anchor"><span class="anchor-link"></span></a>A Router Actor</h2>
<p>A router can also be created as a self contained actor that manages the routees itself and loads routing logic and other settings from configuration.</p>
@@ -549,7 +549,7 @@ static class Master extends AbstractActor {
<li>Group - The routee actors are created externally to the router and the router sends messages to the specified path using actor selection, without watching for termination.</li>
</ul>
<p>The settings for a router actor can be defined in configuration or programmatically. In order to make an actor to make use of an externally configurable router the <code>FromConfig</code> props wrapper must be used to denote that the actor accepts routing settings from configuration. This is in contrast with Remote Deployment where such marker props is not necessary. If the props of an actor is NOT wrapped in <code>FromConfig</code> it will ignore the router section of the deployment [...]
-<p>You send messages to the routees via the router actor in the same way as for ordinary actors, i.e. via its <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>A [...]
+<p>You send messages to the routees via the router actor in the same way as for ordinary actors, i.e. via its <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>A [...]
<p>In general, any message sent to a router will be sent onwards to its routees, but there are a few exceptions. These are documented in the <a href="routing.html#router-special-messages">Specially Handled Messages</a> section below.</p></div>
<h3><a href="#pool" name="pool" class="anchor"><span class="anchor-link"></span></a>Pool</h3>
<p>The following code and configuration snippets show how to create a <a href="routing.html#round-robin-router">round-robin</a> router that forwards messages to five <code>Worker</code> routees. The routees will be created as the router’s children.</p>
@@ -581,7 +581,7 @@ static class Master extends AbstractActor {
getContext().actorOf(new RoundRobinPool(5).props(Props.create(Worker.class)), "router2");</code></pre></dd>
</dl>
<h4><a href="#remote-deployed-routees" name="remote-deployed-routees" class="anchor"><span class="anchor-link"></span></a>Remote Deployed Routees</h4>
-<p>In addition to being able to create local actors as routees, you can instruct the router to deploy its created children on a set of remote hosts. Routees will be deployed in round-robin fashion. In order to deploy routees remotely, wrap the router configuration in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/remote/routing/RemoteRouterConfig.html" title="org.apache.pekko.remote.routing.RemoteRouterConfig"><code>Remote [...]
+<p>In addition to being able to create local actors as routees, you can instruct the router to deploy its created children on a set of remote hosts. Routees will be deployed in round-robin fashion. In order to deploy routees remotely, wrap the router configuration in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/remote/routing/RemoteRouterConfig.html" title="org.apache.pekko.remote.routing.RemoteRouterConfig"><code>Remote [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -627,7 +627,7 @@ sender().!("reply")(context.parent) // alternative syntax</code></pre>
<p>The supervision strategy of the router actor can be configured with the <code>supervisorStrategy</code> property of the Pool. If no configuration is provided, routers default to a strategy of “always escalate”. This means that errors are passed up to the router’s supervisor for handling. The router’s supervisor will decide what to do about any errors.</p>
<p>Note the router’s supervisor will treat the error as an error with the router itself. Therefore a directive to stop or restart will cause the router <em>itself</em> to stop or restart. The router, in turn, will cause its children to stop and restart.</p>
<p>It should be mentioned that the router’s restart behavior has been overridden so that a restart, while still re-creating the children, will still preserve the same number of actors in the pool.</p>
-<p>This means that if you have not specified <code>supervisorStrategy</code> of the router or its parent a failure in a routee will escalate to the parent of the router, which will by default restart the router, which will restart all routees (it uses Escalate and does not stop routees during restart). The reason is to make the default behave such that adding <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html#wi [...]
+<p>This means that if you have not specified <code>supervisorStrategy</code> of the router or its parent a failure in a routee will escalate to the parent of the router, which will by default restart the router, which will restart all routees (it uses Escalate and does not stop routees during restart). The reason is to make the default behave such that adding <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html#wi [...]
<p>Setting the strategy is done like this:</p>
<dl>
<dt>Scala</dt>
@@ -650,7 +650,7 @@ final ActorRef router =
</dl><div class="callout note "><div class="callout-title">Note</div>
<p>If the child of a pool router terminates, the pool router will not automatically spawn a new child. In the event that all children of a pool router have terminated the router will terminate itself unless it is a dynamic router, e.g. using a resizer.</p></div>
<h3><a href="#group" name="group" class="anchor"><span class="anchor-link"></span></a>Group</h3>
-<p>Sometimes, rather than having the router actor create its routees, it is desirable to create routees separately and provide them to the router for its use. You can do this by passing in paths of the routees to the router’s configuration. Messages will be sent with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></s [...]
+<p>Sometimes, rather than having the router actor create its routees, it is desirable to create routees separately and provide them to the router for its use. You can do this by passing in paths of the routees to the router’s configuration. Messages will be sent with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSelection.html" title="org.apache.pekko.actor.ActorSelection"><code>ActorSelection</code></a></s [...]
<p>The example below shows how to create a router by providing it with the path strings of three routee actors. </p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/routing/RouterDocSpec.scala#L51-L56" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko.actor.deployment {
/parent/router3 {
@@ -889,7 +889,7 @@ ActorRef router8 = getContext().actorOf(new RandomGroup(paths).props(), "ro
}
}
}</code></pre>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/BalancingPool.html" title="org.apache.pekko.routing.BalancingPool"><code>BalancingPool</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/BalancingPool.html" title="org.apache.pekko.routing.BalancingPool"><code>BalancingPool</code></a></span> automatically uses a special <code>Bala [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/BalancingPool.html" title="org.apache.pekko.routing.BalancingPool"><code>BalancingPool</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/BalancingPool.html" title="org.apache.pekko.routing.BalancingPool"><code>BalancingPool</code></a></span> automatically uses a special <code>Bala [...]
<p>While it is not possible to change the dispatcher used by the routees, it is possible to fine tune the used <em>executor</em>. By default the <code>fork-join-dispatcher</code> is used and can be configured as explained in <a href="dispatchers.html">Dispatchers</a>. In situations where the routees are expected to perform blocking operations it may be useful to replace it with a <code>thread-pool-executor</code> hinting the number of allocated threads explicitly:</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/routing/RouterDocSpec.scala#L99-L113" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko.actor.deployment {
/parent/router10b {
@@ -1019,7 +1019,7 @@ ActorRef router16 = getContext().actorOf(new BroadcastGroup(paths).props(), &quo
<p>Broadcast routers always broadcast <em>every</em> message to their routees. If you do not want to broadcast every message, then you can use a non-broadcasting router and use <a href="#broadcast-messages">Broadcast Messages</a> as needed.</p></div>
<h3><a href="#scattergatherfirstcompletedpool-and-scattergatherfirstcompletedgroup" name="scattergatherfirstcompletedpool-and-scattergatherfirstcompletedgroup" class="anchor"><span class="anchor-link"></span></a>ScatterGatherFirstCompletedPool and ScatterGatherFirstCompletedGroup</h3>
<p>The ScatterGatherFirstCompletedRouter will send the message on to all its routees. It then waits for first reply it gets back. This result will be sent back to original sender. Other replies are discarded.</p>
-<p>It is expecting at least one reply within a configured duration, otherwise it will reply with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org [...]
+<p>It is expecting at least one reply within a configured duration, otherwise it will reply with <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org [...]
<p>ScatterGatherFirstCompletedPool defined in configuration:</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/routing/RouterDocSpec.scala#L156-L162" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko.actor.deployment {
/parent/router17 {
@@ -1164,8 +1164,8 @@ ActorRef router24 =
<p>There is 3 ways to define what data to use for the consistent hash key.</p>
<ul>
<li>You can define <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/routing/ConsistentHashingPool.html#hashMapping:org.apache.pekko.routing.ConsistentHashingRouter.ConsistentHashMapping" title="pekko.routing.ConsistentHashingPool"><code>hashMapping</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/routing/ConsistentHashingRoutingLogic.html#withHashMapper(org.apache.pekko.routing.ConsistentHashingRou [...]
- <li>The messages may implement <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRouter$$ConsistentHashable.html" title="org.apache.pekko.routing.ConsistentHashingRouter.ConsistentHashable"><code>ConsistentHashingRouter.ConsistentHashable</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRouter$$Consi [...]
- <li>The messages can be wrapped in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRouter$$ConsistentHashableEnvelope.html" title="org.apache.pekko.routing.ConsistentHashingRouter.ConsistentHashableEnvelope"><code>ConsistentHashingRouter.ConsistentHashableEnvelope</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/ [...]
+ <li>The messages may implement <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRouter$$ConsistentHashable.html" title="org.apache.pekko.routing.ConsistentHashingRouter.ConsistentHashable"><code>ConsistentHashingRouter.ConsistentHashable</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRouter$$Consi [...]
+ <li>The messages can be wrapped in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ConsistentHashingRouter$$ConsistentHashableEnvelope.html" title="org.apache.pekko.routing.ConsistentHashingRouter.ConsistentHashableEnvelope"><code>ConsistentHashingRouter.ConsistentHashableEnvelope</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/ [...]
</ul>
<p>These ways to define the consistent hash key can be use together and at the same time for one router. The <span class="group-scala"><code>hashMapping</code></span><span class="group-java"><code>withHashMapper</code></span> is tried first.</p>
<p>Code example:</p>
@@ -1385,7 +1385,7 @@ ActorRef router28 = getContext().actorOf(new ConsistentHashingGroup(paths).props
<a id="router-special-messages"></a>
<h2><a href="#specially-handled-messages" name="specially-handled-messages" class="anchor"><span class="anchor-link"></span></a>Specially Handled Messages</h2>
<p>Most messages sent to router actors will be forwarded according to the routers’ routing logic. However there are a few types of messages that have special behavior.</p>
-<p>Note that these special messages, except for the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Broadcast.html" title="org.apache.pekko.routing.Broadcast"><code>Broadcast</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Broadcast.html" title="org.apache.pekko.routing.Broadcast"><code>Broadcast</code></a></span> message, are only [...]
+<p>Note that these special messages, except for the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Broadcast.html" title="org.apache.pekko.routing.Broadcast"><code>Broadcast</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Broadcast.html" title="org.apache.pekko.routing.Broadcast"><code>Broadcast</code></a></span> message, are only [...]
<h3><a href="#broadcast-messages" name="broadcast-messages" class="anchor"><span class="anchor-link"></span></a>Broadcast Messages</h3>
<p>A <code>Broadcast</code> message can be used to send a message to <em>all</em> of a router’s routees. When a router receives a <code>Broadcast</code> message, it will broadcast that message’s <em>payload</em> to all routees, no matter how that router would normally route its messages.</p>
<p>The example below shows how you would use a <code>Broadcast</code> message to send a very important message to every routee of a router.</p>
@@ -1401,7 +1401,7 @@ router ! Broadcast("Watch out for Davy Jones' locker")</code>
<p>In this example the router receives the <code>Broadcast</code> message, extracts its payload (<code>"Watch out for Davy Jones' locker"</code>), and then sends the payload on to all of the router’s routees. It is up to each routee actor to handle the received payload message.</p><div class="callout note "><div class="callout-title">Note</div>
<p>Do not use <a href="routing.html#broadcast-messages">Broadcast Messages</a> when you use <a href="routing.html#balancing-pool">BalancingPool</a> for routers. Routees on <a href="routing.html#balancing-pool">BalancingPool</a> shares the same mailbox instance, thus some routees can possibly get the broadcast message multiple times, while other routees get no broadcast message.</p></div>
<h3><a href="#poisonpill-messages" name="poisonpill-messages" class="anchor"><span class="anchor-link"></span></a>PoisonPill Messages</h3>
-<p>A <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span> message has special handling for all actors, including for routers. [...]
+<p>A <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span> message has special handling for all actors, including for routers. [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1427,8 +1427,8 @@ router ! Broadcast(PoisonPill)</code></pre></dd>
</dl>
<p>With the code shown above, each routee will receive a <code>PoisonPill</code> message. Each routee will continue to process its messages as normal, eventually processing the <code>PoisonPill</code>. This will cause the routee to stop. After all routees have stopped the router will itself be stopped automatically unless it is a dynamic router, e.g. using a resizer.</p>
<h3><a href="#kill-messages" name="kill-messages" class="anchor"><span class="anchor-link"></span></a>Kill Messages</h3>
-<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span> messages are another type of message that has special handling. See <a href="actors.html#killing-actors"> [...]
-<p>When a <code>Kill</code> message is sent to a router the router processes the message internally, and does <em>not</em> send it on to its routees. The router will throw an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorKilledException.html" title="org.apache.pekko.actor.ActorKilledException"><code>ActorKilledException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d [...]
+<p><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Kill.html" title="org.apache.pekko.actor.Kill"><code>Kill</code></a></span> messages are another type of message that has special handling. See <a href="actors.html#killing-actors"> [...]
+<p>When a <code>Kill</code> message is sent to a router the router processes the message internally, and does <em>not</em> send it on to its routees. The router will throw an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorKilledException.html" title="org.apache.pekko.actor.ActorKilledException"><code>ActorKilledException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec [...]
<p>Routees that are children of the router will also be suspended, and will be affected by the supervision directive that is applied to the router. Routees that are not the routers children, i.e. those that were created externally to the router, will not be affected.</p>
<dl>
<dt>Scala</dt>
@@ -1439,7 +1439,7 @@ router ! Kill</code></pre></dd>
<dd>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/java/jdocs/routing/RouterDocTest.java#L438" target="_blank" title="Go to snippet source">source</a><code class="language-java">router.tell(Kill.getInstance(), getTestActor());</code></pre></dd>
</dl>
-<p>As with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span> message, there is a distinction between killing a router, [...]
+<p>As with the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/PoisonPill.html" title="org.apache.pekko.actor.PoisonPill"><code>PoisonPill</code></a></span> message, there is a distinction between killing a router, [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1453,16 +1453,16 @@ router ! Broadcast(Kill)</code></pre></dd>
</dl>
<h3><a href="#management-messages" name="management-messages" class="anchor"><span class="anchor-link"></span></a>Management Messages</h3>
<ul>
- <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/GetRoutees.html" title="org.apache.pekko.routing.GetRoutees"><code>GetRoutees</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/GetRoutees.html" title="org.apache.pekko.routing.GetRoutees"><code>GetRoutees</code></a></span> to a router actor will make it send back its curre [...]
- <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/AddRoutee.html" title="org.apache.pekko.routing.AddRoutee"><code>AddRoutee</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/AddRoutee.html" title="org.apache.pekko.routing.AddRoutee"><code>AddRoutee</code></a></span> to a router actor will add that routee to its collection [...]
- <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RemoveRoutee.html" title="org.apache.pekko.routing.RemoveRoutee"><code>RemoveRoutee</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RemoveRoutee.html" title="org.apache.pekko.routing.RemoveRoutee"><code>RemoveRoutee</code></a></span> to a router actor will remove that rou [...]
- <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/AdjustPoolSize.html" title="org.apache.pekko.routing.AdjustPoolSize"><code>AdjustPoolSize</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/AdjustPoolSize.html" title="org.apache.pekko.routing.AdjustPoolSize"><code>AdjustPoolSize</code></a></span> to a pool router actor wil [...]
+ <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/GetRoutees.html" title="org.apache.pekko.routing.GetRoutees"><code>GetRoutees</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/GetRoutees.html" title="org.apache.pekko.routing.GetRoutees"><code>GetRoutees</code></a></span> to a router actor will make it send back its curre [...]
+ <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/AddRoutee.html" title="org.apache.pekko.routing.AddRoutee"><code>AddRoutee</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/AddRoutee.html" title="org.apache.pekko.routing.AddRoutee"><code>AddRoutee</code></a></span> to a router actor will add that routee to its collection [...]
+ <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RemoveRoutee.html" title="org.apache.pekko.routing.RemoveRoutee"><code>RemoveRoutee</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RemoveRoutee.html" title="org.apache.pekko.routing.RemoveRoutee"><code>RemoveRoutee</code></a></span> to a router actor will remove that rou [...]
+ <li>Sending <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/AdjustPoolSize.html" title="org.apache.pekko.routing.AdjustPoolSize"><code>AdjustPoolSize</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/AdjustPoolSize.html" title="org.apache.pekko.routing.AdjustPoolSize"><code>AdjustPoolSize</code></a></span> to a pool router actor wil [...]
</ul>
<p>These management messages may be handled after other messages, so if you send <code>AddRoutee</code> immediately followed by an ordinary message you are not guaranteed that the routees have been changed when the ordinary message is routed. If you need to know when the change has been applied you can send <code>AddRoutee</code> followed by <code>GetRoutees</code> and when you receive the <code>Routees</code> reply you know that the preceding change has been applied.</p>
<a id="resizable-routers"></a>
<h2><a href="#dynamically-resizable-pool" name="dynamically-resizable-pool" class="anchor"><span class="anchor-link"></span></a>Dynamically Resizable Pool</h2>
<p><span class="group-scala">Most</span><span class="group-java">All</span> pools can be used with a fixed number of routees or with a resize strategy to adjust the number of routees dynamically.</p>
-<p>There are two types of resizers: the default <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Resizer.html" title="org.apache.pekko.routing.Resizer"><code>Resizer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Resizer.html" title="org.apache.pekko.routing.Resizer"><code>Resizer</code></a></span> and the <span class="group-scala"> [...]
+<p>There are two types of resizers: the default <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Resizer.html" title="org.apache.pekko.routing.Resizer"><code>Resizer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Resizer.html" title="org.apache.pekko.routing.Resizer"><code>Resizer</code></a></span> and the <span class="group-scala"> [...]
<h3><a href="#default-resizer" name="default-resizer" class="anchor"><span class="anchor-link"></span></a>Default Resizer</h3>
<p>The default resizer ramps up and down pool size based on pressure, measured by the percentage of busy routees in the pool. It ramps up pool size if the pressure is higher than a certain threshold and backs off if the pressure is lower than certain threshold. Both thresholds are configurable.</p>
<p>Pool with default resizer defined in configuration:</p>
@@ -1506,7 +1506,7 @@ ActorRef router30 =
</dl>
<p><em>It is also worth pointing out that if you define the <code>router</code> in the configuration file then this value will be used instead of any programmatically sent parameters.</em></p>
<h3><a href="#optimal-size-exploring-resizer" name="optimal-size-exploring-resizer" class="anchor"><span class="anchor-link"></span></a>Optimal Size Exploring Resizer</h3>
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/OptimalSizeExploringResizer.html" title="org.apache.pekko.routing.OptimalSizeExploringResizer"><code>OptimalSizeExploringResizer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/OptimalSizeExploringResizer.html" title="org.apache.pekko.routing.OptimalSizeExploringResizer"><code>O [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/OptimalSizeExploringResizer.html" title="org.apache.pekko.routing.OptimalSizeExploringResizer"><code>OptimalSizeExploringResizer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/OptimalSizeExploringResizer.html" title="org.apache.pekko.routing.OptimalSizeExploringResizer"><code>O [...]
<p>This resizer works best when you expect the pool size to performance function to be a convex function. For example, when you have a CPU bound tasks, the optimal size is bound to the number of CPU cores. When your task is IO bound, the optimal size is bound to optimal number of concurrent connections to that IO service - e.g. a 4 node elastic search cluster may handle 4-8 concurrent requests at optimal speed.</p>
<p>It achieves this by keeping track of message throughput at each pool size and performing the following three resizing operations (one at a time) periodically:</p>
<ul>
@@ -1544,7 +1544,7 @@ ActorRef router30 =
<a id="router-design"></a>
<h2><a href="#how-routing-is-designed-within-pekko" name="how-routing-is-designed-within-pekko" class="anchor"><span class="anchor-link"></span></a>How Routing is Designed within Pekko</h2>
<p>On the surface routers look like normal actors, but they are actually implemented differently. Routers are designed to be extremely efficient at receiving messages and passing them quickly on to routees.</p>
-<p>A normal actor can be used for routing messages, but an actor’s single-threaded processing can become a bottleneck. Routers can achieve much higher throughput with an optimization to the usual message-processing pipeline that allows concurrent routing. This is achieved by embedding routers’ routing logic directly in their <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pek [...]
+<p>A normal actor can be used for routing messages, but an actor’s single-threaded processing can become a bottleneck. Routers can achieve much higher throughput with an optimization to the usual message-processing pipeline that allows concurrent routing. This is achieved by embedding routers’ routing logic directly in their <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pek [...]
<p>The cost to this is that the internals of routing code are more complicated than if routers were implemented with normal actors. Fortunately all of this complexity is invisible to consumers of the routing API. However, it is something to be aware of when implementing your own routers.</p>
<h2><a href="#custom-router" name="custom-router" class="anchor"><span class="anchor-link"></span></a>Custom Router</h2>
<p>You can create your own router should you not find any of the ones provided by Pekko sufficient for your needs. In order to roll your own router you have to fulfill certain criteria which are explained in this section.</p>
@@ -1590,7 +1590,7 @@ class RedundancyRoutingLogic(nbrCopies: Int) extends RoutingLogic {
}
}</code></pre></dd>
</dl>
-<p><code>select</code> will be called for each message and in this example pick a few destinations by round-robin, by reusing the existing <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache [...]
+<p><code>select</code> will be called for each message and in this example pick a few destinations by round-robin, by reusing the existing <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/RoundRobinRoutingLogic.html" title="org.apache.pekko.routing.RoundRobinRoutingLogic"><code>RoundRobinRoutingLogic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache [...]
<p>The implementation of the routing logic must be thread safe, since it might be used outside of actors.</p>
<p>A unit test of the routing logic: </p>
<dl>
@@ -1661,7 +1661,7 @@ class RedundancyRoutingLogic(nbrCopies: Int) extends RoutingLogic {
</dl>
<p>You could stop here and use the <code>RedundancyRoutingLogic</code> with a <code>org.apache.pekko.routing.Router</code> as described in <a href="routing.html#simple-router">A Simple Router</a>.</p>
<p>Let us continue and make this into a self contained, configurable, router actor.</p>
-<p>Create a class that extends <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Pool.html" title="org.apache.pekko.routing.Pool"><code>Pool</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/routing/Pool.html" title="org.apache.pekko.routing.Pool"><code>Pool</code></a></span>, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0. [...]
+<p>Create a class that extends <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Pool.html" title="org.apache.pekko.routing.Pool"><code>Pool</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/routing/Pool.html" title="org.apache.pekko.routing.Pool"><code>Pool</code></a></span>, <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0. [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1783,7 +1783,7 @@ redundancy2 ! "very important"</code></pre></dd>
redundancy2.tell("very important", getTestActor());</code></pre></dd>
</dl>
<h2><a href="#configuring-dispatchers" name="configuring-dispatchers" class="anchor"><span class="anchor-link"></span></a>Configuring Dispatchers</h2>
-<p>The dispatcher for created children of the pool will be taken from <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> as described in <a href="dispatc [...]
+<p>The dispatcher for created children of the pool will be taken from <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> as described in <a href="dispatc [...]
<p>To make it easy to define the dispatcher of the routees of the pool you can define the dispatcher inline in the deployment section of the config.</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/routing/RouterDocSpec.scala#L288-L297" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko.actor.deployment {
/poolWithDispatcher {
@@ -1797,7 +1797,7 @@ redundancy2.tell("very important", getTestActor());</code></pre></dd>
}</code></pre>
<p>That is the only thing you need to do enable a dedicated dispatcher for a pool.</p><div class="callout note "><div class="callout-title">Note</div>
<p>If you use a group of actors and route to their paths, then they will still use the same dispatcher that was configured for them in their <code>Props</code>, it is not possible to change an actors dispatcher after it has been created.</p></div>
-<p>The “head” router cannot always run on the same dispatcher, because it does not process the same type of messages, hence this special actor does not use the dispatcher configured in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/ac [...]
+<p>The “head” router cannot always run on the same dispatcher, because it does not process the same type of messages, hence this special actor does not use the dispatcher configured in <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/ac [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -1814,7 +1814,7 @@ redundancy2.tell("very important", getTestActor());</code></pre></dd>
new RandomPool(5).withDispatcher("router-dispatcher").props(Props.create(Worker.class));
ActorRef router = system.actorOf(props, "poolWithDispatcher");</code></pre></dd>
</dl><div class="callout note "><div class="callout-title">Note</div>
-<p>It is not allowed to configure the <code>routerDispatcher</code> to be a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/BalancingDispatcherConfigurator.html" title="org.apache.pekko.dispatch.BalancingDispatcherConfigurator"><code>BalancingDispatcherConfigurator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/dispatch/BalancingDispatche [...]
+<p>It is not allowed to configure the <code>routerDispatcher</code> to be a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/BalancingDispatcherConfigurator.html" title="org.apache.pekko.dispatch.BalancingDispatcherConfigurator"><code>BalancingDispatcherConfigurator</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/dispatch/BalancingDispatche [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/routing.md">here</a>.
</div>
@@ -1908,7 +1908,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/scheduler.html b/content/scheduler.html
index 97a422f..0dac459 100644
--- a/content/scheduler.html
+++ b/content/scheduler.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>For the new API see <a href="typed/interaction-patterns.html#typed-scheduling">typed scheduling</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Scheduler, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Scheduler, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,17 +445,17 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#introduction" name="introduction" class="anchor"><span class="anchor-link"></span></a>Introduction</h2>
-<p>Sometimes the need for making things happen in the future arises, and where do you go look then? Look no further than <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko. [...]
-<p>You can schedule sending of messages to actors and execution of tasks (functions or Runnable). You will get a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Cancellable"><code>Cancellable</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Ca [...]
-<p>When scheduling periodic or single messages in an actor to itself it is recommended to use the <a href="actors.html#actors-timers">Actor Timers</a> instead of using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Scheduler.html" title="org.apache.pekko.actor.Scheduler"><code>Scheduler</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/act [...]
+<p>Sometimes the need for making things happen in the future arises, and where do you go look then? Look no further than <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko. [...]
+<p>You can schedule sending of messages to actors and execution of tasks (functions or Runnable). You will get a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Cancellable"><code>Cancellable</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Ca [...]
+<p>When scheduling periodic or single messages in an actor to itself it is recommended to use the <a href="actors.html#actors-timers">Actor Timers</a> instead of using the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Scheduler.html" title="org.apache.pekko.actor.Scheduler"><code>Scheduler</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/act [...]
<p>The scheduler in Pekko is designed for high-throughput of thousands up to millions of triggers. The prime use-case being triggering Actor receive timeouts, Future timeouts, circuit breakers and other time dependent events which happen all-the-time and in many instances at the same time. The implementation is based on a Hashed Wheel Timer, which is a known datastructure and algorithm for handling such use cases, refer to the <a href="http://www.cs.columbia.edu/~nahum/w6998/papers/sosp8 [...]
<p>The Pekko scheduler is <strong>not</strong> designed for long-term scheduling (see <a href="https://github.com/enragedginger/akka-quartz-scheduler">akka-quartz-scheduler</a> instead for this use case) nor is it to be used for highly precise firing of the events. The maximum amount of time into the future you can schedule an event to trigger is around 8 months, which in practice is too much to be useful since this would assume the system never went down during that period. If you need [...]
-<p>The default implementation of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Scheduler.html" title="org.apache.pekko.actor.Scheduler"><code>Scheduler</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Scheduler.html" title="org.apache.pekko.actor.Scheduler"><code>Scheduler</code></a></span> used by Pekko is based on job buckets which a [...]
+<p>The default implementation of <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Scheduler.html" title="org.apache.pekko.actor.Scheduler"><code>Scheduler</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Scheduler.html" title="org.apache.pekko.actor.Scheduler"><code>Scheduler</code></a></span> used by Pekko is based on job buckets which a [...]
<h2><a href="#some-examples" name="some-examples" class="anchor"><span class="anchor-link"></span></a>Some examples</h2>
<dl>
<dt>Scala</dt>
@@ -562,7 +562,7 @@ Cancellable cancellable =
cancellable.cancel();</code></pre></dd>
</dl><div class="callout warning "><div class="callout-title">Warning</div>
<p>If you schedule functions or Runnable instances you should be extra careful to not close over unstable references. In practice this means not using <code>this</code> inside the closure in the scope of an Actor instance, not accessing <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Actor.html#sender():org.apache.pekko.actor.ActorRef" title="pekko.actor.Actor"><code>sender</code></a></span><span class="group-java"><a href="https://doc.akka.io/j [...]
-<p>All scheduled task will be executed when the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> is terminated, i.e [...]
+<p>All scheduled task will be executed when the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> is terminated, i.e [...]
<h2><a href="#schedule-periodically" name="schedule-periodically" class="anchor"><span class="anchor-link"></span></a>Schedule periodically</h2>
<p>Scheduling of recurring tasks or messages can have two different characteristics:</p>
<ul>
@@ -577,9 +577,9 @@ cancellable.cancel();</code></pre></dd>
<p>Fixed-rate execution is appropriate for recurring activities that are sensitive to absolute time or where the total time to perform a fixed number of executions is important, such as a countdown timer that ticks once every second for ten seconds.</p><div class="callout warning "><div class="callout-title">Warning</div>
<p><code>scheduleAtFixedRate</code> can result in bursts of scheduled tasks or messages after long garbage collection pauses, which may in worst case cause undesired load on the system. <code>scheduleWithFixedDelay</code> is often preferred.</p></div>
<h2><a href="#the-scheduler-interface" name="the-scheduler-interface" class="anchor"><span class="anchor-link"></span></a>The Scheduler interface</h2>
-<p>The actual scheduler implementation is loaded reflectively upon <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> [...]
+<p>The actual scheduler implementation is loaded reflectively upon <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span> [...]
<h2><a href="#the-cancellable-interface" name="the-cancellable-interface" class="anchor"><span class="anchor-link"></span></a>The Cancellable interface</h2>
-<p>Scheduling a task will result in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Cancellable"><code>Cancellable</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Cancellable"><code>Cancellable</code></a></span> (or throw an <a href="https: [...]
+<p>Scheduling a task will result in a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Cancellable"><code>Cancellable</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Cancellable.html" title="org.apache.pekko.actor.Cancellable"><code>Cancellable</code></a></span> (or throw an <a href="https: [...]
<p>This does not abort the execution of the task, if it had already been started. Check the return value of <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/actor/Cancellable.html#cancel():Boolean" title="pekko.actor.Cancellable"><code>cancel</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/actor/Cancellable.html#cancel()" title="pekko.actor.Cancellable"><code>cancel()</code></a></span> to detect whe [...]
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/scheduler.md">here</a>.
@@ -670,7 +670,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/security/index.html b/content/security/index.html
index 499d311..dd227c9 100644
--- a/content/security/index.html
+++ b/content/security/index.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -417,12 +417,13 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#security-announcements" name="security-announcements" class="anchor"><span class="anchor-link"></span></a>Security Announcements</h1>
<h2><a href="#receiving-security-advisories" name="receiving-security-advisories" class="anchor"><span class="anchor-link"></span></a>Receiving Security Advisories</h2>
-<p>The best way to receive any and all security announcements is to subscribe to the <a href="https://groups.google.com/forum/#!forum/akka-security">Pekko security list</a>.</p>
-<p>The mailing list is very low traffic, and receives notifications only after security reports have been managed by the core team and fixes are publicly available.</p>
+<p>The best way to receive any and all security announcements is to subscribe to the <a href="https://lists.apache.org/list.html?announce@apache.org">Apache Announce Mailing List</a>.</p>
+<p>This mailing list has a reasonable level of traffic, and receives notifications only after security reports have been managed by the core Apache teams and fixes are publicly available.</p>
+<p>This mailing list also has announcements of releases for Apache projects.</p>
<h2><a href="#reporting-vulnerabilities" name="reporting-vulnerabilities" class="anchor"><span class="anchor-link"></span></a>Reporting Vulnerabilities</h2>
<p>We strongly encourage people to report such problems to our private security mailing list first, before disclosing them in a public forum.</p>
-<p>Following best practice, we strongly encourage anyone to report potential security vulnerabilities to <a href="mailto:security@pekko.io">security@pekko.io</a> before disclosing them in a public forum like the mailing list or as a GitHub issue.</p>
-<p>Reports to this email address will be handled by our security team, who will work together with you to ensure that a fix can be provided without delay.</p>
+<p>Please follow the <a href="https://www.apache.org/security/">guidelines</a> laid down by the Apache Security team.</p>
+<p>Ideally, any issues affecting Apache Pekko and Akka should be reported to Apache team first. We will share the report with the Lightbend Akka team.</p>
<h2><a href="#security-related-documentation" name="security-related-documentation" class="anchor"><span class="anchor-link"></span></a>Security Related Documentation</h2>
<ul>
<li><a href="../serialization.html#java-serialization">Java Serialization</a></li>
@@ -515,7 +516,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/serialization-classic.html b/content/serialization-classic.html
index d7b1d7f..afd58ca 100644
--- a/content/serialization-classic.html
+++ b/content/serialization-classic.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Pekko Classic pertains to the original Actor APIs, which have been improved by more type safe and guided Actor APIs. Pekko Classic is still fully supported and existing applications can continue to use the classic APIs. It is also possible to use the new Actor APIs together with classic actors in the same ActorSystem, see <a href="typed/coexisting.html">coexistence</a>. For new projects we recommend using <a href="typed/actors.html">the new Actor API</a>.</p></div>
<p>Serialization is the same for Classic and Typed actors. It is described in <a href="serialization.html">Serialization</a>, aside from serialization of <code>ActorRef</code> that is described <a href="serialization-classic.html#serializing-actorrefs">here</a>.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Serialization, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Serialization, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,7 +445,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -610,7 +610,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/serialization-jackson.html b/content/serialization-jackson.html
index 6adda00..c51bbc9 100644
--- a/content/serialization-jackson.html
+++ b/content/serialization-jackson.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#serialization-with-jackson" name="serialization-with-jackson" class="anchor"><span class="anchor-link"></span></a>Serialization with Jackson</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Jackson Serialization, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Jackson Serialization, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-serialization-jackson" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-serialization-jackson" % Pek
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-serialization-jackson" % Pek
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-serialization-jackson_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -801,7 +801,7 @@ final case class Superhero(name: String, @JsonScalaEnumeration(classOf[PlanetTyp
}
}</code></pre></dd>
</dl>
-<p>To add a new mandatory field we have to use a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html" title="org.apache.pekko.serialization.jackson.JacksonMigration"><code>JacksonMigration</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html" title="org.apache.pekko.seri [...]
+<p>To add a new mandatory field we have to use a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html" title="org.apache.pekko.serialization.jackson.JacksonMigration"><code>JacksonMigration</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html" title="org.apache.pekko.seri [...]
<p>This is how a migration class would look like for adding a <code>discount</code> field:</p>
<dl>
<dt>Scala</dt>
@@ -848,7 +848,7 @@ public class ItemAddedMigration extends JacksonMigration {
}</code></pre></dd>
</dl>
<p>Override the <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/serialization/jackson/JacksonMigration.html#currentVersion:Int" title="pekko.serialization.jackson.JacksonMigration"><code>currentVersion</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/serialization/jackson/JacksonMigration.html#currentVersion()" title="pekko.serialization.jackson.JacksonMigration"><code>currentVersion()</code></a></s [...]
-<p>Implement the transformation of the old JSON structure to the new JSON structure in the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html#transform(fromVersion:Int,json:com.fasterxml.jackson.databind.JsonNode):com.fasterxml.jackson.databind.JsonNode" title="org.apache.pekko.serialization.jackson.JacksonMigration"><code>transform(fromVersion, jsonNode)</code></a></span><span class=" [...]
+<p>Implement the transformation of the old JSON structure to the new JSON structure in the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html#transform(fromVersion:Int,json:com.fasterxml.jackson.databind.JsonNode):com.fasterxml.jackson.databind.JsonNode" title="org.apache.pekko.serialization.jackson.JacksonMigration"><code>transform(fromVersion, jsonNode)</code></a></span><span class=" [...]
<p>The migration class must be defined in configuration file:</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/serialization-jackson/src/test/scala/doc/org/apache/pekko/serialization/jackson/SerializationDocSpec.scala#L57-L59" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko.serialization.jackson.migrations {
"com.myservice.event.ItemAdded" = "com.myservice.event.ItemAddedMigration"
@@ -1112,7 +1112,7 @@ public class CustomerMigration extends JacksonMigration {
}
}</code></pre></dd>
</dl>
-<p>Note the override of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html#transformClassName(fromVersion:Int,className:String):String" title="org.apache.pekko.serialization.jackson.JacksonMigration"><code>transformClassName(fromVersion, className)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serializ [...]
+<p>Note the override of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/jackson/JacksonMigration.html#transformClassName(fromVersion:Int,className:String):String" title="org.apache.pekko.serialization.jackson.JacksonMigration"><code>transformClassName(fromVersion, className)</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serializ [...]
<p>That type of migration must be configured with the old class name as key. The actual class can be removed.</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/serialization-jackson/src/test/scala/doc/org/apache/pekko/serialization/jackson/SerializationDocSpec.scala#L65-L67" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko.serialization.jackson.migrations {
"com.myservice.event.OrderAdded" = "com.myservice.event.OrderPlacedMigration"
@@ -1321,7 +1321,7 @@ pekko.serialization.jackson.jackson-json.compression {
<p>Compression can be disabled by setting the <code>algorithm</code> property to <code>off</code>. It will still be able to decompress payloads that were compressed when serialized, e.g. if this configuration is changed.</p>
<p>For the <code>jackson-cbor</code> and custom bindings other than <code>jackson-json</code> compression is by default disabled, but can be enabled in the same way as the configuration shown above but replacing <code>jackson-json</code> with the binding name (for example <code>jackson-cbor</code>).</p>
<h2><a href="#using-pekko-serialization-for-embedded-types" name="using-pekko-serialization-for-embedded-types" class="anchor"><span class="anchor-link"></span></a>Using Pekko Serialization for embedded types</h2>
-<p>For types that already have an Pekko Serializer defined that are embedded in types serialized with Jackson the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/jackson/PekkoSerializationSerializer.html" title="org.apache.pekko.serialization.jackson.PekkoSerializationSerializer"><code>PekkoSerializationSerializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c29 [...]
+<p>For types that already have an Pekko Serializer defined that are embedded in types serialized with Jackson the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/jackson/PekkoSerializationSerializer.html" title="org.apache.pekko.serialization.jackson.PekkoSerializationSerializer"><code>PekkoSerializationSerializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a52 [...]
<p>The serializer/deserializer are not enabled automatically. The <a href="https://javadoc.io/doc/com.fasterxml.jackson.core/jackson-databind/latest/com/fasterxml/jackson/databind/annotation/JsonSerialize.html" title="com.fasterxml.jackson.databind.annotation.JsonSerialize"><code>@JsonSerialize</code></a> and <a href="https://javadoc.io/doc/com.fasterxml.jackson.core/jackson-databind/latest/com/fasterxml/jackson/databind/annotation/JsonDeserialize.html" title="com.fasterxml.jackson.datab [...]
<p>The type will be embedded as an object with the fields:</p>
<ul>
@@ -1660,7 +1660,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/serialization.html b/content/serialization.html
index f2022ba..b68fc5c 100644
--- a/content/serialization.html
+++ b/content/serialization.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#serialization" name="serialization" class="anchor"><span class="anchor-link"></span></a>Serialization</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Serialization, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Serialization, you must add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-actor" % PekkoVersion</code>
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-actor_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -454,7 +454,7 @@ dependencies {
<p>Pekko itself uses Protocol Buffers to serialize internal messages (for example cluster gossip messages).</p>
<h2><a href="#usage" name="usage" class="anchor"><span class="anchor-link"></span></a>Usage</h2>
<h3><a href="#configuration" name="configuration" class="anchor"><span class="anchor-link"></span></a>Configuration</h3>
-<p>For Pekko to know which <code>Serializer</code> to use for what, you need to edit your configuration: in the <code>pekko.actor.serializers</code>-section, you bind names to implementations of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/Serializer.html" title="org.apache.pekko.serialization.Serializer"><code>serialization.Serializer</code></a></span><span class="group-java"><a href="https://doc.akka.io [...]
+<p>For Pekko to know which <code>Serializer</code> to use for what, you need to edit your configuration: in the <code>pekko.actor.serializers</code>-section, you bind names to implementations of the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/Serializer.html" title="org.apache.pekko.serialization.Serializer"><code>serialization.Serializer</code></a></span><span class="group-java"><a href="https://doc.akka.io [...]
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/serialization/SerializationDocSpec.scala#L171-L180" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko {
actor {
serializers {
@@ -545,7 +545,7 @@ String back = (String) serialization.deserialize(bytes, serializerId, manifest).
</dl>
<p>The manifest is a type hint so that the same serializer can be used for different classes.</p>
<p>Note that when deserializing from bytes the manifest and the identifier of the serializer are needed. It is important to use the serializer identifier in this way to support rolling updates, where the <code>serialization-bindings</code> for a class may have changed from one serializer to another. Therefore the three parts consisting of the bytes, the serializer id, and the manifest should always be transferred or stored together so that they can be deserialized with different <code>se [...]
-<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.serialization.SerializationExtension"><code>SerializationExtension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.serialization.SerializationExtension"><code> [...]
+<p>The <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.serialization.SerializationExtension"><code>SerializationExtension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.serialization.SerializationExtension"><code> [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -566,7 +566,7 @@ Serialization serialization = SerializationExtension.get(system);</code></pre></
<h2><a href="#customization" name="customization" class="anchor"><span class="anchor-link"></span></a>Customization</h2>
<p>The first code snippet on this page contains a configuration file that references a custom serializer <code>docs.serialization.MyOwnSerializer</code>. How would we go about creating such a custom serializer?</p>
<h3><a href="#creating-new-serializers" name="creating-new-serializers" class="anchor"><span class="anchor-link"></span></a>Creating new Serializers</h3>
-<p>A custom <code>Serializer</code> has to inherit from <span class="group-scala"><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/Serializer.html" title="org.apache.pekko.serialization.Serializer"><code>serialization.Serializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/Serializer.html" title="org.apache.pekko.seria [...]
+<p>A custom <code>Serializer</code> has to inherit from <span class="group-scala"><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/Serializer.html" title="org.apache.pekko.serialization.Serializer"><code>serialization.Serializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/Serializer.html" title="org.apache.pekko.seria [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -663,8 +663,8 @@ import java.nio.charset.StandardCharsets;
}
}</code></pre></dd>
</dl>
-<p>The <code>identifier</code> must be unique. The identifier is used when selecting which serializer to use for deserialization. If you have accidentally configured several serializers with the same identifier that will be detected and prevent the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a hr [...]
-<p>If you prefer to define the identifier in cofiguration that is supported by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/BaseSerializer.html" title="org.apache.pekko.serialization.BaseSerializer"><code>BaseSerializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/BaseSerializer.html" title="org.apache.pekko.se [...]
+<p>The <code>identifier</code> must be unique. The identifier is used when selecting which serializer to use for deserialization. If you have accidentally configured several serializers with the same identifier that will be detected and prevent the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorSystem.html" title="org.apache.pekko.actor.ActorSystem"><code>ActorSystem</code></a></span><span class="group-java"><a hr [...]
+<p>If you prefer to define the identifier in cofiguration that is supported by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/BaseSerializer.html" title="org.apache.pekko.serialization.BaseSerializer"><code>BaseSerializer</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/BaseSerializer.html" title="org.apache.pekko.se [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -678,10 +678,10 @@ import java.nio.charset.StandardCharsets;
</dl></div>
<p>The manifest is a type hint so that the same serializer can be used for different classes. The manifest parameter in <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/serialization/Serializer.html#fromBinary(bytes:Array[Byte],manifest:Option[Class[_]]):AnyRef" title="pekko.serialization.Serializer"><code>fromBinary</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/serialization/JSerializer.html#from [...]
<p>Then you only need to fill in the blanks, bind it to a name in your configuration and list which classes should be deserialized with it.</p>
-<p>The serializers are initialized eagerly by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.serialization.SerializationExtension"><code>SerializationExtension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.s [...]
+<p>The serializers are initialized eagerly by the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.serialization.SerializationExtension"><code>SerializationExtension</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializationExtension$.html" title="org.apache.pekko.s [...]
<a id="string-manifest-serializer"></a>
<h3><a href="#serializer-with-string-manifest" name="serializer-with-string-manifest" class="anchor"><span class="anchor-link"></span></a>Serializer with String Manifest</h3>
-<p>The <code>Serializer</code> illustrated above supports a class based manifest (type hint). For serialization of data that need to evolve over time the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org.apache.pekko.serialization.SerializerWithStringManifest"><code>SerializerWithStringManifest</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/ [...]
+<p>The <code>Serializer</code> illustrated above supports a class based manifest (type hint). For serialization of data that need to evolve over time the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/serialization/SerializerWithStringManifest.html" title="org.apache.pekko.serialization.SerializerWithStringManifest"><code>SerializerWithStringManifest</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/ [...]
<p>The manifest string can also encode a version number that can be used in <span class="group-scala"><a href="https://doc.akka.io/api/akka/2.6/org/apache/pekko/serialization/Serializer.html#fromBinary(bytes:Array[Byte],manifest:Option[Class[_]]):AnyRef" title="pekko.serialization.Serializer"><code>fromBinary</code></a></span><span class="group-java"><a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/serialization/JSerializer.html#fromBinaryJava(byte[],java.lang.Class)" title="p [...]
<p>If the data was originally serialized with <code>Serializer</code> and in a later version of the system you change to <code>SerializerWithStringManifest</code> then the manifest string will be the full class name if you used <code>includeManifest=true</code>, otherwise it will be the empty string.</p>
<p>This is how a <code>SerializerWithStringManifest</code> looks like:</p>
@@ -775,7 +775,7 @@ import java.nio.charset.StandardCharsets;
<p>It’s recommended to throw <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="java.lang.IllegalArgumentException"><code>IllegalArgumentException</code></a> or <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/NotSerializableException.html" title="java.io.NotSerializableException"><code>NotSerializableException</code></a> in <code>fromBinary</code> if the manifest is unknown. This makes [...]
<h3><a href="#serializing-actorrefs" name="serializing-actorrefs" class="anchor"><span class="anchor-link"></span></a>Serializing ActorRefs</h3>
<p>Actor references are typically included in the messages. All ActorRefs are serializable when using <a href="serialization-jackson.html">Serialization with Jackson</a>, but in case you are writing your own serializer, you might want to know how to serialize and deserialize them properly.</p>
-<p>To serialize actor references to/from string representation you would use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRefResolver.html" title="org.apache.pekko.actor.typed.ActorRefResolver"><code>ActorRefResolver</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/ActorRefResolver.html" title="org.apache.pekko.ac [...]
+<p>To serialize actor references to/from string representation you would use the <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRefResolver.html" title="org.apache.pekko.actor.typed.ActorRefResolver"><code>ActorRefResolver</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/ActorRefResolver.html" title="org.apache.pekko.ac [...]
<p>For example here’s how a serializer could look for <code>Ping</code> and <code>Pong</code> messages:</p>
<dl>
<dt>Scala</dt>
@@ -880,7 +880,7 @@ import java.nio.charset.StandardCharsets;
}
}</code></pre></dd>
</dl>
-<p>Serialization of Classic <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> is described in <a href="serialization-classic.html#seri [...]
+<p>Serialization of Classic <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/ActorRef.html" title="org.apache.pekko.actor.ActorRef"><code>ActorRef</code></a></span> is described in <a href="serialization-classic.html#seri [...]
<h3><a href="#deep-serialization-of-actors" name="deep-serialization-of-actors" class="anchor"><span class="anchor-link"></span></a>Deep serialization of Actors</h3>
<p>The recommended approach to do deep serialization of internal actor state is to use Pekko <a href="persistence.html">Persistence</a>.</p>
<h2><a href="#serialization-of-pekkos-messages" name="serialization-of-pekkos-messages" class="anchor"><span class="anchor-link"></span></a>Serialization of Pekko’s messages</h2>
@@ -915,8 +915,8 @@ import java.nio.charset.StandardCharsets;
serialize-messages = on
}
}</code></pre>
-<p>Certain messages can be excluded from verification by extending the marker <span class="group-scala">trait</span><span class="group-java">interface</span> <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/NoSerializationVerificationNeeded.html" title="org.apache.pekko.actor.NoSerializationVerificationNeeded"><code>actor.NoSerializationVerificationNeeded</code></a></span><span class="group-java"><a href="https://doc.akk [...]
-<p>If you want to verify that your <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> are serializable you can enable the following config option:</p>
+<p>Certain messages can be excluded from verification by extending the marker <span class="group-scala">trait</span><span class="group-java">interface</span> <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/NoSerializationVerificationNeeded.html" title="org.apache.pekko.actor.NoSerializationVerificationNeeded"><code>actor.NoSerializationVerificationNeeded</code></a></span><span class="group-java"><a href="https://doc.akk [...]
+<p>If you want to verify that your <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/Props.html" title="org.apache.pekko.actor.Props"><code>Props</code></a></span> are serializable you can enable the following config option:</p>
<pre class="prettyprint"><button class="snippet-button copy-snippet" title="Copy snippet to clipboard">copy</button><a class="snippet-button go-to-source" href="https://github.com/akka/akka/tree/main/docs/src/test/scala/docs/serialization/SerializationDocSpec.scala#L156-L160" target="_blank" title="Go to snippet source">source</a><code class="language-scala">pekko {
actor {
serialize-creators = on
@@ -1013,7 +1013,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/split-brain-resolver.html b/content/split-brain-resolver.html
index f0e8d40..9043f2e 100644
--- a/content/split-brain-resolver.html
+++ b/content/split-brain-resolver.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -420,7 +420,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>When operating an Pekko cluster you must consider how to handle <a href="https://en.wikipedia.org/wiki/Network_partition">network partitions</a> (a.k.a. split brain scenarios) and machine crashes (including JVM and hardware failures). This is crucial for correct behavior if you use <a href="typed/cluster-singleton.html">Cluster Singleton</a> or <a href="typed/cluster-sharding.html">Cluster Sharding</a>, especially together with Pekko Persistence.</p>
<p>The <a href="https://akka.io/blog/news/2020/06/08/akka-split-brain-resolver-video">Split Brain Resolver video</a> is a good starting point for learning why it is important to use a correct downing provider and how the Split Brain Resolver works.</p>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Pekko Split Brain Resolver is part of <code>pekko-cluster</code> and you probably already have that dependency included. Otherwise, add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Split Brain Resolver is part of <code>pekko-cluster</code> and you probably already have that dependency included. Otherwise, add the following dependency in your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -429,7 +429,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</cod
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -444,7 +444,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-cluster" % PekkoVersion</cod
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-cluster_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -452,7 +452,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Cluster (classic)</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-cluster</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -831,7 +831,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="lib/prettify/prettify.js"></script>
<script type="text/javascript" src="lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/actor-interop.html b/content/stream/actor-interop.html
index b801e7b..d17e0a0 100644
--- a/content/stream/actor-interop.html
+++ b/content/stream/actor-interop.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#actors-interop" name="actors-interop" class="anchor"><span class="anchor-link"></span></a>Actors interop</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Pekko Streams, add the module to your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Streams, add the module to your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream" % PekkoVersion</code
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream" % PekkoVersion</code
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -795,10 +795,10 @@ actorRef.tell(
<p>Sends the elements of the stream to the given <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span> with backpressure, to be able to signal demand when the actor is ready to receive more elements.</p><div class="callout note "><div class="callout-title">Note</div>
<p>See also: <a href="operators/ActorSink/actorRefWithBackpressure.html">ActorSink.actorRefWithBackpressure operator reference docs</a></p></div>
<h3><a href="#topic-source" name="topic-source" class="anchor"><span class="anchor-link"></span></a>Topic.source</h3>
-<p>A source that will subscribe to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span> and stream [...]
+<p>A source that will subscribe to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span> and stream [...]
<p>See also: <a href="operators/PubSub/source.html">ActorSink.actorRefWithBackpressure operator reference docs</a></p></div>
<h3><a href="#topic-sink" name="topic-sink" class="anchor"><span class="anchor-link"></span></a>Topic.sink</h3>
-<p>A sink that will publish emitted messages to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span [...]
+<p>A sink that will publish emitted messages to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span [...]
<p>See also: <a href="operators/PubSub/sink.html">ActorSink.actorRefWithBackpressure operator reference docs</a></p></div>
<div class="source-github">
The source code for this page can be found <a href="https://github.com/akka/akka/tree/main/docs/src/main/paradox/stream/actor-interop.md">here</a>.
@@ -885,7 +885,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/futures-interop.html b/content/stream/futures-interop.html
index 73b38f5..26d3b21 100644
--- a/content/stream/futures-interop.html
+++ b/content/stream/futures-interop.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,7 +418,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#futures-interop" name="futures-interop" class="anchor"><span class="anchor-link"></span></a>Futures interop</h1>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>To use Pekko Streams, add the module to your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Streams, add the module to your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -427,7 +427,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream" % PekkoVersion</code
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -442,7 +442,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream" % PekkoVersion</code
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream_${versions.ScalaBinary}"
}</code></pre></dd></dl>
@@ -939,7 +939,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/index.html b/content/stream/index.html
index fe9baae..f730353 100644
--- a/content/stream/index.html
+++ b/content/stream/index.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -417,7 +417,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="small-12 large-9 column" id="docs">
<h1><a href="#streams" name="streams" class="anchor"><span class="anchor-link"></span></a>Streams</h1>
<h2><a href="#module-info" name="module-info" class="anchor"><span class="anchor-link"></span></a>Module info</h2>
-<p>To use Pekko Streams, add the module to your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>To use Pekko Streams, add the module to your project:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies ++= Seq(
"org.apache.pekko" %% "pekko-stream" % PekkoVersion,
"org.apache.pekko" %% "pekko-stream-testkit" % PekkoVersion % Test
@@ -429,7 +429,7 @@ libraryDependencies ++= Seq(
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -449,7 +449,7 @@ libraryDependencies ++= Seq(
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream_${versions.ScalaBinary}"
testImplementation "org.apache.pekko:pekko-stream-testkit_${versions.ScalaBinary}"
@@ -458,7 +458,7 @@ dependencies {
<tr><th colspan="2">Project Info: Pekko Streams</th></tr>
<tr><th>Artifact</th><td><div>org.apache.pekko</div>
<div>pekko-stream</div>
- <div>0.0.0+26532-3d93c297-SNAPSHOT</div>
+ <div>0.0.0+26533-ec68a528-SNAPSHOT</div>
<div><a href="project/links.html#snapshots-repository">Snapshots are available</a></div>
</td></tr>
<tr><th>JDK versions</th><td><div>Adopt OpenJDK 8</div><div>Adopt OpenJDK 11</div></td></tr>
@@ -963,7 +963,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorFlow/ask.html b/content/stream/operators/ActorFlow/ask.html
index 6f7f055..8d87160 100644
--- a/content/stream/operators/ActorFlow/ask.html
+++ b/content/stream/operators/ActorFlow/ask.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Use the “Ask Pattern” to send each stream element as an <code>ask</code> to the target actor (of the new actors API), and expect a reply that will be emitted downstream.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,14 +445,14 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html#ask(org.apache.pekko.actor.typed.ActorRef,java.time.Duration,java.util.function.BiFunction)" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.ask</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/ActorFlow$.html#ask[I,Q [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html#ask(org.apache.pekko.actor.typed.ActorRef,java.time.Duration,java.util.function.BiFunction)" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.ask</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/ActorFlow$.html#ask[I,Q [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Use the <a href="../../../typed/interaction-patterns.html#request-response-with-ask-from-outside-an-actor">Ask pattern</a> to send a request-reply message to the target <code>ref</code> actor. If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a>< [...]
+<p>Use the <a href="../../../typed/interaction-patterns.html#request-response-with-ask-from-outside-an-actor">Ask pattern</a> to send a request-reply message to the target <code>ref</code> actor. If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a>< [...]
<p>The <code>ask</code> operator requires</p>
<ul>
<li>the actor <code>ref</code>,</li>
@@ -645,7 +645,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorFlow/askWithContext.html b/content/stream/operators/ActorFlow/askWithContext.html
index 90eaa90..061f80f 100644
--- a/content/stream/operators/ActorFlow/askWithContext.html
+++ b/content/stream/operators/ActorFlow/askWithContext.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Use the “Ask Pattern” to send each stream element (without the context) as an <code>ask</code> to the target actor (of the new actors API), and expect a reply that will be emitted downstream.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,15 +445,15 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html#askWithContext(org.apache.pekko.actor.typed.ActorRef,java.time.Duration,java.util.function.BiFunction)" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.askWithContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/A [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html#askWithContext(org.apache.pekko.actor.typed.ActorRef,java.time.Duration,java.util.function.BiFunction)" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.askWithContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/A [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Use the <a href="../../../typed/interaction-patterns.html#request-response-with-ask-from-outside-an-actor">Ask pattern</a> to send a request-reply message to the target <code>ref</code> actor. The stream context is not sent, instead it is locally recombined to the actor’s reply.</p>
-<p>If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutE [...]
+<p>If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutE [...]
<p>The <code>ask</code> operator requires</p>
<ul>
<li>the actor <code>ref</code>,</li>
@@ -553,7 +553,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorFlow/askWithStatus.html b/content/stream/operators/ActorFlow/askWithStatus.html
index c1dc6fe..e70439b 100644
--- a/content/stream/operators/ActorFlow/askWithStatus.html
+++ b/content/stream/operators/ActorFlow/askWithStatus.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,9 +421,9 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Use the “Ask Pattern” to send each stream element as an <code>ask</code> to the target actor (of the new actors API), and expect a reply of Type <span class="group-scala"><code>StatusReply[T]</code></span><span class="group-java"><code>StatusReply<T></code></span> where the T will be unwrapped and emitted downstream.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
- <pekko.version>0.0.0+26532-3d93c297-SNAPSHOT</pekko.version>
+ <pekko.version>0.0.0+26533-ec68a528-SNAPSHOT</pekko.version>
<scala.binary.version>2.13</scala.binary.version>
</properties>
<dependencies>
@@ -433,16 +433,16 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<version>${pekko.version}</version>
</dependency>
</dependencies></code></pre></dd><dt>Gradle</dt><dd><pre class="prettyprint"><code class="language-gradle">def versions = [
- PekkoVersion: "0.0.0+26532-3d93c297-SNAPSHOT",
+ PekkoVersion: "0.0.0+26533-ec68a528-SNAPSHOT",
ScalaBinary: "2.13"
]
dependencies {
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}:${versions.PekkoVersion}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.askWithStatus</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.scaladsl.ActorFlow"><code>ActorFlow.askWithStatus</ [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.askWithStatus</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.scaladsl.ActorFlow"><code>ActorFlow.askWithStatus</ [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Use the <a href="../../../typed/interaction-patterns.html#request-response-with-ask-from-outside-an-actor">Ask pattern</a> to send a request-reply message to the target <code>ref</code> actor when you expect the reply to be <code>org.apache.pekko.pattern.StatusReply</code>. If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="o [...]
+<p>Use the <a href="../../../typed/interaction-patterns.html#request-response-with-ask-from-outside-an-actor">Ask pattern</a> to send a request-reply message to the target <code>ref</code> actor when you expect the reply to be <code>org.apache.pekko.pattern.StatusReply</code>. If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="o [...]
<p>The <code>askWithStatus</code> operator requires</p>
<ul>
<li>the actor <code>ref</code>,</li>
@@ -631,7 +631,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorFlow/askWithStatusAndContext.html b/content/stream/operators/ActorFlow/askWithStatusAndContext.html
index a44e3fa..abd204b 100644
--- a/content/stream/operators/ActorFlow/askWithStatusAndContext.html
+++ b/content/stream/operators/ActorFlow/askWithStatusAndContext.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Use the “Ask Pattern” to send each stream element (without the context) as an <code>ask</code> to the target actor (of the new actors API), and expect a reply of Type <span class="group-scala"><code>StatusReply[T]</code></span><span class="group-java"><code>StatusReply<T></code></span> where the T will be unwrapped and emitted downstream.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,15 +445,15 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.askWithStatusAndContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.scaladsl.ActorFlow"><code>ActorFlow.askWi [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.javadsl.ActorFlow"><code>ActorFlow.askWithStatusAndContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/ActorFlow$.html" title="org.apache.pekko.stream.typed.scaladsl.ActorFlow"><code>ActorFlow.askWi [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Use the <a href="../../../typed/interaction-patterns.html#request-response-with-ask-from-outside-an-actor">Ask pattern</a> to send a request-reply message to the target <code>ref</code> actor when you expect the reply to be <code>org.apache.pekko.pattern.StatusReply</code>. The stream context is not sent, instead it is locally recombined to the actor’s reply.</p>
-<p>If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutE [...]
+<p>If any of the asks times out it will fail the stream with an <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutException"><code>AskTimeoutException</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/AskTimeoutException.html" title="org.apache.pekko.pattern.AskTimeoutE [...]
<p>The <code>ask</code> operator requires</p>
<ul>
<li>the actor <code>ref</code>,</li>
@@ -553,7 +553,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorSink/actorRef.html b/content/stream/operators/ActorSink/actorRef.html
index d23268d..91860f0 100644
--- a/content/stream/operators/ActorSink/actorRef.html
+++ b/content/stream/operators/ActorSink/actorRef.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Sends the elements of the stream to the given <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span> of the new actors API, without considering backpressure.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,12 +445,12 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSink$.html#actorRef(org.apache.pekko.actor.typed.ActorRef,java.lang.Object,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.typed.javadsl.ActorSink"><code>ActorSink.actorRef</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/Actor [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSink$.html#actorRef(org.apache.pekko.actor.typed.ActorRef,java.lang.Object,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.typed.javadsl.ActorSink"><code>ActorSink.actorRef</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/Actor [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Sends the elements of the stream to the given <code>ActorRef</code>. If the target actor terminates the stream will be canceled. When the stream completes successfully the given <code>onCompleteMessage</code> will be sent to the destination actor. When the stream completes with failure the throwable that was signaled to the stream is adapted to the Actor’s protocol using <code>onFailureMessage</code> and then sent to the destination actor.</p>
<p>It will request at most <code>maxInputBufferSize</code> number of elements from upstream, but there is no back-pressure signal from the destination actor, i.e. if the actor is not consuming the messages fast enough the mailbox of the actor will grow. For potentially slow consumer actors it is recommended to use a bounded mailbox with zero <code>mailbox-push-timeout-time</code> or use a rate limiting operator in front of this <code>Sink</code>.</p>
@@ -550,7 +550,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorSink/actorRefWithBackpressure.html b/content/stream/operators/ActorSink/actorRefWithBackpressure.html
index adddb16..cdaf6cf 100644
--- a/content/stream/operators/ActorSink/actorRefWithBackpressure.html
+++ b/content/stream/operators/ActorSink/actorRefWithBackpressure.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Sends the elements of the stream to the given <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span> of the new actors API with backpressure, to be able to signal demand when the actor is ready to receive more elements.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,12 +445,12 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSink$.html#actorRefWithBackpressure(org.apache.pekko.actor.typed.ActorRef,org.apache.pekko.japi.function.Function2,org.apache.pekko.japi.function.Function,java.lang.Object,java.lang.Object,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.typed.javadsl.ActorSink"><code>ActorSink.actorRefWithBackpressure</code></a></span><span cl [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSink$.html#actorRefWithBackpressure(org.apache.pekko.actor.typed.ActorRef,org.apache.pekko.japi.function.Function2,org.apache.pekko.japi.function.Function,java.lang.Object,java.lang.Object,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.typed.javadsl.ActorSink"><code>ActorSink.actorRefWithBackpressure</code></a></span><span cl [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Sends the elements of the stream to the given <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span> with backpressure, to be able to signal demand when the actor is ready to receive more elements. There is also a variant without a concrete acknowledge message accepting any message as such.</p>
<p>See also:</p>
@@ -637,7 +637,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorSource/actorRef.html b/content/stream/operators/ActorSource/actorRef.html
index ded13f8..38c6539 100644
--- a/content/stream/operators/ActorSource/actorRef.html
+++ b/content/stream/operators/ActorSource/actorRef.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materialize an <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span> of the new actors API; sending messages to it will emit them on the stream only if they are of the same type as the stream.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,12 +445,12 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSource$.html#actorRef(java.util.function.Predicate,org.apache.pekko.japi.function.Function,int,org.apache.pekko.stream.OverflowStrategy)" title="org.apache.pekko.stream.typed.javadsl.ActorSource"><code>ActorSource.actorRef</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/st [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSource$.html#actorRef(java.util.function.Predicate,org.apache.pekko.japi.function.Function,int,org.apache.pekko.stream.OverflowStrategy)" title="org.apache.pekko.stream.typed.javadsl.ActorSource"><code>ActorSource.actorRef</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/st [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materialize an <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span> which only accepts messages that are of the same type as the stream.</p>
<p>See also:</p>
@@ -635,7 +635,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/ActorSource/actorRefWithBackpressure.html b/content/stream/operators/ActorSource/actorRefWithBackpressure.html
index 6f438b7..068feac 100644
--- a/content/stream/operators/ActorSource/actorRefWithBackpressure.html
+++ b/content/stream/operators/ActorSource/actorRefWithBackpressure.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materialize an <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span> of the new actors API; sending messages to it will emit them on the stream. The source acknowledges reception after emitting a message, to provide back pressure from the source.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -430,7 +430,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -445,12 +445,12 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSource$.html#actorRefWithBackpressure(org.apache.pekko.actor.typed.ActorRef,java.lang.Object,org.apache.pekko.japi.function.Function,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.typed.javadsl.ActorSource"><code>ActorSource.actorRefWithBackpressure</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/a [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/ActorSource$.html#actorRefWithBackpressure(org.apache.pekko.actor.typed.ActorRef,java.lang.Object,org.apache.pekko.japi.function.Function,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.typed.javadsl.ActorSource"><code>ActorSource.actorRefWithBackpressure</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/a [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materialize an <span class="group-java"><code>ActorRef<T></code></span><span class="group-scala"><code>ActorRef[T]</code></span>, sending messages to it will emit them on the stream. The actor responds with the provided ack message once the element could be emitted allowing for backpressure from the source. Sending another message before the previous one has been acknowledged will fail the stream.</p>
<p>See also:</p>
@@ -737,7 +737,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Balance.html b/content/stream/operators/Balance.html
index 80680b3..3b5e950 100644
--- a/content/stream/operators/Balance.html
+++ b/content/stream/operators/Balance.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -512,7 +512,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Broadcast.html b/content/stream/operators/Broadcast.html
index f6c837a..16b9e60 100644
--- a/content/stream/operators/Broadcast.html
+++ b/content/stream/operators/Broadcast.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Emit each incoming element each of <code>n</code> outputs.</p>
<p><a href="index.html#fan-out-operators">Fan-out operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Broadcast.html" title="org.apache.pekko.stream.javadsl.Broadcast"><code>Broadcast</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Broadcast.html" title="org.apache.pekko.stream.scaladsl.Broadcast"><code>Broadcast</code></a></span></p>
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Broadcast.html" title="org.apache.pekko.stream.javadsl.Broadcast"><code>Broadcast</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Broadcast.html" title="org.apache.pekko.stream.scaladsl.Broadcast"><code>Broadcast</code></a></span></p>
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Emit each incoming element each of <code>n</code> outputs.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -626,7 +626,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Compression/deflate.html b/content/stream/operators/Compression/deflate.html
index 8b7a26b..0c79f10 100644
--- a/content/stream/operators/Compression/deflate.html
+++ b/content/stream/operators/Compression/deflate.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,9 +421,9 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Creates a flow that deflate-compresses a stream of ByteStrings. </p>
<p><a href="../index.html#compression-operators">Compression operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#deflate()" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.deflate</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#deflate:org.apache.pekko.stream.scaladsl.Flow[org.apache.pekko.util.ByteString,org.apache.pekko [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#deflate()" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.deflate</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#deflate:org.apache.pekko.stream.scaladsl.Flow[org.apache.pekko.util.ByteString,org.apache.pekko [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Creates a flow that deflate-compresses a stream of ByteStrings. Note that the compressor will SYNC_FLUSH after every <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.Byt [...]
+<p>Creates a flow that deflate-compresses a stream of ByteStrings. Note that the compressor will SYNC_FLUSH after every <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.Byt [...]
<p>Use the overload method with parameters to control the compression level and compatibility with GZip. </p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
<p><strong>emits</strong> when the compression algorithm produces output for the received <code>ByteString</code></p>
@@ -515,7 +515,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Compression/gunzip.html b/content/stream/operators/Compression/gunzip.html
index 2deaac4..1117eb1 100644
--- a/content/stream/operators/Compression/gunzip.html
+++ b/content/stream/operators/Compression/gunzip.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Creates a flow that gzip-decompresses a stream of ByteStrings. </p>
<p><a href="../index.html#compression-operators">Compression operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#gunzip(int)" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.gunzip</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#gunzip(maxBytesPerChunk:Int):org.apache.pekko.stream.scaladsl.Flow[org.apache.pekko.util.ByteS [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#gunzip(int)" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.gunzip</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#gunzip(maxBytesPerChunk:Int):org.apache.pekko.stream.scaladsl.Flow[org.apache.pekko.util.ByteS [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Creates a flow that gzip-decompresses a stream of ByteStrings. If the input is truncated, uses invalid compression method or is invalid (failed CRC checks) this operator fails with a <code>java.util.zip.ZipException</code>. </p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
@@ -514,7 +514,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Compression/gzip.html b/content/stream/operators/Compression/gzip.html
index fb9e6cf..871da7f 100644
--- a/content/stream/operators/Compression/gzip.html
+++ b/content/stream/operators/Compression/gzip.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,9 +421,9 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Creates a flow that gzip-compresses a stream of ByteStrings. </p>
<p><a href="../index.html#compression-operators">Compression operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#gzip()" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.gzip</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#gzip:org.apache.pekko.stream.scaladsl.Flow[org.apache.pekko.util.ByteString,org.apache.pekko.util.Byt [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#gzip()" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.gzip</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#gzip:org.apache.pekko.stream.scaladsl.Flow[org.apache.pekko.util.ByteString,org.apache.pekko.util.Byt [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Creates a flow that gzip-compresses a stream of ByteStrings. Note that the compressor will SYNC_FLUSH after every <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteSt [...]
+<p>Creates a flow that gzip-compresses a stream of ByteStrings. Note that the compressor will SYNC_FLUSH after every <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteString"><code>ByteString</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/util/ByteString.html" title="org.apache.pekko.util.ByteSt [...]
<p>Use the overload method to control the compression level.</p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
<p><strong>emits</strong> when the compression algorithm produces output for the received <code>ByteString</code></p>
@@ -515,7 +515,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Compression/inflate.html b/content/stream/operators/Compression/inflate.html
index 17187d0..dfc7347 100644
--- a/content/stream/operators/Compression/inflate.html
+++ b/content/stream/operators/Compression/inflate.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Creates a flow that deflate-decompresses a stream of ByteStrings. </p>
<p><a href="../index.html#compression-operators">Compression operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#inflate(int,boolean)" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.indeflate</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#inflate(maxBytesPerChunk:Int,nowrap:Boolean):org.apache.pekko.stream.scaladsl.Flow [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Compression$.html#inflate(int,boolean)" title="org.apache.pekko.stream.javadsl.Compression"><code>Compression.indeflate</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Compression$.html#inflate(maxBytesPerChunk:Int,nowrap:Boolean):org.apache.pekko.stream.scaladsl.Flow [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Creates a flow that deflate-decompresses a stream of ByteStrings.</p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
@@ -514,7 +514,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/FileIO/fromFile.html b/content/stream/operators/FileIO/fromFile.html
index e68be57..6bd70ad 100644
--- a/content/stream/operators/FileIO/fromFile.html
+++ b/content/stream/operators/FileIO/fromFile.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -422,7 +422,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p><a href="../index.html#file-io-sinks-and-sources">File IO Sinks and Sources</a></p><div class="callout warning "><div class="callout-title">Warning</div>
<p>The <code>fromFile</code> operator has been deprecated, use <a href="fromPath.html">fromPath</a> instead. </p></div>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#fromFile(java.io.File)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.fromFile</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#fromFile(f:java.io.File,chunkSize:Int):org.apache.pekko.stream.scaladsl.Source[org.apache.pekko.util. [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#fromFile(java.io.File)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.fromFile</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#fromFile(f:java.io.File,chunkSize:Int):org.apache.pekko.stream.scaladsl.Source[org.apache.pekko.util. [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Emits the contents of a file, as <code>ByteString</code>s, materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> which will be completed with a <code>IOResult</code> upon reaching the end of the file or if there is a failure.</p>
<div class="source-github">
@@ -510,7 +510,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/FileIO/fromPath.html b/content/stream/operators/FileIO/fromPath.html
index 262b819..119bed8 100644
--- a/content/stream/operators/FileIO/fromPath.html
+++ b/content/stream/operators/FileIO/fromPath.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Emits the contents of a file from the given path.</p>
<p><a href="../index.html#file-io-sinks-and-sources">File IO Sinks and Sources</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#fromPath(java.nio.file.Path,int,long)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.fromPath</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#fromPath(f:java.nio.file.Path,chunkSize:Int,startPosition:Long):org.apache.pekko.strea [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#fromPath(java.nio.file.Path,int,long)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.fromPath</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#fromPath(f:java.nio.file.Path,chunkSize:Int,startPosition:Long):org.apache.pekko.strea [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Emits the contents of a file from the given path, as <code>ByteString</code>s, materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> which will be completed with a <code>IOResult</code> upon reaching the end of the file or if there is a failure.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -526,7 +526,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/FileIO/toFile.html b/content/stream/operators/FileIO/toFile.html
index ba3fa1c..3e5d33a 100644
--- a/content/stream/operators/FileIO/toFile.html
+++ b/content/stream/operators/FileIO/toFile.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -422,7 +422,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p><a href="../index.html#file-io-sinks-and-sources">File IO Sinks and Sources</a></p><div class="callout warning "><div class="callout-title">Warning</div>
<p>The <code>toFile</code> operator has been deprecated, use <a href="toPath.html">toPath</a> instead. </p></div>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#toFile(java.io.File,java.util.Set)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.toFile</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#toFile(f:java.io.File,options:Set[java.nio.file.OpenOption]):org.apache.pekko.stream.scalad [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#toFile(java.io.File,java.util.Set)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.toFile</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#toFile(f:java.io.File,options:Set[java.nio.file.OpenOption]):org.apache.pekko.stream.scalad [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Creates a Sink which writes incoming <code>ByteString</code> elements to the given file path. Overwrites existing files by truncating their contents as default. Materializes a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> of <code>IOResult</code> that will be completed with the size of the file (in bytes) at the streams completion, and a possible exception if IO operation was not completed successfully.</p>
<div class="source-github">
@@ -510,7 +510,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/FileIO/toPath.html b/content/stream/operators/FileIO/toPath.html
index 3600701..2d4e8c6 100644
--- a/content/stream/operators/FileIO/toPath.html
+++ b/content/stream/operators/FileIO/toPath.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Create a sink which will write incoming <code>ByteString</code> s to a given file path.</p>
<p><a href="../index.html#file-io-sinks-and-sources">File IO Sinks and Sources</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#toPath(java.nio.file.Path,java.util.Set,long)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.toPath</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#toPath(f:java.nio.file.Path,options:Set[java.nio.file.OpenOption],startPosition: [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/FileIO$.html#toPath(java.nio.file.Path,java.util.Set,long)" title="org.apache.pekko.stream.javadsl.FileIO"><code>FileIO.toPath</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/FileIO$.html#toPath(f:java.nio.file.Path,options:Set[java.nio.file.OpenOption],startPosition: [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Creates a Sink which writes incoming <code>ByteString</code> elements to the given file path. Overwrites existing files by truncating their contents as default. Materializes a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> of <code>IOResult</code> that will be completed with the size of the file (in bytes) at the streams completion, and a possible exception if IO operation was not completed successfully.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -526,7 +526,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/asFlowWithContext.html b/content/stream/operators/Flow/asFlowWithContext.html
index be4a9aa..a13ea45 100644
--- a/content/stream/operators/Flow/asFlowWithContext.html
+++ b/content/stream/operators/Flow/asFlowWithContext.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,10 +421,10 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Extracts context data from the elements of a <code>Flow</code> so that it can be turned into a <code>FlowWithContext</code> which can propagate that context per element along a stream.</p>
<p><a href="../index.html#simple-operators">Simple operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html#asFlowWithContext(org.apache.pekko.japi.function.Function2,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.asFlowWithContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html#asFlowWithContext[U,CtxU, [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html#asFlowWithContext(org.apache.pekko.japi.function.Function2,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.asFlowWithContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html#asFlowWithContext[U,CtxU, [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>See <a href="../../stream-context.html">Context Propagation</a> for a general overview of context propagation.</p>
-<p>Extracts context data from the elements of a <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> so that it can be turn [...]
+<p>Extracts context data from the elements of a <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> so that it can be turn [...]
<p>See also:</p>
<ul>
<li><a href="../../stream-context.html">Context Propagation</a></li>
@@ -595,7 +595,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/completionStageFlow.html b/content/stream/operators/Flow/completionStageFlow.html
index 2397efd..cc797f2 100644
--- a/content/stream/operators/Flow/completionStageFlow.html
+++ b/content/stream/operators/Flow/completionStageFlow.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Streams the elements through the given future flow once it successfully completes.</p>
<p><a href="../index.html#simple-operators">Simple operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#completionStageFlow(java.util.concurrent.CompletionStage)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.completionStageFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow.compl [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#completionStageFlow(java.util.concurrent.CompletionStage)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.completionStageFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow.compl [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Streams the elements through the given flow once the <code>CompletionStage</code> successfully completes. If the future fails the stream fails.</p>
<h2><a href="#examples" name="examples" class="anchor"><span class="anchor-link"></span></a>Examples</h2>
@@ -539,7 +539,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/flattenOptional.html b/content/stream/operators/Flow/flattenOptional.html
index 7d7405a..cd018d9 100644
--- a/content/stream/operators/Flow/flattenOptional.html
+++ b/content/stream/operators/Flow/flattenOptional.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Collect the value of <code>Optional</code> from all the elements passing through this flow , empty <code>Optional</code> is filtered out.</p>
<p><a href="../index.html#simple-operators">Simple operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#flattenOptional(org.apache.pekko.stream.javadsl.Flow)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.flattenOptional</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow.flattenOption [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#flattenOptional(org.apache.pekko.stream.javadsl.Flow)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.flattenOptional</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow.flattenOption [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Streams the elements through the given future flow once it successfully completes. If the future fails the stream is failed.</p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
@@ -515,7 +515,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/fromSinkAndSource.html b/content/stream/operators/Flow/fromSinkAndSource.html
index 52d7131..8a69572 100644
--- a/content/stream/operators/Flow/fromSinkAndSource.html
+++ b/content/stream/operators/Flow/fromSinkAndSource.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Creates a <code>Flow</code> from a <code>Sink</code> and a <code>Source</code> where the Flow’s input will be sent to the <code>Sink</code> and the <code>Flow</code> ’s output will come from the Source.</p>
<p><a href="../index.html#flow-operators-composed-of-sinks-and-sources">Flow operators composed of Sinks and Sources</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#fromSinkAndSource(org.apache.pekko.stream.Graph,org.apache.pekko.stream.Graph)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.fromSinkAndSource</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#fromSinkAndSource[I,O](sink:org.apache.pekko [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#fromSinkAndSource(org.apache.pekko.stream.Graph,org.apache.pekko.stream.Graph)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.fromSinkAndSource</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#fromSinkAndSource[I,O](sink:org.apache.pekko [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<img src="../../../images/fromSinkAndSource.png" alt="Diagram" width="350"/>
<p><code>fromSinkAndSource</code> combines a separate <code>Sink</code> and <code>Source</code> into a <code>Flow</code>.</p>
@@ -471,7 +471,7 @@ connectionStream.runForeach(
incomingConnection -> incomingConnection.handleWith(serverFlow, system), system);</code></pre></dd>
</dl>
<p>With this server running you could use <code>telnet 127.0.0.1 9999</code> to see a stream of timestamps being printed, one every second. </p>
-<p>The following sample is a little bit more advanced and uses the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/MergeHub$.html" title="org.apache.pekko.stream.javadsl.MergeHub"><code>MergeHub</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/MergeHub$.html" title="org.apache.pekko.stream.scaladsl.MergeHub"><code>Merg [...]
+<p>The following sample is a little bit more advanced and uses the <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/MergeHub$.html" title="org.apache.pekko.stream.javadsl.MergeHub"><code>MergeHub</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/MergeHub$.html" title="org.apache.pekko.stream.scaladsl.MergeHub"><code>Merg [...]
<dl>
<dt>Scala</dt>
<dd>
@@ -629,7 +629,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/fromSinkAndSourceCoupled.html b/content/stream/operators/Flow/fromSinkAndSourceCoupled.html
index 84be658..959274b 100644
--- a/content/stream/operators/Flow/fromSinkAndSourceCoupled.html
+++ b/content/stream/operators/Flow/fromSinkAndSourceCoupled.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Allows coupling termination (cancellation, completion, erroring) of Sinks and Sources while creating a Flow between them.</p>
<p><a href="../index.html#flow-operators-composed-of-sinks-and-sources">Flow operators composed of Sinks and Sources</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#fromSinkAndSourceCoupled(org.apache.pekko.stream.Graph,org.apache.pekko.stream.Graph)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.fromSinkAndSourceCoupled</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#fromSinkAndSourceCoupled[I,O]( [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#fromSinkAndSourceCoupled(org.apache.pekko.stream.Graph,org.apache.pekko.stream.Graph)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.fromSinkAndSourceCoupled</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#fromSinkAndSourceCoupled[I,O]( [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>See <a href="fromSinkAndSource.html">Flow.fromSinkAndSource</a> for docs on the general workings and examples.</p>
<p>This operator only adds coupled termination to what <code>fromSinkAndSource</code> does: If the emitted <code>Flow</code> gets a cancellation, the <code>Source</code> is cancelled, however the Sink will also be completed. The table below illustrates the effects in detail:</p>
@@ -552,7 +552,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/futureFlow.html b/content/stream/operators/Flow/futureFlow.html
index 47ec68e..fb9bfec 100644
--- a/content/stream/operators/Flow/futureFlow.html
+++ b/content/stream/operators/Flow/futureFlow.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Streams the elements through the given future flow once it successfully completes.</p>
<p><a href="../index.html#simple-operators">Simple operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.futureFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#futureFlow[I,O,M](flow:scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Flow[I,O,M]]):org.apache.pekko.stream.scaladsl.Flo [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.futureFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#futureFlow[I,O,M](flow:scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Flow[I,O,M]]):org.apache.pekko.stream.scaladsl.Flo [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Streams the elements through the given future flow once it successfully completes. If the future fails the stream is failed.</p>
<h2><a href="#examples" name="examples" class="anchor"><span class="anchor-link"></span></a>Examples</h2>
@@ -534,7 +534,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/lazyCompletionStageFlow.html b/content/stream/operators/Flow/lazyCompletionStageFlow.html
index 9ba5f22..9dab73f 100644
--- a/content/stream/operators/Flow/lazyCompletionStageFlow.html
+++ b/content/stream/operators/Flow/lazyCompletionStageFlow.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -515,7 +515,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/lazyFlow.html b/content/stream/operators/Flow/lazyFlow.html
index 61c39cb..3fbdb2f 100644
--- a/content/stream/operators/Flow/lazyFlow.html
+++ b/content/stream/operators/Flow/lazyFlow.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Defers creation and materialization of a <code>Flow</code> until there is a first element.</p>
<p><a href="../index.html#simple-operators">Simple operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#lazyFlow(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyFlow[I,O,M](create:()=>org.apache.pekko.stream.scaladsl.Flow[I,O,M]):org.apa [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#lazyFlow(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyFlow[I,O,M](create:()=>org.apache.pekko.stream.scaladsl.Flow[I,O,M]):org.apa [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Defers <code>Flow</code> creation and materialization until when the first element arrives at the <code>lazyFlow</code> from upstream. After that the stream behaves as if the nested flow replaced the <code>lazyFlow</code>. The nested <code>Flow</code> will not be created if the outer flow completes or fails before any elements arrive.</p>
<p>Note that asynchronous boundaries and many other operators in the stream may do pre-fetching or trigger demand and thereby making an early element come throught the stream leading to creation of the inner flow earlier than you would expect.</p>
@@ -635,7 +635,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/lazyFutureFlow.html b/content/stream/operators/Flow/lazyFutureFlow.html
index 2084294..d91360f 100644
--- a/content/stream/operators/Flow/lazyFutureFlow.html
+++ b/content/stream/operators/Flow/lazyFutureFlow.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Defers creation and materialization of a <code>Flow</code> until there is a first element.</p>
<p><a href="../index.html#simple-operators">Simple operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyFutureFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyFutureFlow[I,O,M](create:()=>scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Flow[I,O,M]]):org.apache.pekko.st [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyFutureFlow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyFutureFlow[I,O,M](create:()=>scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Flow[I,O,M]]):org.apache.pekko.st [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>When the first element comes from upstream the actual <code>Future[Flow]</code> is created and when that completes it is materialized and inserted in the stream. The internal <code>Flow</code> will not be created if there are no elements on completion or failure of up or downstream.</p>
<p>The materialized value of the <code>Flow</code> will be the materialized value of the created internal flow if it is materialized and failed with a <code>org.apache.pekko.stream.NeverMaterializedException</code> if the stream fails or completes without the flow being materialized.</p>
@@ -519,7 +519,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Flow/lazyInitAsync.html b/content/stream/operators/Flow/lazyInitAsync.html
index 664c5c3..385b8cd 100644
--- a/content/stream/operators/Flow/lazyInitAsync.html
+++ b/content/stream/operators/Flow/lazyInitAsync.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Deprecated by <a href="lazyFutureFlow.html"><code>Flow.lazyFutureFlow</code></a> in combination with <a href="../Source-or-Flow/prefixAndTail.html"><code>prefixAndTail</code></a>.</p>
<p><a href="../index.html#simple-operators">Simple operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#lazyInitAsync(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyInitAsync</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyInitAsync[I,O,M](flowFactory:()=>scala.concurrent.Future[org.apach [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#lazyInitAsync(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyInitAsync</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyInitAsync[I,O,M](flowFactory:()=>scala.concurrent.Future[org.apach [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p><code>fromCompletionStage</code> has been deprecated in 2.6.0 use <a href="lazyFutureFlow.html">lazyFutureFlow</a> in combination with <a href="../Source-or-Flow/prefixAndTail.html"><code>prefixAndTail</code></a>) instead.</p>
<p>Defers creation until a first element arrives.</p>
@@ -517,7 +517,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/MergeSequence.html b/content/stream/operators/MergeSequence.html
index d629d26..1fbaea0 100644
--- a/content/stream/operators/MergeSequence.html
+++ b/content/stream/operators/MergeSequence.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Merge a linear sequence partitioned across multiple sources.</p>
<p><a href="index.html#fan-in-operators">Fan-in operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/MergeSequence.html" title="org.apache.pekko.stream.javadsl.MergeSequence"><code>MergeSequence</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/MergeSequence.html" title="org.apache.pekko.stream.scaladsl.MergeSequence"><code>MergeSequence</code></a></span></p>
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/MergeSequence.html" title="org.apache.pekko.stream.javadsl.MergeSequence"><code>MergeSequence</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/MergeSequence.html" title="org.apache.pekko.stream.scaladsl.MergeSequence"><code>MergeSequence</code></a></span></p>
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Merge a linear sequence partitioned across multiple sources. Each element from upstream must have a defined index, starting from 0. There must be no gaps in the sequence, nor may there be any duplicates. Each upstream source must be ordered by the sequence.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -605,7 +605,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Partition.html b/content/stream/operators/Partition.html
index 43a533c..76a902b 100644
--- a/content/stream/operators/Partition.html
+++ b/content/stream/operators/Partition.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Fan-out the stream to several streams.</p>
<p><a href="index.html#fan-out-operators">Fan-out operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Partition.html" title="org.apache.pekko.stream.javadsl.Partition"><code>Partition</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Partition.html" title="org.apache.pekko.stream.scaladsl.Partition"><code>Partition</code></a></span></p>
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Partition.html" title="org.apache.pekko.stream.javadsl.Partition"><code>Partition</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Partition.html" title="org.apache.pekko.stream.scaladsl.Partition"><code>Partition</code></a></span></p>
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Fan-out the stream to several streams. Each upstream element is emitted to one downstream consumer according to the partitioner function applied to the element.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -592,7 +592,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/PubSub/sink.html b/content/stream/operators/PubSub/sink.html
index 9dd9e33..bf2cd3e 100644
--- a/content/stream/operators/PubSub/sink.html
+++ b/content/stream/operators/PubSub/sink.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,12 +418,12 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#pubsub-sink" name="pubsub-sink" class="anchor"><span class="anchor-link"></span></a>PubSub.sink</h1>
-<p>A sink that will publish emitted messages to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span>.</p>
+<p>A sink that will publish emitted messages to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span>.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<p>Note that there is no backpressure from the topic, so care must be taken to not publish messages at a higher rate than that can be handled by subscribers.</p>
<p>If the topic does not have any subscribers when a message is published, or the topic actor is stopped, the message is sent to dead letters.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -432,7 +432,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -447,12 +447,12 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/PubSub$.html#sink(org.apache.pekko.actor.typed.Topic)" title="org.apache.pekko.stream.typed.javadsl.PubSub"><code>PubSub.sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/PubSub$.html#sink[T](topic:org.apache.pekko.actor.typed.Toppic[T]):org.apache.pekk [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/PubSub$.html#sink(org.apache.pekko.actor.typed.Topic)" title="org.apache.pekko.stream.typed.javadsl.PubSub"><code>PubSub.sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/PubSub$.html#sink[T](topic:org.apache.pekko.actor.typed.Toppic[T]):org.apache.pekk [...]
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
<p><strong>cancels</strong> never</p>
<p><strong>backpressures</strong> never</p></div>
@@ -542,7 +542,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/PubSub/source.html b/content/stream/operators/PubSub/source.html
index 8510e87..ba3123a 100644
--- a/content/stream/operators/PubSub/source.html
+++ b/content/stream/operators/PubSub/source.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,12 +418,12 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#pubsub-source" name="pubsub-source" class="anchor"><span class="anchor-link"></span></a>PubSub.source</h1>
-<p>A source that will subscribe to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span> and stream [...]
+<p>A source that will subscribe to a <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/actor/typed/pubsub/Topic$.html" title="org.apache.pekko.actor.typed.pubsub.Topic"><code>Topic</code></a></span> and stream [...]
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<p>The source can be materialized multiple times, each materialized stream will stream messages published to the topic after the stream has started.</p>
<p>Note that it is not possible to propagate the backpressure from the running stream to the pub sub topic, if the stream is backpressuring published messages are buffered up to a limit and if the limit is hit the configurable <code>OverflowStrategy</code> decides what happens. It is not possible to use the <code>Backpressure</code> strategy.</p>
<h2><a href="#dependency" name="dependency" class="anchor"><span class="anchor-link"></span></a>Dependency</h2>
-<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26532-3d93c297-SNAPSHOT"
+<p>This operator is included in:</p><dl class="dependency"><dt>sbt</dt><dd><pre class="prettyprint"><code class="language-scala">val PekkoVersion = "0.0.0+26533-ec68a528-SNAPSHOT"
libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion</code></pre></dd><dt>Maven</dt><dd><pre class="prettyprint"><code class="language-xml"><properties>
<scala.binary.version>2.13</scala.binary.version>
</properties>
@@ -432,7 +432,7 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
<dependency>
<groupId>org.apache.pekko</groupId>
<artifactId>pekko-bom_${scala.binary.version}</artifactId>
- <version>0.0.0+26532-3d93c297-SNAPSHOT</version>
+ <version>0.0.0+26533-ec68a528-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
@@ -447,12 +447,12 @@ libraryDependencies += "org.apache.pekko" %% "pekko-stream-typed" % PekkoVersion
ScalaBinary: "2.13"
]
dependencies {
- implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26532-3d93c297-SNAPSHOT")
+ implementation platform("org.apache.pekko:pekko-bom_${versions.ScalaBinary}:0.0.0+26533-ec68a528-SNAPSHOT")
implementation "org.apache.pekko:pekko-stream-typed_${versions.ScalaBinary}"
}</code></pre></dd></dl>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/PubSub$.html#source(org.apache.pekko.actor.typed.Topic)" title="org.apache.pekko.stream.typed.javadsl.PubSub"><code>PubSub.source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/PubSub$.html#source[T](topic:org.apache.pekko.actor.typed.Topic[T]):org.apache [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/javadsl/PubSub$.html#source(org.apache.pekko.actor.typed.Topic)" title="org.apache.pekko.stream.typed.javadsl.PubSub"><code>PubSub.source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/typed/scaladsl/PubSub$.html#source[T](topic:org.apache.pekko.actor.typed.Topic[T]):org.apache [...]
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
<p><strong>emits</strong> a message published to the topic is emitted as soon as there is demand from downstream</p>
<p><strong>completes</strong> when the topic actor terminates </p></div>
@@ -542,7 +542,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/RestartFlow/onFailuresWithBackoff.html b/content/stream/operators/RestartFlow/onFailuresWithBackoff.html
index 0e27a81..c6c0d55 100644
--- a/content/stream/operators/RestartFlow/onFailuresWithBackoff.html
+++ b/content/stream/operators/RestartFlow/onFailuresWithBackoff.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,15 +418,15 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#restartflow-onfailureswithbackoff" name="restartflow-onfailureswithbackoff" class="anchor"><span class="anchor-link"></span></a>RestartFlow.onFailuresWithBackoff</h1>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
<p><a href="../index.html#error-handling">Error handling</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartFlow$.html#onFailuresWithBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartFlow"><code>RestartFlow.onFailuresWithBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Restart [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartFlow$.html#onFailuresWithBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartFlow"><code>RestartFlow.onFailuresWithBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Restart [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
-<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> will not emit any failure as long as maxRestarts is not reache [...]
-<p>The restart process is inherently lossy, since there is no coordination between cancelling and the sending of messages. A termination signal from either end of the wrapped <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pek [...]
-<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
+<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> will not emit any failure as long as maxRestarts is not reache [...]
+<p>The restart process is inherently lossy, since there is no coordination between cancelling and the sending of messages. A termination signal from either end of the wrapped <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pek [...]
+<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
<p>See also: </p>
<ul>
<li><a href="../RestartSource/withBackoff.html">RestartSource.withBackoff</a></li>
@@ -524,7 +524,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/RestartFlow/withBackoff.html b/content/stream/operators/RestartFlow/withBackoff.html
index b89f7bc..0058ba8 100644
--- a/content/stream/operators/RestartFlow/withBackoff.html
+++ b/content/stream/operators/RestartFlow/withBackoff.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,15 +418,15 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#restartflow-withbackoff" name="restartflow-withbackoff" class="anchor"><span class="anchor-link"></span></a>RestartFlow.withBackoff</h1>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
<p><a href="../index.html#error-handling">Error handling</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartFlow$.html#withBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartFlow"><code>RestartFlow.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/RestartFlow$.html#withBacko [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartFlow$.html#withBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartFlow"><code>RestartFlow.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/RestartFlow$.html#withBacko [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
-<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> will not cancel, complete or emit a failure, until the opposit [...]
-<p>The restart process is inherently lossy, since there is no coordination between cancelling and the sending of messages. A termination signal from either end of the wrapped <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pek [...]
-<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> with a <span class="group-java"><a href="https://doc [...]
+<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> will not cancel, complete or emit a failure, until the opposit [...]
+<p>The restart process is inherently lossy, since there is no coordination between cancelling and the sending of messages. A termination signal from either end of the wrapped <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pek [...]
+<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
<p>See also: </p>
<ul>
<li><a href="../RestartSource/withBackoff.html">RestartSource.withBackoff</a></li>
@@ -524,7 +524,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/RestartSink/withBackoff.html b/content/stream/operators/RestartSink/withBackoff.html
index fc767af..4808c9d 100644
--- a/content/stream/operators/RestartSink/withBackoff.html
+++ b/content/stream/operators/RestartSink/withBackoff.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,15 +418,15 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#restartsink-withbackoff" name="restartsink-withbackoff" class="anchor"><span class="anchor-link"></span></a>RestartSink.withBackoff</h1>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span> with a <span class="group-java"><a href="https://doc [...]
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span> with a <span class="group-java"><a href="https://doc [...]
<p><a href="../index.html#error-handling">Error handling</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartSink$.html#withBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartSink"><code>RestartSink.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/RestartSink$.html#withBacko [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartSink$.html#withBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartSink"><code>RestartSink.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/RestartSink$.html#withBacko [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span> with a <span class="group-java"><a href="https://doc [...]
-<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span> will not cancel as long as maxRestarts is not reached, since c [...]
-<p>The restart process is inherently lossy, since there is no coordination between cancelling and the sending of messages. When the wrapped <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title [...]
-<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span> with a <span class="group-java"><a href="https://doc [...]
+<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink</code></a></span> will not cancel as long as maxRestarts is not reached, since c [...]
+<p>The restart process is inherently lossy, since there is no coordination between cancelling and the sending of messages. When the wrapped <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html" title [...]
+<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
<p>See also: </p>
<ul>
<li><a href="../RestartSource/withBackoff.html">RestartSource.withBackoff</a></li>
@@ -523,7 +523,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/RestartSource/onFailuresWithBackoff.html b/content/stream/operators/RestartSource/onFailuresWithBackoff.html
index 0cef157..c971ecc 100644
--- a/content/stream/operators/RestartSource/onFailuresWithBackoff.html
+++ b/content/stream/operators/RestartSource/onFailuresWithBackoff.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,14 +418,14 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#restartsource-onfailureswithbackoff" name="restartsource-onfailureswithbackoff" class="anchor"><span class="anchor-link"></span></a>RestartSource.onFailuresWithBackoff</h1>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href= [...]
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href= [...]
<p><a href="../index.html#error-handling">Error handling</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartSource$.html#onFailuresWithBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartSource"><code>RestartSource.onFailuresWithBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/R [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartSource$.html#onFailuresWithBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartSource"><code>RestartSource.onFailuresWithBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/R [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Wraps the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href [...]
-<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> will not emit a failure as long as maxRestarts is [...]
-<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
+<p>Wraps the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href [...]
+<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> will not emit a failure as long as maxRestarts is [...]
+<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
<p>See also: </p>
<ul>
<li><a href="withBackoff.html">RestartSource.withBackoff</a></li>
@@ -663,7 +663,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/RestartSource/withBackoff.html b/content/stream/operators/RestartSource/withBackoff.html
index a5187e4..c7cef8c 100644
--- a/content/stream/operators/RestartSource/withBackoff.html
+++ b/content/stream/operators/RestartSource/withBackoff.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,14 +418,14 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#restartsource-withbackoff" name="restartsource-withbackoff" class="anchor"><span class="anchor-link"></span></a>RestartSource.withBackoff</h1>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href= [...]
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href= [...]
<p><a href="../index.html#error-handling">Error handling</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartSource$.html#withBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartSource"><code>RestartSource.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/RestartSource$.html#w [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/RestartSource$.html#withBackoff(org.apache.pekko.stream.RestartSettings,org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.RestartSource"><code>RestartSource.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/RestartSource$.html#w [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href= [...]
-<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> will not emit a complete or fail as long as maxRes [...]
-<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> with a <span class="group-java"><a href= [...]
+<p>This <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Source.html" title="org.apache.pekko.stream.javadsl.Source"><code>Source</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Source.html" title="org.apache.pekko.stream.scaladsl.Source"><code>Source</code></a></span> will not emit a complete or fail as long as maxRes [...]
+<p>This uses the same exponential backoff algorithm as <span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/pattern/BackoffOpts$.html" title="org.apache.pekko.pattern.BackoffOpts"><code>BackoffOpts</code></a></span>.</p>
<p>See also: </p>
<ul>
<li><a href="onFailuresWithBackoff.html">RestartSource.onFailuresWithBackoff</a></li>
@@ -524,7 +524,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/RetryFlow/withBackoff.html b/content/stream/operators/RetryFlow/withBackoff.html
index 3d8029f..1a9f929 100644
--- a/content/stream/operators/RetryFlow/withBackoff.html
+++ b/content/stream/operators/RetryFlow/withBackoff.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,10 +418,10 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#retryflow-withbackoff" name="retryflow-withbackoff" class="anchor"><span class="anchor-link"></span></a>RetryFlow.withBackoff</h1>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> and retry individual elements in that stream with an [...]
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow.html" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow.html" title="org.apache.pekko.stream.scaladsl.Flow"><code>Flow</code></a></span> and retry individual elements in that stream with an [...]
<p><a href="../index.html#error-handling">Error handling</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/RetryFlow$.html#withBackoff(java.time.Duration,java.time.Duration,double,int,org.apache.pekko.stream.javadsl.Flow,org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.RetryFlow"><code>RetryFlow.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/s [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/RetryFlow$.html#withBackoff(java.time.Duration,java.time.Duration,double,int,org.apache.pekko.stream.javadsl.Flow,org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.RetryFlow"><code>RetryFlow.withBackoff</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/s [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>When an element is emitted by the wrapped <code>flow</code> it is passed to the <code>decideRetry</code> function, which may return an element to retry in the <code>flow</code>. </p>
<p>The retry backoff is controlled by the <code>minBackoff</code>, <code>maxBackoff</code> and <code>randomFactor</code> parameters. At most <code>maxRetries</code> will be made after the initial try.</p>
@@ -548,7 +548,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/RetryFlow/withBackoffAndContext.html b/content/stream/operators/RetryFlow/withBackoffAndContext.html
index 8f5a59a..faeea5d 100644
--- a/content/stream/operators/RetryFlow/withBackoffAndContext.html
+++ b/content/stream/operators/RetryFlow/withBackoffAndContext.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -418,10 +418,10 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<div class="page-content row">
<div class="small-12 large-9 column" id="docs">
<h1><a href="#retryflow-withbackoffandcontext" name="retryflow-withbackoffandcontext" class="anchor"><span class="anchor-link"></span></a>RetryFlow.withBackoffAndContext</h1>
-<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/FlowWithContext.html" title="org.apache.pekko.stream.javadsl.FlowWithContext"><code>FlowWithContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/FlowWithContext.html" title="org.apache.pekko.stream.scaladsl.FlowWithContext"><code>FlowWithContext</cod [...]
+<p>Wrap the given <span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/FlowWithContext.html" title="org.apache.pekko.stream.javadsl.FlowWithContext"><code>FlowWithContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/FlowWithContext.html" title="org.apache.pekko.stream.scaladsl.FlowWithContext"><code>FlowWithContext</cod [...]
<p><a href="../index.html#error-handling">Error handling</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/RetryFlow$.html#withBackoffAndContext(java.time.Duration,java.time.Duration,double,int,org.apache.pekko.stream.javadsl.FlowWithContext,org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.RetryFlow"><code>RetryFlow.withBackoffAndContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/RetryFlow$.html#withBackoffAndContext(java.time.Duration,java.time.Duration,double,int,org.apache.pekko.stream.javadsl.FlowWithContext,org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.RetryFlow"><code>RetryFlow.withBackoffAndContext</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>When an element is emitted by the wrapped <code>flow</code> it is passed to the <code>decideRetry</code> function, which may return an element to retry in the <code>flow</code>. </p>
<p>The retry backoff is controlled by the <code>minBackoff</code>, <code>maxBackoff</code> and <code>randomFactor</code> parameters. At most <code>maxRetries</code> will be made after the initial try.</p>
@@ -557,7 +557,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/actorRef.html b/content/stream/operators/Sink/actorRef.html
index 7da8ee3..202cc07 100644
--- a/content/stream/operators/Sink/actorRef.html
+++ b/content/stream/operators/Sink/actorRef.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Send the elements from the stream to an <code>ActorRef</code> of the classic actors API.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#actorRef(org.apache.pekko.actor.ActorRef,java.lang.Object)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.actorRef</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#actorRef[T](ref:org.apache.pekko.actor.ActorRef,onCompleteMessage:Any,onF [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#actorRef(org.apache.pekko.actor.ActorRef,java.lang.Object)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.actorRef</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#actorRef[T](ref:org.apache.pekko.actor.ActorRef,onCompleteMessage:Any,onF [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Send the elements from the stream to an <code>ActorRef</code>. No backpressure so care must be taken to not overflow the inbox.</p>
<p>See also:</p>
@@ -519,7 +519,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/actorRefWithBackpressure.html b/content/stream/operators/Sink/actorRefWithBackpressure.html
index 5a3912a..e51e370 100644
--- a/content/stream/operators/Sink/actorRefWithBackpressure.html
+++ b/content/stream/operators/Sink/actorRefWithBackpressure.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Send the elements from the stream to an <code>ActorRef</code> (of the classic actors API) which must then acknowledge reception after completing a message, to provide back pressure onto the sink.</p>
<p><a href="../index.html#actor-interop-operators">Actor interop operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#actorRefWithBackpressure(org.apache.pekko.actor.ActorRef,java.lang.Object,java.lang.Object,java.lang.Object,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.actorRefWithBackpressure</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/ [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#actorRefWithBackpressure(org.apache.pekko.actor.ActorRef,java.lang.Object,java.lang.Object,java.lang.Object,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.actorRefWithBackpressure</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/ [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Send the elements from the stream to an <code>ActorRef</code> which must then acknowledge reception after completing a message, to provide back pressure onto the sink. There is also a variant without a concrete acknowledge message accepting any message as such.</p>
<p>See also:</p>
@@ -670,7 +670,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/asPublisher.html b/content/stream/operators/Sink/asPublisher.html
index 21b1596..764d33d 100644
--- a/content/stream/operators/Sink/asPublisher.html
+++ b/content/stream/operators/Sink/asPublisher.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Integration with Reactive Streams, materializes into a <code>org.reactivestreams.Publisher</code>.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#asPublisher(org.apache.pekko.stream.javadsl.AsPublisher)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.asPublisher</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#asPublisher[T](fanout:Boolean):org.apache.pekko.stream.scaladsl.Sink[T,o [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#asPublisher(org.apache.pekko.stream.javadsl.AsPublisher)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.asPublisher</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#asPublisher[T](fanout:Boolean):org.apache.pekko.stream.scaladsl.Sink[T,o [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>This method gives you the capability to publish the data from the <code>Sink</code> through a Reactive Streams <a href="https://www.reactive-streams.org/reactive-streams-1.0.3-javadoc/org/reactivestreams/Publisher.html">Publisher</a>. Generally, in Pekko Streams a <code>Sink</code> is considered a subscriber, which consumes the data from source. To integrate with other Reactive Stream implementations <code>Sink.asPublisher</code> provides a <code>Publisher</code> materialized value wh [...]
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -544,7 +544,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/cancelled.html b/content/stream/operators/Sink/cancelled.html
index 5ec165e..157b372 100644
--- a/content/stream/operators/Sink/cancelled.html
+++ b/content/stream/operators/Sink/cancelled.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Immediately cancel the stream</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#cancelled()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.cancelled</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#cancelled[T]:org.apache.pekko.stream.scaladsl.Sink[T,org.apache.pekko.NotUsed]" title="org.apache.pekko.stream.scaladsl [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#cancelled()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.cancelled</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#cancelled[T]:org.apache.pekko.stream.scaladsl.Sink[T,org.apache.pekko.NotUsed]" title="org.apache.pekko.stream.scaladsl [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Immediately cancel the stream</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -526,7 +526,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/collect.html b/content/stream/operators/Sink/collect.html
index 5314364..52cfd46 100644
--- a/content/stream/operators/Sink/collect.html
+++ b/content/stream/operators/Sink/collect.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Collect all input elements using a Java <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/stream/Collector.html" title="java.util.stream.Collector"><code>Collector</code></a>.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#collect(java.util.stream.Collector)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.collect</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink.collect</code></a></span></p>
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#collect(java.util.stream.Collector)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.collect</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink.collect</code></a></span></p>
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>A <a href="https://doc.akka.io/japi/akka/2.6/org/apache/pekko/stream/javadsl/Sink.html" title="pekko.stream.javadsl.Sink"><code>Sink</code></a> which materializes into a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/CompletionStage.html" title="java.util.concurrent.CompletionStage"><code>CompletionStage</code></a> which will be completed with a result of the Java <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/uti [...]
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -523,7 +523,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/collection.html b/content/stream/operators/Sink/collection.html
index 1e8be69..30f7512 100644
--- a/content/stream/operators/Sink/collection.html
+++ b/content/stream/operators/Sink/collection.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p><span class="group-scala">Collect all values emitted from the stream into a collection.</span><span class="group-java">Operator only available in the Scala API. The closest operator in the Java API is <a href="seq.html"><code>Sink.seq</code></a></span>.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p><div class="group-scala">
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.collection</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#collection[T,That](implicitcbf:org.apache.pekko.util.ccompat.Factory[T,Thatwithscala.collection.immutable.Iterable[_]]):org.apache [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.collection</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#collection[T,That](implicitcbf:org.apache.pekko.util.ccompat.Factory[T,Thatwithscala.collection.immutable.Iterable[_]]):org.apache [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Collect values emitted from the stream into an arbitrary collection <code>That</code>. The resulting collection is available through a <code>Future[That]</code> or when the stream completes. Note that the collection boundaries are those defined in the <code>CanBuildFrom</code> associated with the chosen collection. See <a href="https://docs.scala-lang.org/overviews/core/architecture-of-scala-213-collections.html">The Architecture of Scala 2.13’s Collections</a> for more info. Th [...]
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -523,7 +523,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/combine.html b/content/stream/operators/Sink/combine.html
index 9c4c770..6b2da60 100644
--- a/content/stream/operators/Sink/combine.html
+++ b/content/stream/operators/Sink/combine.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Combine several sinks into one using a user specified strategy</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#combine(org.apache.pekko.stream.javadsl.Sink,org.apache.pekko.stream.javadsl.Sink,java.util.List,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.combine</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$. [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#combine(org.apache.pekko.stream.javadsl.Sink,org.apache.pekko.stream.javadsl.Sink,java.util.List,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.combine</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$. [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Combine several sinks into one using a user specified strategy</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -538,7 +538,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/completionStageSink.html b/content/stream/operators/Sink/completionStageSink.html
index f1a9dfc..f2dc9ed 100644
--- a/content/stream/operators/Sink/completionStageSink.html
+++ b/content/stream/operators/Sink/completionStageSink.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -510,7 +510,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/fold.html b/content/stream/operators/Sink/fold.html
index d00ee8c..ce06a46 100644
--- a/content/stream/operators/Sink/fold.html
+++ b/content/stream/operators/Sink/fold.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Fold over emitted element with a function, where each invocation will get the new element and the result from the previous fold invocation.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#fold(java.lang.Object,org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.fold</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#fold[U,T](zero:U)(f:(U,T)=>U):org.apache.pekko.stream.scaladsl.Sink[T [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#fold(java.lang.Object,org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.fold</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#fold[U,T](zero:U)(f:(U,T)=>U):org.apache.pekko.stream.scaladsl.Sink[T [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Fold over emitted element with a function, where each invocation will get the new element and the result from the previous fold invocation. The first invocation will be provided the <code>zero</code> value.</p>
<p>Materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> that will complete with the last state when the stream has completed.</p>
@@ -532,7 +532,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/foreach.html b/content/stream/operators/Sink/foreach.html
index 17048cf..150023b 100644
--- a/content/stream/operators/Sink/foreach.html
+++ b/content/stream/operators/Sink/foreach.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Invoke a given procedure for each element received.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#foreach(org.apache.pekko.japi.function.Procedure)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.foreach</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#foreach[T](f:T=%3EUnit):org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Fu [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#foreach(org.apache.pekko.japi.function.Procedure)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.foreach</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#foreach[T](f:T=%3EUnit):org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Fu [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Invoke a given procedure for each element received. Note that it is not safe to mutate shared state from the procedure.</p>
<p>The sink materializes into a <span class="group-scala"><code>Future[Done]</code></span> <span class="group-java"><code>CompletionStage<Done></code></span> which completes when the stream completes, or fails if the stream fails.</p>
@@ -545,7 +545,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/foreachAsync.html b/content/stream/operators/Sink/foreachAsync.html
index 4e6cff5..2ac59f3 100644
--- a/content/stream/operators/Sink/foreachAsync.html
+++ b/content/stream/operators/Sink/foreachAsync.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Invoke a given procedure asynchronously for each element received.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#foreachAsync(int,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.foreachAsync</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#foreachAsync[T](parallelism:Int)(f:T=>scala.concurrent.Future[Unit] [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#foreachAsync(int,org.apache.pekko.japi.function.Function)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.foreachAsync</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#foreachAsync[T](parallelism:Int)(f:T=>scala.concurrent.Future[Unit] [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Invoke a given procedure asynchronously for each element received. Note that if shared state is mutated from the procedure that must be done in a thread-safe way.</p>
<p>The sink materializes into a <span class="group-scala"><code>Future[Done]</code></span> <span class="group-java"><code>CompletionStage<Done></code></span> which completes when the stream completes, or fails if the stream fails.</p>
@@ -535,7 +535,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/foreachParallel.html b/content/stream/operators/Sink/foreachParallel.html
index f573b87..120e281 100644
--- a/content/stream/operators/Sink/foreachParallel.html
+++ b/content/stream/operators/Sink/foreachParallel.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -507,7 +507,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/fromMaterializer.html b/content/stream/operators/Sink/fromMaterializer.html
index b2cddb3..99d2b7e 100644
--- a/content/stream/operators/Sink/fromMaterializer.html
+++ b/content/stream/operators/Sink/fromMaterializer.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Defer the creation of a <code>Sink</code> until materialization and access <code>Materializer</code> and <code>Attributes</code></p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#fromMaterializer(java.util.function.BiFunction)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.fromMaterializer</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#fromMaterializer[T,M](factory:(org.apache.pekko.stream.Materializer,org.apac [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#fromMaterializer(java.util.function.BiFunction)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.fromMaterializer</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#fromMaterializer[T,M](factory:(org.apache.pekko.stream.Materializer,org.apac [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Typically used when access to materializer is needed to run a different stream during the construction of a sink. Can also be used to access the underlying <code>ActorSystem</code> from <code>Materializer</code>.</p>
<div class="source-github">
@@ -509,7 +509,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/fromSubscriber.html b/content/stream/operators/Sink/fromSubscriber.html
index 929d1c0..d236dbf 100644
--- a/content/stream/operators/Sink/fromSubscriber.html
+++ b/content/stream/operators/Sink/fromSubscriber.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Integration with Reactive Streams, wraps a <code>org.reactivestreams.Subscriber</code> as a sink.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#fromSubscriber(org.reactivestreams.Subscriber)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.fromSubscriber</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#fromSubscriber[T](subscriber:org.reactivestreams.Subscriber[T]):org.apache.pekk [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#fromSubscriber(org.reactivestreams.Subscriber)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.fromSubscriber</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#fromSubscriber[T](subscriber:org.reactivestreams.Subscriber[T]):org.apache.pekk [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>TODO: We would welcome help on contributing descriptions and examples, see: <a href="https://github.com/akka/akka/issues/25646">https://github.com/akka/akka/issues/25646</a></p>
<div class="source-github">
@@ -509,7 +509,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/futureSink.html b/content/stream/operators/Sink/futureSink.html
index 7bfca2d..19d2853 100644
--- a/content/stream/operators/Sink/futureSink.html
+++ b/content/stream/operators/Sink/futureSink.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Streams the elements to the given future sink once it successfully completes. </p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.futureSink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#futureSink[T,M](future:scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Sink[T,M]]):org.apache.pekko.stream.scaladsl.Sink[ [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.futureSink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#futureSink[T,M](future:scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Sink[T,M]]):org.apache.pekko.stream.scaladsl.Sink[ [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Streams the elements through the given future flow once it successfully completes. If the future fails the stream is failed.</p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
@@ -513,7 +513,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/head.html b/content/stream/operators/Sink/head.html
index dfa449d..4d0324a 100644
--- a/content/stream/operators/Sink/head.html
+++ b/content/stream/operators/Sink/head.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> which completes with the first value arriving, after this the stream is canceled.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#head()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.head</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#head[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[T]]" title="org.apache.pekko.stream.scaladsl.Sink"><code> [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#head()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.head</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#head[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[T]]" title="org.apache.pekko.stream.scaladsl.Sink"><code> [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> which completes with the first value arriving, after this the stream is canceled. If no element is emitted, the <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> is failed.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -529,7 +529,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/headOption.html b/content/stream/operators/Sink/headOption.html
index c7e742b..d50147e 100644
--- a/content/stream/operators/Sink/headOption.html
+++ b/content/stream/operators/Sink/headOption.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materializes into a <span class="group-scala"><code>Future[Option[T]]</code></span> <span class="group-java"><code>CompletionStage<Optional<T>></code></span> which completes with the first value arriving wrapped in <span class="group-scala"><code>Some</code></span> <span class="group-java"><code>Optional</code></span>, or <span class="group-scala">a <code>None</code></span> <span class="group-java">an empty Optional</span> if the stream completes without any elements emitted.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#headOption()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.headOption</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#headOption[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[Option[T]]]" title="org.apache.pekko.st [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#headOption()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.headOption</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#headOption[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[Option[T]]]" title="org.apache.pekko.st [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materializes into a <span class="group-scala"><code>Future[Option[T]]</code></span> <span class="group-java"><code>CompletionStage<Optional<T>></code></span> which completes with the first value arriving wrapped in <span class="group-scala"><code>Some</code></span> <span class="group-java"><code>Optional</code></span>, or <span class="group-scala">a <code>None</code></span> <span class="group-java">an empty Optional</span> if the stream completes without any elements emitted.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -530,7 +530,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/ignore.html b/content/stream/operators/Sink/ignore.html
index 441fb7d..2d7e402 100644
--- a/content/stream/operators/Sink/ignore.html
+++ b/content/stream/operators/Sink/ignore.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Consume all elements but discards them.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#ignore()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.ignore</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink.ignore</code></a></span></p>
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#ignore()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.ignore</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink.ignore</code></a></span></p>
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Consume all elements but discards them. Useful when a stream has to be consumed but there is no use to actually do anything with the elements in the <code>Sink</code>. Processing of the elements may occur in the <code>Source</code>/<code>Flow</code>. </p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -529,7 +529,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/last.html b/content/stream/operators/Sink/last.html
index c1650aa..cdf6c5f 100644
--- a/content/stream/operators/Sink/last.html
+++ b/content/stream/operators/Sink/last.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> which will complete with the last value emitted when the stream completes.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#last()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.last</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#last[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[T]]" title="org.apache.pekko.stream.scaladsl.Sink"><code> [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#last()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.last</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#last[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[T]]" title="org.apache.pekko.stream.scaladsl.Sink"><code> [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> which will complete with the last value emitted when the stream completes. If the stream completes with no elements the <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> is failed.</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -529,7 +529,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/lastOption.html b/content/stream/operators/Sink/lastOption.html
index 5a27514..717a99d 100644
--- a/content/stream/operators/Sink/lastOption.html
+++ b/content/stream/operators/Sink/lastOption.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materialize a <span class="group-scala"><code>Future[Option[T]]</code></span> <span class="group-java"><code>CompletionStage<Optional<T>></code></span> which completes with the last value emitted wrapped in an <span class="group-scala"><code>Some</code></span> <span class="group-java"><code>Optional</code></span> when the stream completes.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#lastOption()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.lastOption</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#lastOption[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[Option[T]]]" title="org.apache.pekko.st [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#lastOption()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.lastOption</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#lastOption[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[Option[T]]]" title="org.apache.pekko.st [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materialize a <span class="group-scala"><code>Future[Option[T]]</code></span> <span class="group-java"><code>CompletionStage<Optional<T>></code></span> which completes with the last value emitted wrapped in an <span class="group-scala"><code>Some</code></span> <span class="group-java"><code>Optional</code></span> when the stream completes. if the stream completes with no elements the <code>CompletionStage</code> is completed with <span class="group-scala"><code>None</code> [...]
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -529,7 +529,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/lazyCompletionStageSink.html b/content/stream/operators/Sink/lazyCompletionStageSink.html
index 4666248..95f0596 100644
--- a/content/stream/operators/Sink/lazyCompletionStageSink.html
+++ b/content/stream/operators/Sink/lazyCompletionStageSink.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -513,7 +513,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/lazyFutureSink.html b/content/stream/operators/Sink/lazyFutureSink.html
index 15adba7..1db5e92 100644
--- a/content/stream/operators/Sink/lazyFutureSink.html
+++ b/content/stream/operators/Sink/lazyFutureSink.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Defers creation and materialization of a <code>Sink</code> until there is a first element.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.lazyFutureSink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#lazyFutureSink[T,M](create:()=>scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Sink[T,M]]):org.apache.pekko.stream [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.lazyFutureSink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#lazyFutureSink[T,M](create:()=>scala.concurrent.Future[org.apache.pekko.stream.scaladsl.Sink[T,M]]):org.apache.pekko.stream [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>When the first element comes from upstream the <code>Future[Sink]</code> is created. When that completes successfully with a sink that is materialized and inserted in the stream. The internal <code>Sink</code> will not be created if the stream completes of fails before any element got through.</p>
<p>The materialized value of the <code>Sink</code> will be the materialized value of the created internal flow if it is materialized and failed with a <code>org.apache.pekko.stream.NeverMaterializedException</code> if the stream fails or completes without the flow being materialized.</p>
@@ -516,7 +516,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/lazyInitAsync.html b/content/stream/operators/Sink/lazyInitAsync.html
index f4a23eb..c4a6dd0 100644
--- a/content/stream/operators/Sink/lazyInitAsync.html
+++ b/content/stream/operators/Sink/lazyInitAsync.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Deprecated by <a href="lazyFutureSink.html"><code>Sink.lazyFutureSink</code></a>.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#lazyInitAsync(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyInitAsync</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyInitAsync[I,O,M](flowFactory:()=>scala.concurrent.Future[org.apach [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Flow$.html#lazyInitAsync(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Flow"><code>Flow.lazyInitAsync</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Flow$.html#lazyInitAsync[I,O,M](flowFactory:()=>scala.concurrent.Future[org.apach [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p><code>lazyInitAsync</code> has been deprecated in 2.6.0, use <a href="lazyFutureSink.html">lazyFutureSink</a> instead.</p>
<p>Creates a real <code>Sink</code> upon receiving the first element. Internal <code>Sink</code> will not be created if there are no elements, because of completion or error.</p>
@@ -519,7 +519,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/lazySink.html b/content/stream/operators/Sink/lazySink.html
index 78f90bf..d9fe0ee 100644
--- a/content/stream/operators/Sink/lazySink.html
+++ b/content/stream/operators/Sink/lazySink.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Defers creation and materialization of a <code>Sink</code> until there is a first element.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#lazySink(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.lazySink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#lazySink[T,M](create:()=>org.apache.pekko.stream.scaladsl.Sink[T,M]):org.apache. [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#lazySink(org.apache.pekko.japi.function.Creator)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.lazySink</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#lazySink[T,M](create:()=>org.apache.pekko.stream.scaladsl.Sink[T,M]):org.apache. [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Defers <code>Sink</code> creation and materialization until when the first element arrives from upstream to the <code>lazySink</code>. After that the stream behaves as if the nested sink replaced the <code>lazySink</code>. The nested <code>Sink</code> will not be created if upstream completes or fails without any elements arriving at the sink.</p>
<p>The materialized value of the <code>Sink</code> is a <span class="group-scala"><code>Future</code></span><span class="group-java"><code>CompletionStage</code></span> that is completed with the materialized value of the nested sink once that is constructed.</p>
@@ -575,7 +575,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/never.html b/content/stream/operators/Sink/never.html
index 29a0dee..7d0c659 100644
--- a/content/stream/operators/Sink/never.html
+++ b/content/stream/operators/Sink/never.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Always backpressure never cancel and never consume any elements from the stream.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#never()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.never</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink.never</code></a></span> <span class="group-java"><a href="https://doc [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#never()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.never</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html" title="org.apache.pekko.stream.scaladsl.Sink"><code>Sink.never</code></a></span> <span class="group-java"><a href="https://doc [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>A <code>Sink</code> that will always backpressure never cancel and never consume any elements from the stream.</p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
@@ -513,7 +513,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/onComplete.html b/content/stream/operators/Sink/onComplete.html
index f198a26..5880974 100644
--- a/content/stream/operators/Sink/onComplete.html
+++ b/content/stream/operators/Sink/onComplete.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Invoke a callback when the stream has completed or failed.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#onComplete(org.apache.pekko.japi.function.Procedure)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.onComplete</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#onComplete[T](callback:scala.util.Try[org.apache.pekko.Done]=>Unit):org.ap [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#onComplete(org.apache.pekko.japi.function.Procedure)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.onComplete</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#onComplete[T](callback:scala.util.Try[org.apache.pekko.Done]=>Unit):org.ap [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Invoke a callback when the stream has completed or failed.</p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
@@ -513,7 +513,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/preMaterialize.html b/content/stream/operators/Sink/preMaterialize.html
index cb3d7d2..29f956d 100644
--- a/content/stream/operators/Sink/preMaterialize.html
+++ b/content/stream/operators/Sink/preMaterialize.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materializes this Sink, immediately returning (1) its materialized value, and (2) a new Sink that can be consume elements ‘into’ the pre-materialized one.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html#preMaterialize(org.apache.pekko.actor.ClassicActorSystemProvider)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.preMaterialize</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html#preMaterialize()(implicitmaterializer:org.apache.pekko.stream. [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink.html#preMaterialize(org.apache.pekko.actor.ClassicActorSystemProvider)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.preMaterialize</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink.html#preMaterialize()(implicitmaterializer:org.apache.pekko.stream. [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materializes this Sink, immediately returning (1) its materialized value, and (2) a new Sink that can be consume elements ‘into’ the pre-materialized one. Useful for when you need a materialized value of a Sink when handing it out to someone to materialize it for you.</p>
<div class="source-github">
@@ -509,7 +509,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/queue.html b/content/stream/operators/Sink/queue.html
index 51c02b7..3f67884 100644
--- a/content/stream/operators/Sink/queue.html
+++ b/content/stream/operators/Sink/queue.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Materialize a <code>SinkQueue</code> that can be pulled to trigger demand through the sink.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#queue(int)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.queue</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#queue[T](maxConcurrentPulls:Int):org.apache.pekko.stream.scaladsl.Sink[T,org.apache.pekko.stream.scaladsl.SinkQueueWithCance [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#queue(int)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.queue</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#queue[T](maxConcurrentPulls:Int):org.apache.pekko.stream.scaladsl.Sink[T,org.apache.pekko.stream.scaladsl.SinkQueueWithCance [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materialize a <code>SinkQueue</code> that can be pulled to trigger demand through the sink. The queue contains a buffer in case stream emitting elements faster than queue pulling them.</p>
<h2><a href="#reactive-streams-semantics" name="reactive-streams-semantics" class="anchor"><span class="anchor-link"></span></a>Reactive Streams semantics</h2><div class="callout">
@@ -513,7 +513,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/reduce.html b/content/stream/operators/Sink/reduce.html
index d6738c5..bc2d6e8 100644
--- a/content/stream/operators/Sink/reduce.html
+++ b/content/stream/operators/Sink/reduce.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Apply a reduction function on the incoming elements and pass the result to the next invocation.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#reduce(org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.reduce</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#reduce[T](f:(T,T)=>T):org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Fut [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#reduce(org.apache.pekko.japi.function.Function2)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.reduce</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#reduce[T](f:(T,T)=>T):org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Fut [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Apply a reduction function on the incoming elements and pass the result to the next invocation. The first invocation receives the two first elements of the flow.</p>
<p>Materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> that will be completed by the last result of the reduction function.</p>
@@ -531,7 +531,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/seq.html b/content/stream/operators/Sink/seq.html
index 161e1b5..67205a6 100644
--- a/content/stream/operators/Sink/seq.html
+++ b/content/stream/operators/Sink/seq.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Collect values emitted from the stream into a collection.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#seq()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.seq</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#seq[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[scala.collection.immutable.Seq[T]]]" title="org.apache.pekko [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#seq()" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.seq</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#seq[T]:org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[scala.collection.immutable.Seq[T]]]" title="org.apache.pekko [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Collect values emitted from the stream into a collection, the collection is available through a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> or which completes when the stream completes. Note that the collection is bounded to <span class="group-scala"><code>Int.MaxValue</code></span> <span class="group-java"><code>Integer.MAX_VALUE</code></span>, if more element are emitted the sink will cancel the stream</p>
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -535,7 +535,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/setup.html b/content/stream/operators/Sink/setup.html
index 68b8b06..9bebd8c 100644
--- a/content/stream/operators/Sink/setup.html
+++ b/content/stream/operators/Sink/setup.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -422,7 +422,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p><a href="../index.html#sink-operators">Sink operators</a></p><div class="callout warning "><div class="callout-title">Warning</div>
<p>The <code>setup</code> operator has been deprecated, use <a href="fromMaterializer.html">fromMaterializer</a> instead. </p></div>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#setup(java.util.function.BiFunction)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.setup</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#setup[T,M](factory:(org.apache.pekko.stream.ActorMaterializer,org.apache.pekko.stream.Attributes)= [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#setup(java.util.function.BiFunction)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.setup</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#setup[T,M](factory:(org.apache.pekko.stream.ActorMaterializer,org.apache.pekko.stream.Attributes)= [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Typically used when access to materializer is needed to run a different stream during the construction of a sink. Can also be used to access the underlying <code>ActorSystem</code> from <code>ActorMaterializer</code>.</p>
<div class="source-github">
@@ -510,7 +510,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Sink/takeLast.html b/content/stream/operators/Sink/takeLast.html
index 1a2473a..c1e9d3c 100644
--- a/content/stream/operators/Sink/takeLast.html
+++ b/content/stream/operators/Sink/takeLast.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -227,7 +227,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
</div>
</div>
<select class="supergroup" name="Language"><option class="group" value="group-scala">Scala</option><option class="group" value="group-java">Java</option></select>
@@ -421,7 +421,7 @@ C16.952,7,17,6.553,17,6c0-0.553-0.048-1-0.6-1H3.6C3.048,5,3,5.447,3,6C3,6.553,3.
<p>Collect the last <code>n</code> values emitted from the stream into a collection.</p>
<p><a href="../index.html#sink-operators">Sink operators</a></p>
<h2><a href="#signature" name="signature" class="anchor"><span class="anchor-link"></span></a>Signature</h2>
-<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#takeLast(int)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.takeLast</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26532-3d93c297-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#takeLast[T](n:Int):org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[scala.collection.immutable.Seq[T]]] [...]
+<p><span class="group-java"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/javadsl/Sink$.html#takeLast(int)" title="org.apache.pekko.stream.javadsl.Sink"><code>Sink.takeLast</code></a></span><span class="group-scala"><a href="https://doc.akka.io/api/akka/0.0.0+26533-ec68a528-SNAPSHOT/org/apache/pekko/stream/scaladsl/Sink$.html#takeLast[T](n:Int):org.apache.pekko.stream.scaladsl.Sink[T,scala.concurrent.Future[scala.collection.immutable.Seq[T]]] [...]
<h2><a href="#description" name="description" class="anchor"><span class="anchor-link"></span></a>Description</h2>
<p>Materializes into a <span class="group-scala"><code>Future</code></span> <span class="group-java"><code>CompletionStage</code></span> of <span class="group-scala"><code>immutable.Seq[T]</code></span> <span class="group-java"><code>List<In></code></span> containing the last <code>n</code> collected elements when the stream completes. If the stream completes before signaling at least n elements, the <span class="group-scala"><code>Future</code></span> <span class="group-java"><cod [...]
<h2><a href="#example" name="example" class="anchor"><span class="anchor-link"></span></a>Example</h2>
@@ -579,7 +579,7 @@ The source code for this page can be found <a href="https://github.com/akka/akka
<script type="text/javascript" src="../../../lib/prettify/prettify.js"></script>
<script type="text/javascript" src="../../../lib/prettify/lang-scala.js"></script>
<script type="text/javascript">jQuery(function(){window.prettyPrint && prettyPrint()});</script>
-<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26532-3d93c297-SNAPSHOT', 'https://akka.io/')});</script>
+<script type="text/javascript">jQuery(function(jq){initOldVersionWarnings(jq, '0.0.0+26533-ec68a528-SNAPSHOT', 'https://akka.io/')});</script>
</html>
diff --git a/content/stream/operators/Source-or-Flow/aggregateWithBoundary.html b/content/stream/operators/Source-or-Flow/aggregateWithBoundary.html
index 53fb8bd..b8ebf8e 100644
--- a/content/stream/operators/Source-or-Flow/aggregateWithBoundary.html
+++ b/content/stream/operators/Source-or-Flow/aggregateWithBoundary.html
@@ -32,7 +32,7 @@
<span class="home-icon">⌂</span>Pekko Documentation
</a>
<div class="version-number">
-0.0.0+26532-3d93c297*
+0.0.0+26533-ec68a528*
... 12738 lines suppressed ...
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@pekko.apache.org
For additional commands, e-mail: commits-help@pekko.apache.org