io.servicetalk.http.api

Interface ReservedBlockingStreamingHttpConnection

All Superinterfaces:

AutoCloseable, BlockingStreamingHttpConnection, BlockingStreamingHttpRequester, BlockingStreamingHttpRequestFactory, GracefulAutoCloseable

public interface ReservedBlockingStreamingHttpConnection
extends BlockingStreamingHttpConnection

A special type of BlockingStreamingHttpConnection for the exclusive use of the caller of BlockingStreamingHttpClient.reserveConnection(HttpRequestMetaData) and BlockingStreamingHttpClient.reserveConnection(HttpExecutionStrategy, HttpRequestMetaData).

Method Summary

Modifier and Type	Method and Description
default ReservedBlockingHttpConnection	asBlockingConnection() Convert this BlockingStreamingHttpConnection to the BlockingHttpConnection API.
default ReservedHttpConnection	asConnection() Convert this BlockingStreamingHttpConnection to the HttpConnection API.
ReservedStreamingHttpConnection	asStreamingConnection() Convert this BlockingStreamingHttpConnection to the StreamingHttpConnection API.
void	release() Releases this reserved BlockingStreamingHttpConnection to be used for subsequent requests.

Methods inherited from interface BlockingStreamingHttpConnection

connectionContext, request, transportEventIterable

Methods inherited from interface BlockingStreamingHttpRequester

close, executionContext, httpResponseFactory, request

Methods inherited from interface BlockingStreamingHttpRequestFactory

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

Methods inherited from interface GracefulAutoCloseable

closeGracefully

Method Detail

release

void release()
      throws Exception

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

Throws:

Exception - if any exception occurs during releasing.

asStreamingConnection

ReservedStreamingHttpConnection asStreamingConnection()

Description copied from interface: BlockingStreamingHttpConnection

Convert this BlockingStreamingHttpConnection to the StreamingHttpConnection API.

Note that the resulting StreamingHttpConnection may still be subject to any blocking, in memory aggregation, and other behavior as this BlockingStreamingHttpConnection.

Specified by:

asStreamingConnection in interface BlockingStreamingHttpConnection

Returns:

a StreamingHttpConnection representation of this BlockingStreamingHttpConnection.

asConnection

default ReservedHttpConnection asConnection()

Description copied from interface: BlockingStreamingHttpConnection

Convert this BlockingStreamingHttpConnection to the HttpConnection API.

Note that the resulting HttpConnection may still be subject to any blocking, in memory aggregation, and other behavior as this BlockingStreamingHttpConnection.

Specified by:

asConnection in interface BlockingStreamingHttpConnection

Returns:

a HttpConnection representation of this BlockingStreamingHttpConnection.

asBlockingConnection

default ReservedBlockingHttpConnection asBlockingConnection()

Description copied from interface: BlockingStreamingHttpConnection

Convert this BlockingStreamingHttpConnection to the BlockingHttpConnection API.

Note that the resulting BlockingHttpConnection may still be subject to in memory aggregation and other behavior as this BlockingStreamingHttpConnection.

Specified by:

asBlockingConnection in interface BlockingStreamingHttpConnection

Returns:

a BlockingHttpConnection representation of this BlockingStreamingHttpConnection.