All Superinterfaces:

AsynchronousChannel ， AutoCloseable ， Channel ， Closeable

所有已知实现类：

AsynchronousSocketChannel
```
public interface AsynchronousByteChannel
extends AsynchronousChannel
```
一个可以读写字节的异步通道。
某些频道在任何给定的时间可能不允许多于一个读或写。如果线程在先前的读取操作完成之前调用读取方法，那么将抛出一个ReadPendingException 。类似地，如果在先前写入完成之前调用了写入方法，则抛出WritePendingException 。其他类型的I / O操作是否可以与读取操作同时进行取决于通道的类型。

请注意， ByteBuffers不适合多个并发线程使用。当启动读或写操作时，必须注意确保在操作完成之前不访问缓冲区。

从以下版本开始：

1.7

另请参见：

Channels.newInputStream(AsynchronousByteChannel) ， Channels.newOutputStream(AsynchronousByteChannel)

方法摘要

所有方法接口方法抽象方法
Modifier and Type	方法	描述
`Future<Integer>`	`read(ByteBuffer dst)`	从该通道读取到给定缓冲区的字节序列。
`<A> void`	`read(ByteBuffer dst, A attachment, CompletionHandler<Integer,? super A> handler)`	从该通道读取到给定缓冲区的字节序列。
`Future<Integer>`	`write(ByteBuffer src)`	从给定的缓冲区向该通道写入一个字节序列。
`<A> void`	`write(ByteBuffer src, A attachment, CompletionHandler<Integer,? super A> handler)`	从给定的缓冲区向该通道写入一个字节序列。

Methods inherited from interface java.nio.channels.AsynchronousChannel
close

Methods inherited from interface java.nio.channels.Channel
isOpen

- 方法详细信息
  - read
```
<A> void read(ByteBuffer dst,
              A attachment,
              CompletionHandler<Integer,? super A> handler)
```
    从该通道读取到给定缓冲区的字节序列。
    该方法启动异步读取操作，以从该通道读取到给定缓冲器中的字节序列。 handler参数是一个完成处理程序，在读取操作完成（或失败）时调用该处理程序。传递给完成处理程序的结果是读取的字节数或-1如果没有字节可以读取，因为通道已达到流出尾。
    
    读取操作可以从通道读取r个字节，其中r是缓冲区中剩余的字节数，即尝试读取时的dst.remaining() 。其中r为0，读操作立即完成，结果为0而不启动I / O操作。
    
    假设长度为n的字节序列被读取，其中0 < n <= r 。该字节序列将被转移到缓冲器，使得序列中的第一个字节是在索引p和最后一个字节是在索引p + Ñ - 1 ，其中p为缓冲区的位置在执行读取的时刻。完成后，缓冲区的位置将等于p + n ; 其限制将不会改变。
    
    缓冲区不能安全地被多个并发线程使用，因此在操作完成之前，请注意不要访问缓冲区。
    
    可以随时调用此方法。某些渠道类型在任何给定时间可能不允许多于一个读取。如果线程在先前的读取操作完成之前启动读取操作，那么将抛出一个ReadPendingException 。
    
    参数类型
    
    A - 附件的类型
    
    参数
    
    dst - 要传输字节的缓冲区
    
    attachment - 要附加到I / O操作的对象; 可以是null
    
    handler - 完成处理程序
    
    异常
    
    IllegalArgumentException - 如果缓冲区是只读的
    
    ReadPendingException - 如果通道不允许多个读取未完成，并且以前的读取尚未完成
    
    ShutdownChannelGroupException - 如果通道与已终止的group关联
  - read
```
Future<Integer> read(ByteBuffer dst)
```
    从该通道读取到给定缓冲区的字节序列。
    该方法启动异步读取操作，以从该通道读取到给定缓冲器中的字节序列。该方法的行为方式与read(ByteBuffer,Object,CompletionHandler)方法完全相同，不同之处在于，该方法不是指定完成处理程序，而是返回表示待处理结果的Future 。 Future的get方法返回读取的字节数或-1如果没有字节可以读取，因为通道已经到达流终止。
    
    参数
    
    dst - 要传输字节的缓冲区
    
    结果
    
    代表操作结果的未来
    
    异常
    
    IllegalArgumentException - 如果缓冲区是只读的
    
    ReadPendingException - 如果通道不允许多个读取未完成，并且以前的读取尚未完成
  - write
```
<A> void write(ByteBuffer src,
               A attachment,
               CompletionHandler<Integer,? super A> handler)
```
    从给定的缓冲区向该通道写入一个字节序列。
    该方法启动异步写入操作，以从给定的缓冲区向该通道写入字节序列。 handler参数是在写操作完成（或失败）时调用的完成处理程序。传递给完成处理程序的结果是写入的字节数。
    
    写入操作可以写入r字节到通道，其中r是缓冲区中剩余的字节数，即在尝试写入时的src.remaining() 。其中r为0，写操作立即完成，结果为0而不启动I / O操作。
    
    假设写入长度为n的字节序列，其中0 < n <= r 。该字节序列将从索引p开始从缓冲区传送，其中p是执行写入时的缓冲区的位置; 写入的最后一个字节的索引将为p + n - 1 。完成后，缓冲区的位置将等于p + n ; 其限制将不会改变。
    
    缓冲区不能安全地被多个并发线程使用，因此在操作完成之前，请注意不要访问缓冲区。
    
    可以随时调用此方法。某些频道类型可能不允许在任何给定时间多出一个写入。如果线程在先前写入操作完成之前启动了写入操作，那么将抛出一个WritePendingException 。
    
    参数类型
    
    A - 附件的类型
    
    参数
    
    src - 要检索字节的缓冲区
    
    attachment - 要附加到I / O操作的对象; 可以是null
    
    handler - 完成处理程序对象
    
    异常
    
    WritePendingException - 如果通道不允许多个写入未完成，并且以前的写入尚未完成
    
    ShutdownChannelGroupException - 如果通道与已终止的group关联
  - write
```
Future<Integer> write(ByteBuffer src)
```
    从给定的缓冲区向该通道写入一个字节序列。
    该方法启动异步写入操作，以从给定的缓冲区向该通道写入字节序列。该方法的行为方式与write(ByteBuffer,Object,CompletionHandler)方法完全相同，不同之处在于，该方法不是指定完成处理程序，而是返回表示待处理结果的Future 。 Future的get方法返回写入的字节数。
    
    参数
    
    src - 要检索字节的缓冲区
    
    结果
    
    代表操作结果的未来
    
    异常
    
    WritePendingException - 如果通道不允许多个写入未完成，并且以前的写入尚未完成

Interface AsynchronousByteChannel

方法摘要

Methods inherited from interface java.nio.channels.AsynchronousChannel

Methods inherited from interface java.nio.channels.Channel

方法详细信息

read

read

write

write