Package software.amazon.awssdk.crt.http

Class HttpStreamBase

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.http.HttpStreamBase

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

Http2Stream, HttpStream

public class HttpStreamBase
extends CrtResource

An base class represents a single Http Request/Response for both HTTP/1.1 and HTTP/2 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.

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.awssdk.crt.CrtResource

CrtResource.ResourceInstance

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	HttpStreamBase(long ptr)

Method Summary

Modifier and Type	Method	Description
void	activate()	Activates the client stream.
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, addRef, addReferenceTo, close, collectNativeResource, collectNativeResources, decRef, getNativeHandle, getResourceLogDescription, isNull, logNativeResources, releaseReferences, removeReferenceTo, setDescription, swapReferenceTo, waitForNoResources

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpStreamBase

protected HttpStreamBase(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

Returns:

true if this resource releases synchronously, false if this resource performs async shutdown

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 HttpStreamResponseHandler, and should be <= to the total number of un-acked bytes.

Parameters:

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

activate

public void activate()

Activates the client stream.

getResponseStatusCode

public int getResponseStatusCode()

Retrieves the Http Response Status Code

Returns:

The Http Response Status Code