SelectableChannel JDK 1.6)

Description

publicabstract abstract class SelectableChannel

A channel that can be multiplexed via a Selector.

In order to be used with a selector, an instance of this class must first be registered via the register method. This method returns a new SelectionKey object that represents the channel's registration with the selector.

Once registered with a selector, a channel remains registered until it is deregistered. This involves deallocating whatever resources were allocated to the channel by the selector.

A channel cannot be deregistered directly; instead, the key representing its registration must be cancelled. Cancelling a key requests that the channel be deregistered during the selector's next selection operation. A key may be cancelled explicitly by invoking its cancel method. All of a channel's keys are cancelled implicitly when the channel is closed, whether by invoking its close method or by interrupting a thread blocked in an I/O operation upon the channel.

If the selector itself is closed then the channel will be deregistered, and the key representing its registration will be invalidated, without further delay.

A channel may be registered at most once with any particular selector.

Whether or not a channel is registered with one or more selectors may be determined by invoking the isRegistered method.

Selectable channels are safe for use by multiple concurrent threads.

Blocking mode

A selectable channel is either in blocking mode or in non-blocking mode. In blocking mode, every I/O operation invoked upon the channel will block until it completes. In non-blocking mode an I/O operation will never block and may transfer fewer bytes than were requested or possibly no bytes at all. The blocking mode of a selectable channel may be determined by invoking its isBlocking method.

Newly-created selectable channels are always in blocking mode. Non-blocking mode is most useful in conjunction with selector-based multiplexing. A channel must be placed into non-blocking mode before being registered with a selector, and may not be returned to blocking mode until it has been deregistered.

See also: SelectionKey Selector

Methods

Hide/Show inherited methods

protectedfinal void begin () [Inherited From AbstractInterruptibleChannel]

Marks the beginning of an I/O operation that might block indefinitely.

publicabstract Object blockingLock ()

Retrieves the object upon which the configureBlocking and register methods synchronize.

publicfinal void close () throws IOException [Inherited From AbstractInterruptibleChannel]

Closes this channel.

publicabstract SelectableChannel configureBlocking (boolean block) throws IOException

Adjusts this channel's blocking mode.

protectedfinal void end (boolean completed) throws AsynchronousCloseException [Inherited From AbstractInterruptibleChannel]

Marks the end of an I/O operation that might block indefinitely.

protectedabstract void implCloseChannel () throws IOException [Inherited From AbstractInterruptibleChannel]

Closes this channel.

publicabstract boolean isBlocking ()

Tells whether or not every I/O operation on this channel will block until it completes.

publicfinal boolean isOpen () [Inherited From AbstractInterruptibleChannel]

publicabstract boolean isRegistered ()

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

publicabstract SelectionKey keyFor (Selector sel)

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

publicabstract SelectorProvider provider ()

Returns the provider that created this channel.

publicfinal SelectionKey register (Selector sel, int ops) throws ClosedChannelException

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

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

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

publicabstract int validOps ()

Returns an operation set identifying this channel's supported operations.