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