io.smallrye.mutiny.groups

Class UniOnItemOrFailure<T>

java.lang.Object

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

public class UniOnItemOrFailure<T>
extends Object

Constructor Summary

Constructors

Constructor and Description
UniOnItemOrFailure(Uni<T> upstream)

Method Summary

Modifier and Type	Method and Description
<R> Uni<R>	apply(BiFunction<? super T,Throwable,? extends R> mapper) Deprecated. use transform(BiFunction)
Uni<T>	invoke(BiConsumer<? super T,Throwable> callback) Produces a new Uni invoking the given callback when the item or failure event is fired.
Uni<T>	invokeUni(BiFunction<? super T,Throwable,? extends Uni<?>> callback) Produces a new Uni invoking the given callback when the item or failure event is fired.
<R> Uni<R>	produceUni(BiFunction<? super T,Throwable,? extends Uni<? extends R>> mapper) Deprecated. Use transformToUni(BiFunction) instead
<R> Uni<R>	produceUni(Functions.TriConsumer<? super T,Throwable,UniEmitter<? super R>> consumer) Deprecated. Use transformToUni(Functions.TriConsumer) instead
<R> Uni<R>	transform(BiFunction<? super T,Throwable,? extends R> mapper) Produces a new Uni invoking the given function when the current Uni fires the item or failure event.
<R> Uni<R>	transformToUni(BiFunction<? super T,Throwable,? extends Uni<? extends R>> mapper) Transforms the received item or failure asynchronously, forwarding the events emitted by another Uni produced by the given mapper.
<R> Uni<R>	transformToUni(Functions.TriConsumer<? super T,Throwable,UniEmitter<? super R>> consumer) Transforms the received item or failure asynchronously, forwarding the events emitted by the UniEmitter provided to the given consumer.

Methods inherited from class java.lang.Object

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

Constructor Detail

UniOnItemOrFailure

public UniOnItemOrFailure(Uni<T> upstream)

Method Detail

invoke

public Uni<T> invoke(BiConsumer<? super T,Throwable> callback)

Produces a new Uni invoking the given callback when the item or failure event is fired. Note that the item can be null, so detecting failures must be done by checking whether the failure parameter is null.

Parameters:

callback - the callback, must not be null

Returns:

the new Uni

invokeUni

public Uni<T> invokeUni(BiFunction<? super T,Throwable,? extends Uni<?>> callback)

Produces a new Uni invoking the given callback when the item or failure event is fired. Note that the item can be null, so detecting failures must be done by checking whether the failure parameter is null.

Parameters:

callback - the callback, must not be null

Returns:

the new Uni

apply

@Deprecated
public <R> Uni<R> apply(BiFunction<? super T,Throwable,? extends R> mapper)

Deprecated. use transform(BiFunction)

Produces a new Uni invoking the given function when the current Uni fires the item or failure event. Note that the item can be null, so detecting failures must be done by checking whether the failure parameter is null.

The function receives the item and failure as parameters, and can transform the item or recover from the failure. The returned object is sent downstream as item.

For asynchronous composition, see transformToUni(BiFunction).

Type Parameters:

R - the type of Uni item

Parameters:

mapper - the mapper function, must not be null

Returns:

the new Uni

transform

public <R> Uni<R> transform(BiFunction<? super T,Throwable,? extends R> mapper)

Produces a new Uni invoking the given function when the current Uni fires the item or failure event. Note that the item can be null, so detecting failures must be done by checking whether the failure parameter is null.

The function receives the item and failure as parameters, and can transform the item or recover from the failure. The returned object is sent downstream as item.

For asynchronous composition, see transformToUni(BiFunction).

Type Parameters:

R - the type of Uni item

Parameters:

mapper - the mapper function, must not be null

Returns:

the new Uni

transformToUni

public <R> Uni<R> transformToUni(BiFunction<? super T,Throwable,? extends Uni<? extends R>> mapper)

Transforms the received item or failure asynchronously, forwarding the events emitted by another Uni produced by the given mapper.

Note that the item can be null, so detecting failures must be done by checking whether the failure parameter is null.

The mapper is called with the item produced by the upstream or the propagated failure. It produces an Uni, possibly using another type of item (R). It can be used to recover from a failure. The events fired by the produced Uni are forwarded to the Uni returned by this method.

This operation is generally named flatMap.

Type Parameters:

R - the type of item

Parameters:

mapper - the function called with the item and failure sent by the upstream Uni to produce another Uni, must not be null, must not return null.

Returns:

a new Uni that would fire events from the uni produced by the mapper function, possibly in an asynchronous manner.

produceUni

@Deprecated
public <R> Uni<R> produceUni(BiFunction<? super T,Throwable,? extends Uni<? extends R>> mapper)

Deprecated. Use transformToUni(BiFunction) instead

Transforms the received item or failure asynchronously, forwarding the events emitted by another Uni produced by the given mapper.

Note that the item can be null, so detecting failures must be done by checking whether the failure parameter is null.

The mapper is called with the item produced by the upstream or the propagated failure. It produces an Uni, possibly using another type of item (R). It can be used to recover from a failure. The events fired by the produced Uni are forwarded to the Uni returned by this method.

This operation is generally named flatMap.

Type Parameters:

R - the type of item

Parameters:

mapper - the function called with the item and failure sent by the upstream Uni to produce another Uni, must not be null, must not return null.

Returns:

a new Uni that would fire events from the uni produced by the mapper function, possibly in an asynchronous manner.

transformToUni

public <R> Uni<R> transformToUni(Functions.TriConsumer<? super T,Throwable,UniEmitter<? super R>> consumer)

Transforms the received item or failure asynchronously, forwarding the events emitted by the UniEmitter provided to the given consumer.

The consumer is called with the item event or failure event emitted by the current Uni and an emitter used to fire events downstream.

As the item received from upstream can be null, detecting a failure must be done by checking whether the failure passed to the consumer is null.

Type Parameters:

R - the type of item emitted by the emitter

Parameters:

consumer - the function called with the item of the this Uni and an UniEmitter. It must not be null.

Returns:

a new Uni that would fire events from the emitter consumed by the mapper function, possibly in an asynchronous manner.

produceUni

@Deprecated
public <R> Uni<R> produceUni(Functions.TriConsumer<? super T,Throwable,UniEmitter<? super R>> consumer)

Deprecated. Use transformToUni(Functions.TriConsumer) instead

Transforms the received item or failure asynchronously, forwarding the events emitted by the UniEmitter provided to the given consumer.

The consumer is called with the item event or failure event emitted by the current Uni and an emitter used to fire events downstream.

As the item received from upstream can be null, detecting a failure must be done by checking whether the failure passed to the consumer is null.

Type Parameters:

R - the type of item emitted by the emitter

Parameters:

consumer - the function called with the item of the this Uni and an UniEmitter. It must not be null.

Returns:

a new Uni that would fire events from the emitter consumed by the mapper function, possibly in an asynchronous manner.