IAsynchronousChannel 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，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- 派生
- 属性
- 实现
注解
支持异步 I/O 操作的通道。 异步 I/O 操作通常采用以下两种形式之一：
<ol><li>
{@link Future}<V> <em>operation</em>(<em>...</em>)
</li><li>
void <em>operation</em>(<em>...</em> A attachment, {@link
CompletionHandler}<V,? super A> handler)
</li></ol>
其中 operation 是 I/O 操作 (读取或写入的名称，例如 ) ，V 是 I/O 操作的结果类型， A 是附加到 I/O 操作的对象类型，以便在使用结果时提供上下文。 对于使用 em>无状态/emCompletionHandler> 来使用许多 I/O 操作的结果的情况<，附件<非常重要。
在第一种形式中，接口定义Future Future的方法可用于检查操作是否已完成、等待操作完成以及检索结果。 第二种形式是调用 ， CompletionHandler 以在 I/O 操作完成或失败时使用该操作的结果。
实现此接口的通道是 <em>异步 closeable</em>：如果通道上的 I/O 操作未完成，并且调用了通道的 #close close 方法，则 I/O 操作将失败并出现异常 AsynchronousCloseException。
异步通道可以安全地供多个并发线程使用。 某些通道实现可能支持并发读取和写入，但可能不允许在任何给定时间执行多个读取和一个写入操作。
<h2>Cancellation</h2>
接口 Future 定义 Future#cancel cancel 取消执行的方法。 这会导致等待 I/O 操作结果的所有线程引发 java.util.concurrent.CancellationException。 是否可以取消基础 I/O 操作是高度特定于实现的，因此未指定。 如果取消使通道或它连接到的实体处于不一致状态，则通道将置于特定于 <实现的 em>error state</em> 中，从而阻止进一步尝试启动 类似于 已取消的操作的 I/O 操作。 例如，如果取消了读取操作，但实现无法保证未从通道中读取字节，则会将通道置于错误状态;进一 read 步尝试启动操作会导致引发未指定的运行时异常。 同样，如果取消了写入操作，但实现无法保证字节未写入通道，则后续尝试启动 write 将失败，并出现未指定的运行时异常。
Future#cancel cancel如果调用方法且mayInterruptIfRunning参数设置为 true ，则 I/O 操作可能会因关闭通道而中断。 在这种情况下，等待 I/O 操作结果的所有线程都会引发， CancellationException 通道上未完成的任何其他 I/O 操作都已完成， AsynchronousCloseException异常为 。
cancel调用 方法以取消读取或写入操作时，建议丢弃 I/O 操作中使用的所有缓冲区，或小心确保通道保持打开状态时不会访问缓冲区。
在 1.7 中添加。
的 java.nio.channels.AsynchronousChannelJava 文档。
此页面的某些部分是基于 创建和共享的工作进行的修改，并根据 署名许可中所述的条款使用。
属性
| Handle |
获取基础 Android 对象的 JNI 值。 (继承自 IJavaObject) |
| IsOpen |
如果此通道处于打开状态，则返回 true。 (继承自 IChannel) |
| JniIdentityHashCode |
返回包装实例的 的值 |
| JniManagedPeerState |
托管对等方的状态。 (继承自 IJavaPeerable) |
| JniPeerMembers |
成员访问和调用支持。 (继承自 IJavaPeerable) |
| PeerReference |
返回 JniObjectReference 包装的 Java 对象实例的 。 (继承自 IJavaPeerable) |
方法
| Close() |
关闭此通道。 |
| Disposed() |
在释放实例时调用。 (继承自 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果没有对此实例的未完成引用，则调用 |
| Finalized() |
在实例完成时调用。 (继承自 IJavaPeerable) |
| SetJniIdentityHashCode(Int32) |
设置 返回 |
| SetJniManagedPeerState(JniManagedPeerStates) |
支持异步 I/O 操作的通道。 (继承自 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
设置 返回 |
| UnregisterFromRuntime() |
取消注册此实例，以便运行时不会从将来 Java.Interop.JniRuntime+JniValueManager.PeekValue 的调用中返回它。 (继承自 IJavaPeerable) |
扩展方法
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
支持异步 I/O 操作的通道。 |
| GetJniTypeName(IJavaPeerable) |
支持异步 I/O 操作的通道。 |