-
- All Known Implementing Classes:
AbstractService
,HttpSocketService
,MqttSocketService
public interface Service
Network service listener that handles asynchronous I/O operations for a non-blocking NIO server socket channel. AService
interfaces with the underlying asynchronous networking system via aServiceContext
. The service context invokes I/O callbacks on theService
when the underlying server socket is ready to perform I/O operations permitted by the service context'sFlowControl
.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Socket
createSocket()
Returns a newSocket
binding to handle an incoming network connection.void
didAccept(Socket socket)
Lifecycle callback invoked by the service context after the underlying network listener has accepted a newsocket
connection.void
didBind()
Lifecycle callback invoked by the service context after the underlying network listener has bound to a port.void
didFail(Throwable error)
Lifecycle callback invoked by the service context when the underlying network listener fails by throwing anerror
.void
didUnbind()
Lifecycle callback invoked by the service context after the underlying network listener has been unbound.ServiceContext
serviceContext()
Returns the network listener context to which thisService
is bound; returnsnull
if thisService
is unbound.void
setServiceContext(ServiceContext context)
Sets the network listener context to which thisService
is bound.
-
-
-
Method Detail
-
serviceContext
ServiceContext serviceContext()
Returns the network listener context to which thisService
is bound; returnsnull
if thisService
is unbound.
-
setServiceContext
void setServiceContext(ServiceContext context)
Sets the network listener context to which thisService
is bound.
-
createSocket
Socket createSocket()
Returns a newSocket
binding to handle an incoming network connection.
-
didBind
void didBind()
Lifecycle callback invoked by the service context after the underlying network listener has bound to a port.
-
didAccept
void didAccept(Socket socket)
Lifecycle callback invoked by the service context after the underlying network listener has accepted a newsocket
connection.
-
didUnbind
void didUnbind()
Lifecycle callback invoked by the service context after the underlying network listener has been unbound.
-
didFail
void didFail(Throwable error)
Lifecycle callback invoked by the service context when the underlying network listener fails by throwing anerror
. The listener will automatically be closed.
-
-