Class RestartSink
- java.lang.Object
-
- akka.stream.javadsl.RestartSink
-
public class RestartSink extends java.lang.ObjectA RestartSink wraps aSinkthat gets restarted when it completes or fails.They are useful for graphs that need to run for longer than the
Sinkcan necessarily guarantee it will, for example, forSinkstreams that depend on a remote server that may crash or become partitioned. The RestartSink ensures that the graph can continue running while theSinkrestarts.
-
-
Constructor Summary
Constructors Constructor Description RestartSink()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static <T> Sink<T,NotUsed>withBackoff(RestartSettings settings, Creator<Sink<T,?>> sinkFactory)
-
-
-
Method Detail
-
withBackoff
public static <T> Sink<T,NotUsed> withBackoff(RestartSettings settings, Creator<Sink<T,?>> sinkFactory)
Wrap the givenSinkwith aSinkthat will restart it when it fails or complete using an exponential backoff.This
Sinkwill not cancel as long as maxRestarts is not reached, since cancellation by the wrappedSinkis handled by restarting it. The wrappedSinkcan however be completed by feeding a completion or error into thisSink. When that happens, theSink, if currently running, will terminate and will not be restarted. This can be triggered simply by the upstream completing, or externally by introducing aKillSwitchright before thisSinkin the graph.The restart process is inherently lossy, since there is no coordination between cancelling and the sending of messages. When the wrapped
Sinkdoes cancel, thisSinkwill backpressure, however any elements already sent may have been lost.This uses the same exponential backoff algorithm as
BackoffOpts.- Parameters:
settings-RestartSettingsdefining restart configurationsinkFactory- A factory for producing theSinkto wrap.
-
-