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 |
public DatagramPacket(byte[] buf, int offset, int length)
构造一个 DatagramPacket 用于接收长度长度的数据包,指定缓冲区的偏移量。
长度参数必须小于或等于 buf.length。
参数:
参数名称 | 参数描述 |
---|---|
buf | 用于保存传入数据报的缓冲区。 |
offset | 缓冲区的偏移量 |
length | 要读取的字节数。 |
public DatagramPacket(byte[] buf, int length)
构造一个 DatagramPacket 用于接收长度长度的数据包。
长度参数必须小于或等于 buf.length。
参数:
参数名称 | 参数描述 |
---|---|
buf | 用于保存传入数据报的缓冲区。 |
length | 要读取的字节数。 |
public DatagramPacket(byte[] buf, int offset, int length, InetAddress address, int port)
构造一个数据报包,用于发送长度为长度的数据包,偏移量为 ioffset 到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。
参数:
参数名称 | 参数描述 |
---|---|
buf | 数据包数据。 |
offset | 数据包数据偏移量。 |
length | 包数据长度。 |
address | 目的地址。 |
port | 目的端口号。 |
public DatagramPacket(byte[] buf, int offset, int length, SocketAddress address)
构造一个数据报包,用于发送长度为长度的数据包,偏移量为 ioffset 到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。
参数:
参数名称 | 参数描述 |
---|---|
buf | 数据包数据。 |
offset | 数据包数据偏移量。 |
length | 包数据长度。 |
address | 目标套接字地址。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果不支持地址类型 |
public DatagramPacket(byte[] buf, int length, InetAddress address, int port)
构造一个数据报包,用于将长度长度的数据包发送到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。
参数:
参数名称 | 参数描述 |
---|---|
buf | 数据包数据。 |
length | 数据包长度。 |
address | 目的地址。 |
port | 目的端口号。 |
public DatagramPacket(byte[] buf, int length, SocketAddress address)
构造一个数据报包,用于将长度长度的数据包发送到指定主机上的指定端口号。 长度参数必须小于或等于 buf.length。
参数:
参数名称 | 参数描述 |
---|---|
buf | 数据包数据。 |
length | 数据包长度。 |
address | 目的地址。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果不支持地址类型 |
public InetAddress getAddress()
返回此数据报被发送到或接收到数据报的机器的 IP 地址。
返回:
发送该数据报的机器的 IP 地址或接收该数据报的机器的 IP 地址。
public int getPort()
返回此数据报被发送到或从其接收到的远程主机上的端口号。
返回:
发送该数据报或接收该数据报的远程主机上的端口号。
public byte[] getData()
返回数据缓冲区。 接收到的数据或要发送的数据从缓冲区中的偏移量开始,运行长度为 long。
返回:
用于接收或发送数据的缓冲区
public int getOffset()
返回要发送的数据的偏移量或接收的数据的偏移量。
返回:
要发送的数据的偏移量或接收的数据的偏移量。
public int getLength()
返回要发送的数据的长度或接收的数据的长度。
返回:
要发送的数据的长度或接收的数据的长度。
public void setData(byte[] buf, int offset, int length)
设置此数据包的数据缓冲区。 这将设置数据包的数据、长度和偏移量。
参数:
参数名称 | 参数描述 |
---|---|
buf | 为此数据包设置的缓冲区 |
offset | 数据中的偏移量 |
length | 数据的长度和/或用于接收数据的缓冲区的长度 |
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果参数为空 |
public void setAddress(InetAddress iaddr)
设置要发送此数据报的机器的 IP 地址。
参数:
参数名称 | 参数描述 |
---|---|
iaddr | 网络地址 |
public void setPort(int iport)
设置此数据报要发送到的远程主机上的端口号。
参数:
参数名称 | 参数描述 |
---|---|
iport | 端口号 |
public void setSocketAddress(SocketAddress address)
设置这个数据报被发送到的远程主机的 SocketAddress(通常是 IP 地址 + 端口号)。
参数:
参数名称 | 参数描述 |
---|---|
address | 套接字地址 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果地址为 null 或者是此套接字不支持的 SocketAddress 子类 |
public SocketAddress getSocketAddress()
获取此数据包正在发送到或来自的远程主机的 SocketAddress(通常是 IP 地址 + 端口号)。
返回:
套接字地址
public void setData(byte[] buf)
设置此数据包的数据缓冲区。 将此 DatagramPacket 的偏移量设置为 0,并将长度设置为 buf 的长度。
参数:
参数名称 | 参数描述 |
---|---|
buf | 为此数据包设置的缓冲区。 |
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果参数为空。 |
public void setLength(int length)
设置此数据包的长度。 数据包的长度是将要发送的数据包数据缓冲区中的字节数,或将用于接收数据的数据包数据缓冲区的字节数。 长度必须小于或等于偏移量加上数据包缓冲区的长度。
参数:
参数名称 | 参数描述 |
---|---|
length | 为此数据包设置的长度。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果长度为负或长度大于数据包的数据缓冲区长度。 |
备案信息: 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络,版权归原作者所有,仅作学习交流使用,如不慎侵犯了您的权利,请联系我们。