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);
 }

end方法的completed参数说明I / O操作是否实际完成，也就是说它是否具有对调用者可见的任何效果。 在读取字节的操作的情况下，例如，如果只有某些字节实际传输到调用者的目标缓冲区中，则该参数应为true 。

具体的通道类还必须以这样的方式实现implCloseChannel方法：如果在通道上的本地I / O操作中阻止另一个线程时被调用，则该操作将立即返回，通过抛出异常或正常返回。 如果一个线程被中断或被阻塞的通道被异步地关闭，则通道的end方法将抛出适当的异常。

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

从以下版本开始：

1.4

构造方法摘要

构造方法

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

构造方法详细信息

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操作中阻塞的线程中断