compact1, compact2, compact3

java.nio.channels

Interface AsynchronousChannel

All Superinterfaces:

AutoCloseable ， Channel ， Closeable

All Known Subinterfaces:

AsynchronousByteChannel

所有已知实现类：

AsynchronousFileChannel ， AsynchronousServerSocketChannel ， AsynchronousSocketChannel

public interface AsynchronousChannel
extends Channel

支持异步I / O操作的通道。 异步I / O操作通常采用以下两种形式之一：

1.   Future<V> operation(...) 

2.   void operation(... A attachment, CompletionHandler<V,? super A> handler) 

其中操作是I / O操作的名称（例如读或写）， V是I / O操作的结果类型， A是附加到I / O操作以提供上下文的对象的类型消耗结果。 对于无状态 CompletionHandler用于消耗许多I / O操作的结果的情况， CompletionHandler很重要。

在第一种形式中，由Future接口定义的方法可用于检查操作是否已经完成，等待其完成，并检索结果。 在第二种形式中，一个CompletionHandler被调用它何时完成或失败来消耗I / O操作的结果。

实现此接口的通道异步关闭 ：如果通道上的I / O操作未完成，并且调用通道的close方法，则I / O操作将失败，但AsynchronousCloseException 除外 。

异步通道可以安全地被多个并发线程使用。 一些通道实现可以支持并发读取和写入，但是在任何给定时间可能不允许多于一个读取和一个写入操作。

消除

Future接口定义了取消执行的cancel方法。 这将导致所有线程等待I / O操作的结果抛出CancellationException 。 是否可以取消基础I / O操作是高度实现具体的，因此未指定。 如果取消离开通道或其连接的实体处于不一致的状态，则该通道将被置于实现特定的错误状态 ，以防止进一步尝试启动类似于已取消操作的I / O操作。 例如，如果读取操作被取消，但实现不能保证字节没有从通道读取，那么它将通道置于错误状态; 进一步尝试启动read操作会引起未指定的运行时异常。 同样，如果一个写操作将被取消，但执行不能保证字节还没有被写入通道，然后随后尝试启动write将失败，未指定的运行时异常。

在cancel方法调用mayInterruptIfRunning参数设置为true下，I / O操作可能会由于关闭通道而中断。 在这种情况下，等待I / O操作结果的所有线程都抛出CancellationException以及任何其他在通道上未完成的I / O操作，并且异常AsynchronousCloseException 。

在调用cancel方法以取消读取或写入操作的情况下，建议丢弃在I / O操作中使用的所有缓冲区，或注意确保在通道保持打开状态时不访问缓冲区。

从以下版本开始：

1.7

方法摘要

Modifier and Type	Method and Description
void	close() 关闭此频道。

Methods inherited from interface java.nio.channels.Channel

isOpen

方法详细信息

close

void close()
    throws IOException

关闭此频道。

此通道上的任何未完成的异步操作将完成，但AsynchronousCloseException 除外 。 在关闭通道后，进一步尝试启动异步I / O操作，立即完成原因ClosedChannelException 。

该方法的行为与Channel接口的规定完全相同。

Specified by:

close在界面 AutoCloseable

Specified by:

close中的 Channel

Specified by:

close在接口 Closeable

异常

IOException - 如果发生I / O错误