Package convex.net

Class NIOServer

java.lang.Object

convex.net.NIOServer

All Implemented Interfaces:

Closeable, AutoCloseable

public class NIOServer
extends Object
implements Closeable

NIO Server implementation that handles incoming messages on a given port. Allocates a single thread for the selector. Incoming messages are associated with a Connection (which is created if required), then placed on the receive message queue. This will block if the receive queue is full (thereby applying back-pressure to clients)

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_PORT
protected static final long	PRUNE_TIMEOUT
protected static final long	SELECT_TIMEOUT

Method Summary

Modifier and Type	Method	Description
void	close()
static NIOServer	create(Server server)	Creates a new unlaunched NIO server component
void	finalize()
InetSocketAddress	getHostAddress()	Gets the host address for this server (including port), or null if closed
int	getPort()	Gets the port that this server instance is listening on.
void	launch(String bindAddress, Integer port)	Launch NIO Server, binding to a given socket address
protected void	pruneConnections(long ts, Set<SelectionKey> keys)	Prune old connections
protected void	selectRead(SelectionKey key)
protected void	selectWrite(SelectionKey key)

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_PORT

public static final int DEFAULT_PORT

See Also:

• Constant Field Values

SELECT_TIMEOUT

protected static final long SELECT_TIMEOUT

See Also:

• Constant Field Values

PRUNE_TIMEOUT

protected static final long PRUNE_TIMEOUT

See Also:

• Constant Field Values

Method Details

create

public static NIOServer create(Server server)

Creates a new unlaunched NIO server component

Parameters:

server - Peer Server instance for this NIOServer

Returns:

New NIOServer instance

launch

public void launch(String bindAddress,
 Integer port)
            throws IOException

Launch NIO Server, binding to a given socket address

Parameters:

bindAddress - Address to bind to, or null to bind to all addresses (unspecified)

port - Port to use. If 0 or null, a default port will be used, with fallback to a random port

Throws:

IOException

getPort

public int getPort()

Gets the port that this server instance is listening on.

Returns:

Port number, or 0 if a server socket is not bound.

pruneConnections

protected void pruneConnections(long ts,
 Set<SelectionKey> keys)

Prune old connections

Parameters:

keys - Keys to examine

selectWrite

protected void selectWrite(SelectionKey key)
                    throws IOException

Throws:

IOException

selectRead

protected void selectRead(SelectionKey key)
                   throws IOException

Throws:

IOException

finalize

public void finalize()

Overrides:

finalize in class Object

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

getHostAddress

public InetSocketAddress getHostAddress()

Gets the host address for this server (including port), or null if closed

Returns:

Host address