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	如果长度为负或长度大于数据包的数据缓冲区长度。