Package software.amazon.awssdk.crt.eventstream

Class ServerListener

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.eventstream.ServerListener

All Implemented Interfaces:

AutoCloseable

public class ServerListener
extends CrtResource

Event-stream-rpc server listener. Once it begins listening, it will provide new connections as they arrive.

Nested Class Summary

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

CrtResource.ResourceInstance

Constructor Summary

Constructors

Constructor	Description
ServerListener(String hostName, int port, SocketOptions socketOptions, ServerTlsContext tlsContext, ServerBootstrap serverBootstrap, ServerListenerHandler handler)	Instantiates a server listener.

Method Summary

Modifier and Type	Method	Description
protected boolean	canReleaseReferencesImmediately()	Override that determines whether a resource releases its dependencies at the same time the native handle is released or if it waits.
int	getBoundPort()
CompletableFuture<Void>	getShutdownCompleteFuture()
protected void	releaseNativeHandle()	Required override method that must begin the release process of the acquired 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

ServerListener

public ServerListener(String hostName,
                      int port,
                      SocketOptions socketOptions,
                      ServerTlsContext tlsContext,
                      ServerBootstrap serverBootstrap,
                      ServerListenerHandler handler)

Instantiates a server listener. Once this function completes, the server is configured and listening for new connections.

Parameters:

hostName - name of the host to listen on. Can be a dns name, ip address, or unix domain socket (or named pipe on windows) name.

port - port to listen on. Ignored for local domain sockets. For 32bit values exceeding Integer.MAX_VALUE use two's complement (i.e. -1 == 0xFFFFFFFF).

socketOptions - socket options to apply to the listening socket.

tlsContext - optional tls context to apply to the connection if you want to use TLS.

serverBootstrap - bootstrap object for handling connections.

handler - functor interface for handling incoming connections and connection closures.

Method Detail

releaseNativeHandle

protected void releaseNativeHandle()

Description copied from class: CrtResource

Required override method that must begin the release process of the acquired native handle

Specified by:

releaseNativeHandle in class CrtResource

canReleaseReferencesImmediately

protected boolean canReleaseReferencesImmediately()

Description copied from class: CrtResource

Override that determines whether a resource releases its dependencies at the same time the native handle is released or if it waits. Resources with asynchronous shutdown processes should override this with false, and establish a callback from native code that invokes releaseReferences() when the asynchronous shutdown process has completed. See HttpClientConnectionManager for an example.

Specified by:

canReleaseReferencesImmediately in class CrtResource

Returns:

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

getBoundPort

public int getBoundPort()

Returns:

the port which the listener socket is bound to. Note that two's complement is used for 32bit values exceeding Integer.MAX_VALUE (i.e. -1 == 0xFFFFFFFF).

getShutdownCompleteFuture

public CompletableFuture<Void> getShutdownCompleteFuture()

Returns:

future to synchronize shutdown completion of this object.