鸿蒙OS DatagramPacket

DatagramPacket

java.lang.Object

|—java.net.DatagramPacket

public final class DatagramPacket
extends Object

这个类代表一个数据报包。

数据报包用于实现无连接的包传递服务。 每条消息仅根据该数据包中包含的信息从一台机器路由到另一台机器。 从一台机器发送到另一台机器的多个数据包可能会以不同的方式路由,并且可能以任何顺序到达。 不保证数据包交付。

构造函数摘要

构造函数 描述
DatagramPacket(byte[] buf, int length) 构造一个 DatagramPacket 用于接收长度长度的数据包。
DatagramPacket(byte[] buf, int offset, int length) 构造一个 DatagramPacket 用于接收长度长度的数据包,指定缓冲区的偏移量。
DatagramPacket(byte[] buf, int offset, int length, InetAddress address, int port) 构造一个数据报包,用于发送长度为长度的数据包,偏移量为 ioffset 到指定主机上的指定端口号。
DatagramPacket(byte[] buf, int offset, int length, SocketAddress address) 构造一个数据报包,用于发送长度为长度的数据包,偏移量为 ioffset 到指定主机上的指定端口号。
DatagramPacket(byte[] buf, int length, InetAddress address, int port) 构造一个数据报包,用于将长度长度的数据包发送到指定主机上的指定端口号。
DatagramPacket(byte[] buf, int length, SocketAddress address) 构造一个数据报包,用于将长度长度的数据包发送到指定主机上的指定端口号。

方法总结

修饰符和类型 方法 描述
InetAddress getAddress() 返回此数据报被发送到或接收到数据报的机器的 IP 地址。
byte[] getData() 返回数据缓冲区。
int getLength() 返回要发送的数据的长度或接收的数据的长度。
int getOffset() 返回要发送的数据的偏移量或接收的数据的偏移量。
int getPort() 返回此数据报被发送到或从其接收到的远程主机上的端口号。
SocketAddress getSocketAddress() 获取此数据包正在发送到或来自的远程主机的 SocketAddress(通常是 IP 地址 + 端口号)。
void setAddress(InetAddress iaddr) 设置要发送此数据报的机器的 IP 地址。
void setData(byte[] buf) 设置此数据包的数据缓冲区。
void setData(byte[] buf, int offset, int length) 设置此数据包的数据缓冲区。
void setLength(int length) 设置此数据包的长度。
void setPort(int iport) 设置此数据报要发送到的远程主机上的端口号。
void setSocketAddress(SocketAddress address) 设置这个数据报被发送到的远程主机的 SocketAddress(通常是 IP 地址 + 端口号)。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

DatagramPacket

public DatagramPacket(byte[] buf, int offset, int length)

构造一个 DatagramPacket 用于接收长度长度的数据包,指定缓冲区的偏移量。

长度参数必须小于或等于 buf.length。

参数:

参数名称 参数描述
buf 用于保存传入数据报的缓冲区。
offset 缓冲区的偏移量
length 要读取的字节数。

DatagramPacket

public DatagramPacket(byte[] buf, int length)

构造一个 DatagramPacket 用于接收长度长度的数据包。

长度参数必须小于或等于 buf.length。

参数:

参数名称 参数描述
buf 用于保存传入数据报的缓冲区。
length 要读取的字节数。

DatagramPacket

public DatagramPacket(byte[] buf, int offset, int length, InetAddress address, int port)

构造一个数据报包,用于发送长度为长度的数据包,偏移量为 ioffset 到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。

参数:

参数名称 参数描述
buf 数据包数据。
offset 数据包数据偏移量。
length 包数据长度。
address 目的地址。
port 目的端口号。

DatagramPacket

public DatagramPacket(byte[] buf, int offset, int length, SocketAddress address)

构造一个数据报包,用于发送长度为长度的数据包,偏移量为 ioffset 到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。

参数:

参数名称 参数描述
buf 数据包数据。
offset 数据包数据偏移量。
length 包数据长度。
address 目标套接字地址。

Throws:

Throw名称 Throw描述
IllegalArgumentException 如果不支持地址类型

DatagramPacket

public DatagramPacket(byte[] buf, int length, InetAddress address, int port)

构造一个数据报包,用于将长度长度的数据包发送到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。

参数:

参数名称 参数描述
buf 数据包数据。
length 数据包长度。
address 目的地址。
port 目的端口号。

DatagramPacket

public DatagramPacket(byte[] buf, int length, SocketAddress address)

构造一个数据报包,用于将长度长度的数据包发送到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。

参数:

参数名称 参数描述
buf 数据包数据。
length 数据包长度。
address 目的地址。

Throws:

Throw名称 Throw描述
IllegalArgumentException 如果不支持地址类型

方法详情

getAddress

public InetAddress getAddress()

返回此数据报被发送到或接收到数据报的机器的 IP 地址。

返回:

发送该数据报的机器的 IP 地址或接收该数据报的机器的 IP 地址。

getPort

public int getPort()

返回此数据报被发送到或从其接收到的远程主机上的端口号。

返回:

发送该数据报或接收该数据报的远程主机上的端口号。

getData

public byte[] getData()

返回数据缓冲区。 接收到的数据或要发送的数据从缓冲区中的偏移量开始,运行长度为 long。

返回:

用于接收或发送数据的缓冲区

getOffset

public int getOffset()

返回要发送的数据的偏移量或接收的数据的偏移量。

返回:

要发送的数据的偏移量或接收的数据的偏移量。

getLength

public int getLength()

返回要发送的数据的长度或接收的数据的长度。

返回:

要发送的数据的长度或接收的数据的长度。

setData

public void setData(byte[] buf, int offset, int length)

设置此数据包的数据缓冲区。 这将设置数据包的数据、长度和偏移量。

参数:

参数名称 参数描述
buf 为此数据包设置的缓冲区
offset 数据中的偏移量
length 数据的长度和/或用于接收数据的缓冲区的长度

Throws:

Throw名称 Throw描述
NullPointerException 如果参数为空

setAddress

public void setAddress(InetAddress iaddr)

设置要发送此数据报的机器的 IP 地址。

参数:

参数名称 参数描述
iaddr 网络地址

setPort

public void setPort(int iport)

设置此数据报要发送到的远程主机上的端口号。

参数:

参数名称 参数描述
iport 端口号

setSocketAddress

public void setSocketAddress(SocketAddress address)

设置这个数据报被发送到的远程主机的 SocketAddress(通常是 IP 地址 + 端口号)。

参数:

参数名称 参数描述
address 套接字地址

Throws:

Throw名称 Throw描述
IllegalArgumentException 如果地址为 null 或者是此套接字不支持的 SocketAddress 子类

getSocketAddress

public SocketAddress getSocketAddress()

获取此数据包正在发送到或来自的远程主机的 SocketAddress(通常是 IP 地址 + 端口号)。

返回:

套接字地址

setData

public void setData(byte[] buf)

设置此数据包的数据缓冲区。 将此 DatagramPacket 的偏移量设置为 0,并将长度设置为 buf 的长度。

参数:

参数名称 参数描述
buf 为此数据包设置的缓冲区。

Throws:

Throw名称 Throw描述
NullPointerException 如果参数为空。

setLength

public void setLength(int length)

设置此数据包的长度。 数据包的长度是将要发送的数据包数据缓冲区中的字节数,或将用于接收数据的数据包数据缓冲区的字节数。 长度必须小于或等于偏移量加上数据包缓冲区的长度。

参数:

参数名称 参数描述
length 为此数据包设置的长度。

Throws:

Throw名称 Throw描述
IllegalArgumentException 如果长度为负或长度大于数据包的数据缓冲区长度。
版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS DatagramPacket》
文章链接:https://zhuji.vsping.com/313587.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。