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

=str deprecate ActorPublisher/Subscriber, use GraphStage (#21952)

Browse source 
* =str deprecate ActorPublisher/Subscriber, use GraphStage

* =str deprecate Source.actorPublisher / Sink.actorSubscriber

* =str added deprecation note of ActorPublisher,Subscriber
This commit is contained in:
Konrad `ktoso` Malawski 2016-12-08 17:22:01 +01:00 • committed by GitHub
parent 591eafe04c
commit 2ea8cd7410
9 changed files with 90 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

16
akka-docs/rst/scala/stream/stream-integrations.rst
View file

@ -437,6 +437,14 @@ These can be consumed by other Reactive Stream libraries or used as an Akka Stre
ActorPublisher
--------------
.. warning::
**Deprecation warning:** ``ActorPublisher`` is deprecated in favour of the vastly more
type-safe and safe to implement :class:`akka.stream.stage.GraphStage`. It can also
expose a "stage actor ref" is needed to be addressed as-if an Actor.
Custom stages implemented using ``GraphStage`` are also automatically fusable.
To learn more about implementing custom stages using it refer to :ref:`graphstage-scala`.
Extend/mixin :class:`akka.stream.actor.ActorPublisher` in your :class:`Actor` to make it a
stream publisher that keeps track of the subscription life cycle and requested elements.
@ -482,6 +490,14 @@ subscription attempts will be rejected with an :class:`IllegalStateException`.
ActorSubscriber
---------------
.. warning::
**Deprecation warning:** ``ActorSubscriber`` is deprecated in favour of the vastly more
type-safe and safe to implement :class:`akka.stream.stage.GraphStage`. It can also
expose a "stage actor ref" is needed to be addressed as-if an Actor.
Custom stages implemented using ``GraphStage`` are also automatically fusable.
To learn more about implementing custom stages using it refer to :ref:`graphstage-scala`.
Extend/mixin :class:`akka.stream.actor.ActorSubscriber` in your :class:`Actor` to make it a
stream subscriber with full control of stream back pressure. It will receive
``ActorSubscriberMessage.OnNext``, ``ActorSubscriberMessage.OnComplete`` and ``ActorSubscriberMessage.OnError``