org.avineas.io.tcp

Class ServerSocketChannel

java.lang.Object

org.avineas.io.tcp.ServerSocketChannel

All Implemented Interfaces:

java.io.Closeable, Channel, ReadChannel, WriteChannel

public class ServerSocketChannel
extends java.lang.Object

Base channel for incoming TCP connections. Accepts one connection at a time and keeps reading from it until the connection is lost and then tries to re-establish the connection. As such it is a kind of permanent virtual circuit.

Author:

Arie van Wijngaarden

Constructor Summary

Constructors

Constructor and Description
ServerSocketChannel(int port) Construct a server socket channel on a specific local port.

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
int	read(byte[] data, int offset, long timeout) Read a packet or byte array from the channel, filling up either the data buffer or the information as present in the packet.
java.lang.String	toString()
int	write(byte[] data, int length) Write a packet or number of bytes via the channel.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerSocketChannel

public ServerSocketChannel(int port)
                    throws java.io.IOException

Construct a server socket channel on a specific local port.

Parameters:

port - The port to listen on

Throws:

java.io.IOException - In case of errors

Method Detail

read

public int read(byte[] data,
       int offset,
       long timeout)

Description copied from interface: ReadChannel

Read a packet or byte array from the channel, filling up either the data buffer or the information as present in the packet.

Specified by:

read in interface ReadChannel

Parameters:

data - The byte buffer to read into

offset - The offset in the buffer to start reading

timeout - The timeout to wait for the first byte of data to become available, in ms. If a value <= 0 is passed, no waiting is done at all

Returns:

The number of bytes read. -1 on error, 0 if no data available within the timeout. The returned number of bytes may be less than would be expected given the size of the data buffer

write

public int write(byte[] data,
        int length)

Description copied from interface: WriteChannel

Write a packet or number of bytes via the channel.

Specified by:

write in interface WriteChannel

Parameters:

data - The data to write

length - The length to write

Returns:

The number of bytes written, normally the value of the parameter 'length'. -1 is returned if the channel is somehow closed or another error occurred

close

@PreDestroy
public void close()

Specified by:

close in interface java.io.Closeable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object