compact1, compact2, compact3

java.nio.channels.spi

Class AbstractInterruptibleChannel

java.lang.Object

java.nio.channels.spi.AbstractInterruptibleChannel

All Implemented Interfaces:

Closeable， AutoCloseable， Channel， InterruptibleChannel

已知直接子类：

FileChannel， SelectableChannel

public abstract class AbstractInterruptibleChannel
extends Object
implements Channel, InterruptibleChannel

可中断通道基本实现类。

这个类封装了需要实现信道的异步关闭和中断低级机械。一个具体的通道类必须调用begin和end方法之前和之后，分别调用I/O操作可能会无限期的阻塞。为了确保end总是调用方法，这些方法应在一个try …用 finally块：

 boolean completed = false;
 try {
     begin();
     completed = ...;    // Perform blocking I/O operation
     return ...;         // Return result
 } finally {
     end(completed);
 }

的completed争论的end方法告诉是否实际完成的I/O操作，即，是否有任何影响，将给调用者可见。在一个操作读取字节，该案为例，这个说法应该是true如果只有几个字节，实际上是转移到调用者的目标缓冲区。

一个具体的通道类也必须贯彻implCloseChannel方法在这样一种方式，如果是调用另一个线程被阻塞在本地I/O操作在通道那操作将立即返回，或者抛出一个异常或恢复正常。如果一个线程被中断或通道的堵塞是异步关闭通道的end方法将抛出相应的异常。

这类执行需要实现Channel规范同步。该方法的实现不需要同步implCloseChannel对其他线程可能会试图关闭通道。

从以下版本开始：

一点四

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	Method and Description
protected void	begin() 标志着一个可能会被无限期阻止的I / O操作的开始。
void	close() 关闭此通道。
protected void	end(boolean completed) 标志着一个“I / O操作”的结束，可能会被无限期地阻止。
protected abstract void	implCloseChannel() 关闭此通道。
boolean	isOpen() 告诉是否这个通道是打开的。

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractInterruptibleChannel

protected AbstractInterruptibleChannel()

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

方法详细信息

close

public final void close()
                 throws IOException

关闭此通道。

如果通道已被关闭，则此方法将立即返回。否则，它标志着通道关闭，然后调用implCloseChannel方法为了完成关闭操作。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

Specified by:

close 接口 Channel

Specified by:

close 接口 InterruptibleChannel

异常

IOException如果I/O错误发生

implCloseChannel

protected abstract void implCloseChannel()
                                  throws IOException

关闭此通道。

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

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

异常

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

isOpen

public final boolean isOpen()

从接口复制的描述： Channel

告诉是否这个通道是打开的。

Specified by:

isOpen 接口 Channel

结果

true如果，如果，这个通道是开放的

begin

protected final void begin()

标志着一个可能会被无限期阻止的I / O操作的开始。

这种方法应与end串联调用方法，使用try … finally块如图所示above，为了实现这个通道异步关闭和中断。

end

protected final void end(boolean completed)
                  throws AsynchronousCloseException

标志着一个“I / O操作”的结束，可能会被无限期地阻止。

这种方法应与begin串联调用方法，使用try … finally块如图所示above，为了实现这个通道异步关闭和中断。

参数

completed - true如果，仅仅是如果，I/O操作成功完成，即产生了一定的影响，会对操作的调用可见

异常

AsynchronousCloseException如果通道异步关闭

ClosedByInterruptException -如果该线程在I/O操作阻塞中断