Class AsyncSubscriber<T>

java.lang.Object

org.reactivestreams.example.unicast.AsyncSubscriber<T>

All Implemented Interfaces:

Runnable, Subscriber<T>

public abstract class AsyncSubscriber<T>
extends Object
implements Subscriber<T>, Runnable

AsyncSubscriber is an implementation of Reactive Streams `Subscriber`, it runs asynchronously (on an Executor), requests one element at a time, and invokes a user-defined method to process each element. NOTE: The code below uses a lot of try-catches to show the reader where exceptions can be expected, and where they are forbidden.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AsyncSubscriber(Executor executor)

Method Summary

Modifier and Type	Method	Description
final void	onComplete()	Successful terminal state.
final void	onError(Throwable t)	Failed terminal state.
final void	onNext(T element)	Data notification sent by the Publisher in response to requests to Subscription.request(long).
final void	onSubscribe(Subscription s)	Invoked after calling Publisher.subscribe(Subscriber).
final void	run()
protected void	whenComplete()
protected void	whenError(Throwable error)
protected abstract boolean	whenNext(T element)

Methods inherited from class Object

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

Constructor Details

AsyncSubscriber

protected AsyncSubscriber(Executor executor)

Method Details

whenNext

protected abstract boolean whenNext(T element)

whenComplete

protected void whenComplete()

whenError

protected void whenError(Throwable error)

onSubscribe

public final void onSubscribe(Subscription s)

Description copied from interface: Subscriber

Invoked after calling Publisher.subscribe(Subscriber).

No data will start flowing until Subscription.request(long) is invoked.

It is the responsibility of this Subscriber instance to call Subscription.request(long) whenever more data is wanted.

The Publisher will send notifications only in response to Subscription.request(long).

Specified by:

onSubscribe in interface Subscriber<T>

Parameters:

s - the Subscription that allows requesting data via Subscription.request(long)

onNext

public final void onNext(T element)

Description copied from interface: Subscriber

Data notification sent by the Publisher in response to requests to Subscription.request(long).

Specified by:

onNext in interface Subscriber<T>

Parameters:

element - the element signaled

onError

public final void onError(Throwable t)

Description copied from interface: Subscriber

Failed terminal state.

No further events will be sent even if Subscription.request(long) is invoked again.

Specified by:

onError in interface Subscriber<T>

Parameters:

t - the throwable signaled

onComplete

public final void onComplete()

Description copied from interface: Subscriber

Successful terminal state.

No further events will be sent even if Subscription.request(long) is invoked again.

Specified by:

onComplete in interface Subscriber<T>

run

public final void run()

Specified by:

run in interface Runnable