io.smallrye.mutiny.groups

Class UniAwait<T>

java.lang.Object

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

Type Parameters:

T - the type of item

public class UniAwait<T>
extends Object

Waits and returns the item emitted by the Uni. If the Uni receives a failure, the failure is thrown.

This class lets you configure how to retrieves the item of a Uni by blocking the caller thread.

See Also:

Uni.await()

Constructor Summary

Constructors

Constructor and Description
UniAwait(Uni<T> upstream)

Method Summary

Modifier and Type	Method and Description
UniAwaitOptional<T>	asOptional() Indicates that you are awaiting for the item event of the attached Uni wrapped into an Optional.
T	atMost(Duration duration) Subscribes to the Uni and waits (blocking the caller thread) at most the given duration until an item or failure is fired by the upstream uni.
T	indefinitely() Subscribes to the Uni and waits (blocking the caller thread) indefinitely until a item event is fired or a failure event is fired by the upstream uni.

Methods inherited from class java.lang.Object

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

Constructor Detail

UniAwait

public UniAwait(Uni<T> upstream)

Method Detail

indefinitely

public T indefinitely()

Subscribes to the Uni and waits (blocking the caller thread) indefinitely until a item event is fired or a failure event is fired by the upstream uni.

If the Uni fires an item, it returns that item, potentially null if the operation returns null. If the Uni fires a failure, the original exception is thrown (wrapped in a CompletionException it's a checked exception).

Note that each call to this method triggers a new subscription.

Returns:

the item from the Uni, potentially null

atMost

public T atMost(Duration duration)

Subscribes to the Uni and waits (blocking the caller thread) at most the given duration until an item or failure is fired by the upstream uni.

If the Uni fires an item, it returns that item, potentially null if the operation returns null. If the Uni fires a failure, the original exception is thrown (wrapped in a CompletionException it's a checked exception). If the timeout is reached before completion, a TimeoutException is thrown.

Note that each call to this method triggers a new subscription.

Parameters:

duration - the duration, must not be null, must not be negative or zero.

Returns:

the item from the Uni, potentially null

asOptional

public UniAwaitOptional<T> asOptional()

Indicates that you are awaiting for the item event of the attached Uni wrapped into an Optional. So if the Uni fires null as item, you receive an empty Optional.

Returns:

the UniAwaitOptional configured to produce an Optional.