io.servicetalk.http.api

Class HttpLoadBalancerFactory.DefaultFilterableStreamingHttpLoadBalancedConnection

Object

HttpLoadBalancerFactory.DefaultFilterableStreamingHttpLoadBalancedConnection

All Implemented Interfaces:

LoadBalancedConnection, RequestConcurrencyController, ReservableRequestConcurrencyController, ScoreSupplier, AsyncCloseable, ListenableAsyncCloseable, GracefulAutoCloseable, FilterableReservedStreamingHttpConnection, FilterableStreamingHttpConnection, FilterableStreamingHttpLoadBalancedConnection, ReservedStreamingHttpConnection, StreamingHttpConnection, StreamingHttpRequester, StreamingHttpRequestFactory, AutoCloseable

Enclosing interface:

HttpLoadBalancerFactory<ResolvedAddress>

public static final class HttpLoadBalancerFactory.DefaultFilterableStreamingHttpLoadBalancedConnection
extends Object
implements FilterableStreamingHttpLoadBalancedConnection

Default implementation of FilterableStreamingHttpLoadBalancedConnection.

Nested Class Summary

Nested classes/interfaces inherited from interface RequestConcurrencyController

RequestConcurrencyController.Result

Constructor Summary

Constructors

Constructor and Description
DefaultFilterableStreamingHttpLoadBalancedConnection(FilterableStreamingHttpConnection delegate, ReservableRequestConcurrencyController controller) Create a new instance without support for score().
DefaultFilterableStreamingHttpLoadBalancedConnection(FilterableStreamingHttpConnection delegate, ReservableRequestConcurrencyController controller, ScoreSupplier scoreSupplier) Create a new instance.

Method Summary

Modifier and Type	Method and Description
ReservedBlockingHttpConnection	asBlockingConnection() Convert this StreamingHttpConnection to the BlockingHttpConnection API.
ReservedBlockingStreamingHttpConnection	asBlockingStreamingConnection() Convert this StreamingHttpConnection to the BlockingStreamingHttpConnection API.
ReservedHttpConnection	asConnection() Convert this StreamingHttpConnection to the HttpConnection API.
Completable	closeAsync()
Completable	closeAsyncGracefully()
HttpConnectionContext	connectionContext() Get the HttpConnectionContext.
HttpExecutionContext	executionContext() Get the HttpExecutionContext used during construction of this object.
StreamingHttpResponseFactory	httpResponseFactory() Get a StreamingHttpResponseFactory.
StreamingHttpRequest	newRequest(HttpRequestMethod method, String requestTarget) Create a new HttpRequestFactory.
Completable	onClose()
Completable	onClosing()
Completable	releaseAsync() Releases this reserved FilterableStreamingHttpConnection to be used for subsequent requests.
Single<StreamingHttpResponse>	request(StreamingHttpRequest request) Send a request.
void	requestFinished()
int	score()
String	toString()
<T> Publisher<? extends T>	transportEventStream(HttpEventKey<T> eventKey) Returns a Publisher that gives the current value of a transport event as well as subsequent changes to the event value as long as the PublisherSource.Subscriber has expressed enough demand.
RequestConcurrencyController.Result	tryRequest()
boolean	tryReserve()

Methods inherited from class Object

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

Methods inherited from interface StreamingHttpConnection

close, closeGracefully

Methods inherited from interface StreamingHttpRequestFactory

connect, delete, get, head, options, patch, post, put, trace

Constructor Detail

DefaultFilterableStreamingHttpLoadBalancedConnection

public DefaultFilterableStreamingHttpLoadBalancedConnection(FilterableStreamingHttpConnection delegate,
                                                            ReservableRequestConcurrencyController controller)

Create a new instance without support for score().

Parameters:

delegate - FilterableStreamingHttpConnection to delegate to

controller - ReservableRequestConcurrencyController to control concurrent access to the delegate

DefaultFilterableStreamingHttpLoadBalancedConnection

public DefaultFilterableStreamingHttpLoadBalancedConnection(FilterableStreamingHttpConnection delegate,
                                                            ReservableRequestConcurrencyController controller,
                                                            ScoreSupplier scoreSupplier)

Create a new instance.

Parameters:

delegate - FilterableStreamingHttpConnection to delegate to

controller - ReservableRequestConcurrencyController to control concurrent access to the delegate

scoreSupplier - ScoreSupplier to query the score()

Method Detail

score

public int score()

Specified by:

score in interface ScoreSupplier

connectionContext

public HttpConnectionContext connectionContext()

Description copied from interface: FilterableStreamingHttpConnection

Get the HttpConnectionContext.

Specified by:

connectionContext in interface FilterableStreamingHttpConnection

Returns:

the HttpConnectionContext.

transportEventStream

public <T> Publisher<? extends T> transportEventStream(HttpEventKey<T> eventKey)

Description copied from interface: FilterableStreamingHttpConnection

Returns a Publisher that gives the current value of a transport event as well as subsequent changes to the event value as long as the PublisherSource.Subscriber has expressed enough demand.

This is designed for events produced by the transport, and consumed by filters interested in transport behavior which is not directly involved in the data path.

Specified by:

transportEventStream in interface FilterableStreamingHttpConnection

Type Parameters:

T - Type of the event value.

Parameters:

eventKey - Name of the event to fetch.

Returns:

Publisher for the event values.

request

public Single<StreamingHttpResponse> request(StreamingHttpRequest request)

Description copied from interface: StreamingHttpRequester

Send a request.

Specified by:

request in interface StreamingHttpRequester

Parameters:

request - the request to send.

Returns:

The response.

executionContext

public HttpExecutionContext executionContext()

Description copied from interface: StreamingHttpRequester

Get the HttpExecutionContext used during construction of this object.

Note that the ExecutionContext.ioExecutor() will not necessarily be associated with a specific thread unless that was how this object was built.

Specified by:

executionContext in interface StreamingHttpRequester

Returns:

the HttpExecutionContext used during construction of this object.

httpResponseFactory

public StreamingHttpResponseFactory httpResponseFactory()

Description copied from interface: StreamingHttpRequester

Get a StreamingHttpResponseFactory.

Specified by:

httpResponseFactory in interface StreamingHttpRequester

Returns:

a StreamingHttpResponseFactory.

onClose

public Completable onClose()

Specified by:

onClose in interface ListenableAsyncCloseable

onClosing

public Completable onClosing()

Specified by:

onClosing in interface ListenableAsyncCloseable

closeAsync

public Completable closeAsync()

Specified by:

closeAsync in interface AsyncCloseable

closeAsyncGracefully

public Completable closeAsyncGracefully()

Specified by:

closeAsyncGracefully in interface AsyncCloseable

newRequest

public StreamingHttpRequest newRequest(HttpRequestMethod method,
                                       String requestTarget)

Description copied from interface: StreamingHttpRequestFactory

Create a new HttpRequestFactory.

Specified by:

newRequest in interface StreamingHttpRequestFactory

Parameters:

method - The HttpRequestMethod.

requestTarget - The request target.

Returns:

a new HttpRequestFactory.

tryRequest

public RequestConcurrencyController.Result tryRequest()

Specified by:

tryRequest in interface LoadBalancedConnection

Specified by:

tryRequest in interface RequestConcurrencyController

requestFinished

public void requestFinished()

Specified by:

requestFinished in interface LoadBalancedConnection

Specified by:

requestFinished in interface RequestConcurrencyController

tryReserve

public boolean tryReserve()

Specified by:

tryReserve in interface LoadBalancedConnection

Specified by:

tryReserve in interface ReservableRequestConcurrencyController

releaseAsync

public Completable releaseAsync()

Description copied from interface: FilterableReservedStreamingHttpConnection

Releases this reserved FilterableStreamingHttpConnection to be used for subsequent requests. This method must be idempotent, i.e. calling multiple times must not have side-effects.

Specified by:

releaseAsync in interface LoadBalancedConnection

Specified by:

releaseAsync in interface ReservableRequestConcurrencyController

Specified by:

releaseAsync in interface FilterableReservedStreamingHttpConnection

Specified by:

releaseAsync in interface FilterableStreamingHttpLoadBalancedConnection

Returns:

the Completable that is notified on releaseAsync.

asConnection

public ReservedHttpConnection asConnection()

Description copied from interface: StreamingHttpConnection

Convert this StreamingHttpConnection to the HttpConnection API.

This API is provided for convenience. It is recommended that filters are implemented using the StreamingHttpConnection asynchronous API for maximum portability.

Specified by:

asConnection in interface FilterableStreamingHttpLoadBalancedConnection

Specified by:

asConnection in interface ReservedStreamingHttpConnection

Specified by:

asConnection in interface StreamingHttpConnection

Returns:

a HttpConnection representation of this StreamingHttpConnection.

asBlockingStreamingConnection

public ReservedBlockingStreamingHttpConnection asBlockingStreamingConnection()

Description copied from interface: StreamingHttpConnection

Convert this StreamingHttpConnection to the BlockingStreamingHttpConnection API.

This API is provided for convenience for a more familiar sequential programming model. It is recommended that filters are implemented using the StreamingHttpConnection asynchronous API for maximum portability.

Specified by:

asBlockingStreamingConnection in interface FilterableStreamingHttpLoadBalancedConnection

Specified by:

asBlockingStreamingConnection in interface ReservedStreamingHttpConnection

Specified by:

asBlockingStreamingConnection in interface StreamingHttpConnection

Returns:

a BlockingStreamingHttpConnection representation of this StreamingHttpConnection.

asBlockingConnection

public ReservedBlockingHttpConnection asBlockingConnection()

Description copied from interface: StreamingHttpConnection

Convert this StreamingHttpConnection to the BlockingHttpConnection API.

This API is provided for convenience for a more familiar sequential programming model. It is recommended that filters are implemented using the StreamingHttpConnection asynchronous API for maximum portability.

Specified by:

asBlockingConnection in interface FilterableStreamingHttpLoadBalancedConnection

Specified by:

asBlockingConnection in interface ReservedStreamingHttpConnection

Specified by:

asBlockingConnection in interface StreamingHttpConnection

Returns:

a BlockingHttpConnection representation of this StreamingHttpConnection.

toString

public String toString()

Overrides:

toString in class Object