Package software.amazon.awssdk.crt.eventstream

Class ServerConnectionHandler

java.lang.Object

software.amazon.awssdk.crt.eventstream.ServerConnectionHandler

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

OperationRoutingServerConnectionHandler

public abstract class ServerConnectionHandler
extends Object
implements AutoCloseable

Handler for EventStream ServerConnections. It's marked AutoClosable. By default onConnectionClosed, calls the close() function on this object.

Field Summary

Fields

Modifier and Type	Field	Description
protected ServerConnection	connection

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ServerConnectionHandler(ServerConnection connection)

Method Summary

Modifier and Type	Method	Description
void	close()
protected void	onConnectionClosed(int shutdownReason)	Invoked upon the connection closing.
protected abstract ServerConnectionContinuationHandler	onIncomingStream(ServerConnectionContinuation continuation, String operationName)	Invoked upon an incoming stream from a client.
protected abstract void	onProtocolMessage(List<Header> headers, byte[] payload, MessageType messageType, int messageFlags)	Invoked when a message is received on a connection.

Methods inherited from class java.lang.Object

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

Field Detail

connection

protected ServerConnection connection

Constructor Detail

ServerConnectionHandler

protected ServerConnectionHandler(ServerConnection connection)

Method Detail

onProtocolMessage

protected abstract void onProtocolMessage(List<Header> headers,
                                          byte[] payload,
                                          MessageType messageType,
                                          int messageFlags)

Invoked when a message is received on a connection.

Parameters:

headers - List of EventStream headers for the message received.

payload - Payload for the message received

messageType - message type for the message

messageFlags - message flags for the message

onIncomingStream

protected abstract ServerConnectionContinuationHandler onIncomingStream(ServerConnectionContinuation continuation,
                                                                        String operationName)

Invoked upon an incoming stream from a client.

Parameters:

continuation - continuation object for sending continuation events to the client.

operationName - name of the operation the client wishes to invoke.

Returns:

a new instance of ServerConnectionContinuationHandler for handling continuation events.

onConnectionClosed

protected void onConnectionClosed(int shutdownReason)

Invoked upon the connection closing. By default, calls close() on this object.

Parameters:

shutdownReason - reason for the shutdown. 0 means clean shutdown.

close

public void close()

Specified by:

close in interface AutoCloseable