org.cojen.dirmi.io

Interface ChannelConnector

All Superinterfaces:

AutoCloseable, Closeable

All Known Subinterfaces:

ChannelBroker

All Known Implementing Classes:

BufferedSocketChannelConnector, PipedChannelBroker, RecyclableSocketChannelConnector

public interface ChannelConnector
extends Closeable

Supports direct channel connection to a remote endpoint. All channels are linked to the same remote endpoint.

Author:

Brian S O'Neill

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ChannelConnector.Listener Listener for acceping channels asynchronously.

Method Summary

Modifier and Type	Method and Description
void	close() Prevents new channels from being connected and closes all connected channels.
Channel	connect() Returns a new channel, possibly blocking until it has been established.
void	connect(ChannelConnector.Listener listener) Register a listener which is asynchronously given a connected channel.
Channel	connect(long timeout, TimeUnit unit) Returns a new channel, possibly blocking until it has been established.
Channel	connect(Timer timer) Returns a new channel, possibly blocking until it has been established.
Object	getLocalAddress()
Object	getRemoteAddress()

Method Detail

getRemoteAddress

Object getRemoteAddress()

Returns:

remote address of connected channels or null if unknown

getLocalAddress

Object getLocalAddress()

Returns:

local address of connected channels or null if unknown

connect

Channel connect()
         throws IOException

Returns a new channel, possibly blocking until it has been established.

Throws:

IOException

connect

Channel connect(long timeout,
                TimeUnit unit)
         throws IOException

Returns a new channel, possibly blocking until it has been established.

Throws:

IOException

connect

Channel connect(Timer timer)
         throws IOException

Returns a new channel, possibly blocking until it has been established.

Throws:

IOException

connect

void connect(ChannelConnector.Listener listener)

Register a listener which is asynchronously given a connected channel. Listener is called at most once per registration.

close

void close()

Prevents new channels from being connected and closes all connected channels.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable