Package io.smallrye.mutiny.operators.multi.multicast

Class ConnectableMulti<T>

java.lang.Object

io.smallrye.mutiny.operators.AbstractMulti<T>

io.smallrye.mutiny.operators.multi.multicast.ConnectableMulti<T>

Type Parameters:

T - the type of item

All Implemented Interfaces:

Multi<T>, org.reactivestreams.Publisher<T>

Direct Known Subclasses:

MultiPublishOp

public abstract class ConnectableMulti<T>
extends AbstractMulti<T>

A ConnectableMulti is similar to a regular Multi, except that it does not begin emitting items (from upstream to downstream) when it is subscribed to, but only when its connect(io.smallrye.mutiny.operators.multi.multicast.ConnectableMultiConnection) method is called. This allows deferring the dispatching of events. For example, it can wait until a set number of subscribers have subscribed.

Field Summary

Fields

Modifier and Type	Field	Description
protected Multi<T>	upstream

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ConnectableMulti(Multi<T> upstream)

Method Summary

Modifier and Type	Method	Description
protected abstract void	connect(ConnectableMultiConnection connection)	Allows this ConnectableMulti to start emitting the items from its upstream Multi to its Subscribers.
Multi<T>	connectAfter(int numberOfSubscribers)	Returns a Multi that connect to the upstream as soon as the numberOfSubscribers subscribers subscribe.
Multi<T>	referenceCount()	Returns a Multi that stays connected to this ConnectableMulti as long as there is at least one active subscription.
Multi<T>	referenceCount(int count, java.time.Duration duration)	Connects to the upstream ConnectableMulti if the number of subscribers reaches the specified amount and disconnect after the specified duration after all subscribers have unsubscribed (cancelled their subscriptions).

Methods inherited from class io.smallrye.mutiny.operators.AbstractMulti

broadcast, cache, collect, convert, emitOn, group, on, onCancellation, onCompletion, onFailure, onFailure, onFailure, onItem, onOverflow, onRequest, onSubscribe, onTermination, runSubscriptionOn, select, skip, subscribe, subscribe, subscribe, toHotStream, toUni, transform

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.smallrye.mutiny.Multi

call, call, collectItems, concatMap, filter, flatMap, groupItems, invoke, invoke, invokeUni, map, plug, stage, then

Field Detail

upstream

protected final Multi<T> upstream

Constructor Detail

ConnectableMulti

protected ConnectableMulti(Multi<T> upstream)

Method Detail

connect

protected abstract void connect(ConnectableMultiConnection connection)

Allows this ConnectableMulti to start emitting the items from its upstream Multi to its Subscribers.

Parameters:

connection - the connection.

referenceCount

public Multi<T> referenceCount()

Returns a Multi that stays connected to this ConnectableMulti as long as there is at least one active subscription.

Returns:

a Multi

referenceCount

public Multi<T> referenceCount(int count,
                               java.time.Duration duration)

Connects to the upstream ConnectableMulti if the number of subscribers reaches the specified amount and disconnect after the specified duration after all subscribers have unsubscribed (cancelled their subscriptions).

Parameters:

count - the number of subscribers that trigger the emissions

duration - the duration, can be null, if set must be positive

Returns:

the new Multi instance

connectAfter

public Multi<T> connectAfter(int numberOfSubscribers)

Returns a Multi that connect to the upstream as soon as the numberOfSubscribers subscribers subscribe. The connection stays opens even if the subscribers cancelled the subscription. Other subscribers can subscribe, it would not re-subscribe to the upstream.

Parameters:

numberOfSubscribers - the number of subscribe to reach before subscribing to upstream.

Returns:

the multi