io.servicetalk.http.api

Interface FilterableStreamingHttpClient

All Superinterfaces:

AsyncCloseable, ListenableAsyncCloseable, StreamingHttpRequester, StreamingHttpRequestFactory

All Known Subinterfaces:

StreamingHttpClient

All Known Implementing Classes:

StreamingHttpClientFilter

public interface FilterableStreamingHttpClient
extends StreamingHttpRequester

A StreamingHttpClient that supports filtering.

Method Summary

Modifier and Type	Method and Description
default Single<? extends FilterableReservedStreamingHttpConnection>	reserveConnection(HttpExecutionStrategy strategy, HttpRequestMetaData metaData) Deprecated. Use reserveConnection(HttpRequestMetaData). If an HttpExecutionStrategy needs to be altered, provide a value for HttpContextKeys.HTTP_EXECUTION_STRATEGY_KEY in the request context.
default Single<? extends FilterableReservedStreamingHttpConnection>	reserveConnection(HttpRequestMetaData metaData) Reserve a StreamingHttpConnection based on provided HttpRequestMetaData.

Methods inherited from interface StreamingHttpRequester

executionContext, httpResponseFactory, request, request

Methods inherited from interface StreamingHttpRequestFactory

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

Methods inherited from interface ListenableAsyncCloseable

onClose

Methods inherited from interface AsyncCloseable

closeAsync, closeAsyncGracefully

Method Detail

reserveConnection

default Single<? extends FilterableReservedStreamingHttpConnection> reserveConnection(HttpRequestMetaData metaData)

Reserve a StreamingHttpConnection based on provided HttpRequestMetaData.

Parameters:

metaData - Allows the underlying layers to know what StreamingHttpConnections are valid to reserve for future requests with the same HttpRequestMetaData. For example this may provide some insight into shard or other info.

Returns:

a Single that provides the ReservedStreamingHttpConnection upon completion.

reserveConnection

@Deprecated
default Single<? extends FilterableReservedStreamingHttpConnection> reserveConnection(HttpExecutionStrategy strategy,
                                                                                                  HttpRequestMetaData metaData)

Deprecated. Use reserveConnection(HttpRequestMetaData). If an HttpExecutionStrategy needs to be altered, provide a value for HttpContextKeys.HTTP_EXECUTION_STRATEGY_KEY in the request context.

Reserve a StreamingHttpConnection based on provided HttpRequestMetaData.

Parameters:

strategy - HttpExecutionStrategy to use.

metaData - Allows the underlying layers to know what StreamingHttpConnections are valid to reserve for future requests with the same HttpRequestMetaData. For example this may provide some insight into shard or other info.

Returns:

a Single that provides the ReservedStreamingHttpConnection upon completion.