Class Sink<In,Mat>
- java.lang.Object
-
- akka.stream.javadsl.Sink<In,Mat>
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface akka.stream.Graph
Graph.GraphMapMatVal<S extends Shape,M>
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static <In> Sink<In,NotUsed>
actorRef(ActorRef ref, java.lang.Object onCompleteMessage)
Sends the elements of the stream to the givenActorRef
.static <In> Sink<In,NotUsed>
actorRefWithAck(ActorRef ref, java.lang.Object onInitMessage, java.lang.Object ackMessage, java.lang.Object onCompleteMessage, Function<java.lang.Throwable,java.lang.Object> onFailureMessage)
Deprecated.Use actorRefWithBackpressure insteadstatic <In> Sink<In,NotUsed>
actorRefWithBackpressure(ActorRef ref, java.lang.Object onInitMessage, java.lang.Object onCompleteMessage, Function<java.lang.Throwable,java.lang.Object> onFailureMessage)
Sends the elements of the stream to the givenActorRef
that sends back back-pressure signal.static <In> Sink<In,NotUsed>
actorRefWithBackpressure(ActorRef ref, java.lang.Object onInitMessage, java.lang.Object ackMessage, java.lang.Object onCompleteMessage, Function<java.lang.Throwable,java.lang.Object> onFailureMessage)
Sends the elements of the stream to the givenActorRef
that sends back back-pressure signal.Sink<In,Mat>
addAttributes(Attributes attr)
Add the given attributes to thisSink
.static <T> Sink<T,org.reactivestreams.Publisher<T>>
asPublisher(AsPublisher fanout)
ASink
that materializes into aPublisher
.Sink<In,Mat>
asScala()
Converts this Sink to its Scala DSL counterpart.Sink<In,Mat>
async()
Put an asynchronous boundary around thisSink
Sink<In,Mat>
async(java.lang.String dispatcher)
Put an asynchronous boundary around thisSink
Sink<In,Mat>
async(java.lang.String dispatcher, int inputBufferSize)
Put an asynchronous boundary around thisSink
static <T> Sink<T,NotUsed>
cancelled()
ASink
that immediately cancels its upstream after materialization.static <U,In>
Sink<In,java.util.concurrent.CompletionStage<U>>collect(java.util.stream.Collector<In,?,U> collector)
Creates a sink which materializes into aCompletionStage
which will be completed with a result of the Java
Collector
transformation and reduction operations.
static <T,U>
Sink<T,NotUsed>combine(Sink<U,?> output1, Sink<U,?> output2, java.util.List<Sink<U,?>> rest, Function<java.lang.Integer,Graph<UniformFanOutShape<T,U>,NotUsed>> fanOutStrategy)
Combine several sinks with fan-out strategy likeBroadcast
orBalance
and returnsSink
.static <T,U,M>
Sink<T,java.util.List<M>>combine(java.util.List<? extends Graph<SinkShape<U>,M>> sinks, Function<java.lang.Integer,Graph<UniformFanOutShape<T,U>,NotUsed>> fanOutStrategy)
Combine several sinks with fan-out strategy likeBroadcast
orBalance
and returnsSink
.static <T,U,M1,M2,M>
Sink<T,M>combineMat(Sink<U,M1> first, Sink<U,M2> second, Function<java.lang.Integer,Graph<UniformFanOutShape<T,U>,NotUsed>> fanOutStrategy, Function2<M1,M2,M> matF)
Combine two sinks with fan-out strategy likeBroadcast
orBalance
and returnsSink
with 2 outlets.static <T,M>
Sink<T,java.util.concurrent.CompletionStage<M>>completionStageSink(java.util.concurrent.CompletionStage<Sink<T,M>> future)
Turn aFuture[Sink]
into a Sink that will consume the values of the source when the future completes successfully.<In2> Sink<In2,Mat>
contramap(Function<In2,In> f)
Transform this Sink by applying a function to each *incoming* upstream element before it is passed to theSink
static <U,In>
Sink<In,java.util.concurrent.CompletionStage<U>>fold(U zero, Function2<U,In,U> f)
ASink
that will invoke the given function for every received element, giving it its previous output (or the givenzero
value) and the element as input.static <U,In>
Sink<In,java.util.concurrent.CompletionStage<U>>foldAsync(U zero, Function2<U,In,java.util.concurrent.CompletionStage<U>> f)
ASink
that will invoke the given asynchronous function for every received element, giving it its previous output (or the givenzero
value) and the element as input.static <T> Sink<T,java.util.concurrent.CompletionStage<Done>>
foreach(Procedure<T> f)
ASink
that will invoke the given procedure for each received element.static <T> Sink<T,java.util.concurrent.CompletionStage<Done>>
foreachAsync(int parallelism, Function<T,java.util.concurrent.CompletionStage<java.lang.Void>> f)
ASink
that will invoke the given procedure asynchronously for each received element.static <T> Sink<T,java.util.concurrent.CompletionStage<Done>>
foreachParallel(int parallel, Procedure<T> f, scala.concurrent.ExecutionContext ec)
Deprecated.Use `foreachAsync` instead, it allows you to choose how to run the procedure, by calling some other API returning a CompletionStage or using CompletableFuture.supplyAsync.static <T,M>
Sink<T,M>fromGraph(Graph<SinkShape<T>,M> g)
A graph with the shape of a sink logically is a sink, this method makes it so also in type.static <T,M>
Sink<T,java.util.concurrent.CompletionStage<M>>fromMaterializer(java.util.function.BiFunction<Materializer,Attributes,Sink<T,M>> factory)
Defers the creation of aSink
until materialization.static <In> Sink<In,NotUsed>
fromSubscriber(org.reactivestreams.Subscriber<In> subs)
Helper to createSink
fromSubscriber
.Attributes
getAttributes()
static <In> Sink<In,java.util.concurrent.CompletionStage<In>>
head()
ASink
that materializes into aCompletionStage
of the first value received.static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.Optional<In>>>
headOption()
ASink
that materializes into aCompletionStage
of the optional first value received.static <T> Sink<T,java.util.concurrent.CompletionStage<Done>>
ignore()
ASink
that will consume the stream and discard the elements.static <In> Sink<In,java.util.concurrent.CompletionStage<In>>
last()
ASink
that materializes into aCompletionStage
of the last value received.static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.Optional<In>>>
lastOption()
ASink
that materializes into aCompletionStage
of the optional last value received.static <T,M>
Sink<T,java.util.concurrent.CompletionStage<M>>lazyCompletionStageSink(Creator<java.util.concurrent.CompletionStage<Sink<T,M>>> create)
Defers invoking thecreate
function to create a future sink until there is a first element passed from upstream.static <T,M>
Sink<T,java.util.concurrent.CompletionStage<M>>lazyInit(Function<T,java.util.concurrent.CompletionStage<Sink<T,M>>> sinkFactory, Creator<M> fallback)
Deprecated.Use 'Sink.lazyCompletionStageSink' in combination with 'Flow.prefixAndTail(1)' instead.static <T,M>
Sink<T,java.util.concurrent.CompletionStage<java.util.Optional<M>>>lazyInitAsync(Creator<java.util.concurrent.CompletionStage<Sink<T,M>>> sinkFactory)
Deprecated.Use 'Sink.lazyCompletionStageSink' instead.static <T,M>
Sink<T,java.util.concurrent.CompletionStage<M>>lazySink(Creator<Sink<T,M>> create)
Defers invoking thecreate
function to create a sink until there is a first element passed from upstream.<Mat2> Sink<In,Mat2>
mapMaterializedValue(Function<Mat,Mat2> f)
Transform only the materialized value of this Sink, leaving all other properties as they were.Sink<In,Mat>
named(java.lang.String name)
Add aname
attribute to this Sink.
static <T> Sink<T,java.util.concurrent.CompletionStage<Done>>
never()
ASink
that will always backpressure never cancel and never consume any elements from the stream.static <In> Sink<In,NotUsed>
onComplete(Procedure<scala.util.Try<Done>> callback)
ASink
that when the flow is completed, either through a failure or normal completion, apply the provided function withSuccess
orFailure
.Pair<Mat,Sink<In,NotUsed>>
preMaterialize(ClassicActorSystemProvider systemProvider)
Materializes this Sink, immediately returning (1) its materialized value, and (2) a new Sink that can be consume elements 'into' the pre-materialized one.Pair<Mat,Sink<In,NotUsed>>
preMaterialize(Materializer materializer)
Materializes this Sink, immediately returning (1) its materialized value, and (2) a new Sink that can be consume elements 'into' the pre-materialized one.static <T> Sink<T,SinkQueueWithCancel<T>>
queue()
Creates aSink
that is materialized as anSinkQueueWithCancel
.static <T> Sink<T,SinkQueueWithCancel<T>>
queue(int maxConcurrentPulls)
Creates aSink
that is materialized as anSinkQueueWithCancel
.static <In> Sink<In,java.util.concurrent.CompletionStage<In>>
reduce(Function2<In,In,In> f)
ASink
that will invoke the given function for every received element, giving it its previous output (from the second element) and the element as input.<M> M
runWith(Graph<SourceShape<In>,M> source, ClassicActorSystemProvider systemProvider)
Connect thisSink
to aSource
and run it.<M> M
runWith(Graph<SourceShape<In>,M> source, Materializer materializer)
Connect thisSink
to aSource
and run it.static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.List<In>>>
seq()
ASink
that keeps on collecting incoming elements until upstream terminates.static <T,M>
Sink<T,java.util.concurrent.CompletionStage<M>>setup(java.util.function.BiFunction<ActorMaterializer,Attributes,Sink<T,M>> factory)
Deprecated.Use 'fromMaterializer' instead.SinkShape<In>
shape()
The shape of a graph is all that is externally visible: its inlets and outlets.static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.List<In>>>
takeLast(int n)
ASink
that materializes into a aCompletionStage
ofList
containing the lastn
collected elements.java.lang.String
toString()
akka.stream.impl.LinearTraversalBuilder
traversalBuilder()
INTERNAL API.Sink<In,Mat>
withAttributes(Attributes attr)
Replace the attributes of thisSink
with the given ones.
-
-
-
Method Detail
-
fold
public static <U,In> Sink<In,java.util.concurrent.CompletionStage<U>> fold(U zero, Function2<U,In,U> f)
ASink
that will invoke the given function for every received element, giving it its previous output (or the givenzero
value) and the element as input. The returnedCompletionStage
will be completed with value of the final function evaluation when the input stream ends, or completed withFailure
if there is a failure is signaled in the stream.
-
foldAsync
public static <U,In> Sink<In,java.util.concurrent.CompletionStage<U>> foldAsync(U zero, Function2<U,In,java.util.concurrent.CompletionStage<U>> f)
ASink
that will invoke the given asynchronous function for every received element, giving it its previous output (or the givenzero
value) and the element as input. The returnedCompletionStage
will be completed with value of the final function evaluation when the input stream ends, or completed withFailure
if there is a failure is signaled in the stream.
-
collect
public static <U,In> Sink<In,java.util.concurrent.CompletionStage<U>> collect(java.util.stream.Collector<In,?,U> collector)
Creates a sink which materializes into aCompletionStage
which will be completed with a result of the Java
Collector
transformation and reduction operations. This allows usage of Java streams transformations for reactive streams. The
Collector
will trigger demand downstream. Elements emitted through the stream will be accumulated into a mutable result container, optionally transformed into a final representation after all input elements have been processed. The
Collector
can also do reduction at the end. Reduction processing is performed sequentially.
-
reduce
public static <In> Sink<In,java.util.concurrent.CompletionStage<In>> reduce(Function2<In,In,In> f)
ASink
that will invoke the given function for every received element, giving it its previous output (from the second element) and the element as input. The returnedCompletionStage
will be completed with value of the final function evaluation when the input stream ends, or completed withFailure
if there is a failure signaled in the stream.If the stream is empty (i.e. completes before signalling any elements), the reduce operator will fail its downstream with a
NoSuchElementException
, which is semantically in-line with that Scala's standard library collections do in such situations.
-
fromSubscriber
public static <In> Sink<In,NotUsed> fromSubscriber(org.reactivestreams.Subscriber<In> subs)
Helper to createSink
fromSubscriber
.
-
cancelled
public static <T> Sink<T,NotUsed> cancelled()
ASink
that immediately cancels its upstream after materialization.
-
ignore
public static <T> Sink<T,java.util.concurrent.CompletionStage<Done>> ignore()
ASink
that will consume the stream and discard the elements.
-
never
public static <T> Sink<T,java.util.concurrent.CompletionStage<Done>> never()
ASink
that will always backpressure never cancel and never consume any elements from the stream.
-
asPublisher
public static <T> Sink<T,org.reactivestreams.Publisher<T>> asPublisher(AsPublisher fanout)
ASink
that materializes into aPublisher
.If
fanout
istrue
, the materializedPublisher
will support multipleSubscriber
s and the size of theinputBuffer
configured for this operator becomes the maximum number of elements that the fastestSubscriber
can be ahead of the slowest one before slowing the processing down due to back pressure.If
fanout
isfalse
then the materializedPublisher
will only support a singleSubscriber
and reject any additionalSubscriber
s.
-
foreach
public static <T> Sink<T,java.util.concurrent.CompletionStage<Done>> foreach(Procedure<T> f)
ASink
that will invoke the given procedure for each received element. The sink is materialized into aCompletionStage
which will be completed withSuccess
when reaching the normal end of the stream, or completed withFailure
if there is a failure signaled in the stream.
-
foreachAsync
public static <T> Sink<T,java.util.concurrent.CompletionStage<Done>> foreachAsync(int parallelism, Function<T,java.util.concurrent.CompletionStage<java.lang.Void>> f)
ASink
that will invoke the given procedure asynchronously for each received element. The sink is materialized into aCompletionStage
which will be completed withSuccess
when reaching the normal end of the stream, or completed withFailure
if there is a failure signaled in the stream.
-
foreachParallel
public static <T> Sink<T,java.util.concurrent.CompletionStage<Done>> foreachParallel(int parallel, Procedure<T> f, scala.concurrent.ExecutionContext ec)
Deprecated.Use `foreachAsync` instead, it allows you to choose how to run the procedure, by calling some other API returning a CompletionStage or using CompletableFuture.supplyAsync. Since 2.5.17.ASink
that will invoke the given procedure for each received element in parallel. The sink is materialized into aCompletionStage
.If
f
throws an exception and the supervision decision isakka.stream.Supervision.Stop
theCompletionStage
will be completed with failure.If
f
throws an exception and the supervision decision isakka.stream.Supervision.Resume
orakka.stream.Supervision.Restart
the element is dropped and the stream continues.
-
onComplete
public static <In> Sink<In,NotUsed> onComplete(Procedure<scala.util.Try<Done>> callback)
ASink
that when the flow is completed, either through a failure or normal completion, apply the provided function withSuccess
orFailure
.
-
head
public static <In> Sink<In,java.util.concurrent.CompletionStage<In>> head()
ASink
that materializes into aCompletionStage
of the first value received. If the stream completes before signaling at least a single element, the CompletionStage will be failed with aNoSuchElementException
. If the stream signals an error before signaling at least a single element, the CompletionStage will be failed with the streams exception.See also
<In>headOption()
.
-
headOption
public static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.Optional<In>>> headOption()
ASink
that materializes into aCompletionStage
of the optional first value received. If the stream completes before signaling at least a single element, the value of the CompletionStage will be an emptyOptional
. If the stream signals an error errors before signaling at least a single element, the CompletionStage will be failed with the streams exception.See also
<In>head()
.
-
last
public static <In> Sink<In,java.util.concurrent.CompletionStage<In>> last()
ASink
that materializes into aCompletionStage
of the last value received. If the stream completes before signaling at least a single element, the CompletionStage will be failed with aNoSuchElementException
. If the stream signals an error errors before signaling at least a single element, the CompletionStage will be failed with the streams exception.See also
<In>lastOption()
,<In>takeLast(int)
.
-
lastOption
public static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.Optional<In>>> lastOption()
ASink
that materializes into aCompletionStage
of the optional last value received. If the stream completes before signaling at least a single element, the value of the CompletionStage will be an emptyOptional
. If the stream signals an error errors before signaling at least a single element, the CompletionStage will be failed with the streams exception.See also
<In>head()
,<In>takeLast(int)
.
-
takeLast
public static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.List<In>>> takeLast(int n)
ASink
that materializes into a aCompletionStage
ofList
containing the lastn
collected elements.If the stream completes before signaling at least n elements, the
CompletionStage
will complete with all elements seen so far. If the stream never completes theCompletionStage
will never complete. If there is a failure signaled in the stream theCompletionStage
will be completed with failure.
-
seq
public static <In> Sink<In,java.util.concurrent.CompletionStage<java.util.List<In>>> seq()
ASink
that keeps on collecting incoming elements until upstream terminates. As upstream may be unbounded,Flow[T].take
or the stricterFlow[T].limit
(and their variants) may be used to ensure boundedness. Materializes into aCompletionStage
ofSeq[T]
containing all the collected elements.List
is limited toInteger.MAX_VALUE
elements, this Sink will cancel the stream after having received that many elements.See also
Flow.limit
,Flow.limitWeighted
,Flow.take
,Flow.takeWithin
,Flow.takeWhile
-
actorRef
public static <In> Sink<In,NotUsed> actorRef(ActorRef ref, java.lang.Object onCompleteMessage)
Sends the elements of the stream to the givenActorRef
. If the target actor terminates the stream will be canceled. When the stream is completed successfully the givenonCompleteMessage
will be sent to the destination actor. When the stream is completed with failure aStatus.Failure
message will be sent to the destination actor.It will request at most
maxInputBufferSize
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 zeromailbox-push-timeout-time
or use a rate limiting operator in front of thisSink
.
-
actorRefWithBackpressure
public static <In> Sink<In,NotUsed> actorRefWithBackpressure(ActorRef ref, java.lang.Object onInitMessage, java.lang.Object ackMessage, java.lang.Object onCompleteMessage, Function<java.lang.Throwable,java.lang.Object> onFailureMessage)
Sends the elements of the stream to the givenActorRef
that sends back back-pressure signal. First element is alwaysonInitMessage
, then stream is waiting for acknowledgement messageackMessage
from the given actor which means that it is ready to process elements. It also requiresackMessage
message after each stream element to make backpressure work.If the target actor terminates the stream will be canceled. When the stream is completed successfully the given
onCompleteMessage
will be sent to the destination actor. When the stream is completed with failure - result ofonFailureMessage(throwable)
message will be sent to the destination actor.
-
actorRefWithBackpressure
public static <In> Sink<In,NotUsed> actorRefWithBackpressure(ActorRef ref, java.lang.Object onInitMessage, java.lang.Object onCompleteMessage, Function<java.lang.Throwable,java.lang.Object> onFailureMessage)
Sends the elements of the stream to the givenActorRef
that sends back back-pressure signal. First element is alwaysonInitMessage
, then stream is waiting for acknowledgement message from the given actor which means that it is ready to process elements. It also requires an ack message after each stream element to make backpressure work. This variant will consider any message as ack message.If the target actor terminates the stream will be canceled. When the stream is completed successfully the given
onCompleteMessage
will be sent to the destination actor. When the stream is completed with failure - result ofonFailureMessage(throwable)
message will be sent to the destination actor.
-
actorRefWithAck
public static <In> Sink<In,NotUsed> actorRefWithAck(ActorRef ref, java.lang.Object onInitMessage, java.lang.Object ackMessage, java.lang.Object onCompleteMessage, Function<java.lang.Throwable,java.lang.Object> onFailureMessage)
Deprecated.Use actorRefWithBackpressure insteadSends the elements of the stream to the givenActorRef
that sends back back-pressure signal. First element is alwaysonInitMessage
, then stream is waiting for acknowledgement messageackMessage
from the given actor which means that it is ready to process elements. It also requiresackMessage
message after each stream element to make backpressure work.If the target actor terminates the stream will be canceled. When the stream is completed successfully the given
onCompleteMessage
will be sent to the destination actor. When the stream is completed with failure - result ofonFailureMessage(throwable)
message will be sent to the destination actor.
-
fromGraph
public static <T,M> Sink<T,M> fromGraph(Graph<SinkShape<T>,M> g)
A graph with the shape of a sink logically is a sink, this method makes it so also in type.
-
fromMaterializer
public static <T,M> Sink<T,java.util.concurrent.CompletionStage<M>> fromMaterializer(java.util.function.BiFunction<Materializer,Attributes,Sink<T,M>> factory)
-
setup
public static <T,M> Sink<T,java.util.concurrent.CompletionStage<M>> setup(java.util.function.BiFunction<ActorMaterializer,Attributes,Sink<T,M>> factory)
Deprecated.Use 'fromMaterializer' instead. Since 2.6.0.
-
combine
public static <T,U> Sink<T,NotUsed> combine(Sink<U,?> output1, Sink<U,?> output2, java.util.List<Sink<U,?>> rest, Function<java.lang.Integer,Graph<UniformFanOutShape<T,U>,NotUsed>> fanOutStrategy)
Combine several sinks with fan-out strategy likeBroadcast
orBalance
and returnsSink
.
-
combineMat
public static <T,U,M1,M2,M> Sink<T,M> combineMat(Sink<U,M1> first, Sink<U,M2> second, Function<java.lang.Integer,Graph<UniformFanOutShape<T,U>,NotUsed>> fanOutStrategy, Function2<M1,M2,M> matF)
Combine two sinks with fan-out strategy likeBroadcast
orBalance
and returnsSink
with 2 outlets.
-
combine
public static <T,U,M> Sink<T,java.util.List<M>> combine(java.util.List<? extends Graph<SinkShape<U>,M>> sinks, Function<java.lang.Integer,Graph<UniformFanOutShape<T,U>,NotUsed>> fanOutStrategy)
Combine several sinks with fan-out strategy likeBroadcast
orBalance
and returnsSink
. The fanoutGraph's outlets size must match the provides sinks'.
-
queue
public static <T> Sink<T,SinkQueueWithCancel<T>> queue(int maxConcurrentPulls)
Creates aSink
that is materialized as anSinkQueueWithCancel
.akka.stream.javadsl.SinkQueueWithCancel.pull
method is pulling element from the stream and returnsCompletionStage[Option[T}
.
CompletionStage
completes when element is available.Before calling pull method second time you need to ensure that number of pending pulls is less then
maxConcurrentPulls
or wait until some of the previous Futures completes. Pull returns Failed future with ''IllegalStateException'' if there will be more then
maxConcurrentPulls
number of pending pulls.
Sink
will request at most number of elements equal to size ofinputBuffer
from upstream and then stop back pressure. You can configure size of input buffer by usingSink.withAttributes
method.For stream completion you need to pull all elements from
SinkQueueWithCancel
including last None as completion marker- See Also:
SinkQueueWithCancel
-
queue
public static <T> Sink<T,SinkQueueWithCancel<T>> queue()
Creates aSink
that is materialized as anSinkQueueWithCancel
.akka.stream.javadsl.SinkQueueWithCancel.pull
method is pulling element from the stream and returnsCompletionStage[Option[T}
.
CompletionStage
completes when element is available.Before calling pull method second time you need to wait until previous CompletionStage completes. Pull returns Failed future with ''IllegalStateException'' if previous future has not yet completed.
Sink
will request at most number of elements equal to size ofinputBuffer
from upstream and then stop back pressure. You can configure size of input buffer by usingSink.withAttributes
method.For stream completion you need to pull all elements from
SinkQueueWithCancel
including last None as completion marker- See Also:
SinkQueueWithCancel
-
lazyInit
public static <T,M> Sink<T,java.util.concurrent.CompletionStage<M>> lazyInit(Function<T,java.util.concurrent.CompletionStage<Sink<T,M>>> sinkFactory, Creator<M> fallback)
Deprecated.Use 'Sink.lazyCompletionStageSink' in combination with 'Flow.prefixAndTail(1)' instead. Since 2.6.0.Creates a realSink
upon receiving the first element. InternalSink
will not be created if there are no elements, because of completion or error.If upstream completes before an element was received then the
Future
is completed with the value created by fallback. If upstream fails before an element was received,sinkFactory
throws an exception, or materialization of the internal sink fails then theFuture
is completed with the exception. Otherwise theFuture
is completed with the materialized value of the internal sink.
-
lazyInitAsync
public static <T,M> Sink<T,java.util.concurrent.CompletionStage<java.util.Optional<M>>> lazyInitAsync(Creator<java.util.concurrent.CompletionStage<Sink<T,M>>> sinkFactory)
Deprecated.Use 'Sink.lazyCompletionStageSink' instead. Since 2.6.0.Creates a realSink
upon receiving the first element. InternalSink
will not be created if there are no elements, because of completion or error.If upstream completes before an element was received then the
Future
is completed withNone
. If upstream fails before an element was received,sinkFactory
throws an exception, or materialization of the internal sink fails then theFuture
is completed with the exception. Otherwise theFuture
is completed with the materialized value of the internal sink.
-
completionStageSink
public static <T,M> Sink<T,java.util.concurrent.CompletionStage<M>> completionStageSink(java.util.concurrent.CompletionStage<Sink<T,M>> future)
Turn aFuture[Sink]
into a Sink that will consume the values of the source when the future completes successfully. If theFuture
is completed with a failure the stream is failed.The materialized future value is completed with the materialized value of the future sink or failed with a
NeverMaterializedException
if upstream fails or downstream cancels before the future has completed.
-
lazySink
public static <T,M> Sink<T,java.util.concurrent.CompletionStage<M>> lazySink(Creator<Sink<T,M>> create)
Defers invoking thecreate
function to create a sink until there is a first element passed from upstream.The materialized future value is completed with the materialized value of the created sink when that has successfully been materialized.
If the
create
function throws or returns or the stream fails to materialize, in this case the materialized future value is failed with aNeverMaterializedException
.
-
lazyCompletionStageSink
public static <T,M> Sink<T,java.util.concurrent.CompletionStage<M>> lazyCompletionStageSink(Creator<java.util.concurrent.CompletionStage<Sink<T,M>>> create)
Defers invoking thecreate
function to create a future sink until there is a first element passed from upstream.The materialized future value is completed with the materialized value of the created sink when that has successfully been materialized.
If the
create
function throws or returns a future that is failed, or the stream fails to materialize, in this case the materialized future value is failed with aNeverMaterializedException
.
-
shape
public SinkShape<In> shape()
Description copied from interface:Graph
The shape of a graph is all that is externally visible: its inlets and outlets.
-
traversalBuilder
public akka.stream.impl.LinearTraversalBuilder traversalBuilder()
Description copied from interface:Graph
INTERNAL API.Every materializable element must be backed by a stream layout module
- Specified by:
traversalBuilder
in interfaceGraph<In,Mat>
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
runWith
public <M> M runWith(Graph<SourceShape<In>,M> source, ClassicActorSystemProvider systemProvider)
Connect thisSink
to aSource
and run it.Note that the
ActorSystem
can be used as thesystemProvider
parameter.
-
runWith
public <M> M runWith(Graph<SourceShape<In>,M> source, Materializer materializer)
Connect thisSink
to aSource
and run it.
-
mapMaterializedValue
public <Mat2> Sink<In,Mat2> mapMaterializedValue(Function<Mat,Mat2> f)
Transform only the materialized value of this Sink, leaving all other properties as they were.
-
preMaterialize
public Pair<Mat,Sink<In,NotUsed>> preMaterialize(ClassicActorSystemProvider systemProvider)
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.
Note that the
ActorSystem
can be used as thesystemProvider
parameter.
-
preMaterialize
public Pair<Mat,Sink<In,NotUsed>> preMaterialize(Materializer materializer)
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.
Prefer the method taking an ActorSystem unless you have special requirements.
-
withAttributes
public Sink<In,Mat> withAttributes(Attributes attr)
Replace the attributes of thisSink
with the given ones. If this Sink is a composite of multiple graphs, new attributes on the composite will be less specific than attributes set directly on the individual graphs of the composite.- Specified by:
withAttributes
in interfaceGraph<In,Mat>
-
addAttributes
public Sink<In,Mat> addAttributes(Attributes attr)
Add the given attributes to thisSink
. If the specific attribute was already present on this graph this means the added attribute will be more specific than the existing one. If this Sink is a composite of multiple graphs, new attributes on the composite will be less specific than attributes set directly on the individual graphs of the composite.- Specified by:
addAttributes
in interfaceGraph<In,Mat>
-
async
public Sink<In,Mat> async(java.lang.String dispatcher)
Put an asynchronous boundary around thisSink
-
async
public Sink<In,Mat> async(java.lang.String dispatcher, int inputBufferSize)
Put an asynchronous boundary around thisSink
-
getAttributes
public Attributes getAttributes()
- Specified by:
getAttributes
in interfaceGraph<In,Mat>
-
-