io.smallrye.mutiny.groups

Class MultiOnItem<T>

java.lang.Object

io.smallrye.mutiny.groups.MultiOnItem<T>

public class MultiOnItem<T>
extends Object

Constructor Summary

Constructors

Constructor and Description
MultiOnItem(Multi<T> upstream)

Method Summary

Modifier and Type	Method and Description
<R> Multi<R>	apply(Function<? super T,? extends R> mapper) Produces a new Multi invoking the given function for each item emitted by the upstream Multi.
<O> Multi<O>	castTo(Class<O> target) Produces an Multi emitting the item events based on the upstream events but casted to the target class.
<O> Multi<O>	disjoint() Takes the items from the upstream Multi that are either Publisher<O>, O[], Iterable<O> or Multi<O> and disjoint the items to obtain a Multi<O>.
Multi<Void>	ignore() Ignores the passed items.
Uni<Void>	ignoreAsUni() Ignores the passed items.
Multi<T>	invoke(Consumer<T> callback) Produces a new Multi invoking the given callback when an item event is fired by the upstrea.
Multi<T>	invokeUni(Function<? super T,? extends Uni<?>> action) Produces a new Multi invoking the given @{code action} when an item event is received.
<O> MultiFlatten<T,O>	produceCompletionStage(Function<? super T,? extends CompletionStage<? extends O>> mapper) Configures the mapper of the flatMap operation.
<O> MultiFlatten<T,O>	produceIterable(Function<? super T,? extends Iterable<? extends O>> mapper) Configures the mapper of the flatMap operation.
<O> MultiFlatten<T,O>	produceMulti(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper) Configures the mapper of the flatMap operation.
<O> MultiFlatten<T,O>	producePublisher(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper) Configures the mapper of the flatMap operation.
<O> MultiFlatten<T,O>	produceUni(Function<? super T,? extends Uni<? extends O>> mapper) Configures the mapper of the flatMap operation.
Multi<T>	scan(BinaryOperator<T> accumulator) Produces a Multi that fires results coming from the reduction of the item emitted by this current Multi by the passed accumulator reduction function.
<S> Multi<S>	scan(Supplier<S> initialStateProducer, BiFunction<S,? super T,S> accumulator) Produces a Multi that fires items coming from the reduction of the item emitted by this current Multi by the passed accumulator reduction function.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MultiOnItem

public MultiOnItem(Multi<T> upstream)

Method Detail

apply

public <R> Multi<R> apply(Function<? super T,? extends R> mapper)

Produces a new Multi invoking the given function for each item emitted by the upstream Multi.

The function receives the received item as parameter, and can transform it. The returned object is sent downstream as item event.

Type Parameters:

R - the type of item produced by the mapper function

Parameters:

mapper - the mapper function, must not be null

Returns:

the new Multi

invoke

public Multi<T> invoke(Consumer<T> callback)

Produces a new Multi invoking the given callback when an item event is fired by the upstrea.

Parameters:

callback - the callback, must not be null

Returns:

the new Uni

invokeUni

public Multi<T> invokeUni(Function<? super T,? extends Uni<?>> action)

Produces a new Multi invoking the given @{code action} when an item event is received. Note that the received item cannot be null.

Unlike invoke(Consumer), the passed function returns a Uni. When the produced Uni sends its result, the result is discarded, and the original item is forwarded downstream. If the produced Uni fails, the failure is propagated downstream. If the asynchronous action throws an exception, this exception is propagated downstream. This method preserves the order of the items, meaning that the downstream received the items in the same order as the upstream has emitted them.

Parameters:

action - the function taking the item and returning a Uni, must not be null

Returns:

the new Multi

disjoint

public <O> Multi<O> disjoint()

Takes the items from the upstream Multi that are either Publisher<O>, O[], Iterable<O> or Multi<O> and disjoint the items to obtain a Multi<O>.

For example, Multi<[A, B, C], [D, E, F] is transformed into Multi<A, B, C, D, E, F>.

If the items from upstream are not instances of Iterable, Publisher or array, an IllegalArgumentException is propagated downstream.

Type Parameters:

O - the type items contained in the upstream's items.

Returns:

the resulting multi

produceMulti

public <O> MultiFlatten<T,O> produceMulti(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper)

Configures the mapper of the flatMap operation. The mapper returns a multi and is called for each item emitted by the upstream Multi.

Type Parameters:

O - the type of item emitted by the Multi produced by the mapper.

Parameters:

mapper - the mapper, must not be null, must not produce null

Returns:

the object to configure the flatten behavior.

producePublisher

public <O> MultiFlatten<T,O> producePublisher(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper)

Configures the mapper of the flatMap operation. The mapper returns a publisher and is called for each item emitted by the upstream Multi.

Type Parameters:

O - the type of item emitted by the Publisher produced by the mapper.

Parameters:

mapper - the mapper, must not be null, must not produce null

Returns:

the object to configure the flatten behavior.

produceIterable

public <O> MultiFlatten<T,O> produceIterable(Function<? super T,? extends Iterable<? extends O>> mapper)

Configures the mapper of the flatMap operation. The mapper returns a iterable and is called for each item emitted by the upstream Multi.

Type Parameters:

O - the type of item contained by the Iterable produced by the mapper.

Parameters:

mapper - the mapper, must not be null, must not produce null

Returns:

the object to configure the flatten behavior.

produceUni

public <O> MultiFlatten<T,O> produceUni(Function<? super T,? extends Uni<? extends O>> mapper)

Configures the mapper of the flatMap operation. The mapper returns a uni and is called for each item emitted by the upstream Multi.

Type Parameters:

O - the type of item emitted by the Uni produced by the mapper.

Parameters:

mapper - the mapper, must not be null, must not produce null

Returns:

the object to configure the flatten behavior.

produceCompletionStage

public <O> MultiFlatten<T,O> produceCompletionStage(Function<? super T,? extends CompletionStage<? extends O>> mapper)

Configures the mapper of the flatMap operation. The mapper returns a CompletionStage and is called for each item emitted by the upstream Multi.

Type Parameters:

O - the type of item emitted by the CompletionStage produced by the mapper.

Parameters:

mapper - the mapper, must not be null, must not produce null

Returns:

the object to configure the flatten behavior.

ignore

public Multi<Void> ignore()

Ignores the passed items. The resulting Multi will only be notified when the stream completes or fails.

Returns:

the new multi

ignoreAsUni

public Uni<Void> ignoreAsUni()

Ignores the passed items. The resulting Uni will only be completed with null when the stream completes or with a failure if the upstream emits a failure..

Returns:

the new multi

castTo

public <O> Multi<O> castTo(Class<O> target)

Produces an Multi emitting the item events based on the upstream events but casted to the target class.

Type Parameters:

O - the type of item emitted by the produced uni

Parameters:

target - the target class

Returns:

the new Uni

scan

public <S> Multi<S> scan(Supplier<S> initialStateProducer,
                         BiFunction<S,? super T,S> accumulator)

Produces a Multi that fires items coming from the reduction of the item emitted by this current Multi by the passed accumulator reduction function. The produced multi emits the intermediate results.

Unlike scan(BinaryOperator), this operator uses the value produced by the initialStateProducer as first value.

Type Parameters:

S - the type of item emitted by the produced Multi. It's the type returned by the accumulator operation.

Parameters:

initialStateProducer - the producer called to provides the initial value passed to the accumulator operation.

accumulator - the reduction BiFunction, the resulting Multi emits the results of this method. The method is called for every item emitted by this Multi.

Returns:

the produced Multi

scan

public Multi<T> scan(BinaryOperator<T> accumulator)

Produces a Multi that fires results coming from the reduction of the item emitted by this current Multi by the passed accumulator reduction function. The produced multi emits the intermediate results.

Unlike scan(Supplier, BiFunction), this operator doesn't take an initial value but takes the first item emitted by this Multi as initial value.

Parameters:

accumulator - the reduction BiFunction, the resulting Multi emits the results of this method. The method is called for every item emitted by this Multi.

Returns:

the produced Multi