DatagramPacket
java.lang.Object
|—java.net.DatagramPacket
public final class DatagramPacket
extends Object这个类代表一个数据报包。
数据报包用于实现无连接的包传递服务。 每条消息仅根据该数据包中包含的信息从一台机器路由到另一台机器。 从一台机器发送到另一台机器的多个数据包可能会以不同的方式路由，并且可能以任何顺序到达。 不保证数据包交付。
构造函数摘要
构造函数描述
DatagramPacket(byte[]buf,intlength)
构造一个DatagramPacket用于接收长度长度的数据包。
DatagramPacket(byte[]buf,intoffset,intlength)
构造一个DatagramPacket用于接收长度长度的数据包，指定缓冲区的偏移量。
DatagramPacket(byte[]buf,intoffset,intlength,InetAddressaddress,intport)
构造一个数据报包，用于发送长度为长度的数据包，偏移量为ioffset到指定主机上的指定端口号。
DatagramPacket(byte[]buf,intoffset,intlength,SocketAddressaddress)
构造一个数据报包，用于发送长度为长度的数据包，偏移量为ioffset到指定主机上的指定端口号。
DatagramPacket(byte[]buf,intlength,InetAddressaddress,intport)
构造一个数据报包，用于将长度长度的数据包发送到指定主机上的指定端口号。
DatagramPacket(byte[]buf,intlength,SocketAddressaddress)
构造一个数据报包，用于将长度长度的数据包发送到指定主机上的指定端口号。
方法总结
修饰符和类型方法描述
InetAddress
getAddress()
返回此数据报被发送到或接收到数据报的机器的IP地址。
byte[]
getData()
返回数据缓冲区。
int
getLength()
返回要发送的数据的长度或接收的数据的长度。
int
getOffset()
返回要发送的数据的偏移量或接收的数据的偏移量。
int
getPort()
返回此数据报被发送到或从其接收到的远程主机上的端口号。
SocketAddress
getSocketAddress()
获取此数据包正在发送到或来自的远程主机的SocketAddress（通常是IP地址+端口号）。
void
setAddress(InetAddressiaddr)
设置要发送此数据报的机器的IP地址。
void
setData(byte[]buf)
设置此数据包的数据缓冲区。
void
setData(byte[]buf,intoffset,intlength)
设置此数据包的数据缓冲区。
void
setLength(intlength)
设置此数据包的长度。
void
setPort(intiport)
设置此数据报要发送到的远程主机上的端口号。
void
setSocketAddress(SocketAddressaddress)
设置这个数据报被发送到的远程主机的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
如果长度为负或长度大于数据包的数据缓冲区长度。