IAsynchronousChannel 接口

定义

[Android.Runtime.Register("java/nio/channels/AsynchronousChannel", "", "Java.Nio.Channels.IAsynchronousChannelInvoker", ApiSince=26)]
public interface IAsynchronousChannel : IDisposable, Java.Interop.IJavaPeerable, Java.Nio.Channels.IChannel

[<Android.Runtime.Register("java/nio/channels/AsynchronousChannel", "", "Java.Nio.Channels.IAsynchronousChannelInvoker", ApiSince=26)>]
type IAsynchronousChannel = interface
    interface IChannel
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

派生

Java.Nio.Channels.AsynchronousFileChannel

Java.Nio.Channels.AsynchronousServerSocketChannel

Java.Nio.Channels.AsynchronousSocketChannel

Java.Nio.Channels.IAsynchronousByteChannel

属性

RegisterAttribute

实现

IJavaObject IJavaPeerable ICloseable IChannel IDisposable

注解

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

<ol><li>

{@link Future}&lt;V&gt; <em>operation</em>(<em>...</em>)

</li li><>

void <em>operation</em>(<em>...</em> A attachment, {@link
              CompletionHandler}&lt;V,? super A&gt; handler)

</li></ol>

其中 操作是 I/O 操作 的名称（例如读取或写入）， V 是 I/O 操作的结果类型， A 是附加到 I/O 操作的对象的类型，以便在使用结果时提供上下文。 附件对于使用 em 无状态</em>CompletionHandler 来使用许多 I/O 操作的结果的情况<>非常重要。

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

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

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

<h2>Cancellation</h2>

该 Future 接口定义 Future#cancel cancel 取消执行的方法。 这会导致所有等待 I/O 操作结果的线程引发 java.util.concurrent.CancellationException。 是否可以取消基础 I/O 操作是高度具体的实现，因此未指定。 如果取消离开通道或其连接的实体处于不一致状态，则该通道将置于实现特定的 <em 错误状态</em> 中，从而阻止进一步尝试启动与取消的操作类似的 I/O 操作>。 例如，如果读取操作被取消，但实现无法保证尚未从通道读取字节，则它将通道置于错误状态;进一 read 步尝试启动操作会导致引发未指定的运行时异常。 同样，如果写入操作被取消，但实现无法保证尚未写入通道的字节，则后续尝试启动写入 write 操作将失败并出现未指定的运行时异常。

Future#cancel cancel使用参数设置为 true 调用mayInterruptIfRunning该方法时，I/O 操作可能会通过关闭通道中断。 在这种情况下，所有等待 I/O 操作结果的线程都会引发 CancellationException ，通道上 AsynchronousCloseException未完成的任何其他 I/O 操作除外。

cancel如果调用该方法以取消读取或写入操作，则建议放弃 I/O 操作中使用的所有缓冲区或小心，以确保在通道保持打开状态时不会访问缓冲区。

已在 1.7 中添加。

适用于 . 的 java.nio.channels.AsynchronousChannelJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

属性

方法

扩展方法

适用于