Package ch.qos.logback.core.net.server
Class ServerSocketListener<T extends Client>
- java.lang.Object
-
- ch.qos.logback.core.net.server.ServerSocketListener<T>
-
- All Implemented Interfaces:
ServerListener<T>
,Closeable
,AutoCloseable
public abstract class ServerSocketListener<T extends Client> extends Object implements ServerListener<T>
AServerListener
that accepts connections on aServerSocket
.
-
-
Constructor Summary
Constructors Constructor Description ServerSocketListener(ServerSocket serverSocket)
Constructs a new listener.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description T
acceptClient()
Accepts the next client that appears on this listener.void
close()
Closes any underlyingCloseable
resources associated with this listener.String
toString()
-
-
-
Constructor Detail
-
ServerSocketListener
public ServerSocketListener(ServerSocket serverSocket)
Constructs a new listener.- Parameters:
serverSocket
- server socket delegate
-
-
Method Detail
-
acceptClient
public T acceptClient() throws IOException
Accepts the next client that appears on this listener.An implementation of this method is expected to block the calling thread and not return until either a client appears or an exception occurs.
- Specified by:
acceptClient
in interfaceServerListener<T extends Client>
- Returns:
- client object
- Throws:
IOException
-
close
public void close()
Closes any underlyingCloseable
resources associated with this listener.Note that (as described in Doug Lea's discussion about interrupting I/O operations in "Concurrent Programming in Java" (Addison-Wesley Professional, 2nd edition, 1999) this method is used to interrupt any blocked I/O operation in the client when the server is shutting down. The client implementation must anticipate this potential, and gracefully exit when the blocked I/O operation throws the relevant
IOException
subclass.Note also, that unlike
Closeable.close()
this method is not permitted to propagate anyIOException
that occurs when closing the underlying resource(s).- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceServerListener<T extends Client>
-
-