io.smallrye.mutiny.helpers

Class UniCallbackSubscriber<T>

java.lang.Object

io.smallrye.mutiny.helpers.UniCallbackSubscriber<T>

Type Parameters:

T - the type of item received by this subscriber

All Implemented Interfaces:

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

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

Implementation of a UniSubscriber based on callbacks. This implementation also implement UniSubscription to expose the cancel() method.

Constructor Summary

Constructors

Constructor and Description
UniCallbackSubscriber(Consumer<? super T> onResultCallback, Consumer<? super Throwable> onFailureCallback) Creates a UniSubscriber consuming the item and failure of a Uni.

Method Summary

Modifier and Type	Method and Description
void	cancel() Requests the Uni to cancel and clean up resources.
void	onFailure(Throwable t) Called if the computation of the item by the subscriber Uni failed.
void	onItem(T x) Event handler called once the item has been computed by the subscribed Uni.
void	onSubscribe(UniSubscription sub) Event handler called once the subscribed Uni has taken into account the subscription.

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

Constructor Detail

UniCallbackSubscriber

public UniCallbackSubscriber(Consumer<? super T> onResultCallback,
                             Consumer<? super Throwable> onFailureCallback)

Creates a UniSubscriber consuming the item and failure of a Uni.

Parameters:

onResultCallback - callback invoked on item event, must not be null

onFailureCallback - callback invoked on failure event, must not be null

Method Detail

onSubscribe

public final void onSubscribe(UniSubscription sub)

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:

sub - the subscription allowing to cancel the computation.

onFailure

public final void onFailure(Throwable t)

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:

t - the failure, cannot be null.

onItem

public final void onItem(T x)

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:

x - the item, may 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