DatagramChannel

DatagramChannel

DatagramChannel (SelectorProvider provider)

初始化此类的新实例。

bind

DatagramChannel bind (SocketAddress local)

将通道的套接字绑定到本地地址。

此方法用于在套接字和本地地址之间建立关联。 一旦建立了关联，套接字就会保持绑定状态，直到通道关闭。 如果local参数的值为null则套接字将被绑定到自动分配的地址。

connect

DatagramChannel connect (SocketAddress remote)

连接此通道的插座。

通道的套接字配置为只接收来自给定远程对等地址的数据报并发送数据报给给定的远程对等地址。 一旦连接，数据报可能不会被接收或发送到任何其他地址。 数据报套接字保持连接状态，直到它明确断开连接或关闭。

此方法执行与DatagramSocket类的connect方法完全相同的安全检查。 也就是说，如果安装了安全管理器，那么这种方法将验证其方法checkAccept和checkConnect允许分别从给定的远程地址接收和发送数据报。

这个方法可以在任何时候调用。 它对调用时已经进行的读取或写入操作没有任何影响。 如果此通道的套接字未被绑定，则此方法将首先使套接字绑定到自动分配的地址，就像调用参数为null的bind方法null 。

disconnect

DatagramChannel disconnect ()

断开此通道的插座。

通道的套接字配置为只要安全管理器（如果已安装）允许它接收数据报并将数据报发送到任何远程地址。

这个方法可以在任何时候调用。 它对调用时已经进行的读取或写入操作没有任何影响。

如果此通道的套接字未连接，或者通道已关闭，则调用此方法不起作用。

getRemoteAddress

SocketAddress getRemoteAddress ()

返回此通道套接字连接的远程地址。

isConnected

boolean isConnected ()

确定是否连接了此通道的套接字。

open

DatagramChannel open ()

打开数据报通道。

新通道是通过调用系统范围的默认SelectorProvider对象的openDatagramChannel方法创建的。 该频道不会连接。

通道套接字的ProtocolFamily是平台（可能是配置）相关的，因此未指定。 open允许在打开数据报通道时选择协议族，并且应该用于打开用于Internet协议多播的数据报通道。

open

DatagramChannel open (ProtocolFamily family)

打开数据报通道。

family参数用于指定ProtocolFamily 。 如果数据报通道用于IP多路传输，那么这应该对应于该通道将加入的多播组的地址类型。

新通道是通过调用系统范围的默认SelectorProvider对象的openDatagramChannel方法创建的。 该频道不会连接。

read

long read (ByteBuffer[] dsts, 
                int offset, 
                int length)

从此通道读取数据报。

只有在此通道的套接字已连接的情况下才可以调用此方法，并且它只接受来自套接字对等方的数据报。 如果数据报中的字节多于保留在给定缓冲区中的字节，那么数据报的其余部分将被静默丢弃。 否则，此方法的行为与ScatteringByteChannel界面中的规定完全相同。

read

int read (ByteBuffer dst)

从此通道读取数据报。

只有在此通道的套接字已连接的情况下才可以调用此方法，并且它只接受来自套接字对等方的数据报。 如果数据报中有更多的字节比保留在给定的缓冲区中，那么数据报的其余部分将被静默丢弃。 否则，此方法的行为与ReadableByteChannel界面中指定的ReadableByteChannel 。

read

long read (ByteBuffer[] dsts)

从此通道读取数据报。

只有在此通道的套接字已连接的情况下才可以调用此方法，并且它只接受来自套接字对等方的数据报。 如果数据报中的字节多于保留在给定缓冲区中的字节，那么数据报的其余部分将被静默丢弃。 否则，此方法的行为与ScatteringByteChannel界面中的规定完全相同。

receive

SocketAddress receive (ByteBuffer dst)

通过此通道接收数据报。

如果数据报立即可用，或者如果该通道处于阻塞模式并且最终变为可用，则将数据报复制到给定字节缓冲区中，并返回其源地址。 如果此通道处于非阻塞模式并且数据报不能立即可用，则此方法立即返回null 。

数据报从当前位置开始传送到给定的字节缓冲区，就像通过常规的read操作一样。 如果缓冲区中剩余的字节数少于保存数据报所需的字节数，那么数据报的其余部分将被静默丢弃。

此方法执行与DatagramSocket类的receive方法完全相同的安全检查。 也就是说，如果套接字未连接到特定的远程地址和每个数据报接收的该方法验证源的地址和端口号是由安全管理器的所允许的安全管理器已安装然后checkAccept方法。 首先通过connect方法连接套接字，可以避免此安全检查的开销。

这个方法可以在任何时候调用。 然而，如果另一个线程已经在这个通道上启动了一个读操作，那么这个方法的调用将会阻塞，直到第一个操作完成。 如果此通道的套接字未绑定，则此方法将首先使套接字绑定到自动分配的地址，就好像调用参数为null的bind方法null 。

send

int send (ByteBuffer src, 
                SocketAddress target)

通过此通道发送数据报。

如果此通道处于非阻塞模式，并且基础输出缓冲区中有足够的空间，或者此通道处于阻塞模式并且有足够的空间可用，则给定缓冲区中的剩余字节将作为单个数据报传输到给定目标地址。

数据报从字节缓冲区传输，就像通过常规的 write操作一样。

此方法执行与DatagramSocket类的send方法完全相同的安全检查。 也就是说，如果套接字没有连接到特定的远程地址，并且已经安装了安全管理器，那么对于发送的每个数据报，此方法将验证安全管理器的方法checkConnect允许目标地址和端口号。 首先通过connect方法连接套接字，可以避免此安全检查的开销。

这个方法可以在任何时候调用。 但是，如果另一个线程已经在此通道上启动了写操作，则此方法的调用将会阻塞，直到第一个操作完成。 如果此通道的套接字未绑定，则此方法将首先使套接字绑定到自动分配的地址，就像调用bind方法的参数为null 。

setOption

DatagramChannel setOption (SocketOption<T> name, 
                T value)

设置套接字选项的值。

socket

DatagramSocket socket ()

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

返回的对象不会声明任何未在 DatagramSocket类中声明的公共方法。

validOps

int validOps ()

返回标识此频道支持的操作的操作集。

数据报通道支持读取和写入，因此此方法返回 ( OP_READ | OP_WRITE ) 。

write

int write (ByteBuffer src)

将数据报写入此通道。

如果此通道的套接字已连接，则只能调用此方法，在这种情况下，它将数据报直接发送到套接字的对等方。 否则，其行为与WritableByteChannel界面中的指定完全相同。

write

long write (ByteBuffer[] srcs)

将数据报写入此通道。

如果此通道的套接字已连接，则只能调用此方法，在这种情况下，它将数据报直接发送到套接字的对等方。 否则，其行为与GatheringByteChannel界面中的规定完全相同。

write

long write (ByteBuffer[] srcs, 
                int offset, 
                int length)

将数据报写入此通道。

如果此通道的套接字已连接，则只能调用此方法，在这种情况下，它将数据报直接发送到套接字的对等方。 否则，其行为与GatheringByteChannel界面中的指定完全相同。