io.datakernel.eventloop

Class AsyncSslSocket

java.lang.Object

io.datakernel.eventloop.AsyncSslSocket

All Implemented Interfaces:

AsyncTcpSocket, AsyncTcpSocket.EventHandler

public final class AsyncSslSocket
extends Object
implements AsyncTcpSocket, AsyncTcpSocket.EventHandler

Nested Class Summary

Nested classes/interfaces inherited from interface io.datakernel.eventloop.AsyncTcpSocket

AsyncTcpSocket.EventHandler

Method Summary

Modifier and Type	Method and Description
void	close() Closes socket, regardless of any remaining buffered data.
static AsyncSslSocket	create(Eventloop eventloop, AsyncTcpSocket asyncTcpSocket, SSLEngine engine, Executor executor)
InetSocketAddress	getRemoteSocketAddress()
void	onClosedWithError(Exception e) Is called when socket is closed with error.
void	onRead(ByteBuf buf) Is called when new input data was received by socket.
void	onReadEndOfStream() Is called when other side closed output, namely other side won't send any more data
void	onRegistered()
void	onWrite() Is called when all buffered data is flushed to network.
void	read() Must be called to inform the async socket that additional read data is needed.
void	setEventHandler(AsyncTcpSocket.EventHandler eventHandler)
static AsyncSslSocket	wrapClientSocket(Eventloop eventloop, AsyncTcpSocket asyncTcpSocket, SSLContext sslContext, Executor executor)
static AsyncSslSocket	wrapClientSocket(Eventloop eventloop, AsyncTcpSocket asyncTcpSocket, String host, int port, SSLContext sslContext, Executor executor)
static AsyncSslSocket	wrapServerSocket(Eventloop eventloop, AsyncTcpSocket asyncTcpSocket, SSLContext sslContext, Executor executor)
static AsyncSslSocket	wrapSocket(Eventloop eventloop, AsyncTcpSocket asyncTcpSocket, SSLEngine engine, Executor executor)
void	write(ByteBuf buf) Asynchronously writes data to network.
void	writeEndOfStream() Informs socket that no more data will be written.

Methods inherited from class java.lang.Object

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

Method Detail

wrapClientSocket

public static AsyncSslSocket wrapClientSocket(Eventloop eventloop,
                                              AsyncTcpSocket asyncTcpSocket,
                                              String host,
                                              int port,
                                              SSLContext sslContext,
                                              Executor executor)

wrapClientSocket

public static AsyncSslSocket wrapClientSocket(Eventloop eventloop,
                                              AsyncTcpSocket asyncTcpSocket,
                                              SSLContext sslContext,
                                              Executor executor)

wrapServerSocket

public static AsyncSslSocket wrapServerSocket(Eventloop eventloop,
                                              AsyncTcpSocket asyncTcpSocket,
                                              SSLContext sslContext,
                                              Executor executor)

wrapSocket

public static AsyncSslSocket wrapSocket(Eventloop eventloop,
                                        AsyncTcpSocket asyncTcpSocket,
                                        SSLEngine engine,
                                        Executor executor)

create

public static AsyncSslSocket create(Eventloop eventloop,
                                    AsyncTcpSocket asyncTcpSocket,
                                    SSLEngine engine,
                                    Executor executor)

onRegistered

public void onRegistered()

Specified by:

onRegistered in interface AsyncTcpSocket.EventHandler

onRead

public void onRead(ByteBuf buf)

Description copied from interface: AsyncTcpSocket.EventHandler

Is called when new input data was received by socket.

This callback is called only after one or more AsyncTcpSocket.read() invocation,

If this callback has been called, but event handler is still interested in reading data from socket, AsyncTcpSocket.read() method must be called

Specified by:

onRead in interface AsyncTcpSocket.EventHandler

Parameters:

buf - input data

onReadEndOfStream

public void onReadEndOfStream()

Description copied from interface: AsyncTcpSocket.EventHandler

Is called when other side closed output, namely other side won't send any more data

Specified by:

onReadEndOfStream in interface AsyncTcpSocket.EventHandler

onWrite

public void onWrite()

Description copied from interface: AsyncTcpSocket.EventHandler

Is called when all buffered data is flushed to network. This callback is called only after one or more AsyncTcpSocket.write(ByteBuf) invocation, unless the socket is closed.

Specified by:

onWrite in interface AsyncTcpSocket.EventHandler

onClosedWithError

public void onClosedWithError(Exception e)

Description copied from interface: AsyncTcpSocket.EventHandler

Is called when socket is closed with error. No subsequent operations on the socket must be called afterwards. No more event handler methods will be invoked afterwards

Specified by:

onClosedWithError in interface AsyncTcpSocket.EventHandler

setEventHandler

public void setEventHandler(AsyncTcpSocket.EventHandler eventHandler)

Specified by:

setEventHandler in interface AsyncTcpSocket

read

public void read()

Description copied from interface: AsyncTcpSocket

Must be called to inform the async socket that additional read data is needed.

Unless called, the socket won't read any data from network and therefore won't invoke AsyncTcpSocket.EventHandler.onRead(ByteBuf) callback.

Each read invocation may result in at most one AsyncTcpSocket.EventHandler.onRead(ByteBuf) callbacks.

This operation is idempotent and may be called several times prior to actual onRead callbacks.

Specified by:

read in interface AsyncTcpSocket

write

public void write(ByteBuf buf)

Description copied from interface: AsyncTcpSocket

Asynchronously writes data to network.

When written data is flushed, AsyncTcpSocket.EventHandler.onWrite() method will be called

Specified by:

write in interface AsyncTcpSocket

Parameters:

buf - bytes of data

writeEndOfStream

public void writeEndOfStream()

Description copied from interface: AsyncTcpSocket

Informs socket that no more data will be written. Any pending write data is expected to be delivered with corresponding AsyncTcpSocket.EventHandler.onWrite() confirmation. This operation is idempotent. No subsequent AsyncTcpSocket.EventHandler.onWrite() operations on the socket must be called afterwards.

Specified by:

writeEndOfStream in interface AsyncTcpSocket

close

public void close()

Description copied from interface: AsyncTcpSocket

Closes socket, regardless of any remaining buffered data. This operation is idempotent. No subsequent operations on the socket must be called afterwards.

After calling this method no more event handler methods will be invoked

Specified by:

close in interface AsyncTcpSocket

getRemoteSocketAddress

public InetSocketAddress getRemoteSocketAddress()

Specified by:

getRemoteSocketAddress in interface AsyncTcpSocket