org.xnio.channels
Interface AcceptingChannel<C extends ConnectedChannel>

Type Parameters:

C - the channel type

All Superinterfaces:

BoundChannel, Channel, Closeable, CloseableChannel, Configurable, InterruptibleChannel, SimpleAcceptingChannel<C>, SuspendableAcceptChannel

public interface AcceptingChannel<C extends ConnectedChannel>
extends BoundChannel, SimpleAcceptingChannel<C>

A channel which can accept inbound connections from remote endpoints.

Author:

David M. Lloyd

Method Summary

C	accept() Attempt to accept a connection.
ChannelListener.Setter<? extends AcceptingChannel<C>>	getAcceptSetter() Get the setter which can be used to change the accept listener for this channel.
ChannelListener.Setter<? extends AcceptingChannel<C>>	getCloseSetter() Get the setter which can be used to change the close listener for this channel.

Methods inherited from interface org.xnio.channels.BoundChannel

getLocalAddress, getLocalAddress

Methods inherited from interface org.xnio.channels.SuspendableAcceptChannel

awaitAcceptable, awaitAcceptable, resumeAccepts, suspendAccepts, wakeupAccepts

Methods inherited from interface org.xnio.channels.CloseableChannel

close, getWorker

Methods inherited from interface java.nio.channels.Channel

isOpen

Methods inherited from interface org.xnio.channels.Configurable

getOption, setOption, supportsOption

Method Detail

accept

C accept()
                                  throws IOException

Attempt to accept a connection.

Specified by:

accept in interface SimpleAcceptingChannel<C extends ConnectedChannel>

Returns:

the new connection, or null if none is available

Throws:

IOException - if an I/O error occurs

getAcceptSetter

ChannelListener.Setter<? extends AcceptingChannel<C>> getAcceptSetter()

Get the setter which can be used to change the accept listener for this channel. When the listener is called, additional notifications are automatically suspended.

Specified by:

getAcceptSetter in interface SimpleAcceptingChannel<C extends ConnectedChannel>

Specified by:

getAcceptSetter in interface SuspendableAcceptChannel

Returns:

the setter

getCloseSetter

ChannelListener.Setter<? extends AcceptingChannel<C>> getCloseSetter()

Get the setter which can be used to change the close listener for this channel. If the channel is already closed, then the listener will not be called.

Specified by:

getCloseSetter in interface BoundChannel

Specified by:

getCloseSetter in interface CloseableChannel

Specified by:

getCloseSetter in interface SimpleAcceptingChannel<C extends ConnectedChannel>

Specified by:

getCloseSetter in interface SuspendableAcceptChannel

Returns:

the setter