com.threerings.presents.server.net

Class PresentsConnection

java.lang.Object

com.threerings.nio.conman.Connection

com.threerings.presents.server.net.PresentsConnection

All Implemented Interfaces:

NetEventHandler

Direct Known Subclasses:

AuthingConnection

public class PresentsConnection
extends Connection

Parses incoming network data into a stream of Message objects, sends messages to the client and adds datagram support to a connection.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	PresentsConnection.MessageHandler Used with setMessageHandler(com.threerings.presents.server.net.PresentsConnection.MessageHandler).

Field Summary

Fields inherited from class com.threerings.nio.conman.Connection

selkey

Constructor Summary

Constructors

Constructor and Description
PresentsConnection()

Method Summary

Modifier and Type	Method and Description
void	clearMessageHandler() Clears out our message handler, causing any subsequent messages to be dropped on arrival.
InetSocketAddress	getDatagramAddress() Returns the address to which datagrams should be sent or null if no datagram address has been established.
DatagramChannel	getDatagramChannel() Returns the channel through which datagrams should be sent or null if no datagram channel has been established.
boolean	getTransmitDatagrams() Checks whether we should transmit datagrams.
void	handleDatagram(InetSocketAddress source, DatagramChannel channel, ByteBuffer buf, long when) Processes a datagram sent to this connection.
int	handleEvent(long when) Called when a network event has occurred on this handler's source.
void	init(ConnectionManager cmgr, SocketChannel channel, long createStamp) Initializes the connection with its channel.
void	postMessage(Message msg) Posts a message for delivery to this connection.
void	setClassLoader(ClassLoader loader) Configures this connection with a custom class loader.
void	setDatagramSecret(String secret) Sets the secret string used to authenticate datagrams from the client.
void	setMessageHandler(PresentsConnection.MessageHandler handler) Instructs the connection to pass parsed messages on to this handler for processing.
void	setTransmitDatagrams(boolean transmit) Sets whether we should transmit datagrams.

Methods inherited from class com.threerings.nio.conman.Connection

asyncClose, becameIdle, checkIdle, close, connectFailure, getChannel, getConnectionId, getInetAddress, isClosed, networkFailure, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PresentsConnection

public PresentsConnection()

Method Detail

init

public void init(ConnectionManager cmgr,
                 SocketChannel channel,
                 long createStamp)
          throws IOException

Initializes the connection with its channel. Must be called with a PresentsConnectionManager as cmgr.

Overrides:

init in class Connection

Parameters:

cmgr - The connection manager with which this connection is associated.

channel - The socket channel from which we'll be reading messages.

createStamp - The time at which this connection was created.

Throws:

IOException

setMessageHandler

public void setMessageHandler(PresentsConnection.MessageHandler handler)

Instructs the connection to pass parsed messages on to this handler for processing. This should be done before the connection is turned loose to process messages.

clearMessageHandler

public void clearMessageHandler()

Clears out our message handler, causing any subsequent messages to be dropped on arrival. A log message is recorded for the dropped messages.

setClassLoader

public void setClassLoader(ClassLoader loader)

Configures this connection with a custom class loader.

setTransmitDatagrams

public void setTransmitDatagrams(boolean transmit)

Sets whether we should transmit datagrams.

getTransmitDatagrams

public boolean getTransmitDatagrams()

Checks whether we should transmit datagrams.

getDatagramAddress

public InetSocketAddress getDatagramAddress()

Returns the address to which datagrams should be sent or null if no datagram address has been established.

getDatagramChannel

public DatagramChannel getDatagramChannel()

Returns the channel through which datagrams should be sent or null if no datagram channel has been established.

setDatagramSecret

public void setDatagramSecret(String secret)

Sets the secret string used to authenticate datagrams from the client.

postMessage

public void postMessage(Message msg)

Posts a message for delivery to this connection. The message will be delivered by the conmgr thread as soon as it gets to it.

handleDatagram

public void handleDatagram(InetSocketAddress source,
                           DatagramChannel channel,
                           ByteBuffer buf,
                           long when)

Processes a datagram sent to this connection.

handleEvent

public int handleEvent(long when)

Description copied from interface: NetEventHandler

Called when a network event has occurred on this handler's source.

Returns:

the number of bytes read from the network as a result of handling this event.