org.reactivestreams.example.unicast

Class AsyncIterablePublisher<T>

java.lang.Object

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

All Implemented Interfaces:

Publisher<T>

Direct Known Subclasses:

HelperPublisher, InfiniteHelperPublisher, InfiniteIncrementNumberPublisher, NumberIterablePublisher

public class AsyncIterablePublisher<T>
extends java.lang.Object
implements Publisher<T>

AsyncIterablePublisher is an implementation of Reactive Streams `Publisher` which executes asynchronously, using a provided `Executor` and produces elements from a given `Iterable` in a "unicast" configuration to its `Subscribers`. 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

Constructor and Description
AsyncIterablePublisher(java.lang.Iterable<T> elements, java.util.concurrent.Executor executor)
AsyncIterablePublisher(java.lang.Iterable<T> elements, int batchSize, java.util.concurrent.Executor executor)

Method Summary

Modifier and Type	Method and Description
void	subscribe(Subscriber<? super T> s) Request Publisher to start streaming data.

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncIterablePublisher

public AsyncIterablePublisher(java.lang.Iterable<T> elements,
                              java.util.concurrent.Executor executor)

AsyncIterablePublisher

public AsyncIterablePublisher(java.lang.Iterable<T> elements,
                              int batchSize,
                              java.util.concurrent.Executor executor)

Method Detail

subscribe

public void subscribe(Subscriber<? super T> s)

Description copied from interface: Publisher

Request Publisher to start streaming data.

This is a "factory method" and can be called multiple times, each time starting a new Subscription.

Each Subscription will work for only a single Subscriber.

A Subscriber should only subscribe once to a single Publisher.

If the Publisher rejects the subscription attempt or otherwise fails it will signal the error via Subscriber.onError(java.lang.Throwable).

Specified by:

subscribe in interface Publisher<T>

Parameters:

s - the Subscriber that will consume signals from this Publisher