java.nio.channels.spi

Class AbstractSelectableChannel

java.lang.Object

java.nio.channels.spi.AbstractInterruptibleChannel

java.nio.channels.SelectableChannel

java.nio.channels.spi.AbstractSelectableChannel

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.nio.channels.Channel, java.nio.channels.InterruptibleChannel

public abstract class AbstractSelectableChannel
extends java.nio.channels.SelectableChannel

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSelectableChannel(SelectorProvider provider) Initializes the channel

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	blockingLock() Retrieves the object upon which the configureBlocking and register methods synchronize.
java.nio.channels.SelectableChannel	configureBlocking(boolean blocking) Adjusts this channel's blocking mode.
protected void	implCloseChannel() Closes this channel.
protected abstract void	implCloseSelectableChannel() Closes this selectable channel.
protected abstract void	implConfigureBlocking(boolean blocking) Adjusts this channel's blocking mode.
boolean	isBlocking() Tells whether or not every I/O operation on this channel will block until it completes.
boolean	isRegistered() Tells whether or not this channel is currently registered with any selectors.
java.nio.channels.SelectionKey	keyFor(java.nio.channels.Selector selector) Retrieves the key representing the channel's registration with the given selector.
SelectorProvider	provider() Returns the provider that created this channel.
java.nio.channels.SelectionKey	register(java.nio.channels.Selector selin, int ops, java.lang.Object att) Registers this channel with the given selector, returning a selection key.

Methods inherited from class java.nio.channels.SelectableChannel

register, validOps

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

begin, close, end, isOpen

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractSelectableChannel

protected AbstractSelectableChannel(SelectorProvider provider)

Initializes the channel

Parameters:

provider - the provider that created this channel

Method Detail

blockingLock

public final java.lang.Object blockingLock()

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

Specified by:

blockingLock in class java.nio.channels.SelectableChannel

Returns:

the blocking lock

configureBlocking

public final java.nio.channels.SelectableChannel configureBlocking(boolean blocking)
                                                            throws java.io.IOException

Adjusts this channel's blocking mode.

Specified by:

configureBlocking in class java.nio.channels.SelectableChannel

Parameters:

blocking - true if blocking should be enabled, false otherwise

Returns:

this channel

Throws:

java.io.IOException - If an error occurs

implCloseChannel

protected final void implCloseChannel()
                               throws java.io.IOException

Closes this channel.

Specified by:

implCloseChannel in class AbstractInterruptibleChannel

Throws:

java.io.IOException - If an error occurs

implCloseSelectableChannel

protected abstract void implCloseSelectableChannel()
                                            throws java.io.IOException

Closes this selectable channel.

Throws:

java.io.IOException - If an error occurs

implConfigureBlocking

protected abstract void implConfigureBlocking(boolean blocking)
                                       throws java.io.IOException

Adjusts this channel's blocking mode.

Parameters:

blocking - true if blocking should be enabled, false otherwise

Throws:

java.io.IOException - If an error occurs

isBlocking

public final boolean isBlocking()

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

Specified by:

isBlocking in class java.nio.channels.SelectableChannel

Returns:

true of this channel is blocking, false otherwise

isRegistered

public final boolean isRegistered()

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

Specified by:

isRegistered in class java.nio.channels.SelectableChannel

Returns:

true if this channel is registered, false otherwise

keyFor

public final java.nio.channels.SelectionKey keyFor(java.nio.channels.Selector selector)

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

Specified by:

keyFor in class java.nio.channels.SelectableChannel

Parameters:

selector - the selector to get a selection key for

Returns:

the selection key this channel is registered with

provider

public final SelectorProvider provider()

Returns the provider that created this channel.

Specified by:

provider in class java.nio.channels.SelectableChannel

Returns:

the selector provider that created this channel

register

public final java.nio.channels.SelectionKey register(java.nio.channels.Selector selin,
                                      int ops,
                                      java.lang.Object att)
                                              throws java.nio.channels.ClosedChannelException

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

Specified by:

register in class java.nio.channels.SelectableChannel

Parameters:

selin - the seletor to use

ops - the interested operations

att - an attachment for the returned selection key

Returns:

the registered selection key

Throws:

java.nio.channels.ClosedChannelException - If the channel is already closed.

java.nio.channels.IllegalBlockingModeException - If the channel is configured in blocking mode.