IAsynchronousChannel 接口

定义

命名空间:: Java.Nio.Channels

程序集:: Mono.Android.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

支持异步 I/O 操作的通道。

[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 操作通常采用以下两种形式之一：

{@link Future}<V> <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>< 来使用许多 I/O 操作的结果的情况>CompletionHandler非常重要。

在第一种形式中，接口定义的 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使用参数设置为 mayInterruptIfRunning 调用true该方法时，I/O 操作可能会通过关闭通道中断。在这种情况下，所有等待 I/O 操作结果的线程都会引发 CancellationException ，通道上 AsynchronousCloseException未完成的任何其他 I/O 操作除外。

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

已在 1.7 中添加。

Java文档java.nio.channels.AsynchronousChannel。

本页的某些部分是根据创建和共享的工作进行的修改，并根据许可证中所述的条款使用。

属性

名称	说明
Handle	获取基础 Android 对象的 JNI 值。 (继承自 IJavaObject)
IsOpen	如果此通道处于打开状态，则返回 true。 (继承自 IChannel)
JniIdentityHashCode	返回包装实例的值 `java.lang.System.identityHashCode()` 。 (继承自 IJavaPeerable)
JniManagedPeerState	托管对等方的状态。 (继承自 IJavaPeerable)
JniObjectReferenceControlBlock	支持异步 I/O 操作的通道。 (继承自 IJavaPeerable)
JniPeerMembers	成员访问和调用支持。 (继承自 IJavaPeerable)
PeerReference	返回JniObjectReference包装的Java对象实例。 (继承自 IJavaPeerable)

方法

名称	说明
Close()	关闭此通道。
Disposed()	在释放实例时调用。 (继承自 IJavaPeerable)
DisposeUnlessReferenced()	如果没有对此实例的未完成引用，则调用 `Dispose()`;否则不执行任何操作。 (继承自 IJavaPeerable)
Finalized()	在实例完成时调用。 (继承自 IJavaPeerable)
SetJniIdentityHashCode(Int32)	设置由 `JniIdentityHashCode`. 返回的值。 (继承自 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	支持异步 I/O 操作的通道。 (继承自 IJavaPeerable)
SetPeerReference(JniObjectReference)	设置由 `PeerReference`. 返回的值。 (继承自 IJavaPeerable)
UnregisterFromRuntime()	取消注册此实例，使运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。 (继承自 IJavaPeerable)

扩展方法

名称	说明
GetJniTypeName(IJavaPeerable)	获取实例 `self`类型的 JNI 名称。
JavaAs<TResult>(IJavaPeerable)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。
JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	支持异步 I/O 操作的通道。
TryJavaCast<TResult>(IJavaPeerable, TResult)	尝试强制`self`键入`TResult`，检查强制是否在Java端有效。

适用于