- java.lang.Object
-
- swim.io.AbstractSocket
-
- All Implemented Interfaces:
ConnectionContext
,FlowContext
,Socket
public abstract class AbstractSocket extends Object implements Socket, ConnectionContext, FlowContext
-
-
Field Summary
Fields Modifier and Type Field Description protected SocketContext
context
-
Constructor Summary
Constructors Constructor Description AbstractSocket()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
become(Socket socket)
String
cipherSuite()
Returns the cryptographic cipher suite used by the underlying network connection.void
close()
void
didBecome(Socket socket)
Lifecycle callback invoked by the socket context after it hasbecome
a newsocket
implementation.void
didConnect()
Lifecycle callback invoked by the socket context after the underlying network socket has opened a connection.void
didDisconnect()
Lifecycle callback invoked by the socket context after the underlying network connection has disconnected.void
didFail(Throwable error)
Lifecycle callback invoked by the socket context when the underlying network socket fails by throwing anerror
.void
didSecure()
Lifecycle callback invoked by the socket context after the underlying network socket has established a secure connection.void
didTimeout()
Lifecycle callback invoked by the socket context after the underlying network connection has timed out.void
didWrite()
I/O callback invoked by the socket context after the underlying network socket has completed writing all data in itsoutputBuffer
.void
doRead()
I/O callback invoked by the socket context asking thisSocket
to read input data out of the socket context'sinputBuffer
.void
doWrite()
I/O callback invoked by the socket context asking thisSocket
to write output data into the socket context'soutputBuffer
.FlowControl
flowControl()
Returns the currentFlowControl
state of the underlying network channel.void
flowControl(FlowControl flowControl)
Enqueues an atomic replacement of the underlying network channel's flow control state with a newflowControl
.FlowControl
flowControl(FlowModifier flowModifier)
Enqueues an atomic modification to the underlying network channel's flow control state by applying aflowModifier
delta.long
idleTimeout()
Returns the number of idle milliseconds after which thisSocket
should be closed due to inactivity.InputBuffer
inputBuffer()
boolean
isClient()
Returnstrue
if the underlying network channel initiated an outgoing connection.boolean
isConnected()
Returnstrue
if the underlying network channel is currently connected.boolean
isSecure()
Returnstrue
if the underlying network transport is encrypted.boolean
isServer()
Returnstrue
if the underlying network channel accepted an incoming connection.InetSocketAddress
localAddress()
Returns the IP address and port of the local endpoint of the underlying network connection.Collection<Certificate>
localCertificates()
Returns the certificate chain used to authenticate the local endpoint of the underlying network connection.Principal
localPrincipal()
Returns the authenticated identity of the local endpoint of the underlying network connection.OutputBuffer<?>
outputBuffer()
InetSocketAddress
remoteAddress()
Returns the IP address and port of the remote endpoint of the underlying network connection.Collection<Certificate>
remoteCertificates()
Returns the certificate chain used to authenticate the remote endpoint of the underlying network connection.Principal
remotePrincipal()
Returns the authenticated identity of the remote endpoint of the underlying network connection.String
securityProtocol()
Returns the name of the transport-layer security protocol used by the underlying network connection.void
setSocketContext(SocketContext context)
Sets the network socket context to which thisSocket
is bound.SocketContext
socketContext()
Returns the network socket context to which thisSocket
is bound; returnsnull
if thisSocket
is unbound.SocketSettings
socketSettings()
void
willBecome(Socket socket)
Lifecycle callback invoked by the socket context before it hasbecome
a newsocket
implementation.void
willConnect()
Lifecycle callback invoked by the socket context before the underlying network socket attempts to open a connection.void
willSecure()
Lifecycle callback invoked by the socket context before the underlying network socket establishes a secure connection.
-
-
-
Field Detail
-
context
protected SocketContext context
-
-
Method Detail
-
socketContext
public SocketContext socketContext()
Description copied from interface:Socket
Returns the network socket context to which thisSocket
is bound; returnsnull
if thisSocket
is unbound.- Specified by:
socketContext
in interfaceSocket
-
setSocketContext
public void setSocketContext(SocketContext context)
Description copied from interface:Socket
Sets the network socket context to which thisSocket
is bound.- Specified by:
setSocketContext
in interfaceSocket
-
idleTimeout
public long idleTimeout()
Description copied from interface:Socket
Returns the number of idle milliseconds after which thisSocket
should be closed due to inactivity. Returns-1
if a default idle timeout should be used. Returns0
if the underlying network socket should not time out.- Specified by:
idleTimeout
in interfaceSocket
-
doRead
public void doRead()
Description copied from interface:Socket
I/O callback invoked by the socket context asking thisSocket
to read input data out of the socket context'sinputBuffer
. May be invoked concurrently to other I/O callbacks, but never concurrently with otherdoRead
calls.
-
doWrite
public void doWrite()
Description copied from interface:Socket
I/O callback invoked by the socket context asking thisSocket
to write output data into the socket context'soutputBuffer
. May be invoked concurrently to other I/O callbacks, but never concurrently with otherdoWrite
ordidWrite
calls.
-
didWrite
public void didWrite()
Description copied from interface:Socket
I/O callback invoked by the socket context after the underlying network socket has completed writing all data in itsoutputBuffer
. May be invoked concurrently to other I/O callbacks, but never concurrently with otherdoWrite
ordidWrite
calls.
-
willConnect
public void willConnect()
Description copied from interface:Socket
Lifecycle callback invoked by the socket context before the underlying network socket attempts to open a connection.- Specified by:
willConnect
in interfaceSocket
-
didConnect
public void didConnect()
Description copied from interface:Socket
Lifecycle callback invoked by the socket context after the underlying network socket has opened a connection.- Specified by:
didConnect
in interfaceSocket
-
willSecure
public void willSecure()
Description copied from interface:Socket
Lifecycle callback invoked by the socket context before the underlying network socket establishes a secure connection.- Specified by:
willSecure
in interfaceSocket
-
didSecure
public void didSecure()
Description copied from interface:Socket
Lifecycle callback invoked by the socket context after the underlying network socket has established a secure connection.
-
willBecome
public void willBecome(Socket socket)
Description copied from interface:Socket
Lifecycle callback invoked by the socket context before it hasbecome
a newsocket
implementation.- Specified by:
willBecome
in interfaceSocket
-
didBecome
public void didBecome(Socket socket)
Description copied from interface:Socket
Lifecycle callback invoked by the socket context after it hasbecome
a newsocket
implementation.
-
didTimeout
public void didTimeout()
Description copied from interface:Socket
Lifecycle callback invoked by the socket context after the underlying network connection has timed out. The socket will automatically be closed.- Specified by:
didTimeout
in interfaceSocket
-
didDisconnect
public void didDisconnect()
Description copied from interface:Socket
Lifecycle callback invoked by the socket context after the underlying network connection has disconnected.- Specified by:
didDisconnect
in interfaceSocket
-
didFail
public void didFail(Throwable error)
Description copied from interface:Socket
Lifecycle callback invoked by the socket context when the underlying network socket fails by throwing anerror
. The socket will automatically be closed.
-
isConnected
public boolean isConnected()
Description copied from interface:ConnectionContext
Returnstrue
if the underlying network channel is currently connected.- Specified by:
isConnected
in interfaceConnectionContext
-
isClient
public boolean isClient()
Description copied from interface:ConnectionContext
Returnstrue
if the underlying network channel initiated an outgoing connection.- Specified by:
isClient
in interfaceConnectionContext
-
isServer
public boolean isServer()
Description copied from interface:ConnectionContext
Returnstrue
if the underlying network channel accepted an incoming connection.- Specified by:
isServer
in interfaceConnectionContext
-
isSecure
public boolean isSecure()
Description copied from interface:ConnectionContext
Returnstrue
if the underlying network transport is encrypted.- Specified by:
isSecure
in interfaceConnectionContext
-
securityProtocol
public String securityProtocol()
Description copied from interface:ConnectionContext
Returns the name of the transport-layer security protocol used by the underlying network connection. Returnsnull
if the underlying network channel is not currently connected, or if the underlying network connection is not secure.- Specified by:
securityProtocol
in interfaceConnectionContext
-
cipherSuite
public String cipherSuite()
Description copied from interface:ConnectionContext
Returns the cryptographic cipher suite used by the underlying network connection. Returnsnull
if the underlying network channel is not currently connected, or if the underlying network connection is not secure.- Specified by:
cipherSuite
in interfaceConnectionContext
-
localAddress
public InetSocketAddress localAddress()
Description copied from interface:ConnectionContext
Returns the IP address and port of the local endpoint of the underlying network connection. Returnsnull
if the underlying network channel is not currently connected.- Specified by:
localAddress
in interfaceConnectionContext
-
localPrincipal
public Principal localPrincipal()
Description copied from interface:ConnectionContext
Returns the authenticated identity of the local endpoint of the underlying network connection. Returnsnull
if the underlying network channel is not currently connected, or if the underlying network connection is not authenticated.- Specified by:
localPrincipal
in interfaceConnectionContext
-
localCertificates
public Collection<Certificate> localCertificates()
Description copied from interface:ConnectionContext
Returns the certificate chain used to authenticate the local endpoint of the underlying network connection. Returnsnull
if the underlying network channel is not currently connected, or if the underlying network connection is not authenticated.- Specified by:
localCertificates
in interfaceConnectionContext
-
remoteAddress
public InetSocketAddress remoteAddress()
Description copied from interface:ConnectionContext
Returns the IP address and port of the remote endpoint of the underlying network connection. Returnsnull
if the underlying network channel is not currently connected.- Specified by:
remoteAddress
in interfaceConnectionContext
-
remotePrincipal
public Principal remotePrincipal()
Description copied from interface:ConnectionContext
Returns the authenticated identity of the remote endpoint of the underlying network connection. Returnsnull
if the underlying network channel is not currently connected, or if the underlying network connection is not authenticated.- Specified by:
remotePrincipal
in interfaceConnectionContext
-
remoteCertificates
public Collection<Certificate> remoteCertificates()
Description copied from interface:ConnectionContext
Returns the certificate chain used to authenticate the remote endpoint of the underlying network connection. Returnsnull
if the underlying network channel is not currently connected, or if the underlying network connection is not authenticated.- Specified by:
remoteCertificates
in interfaceConnectionContext
-
flowControl
public FlowControl flowControl()
Description copied from interface:FlowContext
Returns the currentFlowControl
state of the underlying network channel.- Specified by:
flowControl
in interfaceFlowContext
-
flowControl
public void flowControl(FlowControl flowControl)
Description copied from interface:FlowContext
Enqueues an atomic replacement of the underlying network channel's flow control state with a newflowControl
.- Specified by:
flowControl
in interfaceFlowContext
-
flowControl
public FlowControl flowControl(FlowModifier flowModifier)
Description copied from interface:FlowContext
Enqueues an atomic modification to the underlying network channel's flow control state by applying aflowModifier
delta.- Specified by:
flowControl
in interfaceFlowContext
-
socketSettings
public SocketSettings socketSettings()
-
inputBuffer
public InputBuffer inputBuffer()
-
outputBuffer
public OutputBuffer<?> outputBuffer()
-
become
public void become(Socket socket)
-
close
public void close()
-
-