io.smallrye.mutiny.operators

Class UniSerializedSubscriber<T>

java.lang.Object

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

All Implemented Interfaces:

Cancellable, UniSubscriber<T>, UniSubscription, org.reactivestreams.Subscription

public class UniSerializedSubscriber<T>
extends Object
implements UniSubscriber<T>, UniSubscription

An implementation of UniSubscriber and UniSubscription making sure event handlers are only called once.

Method Summary

Modifier and Type	Method and Description
void	cancel() Requests the Uni to cancel and clean up resources.
boolean	isCancelledOrDone()
void	onFailure(Throwable failure) Called if the computation of the item by the subscriber Uni failed.
void	onItem(T item) Event handler called once the item has been computed by the subscribed Uni.
void	onSubscribe(UniSubscription subscription) Event handler called once the subscribed Uni has taken into account the subscription.
static <T> void	subscribe(AbstractUni<T> source, UniSubscriber<? super T> subscriber)

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.subscription.UniSubscription

request

Method Detail

subscribe

public static <T> void subscribe(AbstractUni<T> source,
                                 UniSubscriber<? super T> subscriber)

onSubscribe

public void onSubscribe(UniSubscription subscription)

Description copied from interface: UniSubscriber

Event handler called once the subscribed Uni has taken into account the subscription. The Uni have triggered the computation of the item. IMPORTANT: UniSubscriber.onItem(Object) and UniSubscriber.onFailure(Throwable) would not be called before the invocation of this method.

• Executor: Operate on no particular executor, except if Uni.runSubscriptionOn(Executor) has been called
• Exception: Throwing an exception cancels the subscription, UniSubscriber.onItem(Object) and UniSubscriber.onFailure(Throwable) won't be called

Specified by:

onSubscribe in interface UniSubscriber<T>

Parameters:

subscription - the subscription allowing to cancel the computation.

onItem

public void onItem(T item)

Description copied from interface: UniSubscriber

Event handler called once the item has been computed by the subscribed Uni. IMPORTANT: this method will be only called once per subscription. If UniSubscriber.onFailure(Throwable) is called, this method won't be called.

• Executor: Operate on no particular executor, except if Uni.emitOn(java.util.concurrent.Executor) has been called
• Exception: Throwing an exception cancels the subscription.

Specified by:

onItem in interface UniSubscriber<T>

Parameters:

item - the item, may be null.

onFailure

public void onFailure(Throwable failure)

Description copied from interface: UniSubscriber

Called if the computation of the item by the subscriber Uni failed. IMPORTANT: this method will be only called once per subscription. If UniSubscriber.onItem(Object) is called, this method won't be called.

• Executor: Operate on no particular executor, except if Uni.emitOn(java.util.concurrent.Executor) has been called
• Exception: Throwing an exception cancels the subscription.

Specified by:

onFailure in interface UniSubscriber<T>

Parameters:

failure - the failure, cannot be null.

cancel

public void cancel()

Description copied from interface: UniSubscription

Requests the Uni to cancel and clean up resources. If the item is retrieved after cancellation, it is not forwarded to the subscriber. If the cancellation happens after the delivery of the item, this call is ignored.

Calling this method, emits the cancellation event upstream.

Specified by:

cancel in interface Cancellable

Specified by:

cancel in interface UniSubscription

Specified by:

cancel in interface org.reactivestreams.Subscription

isCancelledOrDone

public boolean isCancelledOrDone()