software.amazon.awssdk.crt.http

Class HttpStream

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.http.HttpStream

All Implemented Interfaces:

AutoCloseable

public class HttpStream
extends CrtResource

An HttpStream represents a single Http Request/Response pair within a HttpClientConnection, and wraps the native resources from the aws-c-http library. Can be used to update the Window size, or to abort the stream early in the middle of sending/receiving Http Bodies.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpStream(CrtByteBuffer streamBuffer, long ptr)

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.
int	getResponseStatusCode() Retrieves the Http Response Status Code
void	incrementWindow(int windowSize) Opens the Sliding Read/Write Window by the number of bytes passed as an argument for this HttpStream.
protected void	releaseNativeHandle() Cleans up the stream's associated native handle

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

acquireNativeHandle, addReferenceTo, close, 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

HttpStream

protected HttpStream(CrtByteBuffer streamBuffer,
                     long ptr)

Method Detail

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()

Cleans up the stream's associated native handle

Specified by:

releaseNativeHandle in class CrtResource

incrementWindow

public void incrementWindow(int windowSize)

Opens the Sliding Read/Write Window by the number of bytes passed as an argument for this HttpStream. This function should only be called if the user application previously returned less than the length of the input ByteBuffer from a onResponseBody() call in a CrtHttpStreamHandler, and should be <= to the total number of un-acked bytes.

Parameters:

windowSize - How many bytes to increment the sliding window by.

getResponseStatusCode

public int getResponseStatusCode()

Retrieves the Http Response Status Code

Returns:

The Http Response Status Code