Package org.reactivestreams

Interface Publisher<T>

Type Parameters:

T - the type of element signaled

All Known Subinterfaces:

Processor<T,R>

All Known Implementing Classes:

AsyncIterablePublisher, FlowAdapters.ReactivePublisherFromFlow, FlowAdapters.ReactiveToFlowProcessor, HelperPublisher, IdentityProcessorVerification.TestSetup, InfiniteHelperPublisher, InfiniteIncrementNumberPublisher, NumberIterablePublisher, RangePublisher, SubscriberBlackboxVerification.BlackboxTestStage, SubscriberWhiteboxVerification.WhiteboxTestStage, TestEnvironment.ManualPublisher

public interface Publisher<T>

A Publisher is a provider of a potentially unbounded number of sequenced elements, publishing them according to the demand received from its Subscriber(s).

A Publisher can serve multiple Subscribers subscribed subscribe(Subscriber) dynamically at various points in time.

Method Summary

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

Method Details

subscribe

void subscribe(Subscriber<? super T> s)

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(Throwable).

Parameters:

s - the Subscriber that will consume signals from this Publisher