software.amazon.awssdk.crt.io

Class TlsContext

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.io.TlsContext

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

ClientTlsContext, ServerTlsContext

public class TlsContext
extends CrtResource

This class wraps the aws_tls_context from aws-c-io to provide access to TLS configuration contexts in the AWS Common Runtime.

Nested Class Summary

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

CrtResource.ResourceInstance

Constructor Summary

Constructors

Constructor and Description
TlsContext() Creates a new Client TlsContext.
TlsContext(TlsContextOptions options) Creates a new Client TlsContext.

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.
protected void	releaseNativeHandle() Frees all native resources associated with the context.
protected static long	tlsContextNew(long options)

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

TlsContext

public TlsContext(TlsContextOptions options)
           throws CrtRuntimeException

Creates a new Client TlsContext. There are significant native resources consumed to create a TlsContext, so most applications will only need to create one and re-use it for all connections.

Parameters:

options - A set of options for this context

Throws:

CrtRuntimeException - If the provided options are malformed or the system is unable to allocate space for a native tls context

TlsContext

public TlsContext()
           throws CrtRuntimeException

Creates a new Client TlsContext. There are significant native resources consumed to create a TlsContext, so most applications will only need to create one and re-use it for all connections.

Throws:

CrtRuntimeException

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

Frees all native resources associated with the context. This object is unusable after close is called.

Specified by:

releaseNativeHandle in class CrtResource

tlsContextNew

protected static long tlsContextNew(long options)
                             throws CrtRuntimeException

Throws:

CrtRuntimeException