io.servicetalk.http.api

Interface ReservedHttpConnection

All Superinterfaces:

AsyncCloseable, AutoCloseable, GracefulAutoCloseable, HttpConnection, HttpRequester, HttpRequestFactory, ListenableAsyncCloseable

public interface ReservedHttpConnection
extends HttpConnection

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

Method Summary

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

Methods inherited from interface HttpConnection

close, closeGracefully, connectionContext, request, transportEventStream

Methods inherited from interface HttpRequester

executionContext, httpResponseFactory, request

Methods inherited from interface HttpRequestFactory

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

releaseAsync

Completable releaseAsync()

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

Returns:

the Completable that is notified on releaseAsync.

asStreamingConnection

ReservedStreamingHttpConnection asStreamingConnection()

Description copied from interface: HttpConnection

Convert this HttpConnection to the StreamingHttpConnection API.

Specified by:

asStreamingConnection in interface HttpConnection

Returns:

a StreamingHttpConnection representation of this HttpConnection.

asBlockingStreamingConnection

default ReservedBlockingStreamingHttpConnection asBlockingStreamingConnection()

Description copied from interface: HttpConnection

Convert this HttpConnection to the BlockingStreamingHttpConnection API.

Specified by:

asBlockingStreamingConnection in interface HttpConnection

Returns:

a BlockingStreamingHttpConnection representation of this HttpConnection.

asBlockingConnection

default ReservedBlockingHttpConnection asBlockingConnection()

Description copied from interface: HttpConnection

Convert this HttpConnection to the BlockingHttpConnection API.

Specified by:

asBlockingConnection in interface HttpConnection

Returns:

a BlockingHttpConnection representation of this HttpConnection.