鸿蒙OS开发文档 鸿蒙OS DatagramPacket

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 1

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)构造一个数据报包,用于将长度长度的数据包发送到指定主机上的指定端口号。

方法总结

修饰符和类型方法描述
InetAddressgetAddress()返回此数据报被发送到或接收到数据报的机器的 IP 地址。
byte[]getData()返回数据缓冲区。
intgetLength()返回要发送的数据的长度或接收的数据的长度。
intgetOffset()返回要发送的数据的偏移量或接收的数据的偏移量。
intgetPort()返回此数据报被发送到或从其接收到的远程主机上的端口号。
SocketAddressgetSocketAddress()获取此数据包正在发送到或来自的远程主机的 SocketAddress(通常是 IP 地址 + 端口号)。
voidsetAddress(InetAddress iaddr)设置要发送此数据报的机器的 IP 地址。
voidsetData(byte[] buf)设置此数据包的数据缓冲区。
voidsetData(byte[] buf, int offset, int length)设置此数据包的数据缓冲区。
voidsetLength(int length)设置此数据包的长度。
voidsetPort(int iport)设置此数据报要发送到的远程主机上的端口号。
voidsetSocketAddress(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如果长度为负或长度大于数据包的数据缓冲区长度。