io.smallrye.mutiny.groups

Class UniRepeat<T>

java.lang.Object

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

Type Parameters:

T - the type of item

public class UniRepeat<T>
extends Object

Repeatedly subscribes to a given Uni to generate a Multi.

Constructor Summary

Constructors

Constructor and Description
UniRepeat(Uni<T> upstream)

Method Summary

Modifier and Type	Method and Description
Multi<T>	atMost(long times) Generates a stream, containing the items from the upstream Uni, resubscribed at most times times.
Multi<T>	indefinitely() Generates an unbounded stream, indefinitely resubscribing to the Uni.
Multi<T>	until(Predicate<T> predicate) Generates a stream, containing the items from the upstream Uni, resubscribed until the given predicate returns true.

Methods inherited from class java.lang.Object

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

Constructor Detail

UniRepeat

public UniRepeat(Uni<T> upstream)

Method Detail

indefinitely

public Multi<T> indefinitely()

Generates an unbounded stream, indefinitely resubscribing to the Uni. Note that this enforces:

• the number of requests coming from the subscriber
• cancellation
• failures, that are propagated downstream

The produced Multi contains the items emitted by the upstream Uni. After every emission, another subscription is performed on the Uni, and the item is then propagated. If the Uni fires a failure, the failure is propagated. If the Uni fires an empty items, it resubscribes.

Returns:

the Multi containing the items from the upstream Uni, resubscribed indefinitely.

atMost

public Multi<T> atMost(long times)

Generates a stream, containing the items from the upstream Uni, resubscribed at most times times.

Note that this enforces:

• the number of requests coming from the subscriber
• cancellation
• failures, that are propagated downstream

The produced Multi contains the items emitted by the upstream Uni. After every emission, another subscription is performed on the Uni, and the item is then propagated. If the Uni fires a failure, the failure is propagated. If the Uni fires an empty items, it resubscribes.

This method is named atMost because the repeating re-subscription can be stopped if the subscriber cancels its subscription to the produced Multi.

Parameters:

times - the number of re-subscription, must be strictly positive, 1 is equivalent to Uni.toMulti()

Returns:

the Multi containing the items from the upstream Uni, resubscribed at most times times.

until

public Multi<T> until(Predicate<T> predicate)

Generates a stream, containing the items from the upstream Uni, resubscribed until the given predicate returns true. The predicate is not called on null item. If you want to intercept this case, use a sentinel item.

Parameters:

predicate - the predicate, must not be null

Returns:

the Multi containing the items from the upstream Uni, resubscribed until the predicate returns true.