Package software.amazon.awssdk.crt.io

Class HostResolver

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.io.HostResolver

All Implemented Interfaces:

AutoCloseable

public class HostResolver
extends CrtResource

Java wrapper around the native CRT host resolver, responsible for performing async dns lookups

Nested Class Summary

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

CrtResource.ResourceInstance

Constructor Summary

Constructors

Constructor	Description
HostResolver(EventLoopGroup elg)
HostResolver(EventLoopGroup elg, int maxEntries)

Method Summary

Modifier and Type	Method	Description
protected boolean	canReleaseReferencesImmediately()	Determines whether a resource releases its dependencies at the same time the native handle is released or if it waits.
static void	closeStaticDefault()	Closes the static default host resolver, if it exists.
protected void	releaseNativeHandle()	Cleans up the resolver's associated native handle
static void	setStaticDefaultMaxEntries(int maxEntries)	Sets the max number of cached host entries for the static default resolver, if it's ever created/used.

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

HostResolver

public HostResolver(EventLoopGroup elg)
             throws CrtRuntimeException

Parameters:

elg - event loop group to pass to the host resolver. Not currently used but still mandatory.

Throws:

CrtRuntimeException

HostResolver

public HostResolver(EventLoopGroup elg,
                    int maxEntries)
             throws CrtRuntimeException

Parameters:

elg - event loop group to pass to the host resolver. Not currently used but still mandatory.

maxEntries - maximum size of the name to address mapping cache

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

Cleans up the resolver's associated native handle

Specified by:

releaseNativeHandle in class CrtResource

setStaticDefaultMaxEntries

public static void setStaticDefaultMaxEntries(int maxEntries)

Sets the max number of cached host entries for the static default resolver, if it's ever created/used. Has no effect if the static default host resolver has already been created.

Parameters:

maxEntries - maximum number of host entries cached

closeStaticDefault

public static void closeStaticDefault()

Closes the static default host resolver, if it exists. Primarily intended for tests that use the static default resolver, before they call waitForNoResources().