Module io.smallrye.mutiny

Package io.smallrye.mutiny.operators.multi.processors

Class UnicastProcessor<T>

java.lang.Object

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

io.smallrye.mutiny.operators.multi.processors.UnicastProcessor<T>

Type Parameters:

T - the type of item

All Implemented Interfaces:

Multi<T>, java.util.concurrent.Flow.Processor<T,T>, java.util.concurrent.Flow.Publisher<T>, java.util.concurrent.Flow.Subscriber<T>, java.util.concurrent.Flow.Subscription

public class UnicastProcessor<T>
extends AbstractMulti<T>
implements java.util.concurrent.Flow.Processor<T,T>, java.util.concurrent.Flow.Subscription

Implementation of a processor using a queue to store items and allows a single subscriber to receive these items.

The back pressure model is not using the request protocol but the queue used to store the items. If the queue gets full, an BackPressureFailure exception is propagated downstream.

This processor must not be re-subscribed: it expects exactly 1 subscriber. If you expect multiple subscribers then you should look at creating a Multi from an emitter, see MultiCreate.emitter(Consumer, BackPressureStrategy).

Method Summary

Modifier and Type	Method	Description
void	cancel()
static <I> UnicastProcessor<I>	create()	Creates a new UnicastProcessor using a new unbounded queue.
static <I> UnicastProcessor<I>	create(java.util.Queue<I> queue, java.lang.Runnable onTermination)	Creates a new UnicastProcessor using the given queue.
boolean	hasSubscriber()	Checks whether there is a subscriber listening for the emitted events.
void	onComplete()
void	onError(java.lang.Throwable failure)
void	onNext(T t)
void	onSubscribe(java.util.concurrent.Flow.Subscription upstream)
void	request(long n)
SerializedProcessor<T,T>	serialized()
void	subscribe(MultiSubscriber<? super T> downstream)

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

broadcast, cache, capDemandsUsing, collect, convert, emitOn, group, ifNoItem, log, log, onCancellation, onCompletion, onFailure, onFailure, onFailure, onItem, onOverflow, onRequest, onSubscription, onTermination, paceDemand, runSubscriptionOn, select, skip, subscribe, subscribe, toHotStream, toUni, withContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.concurrent.Flow.Publisher

subscribe

Methods inherited from interface io.smallrye.mutiny.Multi

attachContext, call, call, capDemandsTo, concatMap, filter, flatMap, invoke, invoke, map, plug, split, stage

Method Detail

create

public static <I> UnicastProcessor<I> create()

Creates a new UnicastProcessor using a new unbounded queue.

Type Parameters:

I - the type of item

Returns:

the unicast processor

create

public static <I> UnicastProcessor<I> create(java.util.Queue<I> queue,
                                             java.lang.Runnable onTermination)

Creates a new UnicastProcessor using the given queue.

Type Parameters:

I - the type of item

Parameters:

queue - the queue, must not be null

onTermination - the termination callback, can be null

Returns:

the unicast processor

onSubscribe

public void onSubscribe(java.util.concurrent.Flow.Subscription upstream)

Specified by:

onSubscribe in interface java.util.concurrent.Flow.Subscriber<T>

subscribe

public void subscribe(MultiSubscriber<? super T> downstream)

Overrides:

subscribe in class AbstractMulti<T>

onNext

public void onNext(T t)

Specified by:

onNext in interface java.util.concurrent.Flow.Subscriber<T>

onError

public void onError(java.lang.Throwable failure)

Specified by:

onError in interface java.util.concurrent.Flow.Subscriber<T>

onComplete

public void onComplete()

Specified by:

onComplete in interface java.util.concurrent.Flow.Subscriber<T>

request

public void request(long n)

Specified by:

request in interface java.util.concurrent.Flow.Subscription

cancel

public void cancel()

Specified by:

cancel in interface java.util.concurrent.Flow.Subscription

hasSubscriber

public boolean hasSubscriber()

Checks whether there is a subscriber listening for the emitted events. Mostly for testing purpose.

Returns:

true if there is a subscriber, false otherwise

serialized

public SerializedProcessor<T,T> serialized()