模块 java.base
包 java.nio.channels

接口 AsynchronousChannel

所有父级接口：
AutoCloseable , Channel , Closeable
所有已知的子接口：
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 操作以在使用结果时提供上下文的对象类型。对于 state-less CompletionHandler 用于消耗许多 I/O 操作的结果的情况，附件很重要。

在第一种形式中，Future 接口定义的方法可用于检查操作是否已完成、等待其完成并检索结果。在第二种形式中，调用 CompletionHandler 以在完成或失败时使用 I/O 操作的结果。

实现此接口的通道是 asynchronously closeable ：如果 I/O 操作在通道上未完成并且调用了通道的 close 方法，则 I/O 操作失败并出现异常 AsynchronousCloseException 。

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

消除

Future接口定义了cancel 方法来取消执行。这会导致所有等待 I/O 操作结果的线程抛出 CancellationException 。是否可以取消底层 I/O 操作是高度特定于实现的，因此没有指定。如果取消使通道或它所连接的实体处于不一致状态，则通道将被置于特定于实现的error state中，以防止进一步尝试启动 I/O 操作相似的到被取消的操作。例如，如果一个读操作被取消，但实现不能保证没有从通道中读取字节，那么它会将通道置于错误状态；进一步尝试启动 read 操作会导致抛出未指定的运行时异常。类似地，如果写操作被取消但实现不能保证字节没有被写入通道，那么后续尝试启动 write 将失败并出现未指定的运行时异常。

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

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

自从：
1.7

  • 方法总结

    修饰符和类型
    方法
    描述
    void
    close()
    关闭此通道。

    在接口 java.nio.channels.Channel 中声明的方法

    isOpen