io.servicetalk.http.api

Interface ReservedBlockingHttpConnection

All Superinterfaces:

java.lang.AutoCloseable, BlockingHttpConnection, BlockingHttpRequester, GracefulAutoCloseable, HttpRequestFactory

public interface ReservedBlockingHttpConnection
extends BlockingHttpConnection

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

Method Summary

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

Methods inherited from interface io.servicetalk.http.api.BlockingHttpConnection

connectionContext, request, transportEventIterable

Methods inherited from interface io.servicetalk.http.api.BlockingHttpRequester

close, executionContext, httpResponseFactory, request

Methods inherited from interface io.servicetalk.http.api.HttpRequestFactory

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

Methods inherited from interface io.servicetalk.concurrent.GracefulAutoCloseable

closeGracefully

Method Detail

release

void release()
      throws java.lang.Exception

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

Throws:

java.lang.Exception - if any exception occurs during releasing.

asStreamingConnection

ReservedStreamingHttpConnection asStreamingConnection()

Description copied from interface: BlockingHttpConnection

Convert this BlockingHttpConnection to the StreamingHttpConnection API.

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

Specified by:

asStreamingConnection in interface BlockingHttpConnection

Returns:

a StreamingHttpConnection representation of this BlockingHttpConnection.

asConnection

default ReservedHttpConnection asConnection()

Description copied from interface: BlockingHttpConnection

Convert this BlockingHttpConnection to the HttpConnection API.

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

Specified by:

asConnection in interface BlockingHttpConnection

Returns:

a HttpConnection representation of this BlockingHttpConnection.

asBlockingStreamingConnection

default ReservedBlockingStreamingHttpConnection asBlockingStreamingConnection()

Description copied from interface: BlockingHttpConnection

Convert this BlockingHttpConnection to the BlockingStreamingHttpConnection API.

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

Specified by:

asBlockingStreamingConnection in interface BlockingHttpConnection

Returns:

a BlockingStreamingHttpConnection representation of this BlockingHttpConnection.