compact1, compact2, compact3

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:

Closeable， AutoCloseable， Channel， InterruptibleChannel

已知直接子类：

DatagramChannel， Pipe.SinkChannel， Pipe.SourceChannel， ServerSocketChannel， SocketChannel

public abstract class AbstractSelectableChannel
extends SelectableChannel

用于可选择信道的基本实现类。

这类定义的方法处理通道登记、注销登记的力学，和关闭。它保持这个通道的电流阻塞模式，以及它的选择键的当前组。它执行所需执行的SelectableChannel规范同步。在这个类中定义的抽象保护方法的实现不需要同步对可能在同一个操作中的其他线程进行同步。

从以下版本开始：

一点四

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	AbstractSelectableChannel(SelectorProvider provider) 初始化该类的一个新实例。

方法摘要

Modifier and Type	Method and Description
Object	blockingLock() 检索对象的 configureBlocking和 register方法同步。
SelectableChannel	configureBlocking(boolean block) 调整这个通道的阻塞模式。
protected void	implCloseChannel() 关闭此通道。
protected abstract void	implCloseSelectableChannel() 关闭此可选择的通道。
protected abstract void	implConfigureBlocking(boolean block) 调整这个通道的阻塞模式。
boolean	isBlocking() 告诉是否每一个I / O操作这个通道将阻止，直到它完成。
boolean	isRegistered() 告诉是否这个频道是目前任何选择器注册。
SelectionKey	keyFor(Selector sel) 用给定选择器检索表示信道的注册的键。
SelectorProvider	provider() 返回创建此通道的提供程序。
SelectionKey	register(Selector sel, int ops, Object att) 用所给的选择器来注册这个通道，返回一个选择键。

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

Methods inherited from interface java.nio.channels.Channel

close, isOpen

Constructor Detail

AbstractSelectableChannel

protected AbstractSelectableChannel(SelectorProvider provider)

初始化该类的一个新实例。

参数

provider -供应商，创造了这个频道

方法详细信息

provider

public final SelectorProvider provider()

返回创建此通道的提供程序。

Specified by:

provider 方法重写，继承类 SelectableChannel

结果

创建此通道的提供程序

isRegistered

public final boolean isRegistered()

从阶级复制的描述： SelectableChannel

告诉是否这个频道是目前任何选择器注册。未注册新创建的信道。

由于关键的消除和信道注销之间的固有延迟、信道可保持注册一段时间后，其所有的按键都被取消了。通道也可能在关闭后的一段时间保持注册一段时间。

Specified by:

isRegistered 方法重写，继承类 SelectableChannel

结果

true如果，如果，这个渠道注册

keyFor

public final SelectionKey keyFor(Selector sel)

从阶级复制的描述： SelectableChannel

用给定选择器检索表示信道的注册的键。

Specified by:

keyFor 方法重写，继承类 SelectableChannel

参数

sel -选择器

结果

关键又回到这个通道上注册时用给定的选择器，或 null如果这个通道不该选择注册

register

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

用所给的选择器来注册这个通道，返回一个选择键。

此方法首先验证此通道是开放的，并且给定的初始兴趣集是有效的。

如果该信道已在给定选择器中注册，则表示该注册的选择键在将其设置为给定值的兴趣集返回后返回。

否则该通道尚未注册与给定的选择，这样的选择register方法被调用时保持适当的锁。将所得的键添加到该通道的键集之前返回。

Specified by:

register 方法重写，继承类 SelectableChannel

参数

sel -选择这种渠道是可以注册

ops集产生兴趣的关键

att -产生的关键附件；可 null

结果

用给定选择器表示此通道的注册的一个键

异常

ClosedSelectorException -如果选择关闭

IllegalBlockingModeException -如果这通道阻塞模式

IllegalSelectorException -如果这通道不是由同一供应商创建给定选择器

CancelledKeyException -如果这个频道是目前与给定选择器注册但相应的密钥已被取消

IllegalArgumentException -如果在 ops集一点不对应，通过这个渠道，是支持一个操作，如果 set & ~validOps() != 0

ClosedChannelException -如果这通道关闭

implCloseChannel

protected final void implCloseChannel()
                               throws IOException

关闭此通道。

这种方法，这是在AbstractInterruptibleChannel类指定并由close方法调用时，将调用命令implCloseSelectableChannel方法来执行关闭该通道的实际工作。然后取消此通道的所有键。

Specified by:

implCloseChannel 方法重写，继承类 AbstractInterruptibleChannel

异常

IOException如果I/O错误时关闭通道

implCloseSelectableChannel

protected abstract void implCloseSelectableChannel()
                                            throws IOException

关闭此可选择的通道。

这种方法是以close方法调用执行关闭通道的实际工作。此方法只被调用，如果通道还没有被关闭，它永远不会被调用不止一次。

此方法的一个实现，必须安排任何其他线程被阻塞在这个通道上的I / O操作立即返回，无论是通过抛出一个异常或返回正常。

异常

IOException如果I/O错误发生

isBlocking

public final boolean isBlocking()

从阶级复制的描述： SelectableChannel

告诉是否每一个I / O操作这个通道将阻止，直到它完成。一个新创建的信道总是处于阻塞模式。

如果此通道被关闭，则不指定此方法返回的值。

Specified by:

isBlocking 方法重写，继承类 SelectableChannel

结果

true如果，如果，这个渠道是阻塞模式

blockingLock

public final Object blockingLock()

从阶级复制的描述： SelectableChannel

检索对象的 configureBlocking和 register方法同步。这是在适配器，需要一个特定的阻塞模式保持一段时间的实施往往是有用的。

Specified by:

blockingLock 方法重写，继承类 SelectableChannel

结果

阻塞模式锁定对象

configureBlocking

public final SelectableChannel configureBlocking(boolean block)
                                          throws IOException

调整这个通道的阻塞模式。

如果给定的阻塞模式不同于当前的阻塞模式那么这个方法调用implConfigureBlocking方法，同时保持适当的锁，为了改变模式。

Specified by:

configureBlocking 方法重写，继承类 SelectableChannel

参数

block -如果 true在此通道将被放置在阻塞模式；如果 false然后将非阻塞模式

结果

这个可选的通道

异常

ClosedChannelException -如果这通道关闭

IOException如果I/O错误发生

implConfigureBlocking

protected abstract void implConfigureBlocking(boolean block)
                                       throws IOException

调整这个通道的阻塞模式。

这种方法是以configureBlocking方法调用执行改变阻塞模式的实际工作。如果新模式与当前模式不同，则只调用此方法。

参数

block -如果 true在此通道将被放置在阻塞模式；如果 false然后将非阻塞模式

异常

IOException如果I/O错误发生