software.amazon.awssdk.crt.http

Class HttpClientConnection

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.http.HttpClientConnection

All Implemented Interfaces:

AutoCloseable

public class HttpClientConnection
extends CrtResource

This class wraps aws-c-http to provide the basic HTTP request/response functionality via the AWS Common Runtime. HttpClientConnection represents a single connection to a HTTP service endpoint. This class is not thread safe and should not be called from different threads.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpClientConnection(HttpClientConnectionManager manager, long connection)

Method Summary

Modifier and Type	Method and Description
protected boolean	canReleaseReferencesImmediately() Determines whether a resource releases its dependencies at the same time the native handle is released or if it waits.
CompletableFuture<HttpStream>	makeRequest(HttpRequest request, CrtHttpStreamHandler streamHandler) Schedules an HttpRequest on the Native EventLoop for this HttpClientConnection.
protected void	releaseNativeHandle() Releases this HttpClientConnection back into the Connection Pool, and allows another Request to acquire this connection.

Methods inherited from class software.amazon.awssdk.crt.CrtResource

acquireNativeHandle, addReferenceTo, close, collectNativeResources, getNativeHandle, isNativeResource, isNull, logNativeResources, releaseReferences, waitForNoResources

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpClientConnection

protected HttpClientConnection(HttpClientConnectionManager manager,
                               long connection)

Method Detail

makeRequest

public CompletableFuture<HttpStream> makeRequest(HttpRequest request,
                                                 CrtHttpStreamHandler streamHandler)
                                          throws CrtRuntimeException

Schedules an HttpRequest on the Native EventLoop for this HttpClientConnection.

Parameters:

request - The Request to make to the Server.

streamHandler - The Stream Handler to be called from the Native EventLoop

Returns:

The HttpStream that represents this Request/Response Pair. It can be closed at any time during the request/response, but must be closed by the user thread making this request when it's done.

Throws:

CrtRuntimeException

canReleaseReferencesImmediately

protected boolean canReleaseReferencesImmediately()

Determines whether a resource releases its dependencies at the same time the native handle is released or if it waits. Resources that wait are responsible for calling releaseReferences() manually.

Specified by:

canReleaseReferencesImmediately in class CrtResource

releaseNativeHandle

protected void releaseNativeHandle()

Releases this HttpClientConnection back into the Connection Pool, and allows another Request to acquire this connection.

Specified by:

releaseNativeHandle in class CrtResource