org.reactivestreams.example.unicast

Class AsyncSubscriber<T>

java.lang.Object

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

All Implemented Interfaces:

java.lang.Runnable, Subscriber<T>

public abstract class AsyncSubscriber<T>
extends java.lang.Object
implements Subscriber<T>, java.lang.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 and Description
protected	AsyncSubscriber(java.util.concurrent.Executor executor)

Method Summary

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

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncSubscriber

protected AsyncSubscriber(java.util.concurrent.Executor executor)

Method Detail

whenNext

protected abstract boolean whenNext(T element)

whenComplete

protected void whenComplete()

whenError

protected void whenError(java.lang.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 - 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(java.lang.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 java.lang.Runnable