org.reactivestreams.Publisher Maven / Gradle / Ivy
package org.reactivestreams;
/**
* A {@link Publisher} is a provider of a potentially unbounded number of sequenced elements, publishing them according to
* the demand received from its {@link Subscriber}(s).
*
* A {@link Publisher} can serve multiple {@link Subscriber}s subscribed {@link #subscribe(Subscriber)} dynamically
* at various points in time.
*
* @param the type of element signaled.
*/
public interface Publisher {
/**
* Request {@link Publisher} to start streaming data.
*
* This is a "factory method" and can be called multiple times, each time starting a new {@link Subscription}.
*
* Each {@link Subscription} will work for only a single {@link Subscriber}.
*
* A {@link Subscriber} should only subscribe once to a single {@link Publisher}.
*
* If the {@link Publisher} rejects the subscription attempt or otherwise fails it will
* signal the error via {@link Subscriber#onError}.
*
* @param s the {@link Subscriber} that will consume signals from this {@link Publisher}
*/
public void subscribe(Subscriber s);
}