语言

DatagramChannel 类

定义

面向数据报的套接字的可选通道。

[Android.Runtime.Register("java/nio/channels/DatagramChannel", DoNotGenerateAcw=true)]
public abstract class DatagramChannel : Java.Nio.Channels.Spi.AbstractSelectableChannel, IDisposable, Java.Nio.Channels.IByteChannel, Java.Nio.Channels.IGatheringByteChannel, Java.Nio.Channels.IScatteringByteChannel
[<Android.Runtime.Register("java/nio/channels/DatagramChannel", DoNotGenerateAcw=true)>]
type DatagramChannel = class
    inherit AbstractSelectableChannel
    interface IByteChannel
    interface IReadableByteChannel
    interface IChannel
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IWritableByteChannel
    interface IGatheringByteChannel
    interface IScatteringByteChannel
继承
特性
实现

注解

面向数据报的套接字的可选通道。

通过调用此类方法之 #open open 一来创建数据报通道。 无法为任意预先存在的数据报套接字创建通道。 新创建的数据报通道已打开,但未连接。 数据报通道不需要连接才能 #send send 使用和 #receive receive 方法。 通过调用数据 #connect connect 报通道的方法,可以连接数据报通道,以避免在每次发送和接收操作过程中执行安全检查的开销。 必须连接数据报通道才能使用 #read(java.nio.ByteBuffer) read 和 #write(java.nio.ByteBuffer) write 方法,因为这些方法不接受或返回套接字地址。

连接后,数据报通道将保持连接状态,直到它断开连接或关闭。 是否连接数据报通道可以通过调用其 #isConnected isConnected 方法来确定。

套接字选项是使用 #setOption(SocketOption,Object) setOption 该方法配置的。 Internet 协议套接字的数据报通道支持以下选项:<blockquote<>table class=“striped”><caption style=“display:none”>Socket options</caption><thead<>tr><th scope=“col”>Option Name</th<>scope=“col”>Description</th></tr<>/thead><tbody><tr><th scope=“row”<java.net.StandardSocketOptions#SO_SNDBUF SO_SNDBUF>/th><td> The size套接字发送缓冲区 </td/tr>><<th scope=“row”<>java.net.StandardSocketOptions#SO_RCVBUF SO_RCVBUF/th><td> 套接字接收缓冲区 </td<><>/><tr tr><th scope=“row”java.net.StandardSocketOptions#SO_REUSEADDR SO_REUSEADDR></th<>td> Re-use address </td/><tr><th scope=“row”><java.net.StandardSocketOptions#SO_BROADCAST SO_BROADCAST/th><td> 允许传输广播数据报 </td<<>>/tr><tr><th scope=“row”>java.net.StandardSocketOptions#IP_TOS IP_TOS</th><td> Internet 协议 (IP) 标头 </td<>/tr<>tr<>th scope=“row”java.net.StandardSocketOptions#IP_MULTICAST_IF IP_MULTICAST_IF></th><td> Internet 协议 (IP) 多播数据报<的网络接口 /td></tr><tr<>th scope=“row”>java.net.StandardSocketOptions#IP_MULTICAST_TTL IP_MULTICAST_TTL</th<>td> The time-to-live对于 Internet 协议 (IP) 多播数据报 </td<>/tr<>tr<>th scope=“row”<>java.net.StandardSocketOptions#IP_MULTICAST_LOOP IP_MULTICAST_LOOP/th<>td> Loopback for Internet Protocol (IP) 多播数据报 </td<>/tr></tbody<>/table></blockquote> 其他(特定于实现)选项,也可能受支持。

数据报通道可以安全地供多个并发线程使用。 它们支持并发读取和写入,但最多一个线程可能正在读取,最多一个线程可能在任意给定时间写入。

在 1.4 中添加。

Java文档java.nio.channels.DatagramChannel。

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

构造函数

名称 说明
DatagramChannel(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

DatagramChannel(SelectorProvider)

初始化此类的新实例。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
IsBlocking

指示此通道是否处于阻塞模式。

(继承自 AbstractSelectableChannel)
IsConnected

返回此通道的套接字是否已连接。

IsOpen

如果此通道处于打开状态,则返回 true。

(继承自 AbstractInterruptibleChannel)
IsRegistered

指示此通道是否已向一个或多个选择器注册。

(继承自 AbstractSelectableChannel)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

LocalAddress

返回此通道的套接字绑定到的套接字地址,或者 null 如果套接字未绑定。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
RemoteAddress

返回此通道的套接字连接到的远程地址,或者 null 如果套接字未连接。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

方法

名称 说明
Begin()

标记可能无限期阻止的 I/O 操作的开头。

(继承自 AbstractInterruptibleChannel)
Bind(SocketAddress)

已在 1.7 中添加。

BlockingLock()

获取用于同步 register 和 configureBlocking.

(继承自 AbstractSelectableChannel)
Clone()

创建并返回此对象的副本。

(继承自 Object)
Close()

关闭此通道。

(继承自 AbstractInterruptibleChannel)
ConfigureBlocking(Boolean)

调整此通道的阻止模式。

(继承自 AbstractSelectableChannel)
Connect(SocketAddress)

连接此通道的套接字。

ConnectAsync(SocketAddress)

在任务中运行同步连接操作,以将此通道的数据报限制为指定的对等方。

Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Disconnect()

断开此通道的套接字的连接。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
End(Boolean)

标记可能无限期阻止的 I/O 操作的末尾。

(继承自 AbstractInterruptibleChannel)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
ImplCloseChannel()

关闭此通道。

(继承自 AbstractSelectableChannel)
ImplCloseSelectableChannel()

关闭此可选通道。

(继承自 AbstractSelectableChannel)
ImplConfigureBlocking(Boolean)

调整此通道的阻止模式。

(继承自 AbstractSelectableChannel)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
KeyFor(Selector)

获取指定选择器的此通道的选择键。

(继承自 AbstractSelectableChannel)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
Open()

打开数据报通道。

Open(IProtocolFamily)

打开数据报通道。

Provider()

返回创建此通道的提供程序。

(继承自 AbstractSelectableChannel)
Read(ByteBuffer)

从此通道读取数据报。

Read(ByteBuffer[], Int32, Int32)

从此通道读取数据报。

Read(ByteBuffer[])

从此通道读取数据报。

Receive(ByteBuffer)

通过此通道接收数据报。

ReceiveAsync(ByteBuffer)

在任务中运行同步接收操作,以将一个数据报接收到缓冲区中。

Register(Selector, Operations, Object)

将此通道注册到给定的选择器,并返回选择键。

(继承自 AbstractSelectableChannel)
Register(Selector, Operations)

将此通道注册到给定的选择器,并返回选择键。

(继承自 SelectableChannel)
Send(ByteBuffer, SocketAddress)

通过此通道发送数据报。

SendAsync(ByteBuffer, SocketAddress)

在任务中运行同步发送操作,以将剩余的缓冲区字节作为一个数据报发送。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetOption(ISocketOption, Object)

已在 1.7 中添加。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
Socket()

检索与此通道关联的数据报套接字。

ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
ValidOps()

返回一个操作集,用于标识此通道支持的操作。

Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Write(ByteBuffer)

将数据报写入此通道。

Write(ByteBuffer[], Int32, Int32)

将数据报写入此通道。

Write(ByteBuffer[])

将数据报写入此通道。

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

从运行时的Java对象查找中删除此实例。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

ReadAsync(IReadableByteChannel, ByteBuffer)

在任务中运行通道的同步读取操作。

ReadAsync(IScatteringByteChannel, ByteBuffer[], Int32, Int32)

在任务中运行通道的同步散点读取到所选缓冲区中。

ReadAsync(IScatteringByteChannel, ByteBuffer[])

运行通道的同步散点读取到任务中的所有提供的缓冲区中。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

WriteAsync(IGatheringByteChannel, ByteBuffer[], Int32, Int32)

从任务中的所选缓冲区运行通道的同步收集写入。

WriteAsync(IGatheringByteChannel, ByteBuffer[])

从任务中提供的所有缓冲区运行通道的同步收集写入。

WriteAsync(IWritableByteChannel, ByteBuffer)

在任务中运行通道的同步写入操作。

适用于