Merge pull request #19576 from 2m/wip-deprecate-stage-2m

#19553 deprecate stage infra
This commit is contained in:
drewhk 2016-01-22 15:25:32 +01:00
commit 31bd20237b
4 changed files with 37 additions and 2 deletions

View file

@ -98,3 +98,18 @@ Materialized values of the following sources and sinks:
have been changed from ``Long`` to ``akka.stream.io.IOResult``.
This allows to signal more complicated completion scenarios. For example, on failure it is now possible
to return the exception and the number of bytes written until that exception occured.
PushStage, PushPullStage and DetachedStage have been deprecated in favor of GraphStage
======================================================================================
The :class:`PushStage` :class:`PushPullStage` and :class:`DetachedStage` classes have been deprecated and
should be replaced by :class:`GraphStage` (:ref:`graphstage-java`) which is now a single powerful API
for custom stream processing.
Update procedure
----------------
Please consult the :class:`GraphStage` documentation (:ref:`graphstage-java`) and the `previous migration guide`_
on migrating from :class:`AsyncStage` to :class:`GraphStage`.
.. _`previous migration guide`: http://doc.akka.io/docs/akka-stream-and-http-experimental/2.0.2/java/migration-guide-1.0-2.x-java.html#AsyncStage_has_been_replaced_by_GraphStage