java.nio.channels

Class SelectableChannel

java.lang.Object

java.nio.channels.spi.AbstractInterruptibleChannel

java.nio.channels.SelectableChannel

All Implemented Interfaces:

Closeable, AutoCloseable, Channel, InterruptibleChannel

Direct Known Subclasses:

AbstractSelectableChannel

public abstract class SelectableChannel
extends AbstractInterruptibleChannel

Since:

1.4

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SelectableChannel() Initializes the channel.

Method Summary

Methods

Modifier and Type	Method and Description
abstract Object	blockingLock() Returns the lock of this channel.
abstract SelectableChannel	configureBlocking(boolean block) Adjusts this channel's blocking mode.
abstract boolean	isBlocking() Tells whether this channel is blocking or not.
abstract boolean	isRegistered() Tells whether or not this channel is currently registered with any selectors.
abstract SelectionKey	keyFor(Selector sel) Retrieves the key representing the channel's registration with the given selector.
abstract SelectorProvider	provider() Returns the provider that created this channel.
SelectionKey	register(Selector sel, int ops) Registers this channel with the given selector, returning a selection key.
abstract SelectionKey	register(Selector sel, int ops, Object att) Registers this channel with the given selector, returning a selection key.
abstract int	validOps() Returns a set of valid operations on this channel.

Methods inherited from class java.nio.channels.spi.AbstractInterruptibleChannel

begin, close, end, implCloseChannel, isOpen

Methods inherited from class java.lang.Object

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

Constructor Detail

SelectableChannel

protected SelectableChannel()

Initializes the channel.

Method Detail

blockingLock

public abstract Object blockingLock()

Returns the lock of this channel.

configureBlocking

public abstract SelectableChannel configureBlocking(boolean block)
                                             throws IOException

Adjusts this channel's blocking mode.

Throws:

ClosedChannelException - If this channel is closed.

IllegalBlockingModeException - If block is true and this channel is registered with one or more selectors.

IOException - If an error occurs.

isBlocking

public abstract boolean isBlocking()

Tells whether this channel is blocking or not.

isRegistered

public abstract boolean isRegistered()

Tells whether or not this channel is currently registered with any selectors.

keyFor

public abstract SelectionKey keyFor(Selector sel)

Retrieves the key representing the channel's registration with the given selector.

provider

public abstract SelectorProvider provider()

Returns the provider that created this channel.

register

public final SelectionKey register(Selector sel,
                    int ops)
                            throws ClosedChannelException

Registers this channel with the given selector, returning a selection key.

Throws:

CancelledKeyException - If this channel is currently registered with the given selector but the corresponding key has already been cancelled

ClosedChannelException - If this channel is closed.

IllegalArgumentException - If a bit in ops does not correspond to an operation that is supported by this channel, that is, if set & ~validOps() != 0.

IllegalBlockingModeException - If block is true and this channel is registered with one or more selectors.

IllegalSelectorException - If this channel was not created by the same provider as the given selector.

register

public abstract SelectionKey register(Selector sel,
                    int ops,
                    Object att)
                               throws ClosedChannelException

Registers this channel with the given selector, returning a selection key.

Throws:

CancelledKeyException - If this channel is currently registered with the given selector but the corresponding key has already been cancelled.

ClosedChannelException - If this channel is closed.

IllegalArgumentException - If a bit in ops does not correspond to an operation that is supported by this channel, that is, if set & ~validOps() != 0.

IllegalBlockingModeException - If block is true and this channel is registered with one or more selectors.

IllegalSelectorException - If this channel was not created by the same provider as the given selector.

validOps

public abstract int validOps()

Returns a set of valid operations on this channel.