Package com.linecorp.armeria.common.unsafe

Interface PooledStreamMessage<T>

All Superinterfaces:

org.reactivestreams.Publisher<T>, StreamMessage<T>

All Known Subinterfaces:

PooledHttpRequest, PooledHttpResponse

public interface PooledStreamMessage<T>
extends StreamMessage<T>

A StreamMessage that exposes unsafe APIs for subscribing to pooled objects from the stream.

Method Summary

Modifier and Type	Method	Description
default void	subscribe(org.reactivestreams.Subscriber<? super T> subscriber)	Deprecated. Use subscribeWithPooledObjects(Subscriber).
default void	subscribe(org.reactivestreams.Subscriber<? super T> subscriber, SubscriptionOption... options)	Deprecated. Use subscribeWithPooledObjects(Subscriber, SubscriptionOption...).
void	subscribe(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor)	Deprecated. Use subscribeWithPooledObjects(Subscriber, EventExecutor).
void	subscribe(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor, SubscriptionOption... options)	Deprecated. Use subscribeWithPooledObjects(Subscriber, EventExecutor, SubscriptionOption...).
default void	subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber)	Requests to start streaming data to the specified Subscriber.
default void	subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber, SubscriptionOption... options)	Requests to start streaming data to the specified Subscriber.
default void	subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor)	Requests to start streaming data to the specified Subscriber.
default void	subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor, SubscriptionOption... options)	Requests to start streaming data to the specified Subscriber.

Methods inherited from interface com.linecorp.armeria.common.stream.StreamMessage

abort, abort, defaultSubscriberExecutor, isComplete, isEmpty, isOpen, toDuplicator, toDuplicator, whenComplete

Method Details

subscribeWithPooledObjects

default void subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber)

Requests to start streaming data to the specified Subscriber. If there is a problem subscribing, Subscriber.onError(Throwable) will be invoked with one of the following exceptions:

• IllegalStateException if other Subscriber subscribed to this stream already.
• AbortedStreamException if this stream has been aborted.
• CancelledSubscriptionException if this stream has been cancelled and SubscriptionOption.NOTIFY_CANCELLATION is specified when subscribed.
• Other exceptions that occurred due to an error while retrieving the elements.

subscribeWithPooledObjects

default void subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber, SubscriptionOption... options)

Requests to start streaming data to the specified Subscriber. If there is a problem subscribing, Subscriber.onError(Throwable) will be invoked with one of the following exceptions:

• IllegalStateException if other Subscriber subscribed to this stream already.
• AbortedStreamException if this stream has been aborted.
• CancelledSubscriptionException if this stream has been cancelled and SubscriptionOption.NOTIFY_CANCELLATION is specified when subscribed.
• Other exceptions that occurred due to an error while retrieving the elements.

Parameters:

options - SubscriptionOptions to subscribe with

subscribeWithPooledObjects

default void subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor)

Requests to start streaming data to the specified Subscriber. If there is a problem subscribing, Subscriber.onError(Throwable) will be invoked with one of the following exceptions:

• IllegalStateException if other Subscriber subscribed to this stream already.
• AbortedStreamException if this stream has been aborted.
• CancelledSubscriptionException if this stream has been cancelled and SubscriptionOption.NOTIFY_CANCELLATION is specified when subscribed.
• Other exceptions that occurred due to an error while retrieving the elements.

Parameters:

executor - the executor to subscribe

subscribeWithPooledObjects

default void subscribeWithPooledObjects(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor, SubscriptionOption... options)

Requests to start streaming data to the specified Subscriber. If there is a problem subscribing, Subscriber.onError(Throwable) will be invoked with one of the following exceptions:

• IllegalStateException if other Subscriber subscribed to this stream already.
• AbortedStreamException if this stream has been aborted.
• CancelledSubscriptionException if this stream has been cancelled and SubscriptionOption.NOTIFY_CANCELLATION is specified when subscribed.
• Other exceptions that occurred due to an error while retrieving the elements.

Parameters:

executor - the executor to subscribe

options - SubscriptionOptions to subscribe with

subscribe

@Deprecated default void subscribe(org.reactivestreams.Subscriber<? super T> subscriber)

Deprecated.

Use subscribeWithPooledObjects(Subscriber).

Requests to start streaming data to the specified Subscriber without pooled objects. When operating on PooledStreamMessage this should be avoided.

Specified by:

subscribe in interface org.reactivestreams.Publisher<T>

Specified by:

subscribe in interface StreamMessage<T>

subscribe

@Deprecated default void subscribe(org.reactivestreams.Subscriber<? super T> subscriber, SubscriptionOption... options)

Deprecated.

Use subscribeWithPooledObjects(Subscriber, SubscriptionOption...).

Requests to start streaming data to the specified Subscriber without pooled objects. When operating on PooledStreamMessage this should be avoided.

Specified by:

subscribe in interface StreamMessage<T>

options - SubscriptionOptions to subscribe with

subscribe

@Deprecated void subscribe(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor)

Deprecated.

Use subscribeWithPooledObjects(Subscriber, EventExecutor).

Requests to start streaming data to the specified Subscriber without pooled objects. When operating on PooledStreamMessage this should be avoided.

Specified by:

subscribe in interface StreamMessage<T>

executor - the executor to subscribe

subscribe

@Deprecated void subscribe(org.reactivestreams.Subscriber<? super T> subscriber, EventExecutor executor, SubscriptionOption... options)

Deprecated.

Use subscribeWithPooledObjects(Subscriber, EventExecutor, SubscriptionOption...).

Requests to start streaming data to the specified Subscriber without pooled objects. When operating on PooledStreamMessage this should be avoided.

Specified by:

subscribe in interface StreamMessage<T>

executor - the executor to subscribe

options - SubscriptionOptions to subscribe with