compact1, compact2, compact3

java.net

Class DatagramPacket

java.lang.Object

java.net.DatagramPacket

public final class DatagramPacket
extends Object

这类表示一个数据报包。

数据包是用来实现一个无连接的分组传送服务。每个消息都是从一台机器路由到另一个完全基于包含在该数据包内的信息。从一台机器发送到另一台机器的多个数据包可能会被不同的路由，并可能以任何顺序到达。包交付没有保证。

从以下版本开始：

JDK1.0

构造方法摘要

构造方法

Constructor and Description
DatagramPacket(byte[] buf, int length) 接收数据包长度 length DatagramPacket构建。
DatagramPacket(byte[] buf, int length, InetAddress address, int port) 指定主机上的指定端口发送数据包的长度 length数据报包结构。
DatagramPacket(byte[] buf, int offset, int length) 接收数据包长度 length DatagramPacket结构，指定一个偏移量到缓冲区。
DatagramPacket(byte[] buf, int offset, int length, InetAddress address, int port) 发送有偏置 ioffsetto指定端口号指定主机上的数据包长度 length数据报包结构。
DatagramPacket(byte[] buf, int offset, int length, SocketAddress address) 发送有偏置 ioffsetto指定端口号指定主机上的数据包长度 length数据报包结构。
DatagramPacket(byte[] buf, int length, SocketAddress address) 指定主机上的指定端口发送数据包的长度 length数据报包结构。

方法摘要

Modifier and Type	Method and Description
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地址+端口号）的远程主机的数据报发送。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length)

接收数据包长度 length DatagramPacket结构，指定一个偏移量到缓冲区。

的length参数必须小于或等于buf.length。

参数

buf -将传入的数据报缓冲区。

offset -缓冲区偏移

length -字节数读。

从以下版本开始：

一点二

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length)

接收数据包长度 length DatagramPacket

的length参数必须小于或等于buf.length。

构建。

参数

buf -将传入的数据报缓冲区。

length -字节数读。

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      InetAddress address,
                      int port)

发送有偏置 ioffsetto指定端口号指定主机上的数据包长度 length数据报包结构。的 length参数必须小于或等于 buf.length。

参数

buf -分组数据。

offset -分组数据偏移。

length -分组数据长度。

address -目标地址。

port -目的端口号。

从以下版本开始：

一点二

另请参见：

InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      SocketAddress address)

发送有偏置 ioffsetto指定端口号指定主机上的数据包长度 length数据报包结构。的 length参数必须小于或等于 buf.length。

参数

buf -分组数据。

offset -分组数据偏移。

length -分组数据长度。

address -目的套接字地址。

异常

IllegalArgumentException如果地址类型不支持

从以下版本开始：

一点四

另请参见：

InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length,
                      InetAddress address,
                      int port)

指定主机上的指定端口发送数据包的长度 length数据报包结构。的 length参数必须小于或等于 buf.length。

参数

buf -分组数据。

length -包长。

address -目标地址。

port -目的端口号。

另请参见：

InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length,
                      SocketAddress address)

指定主机上的指定端口发送数据包的长度 length数据报包结构。的 length参数必须小于或等于 buf.length。

参数

buf -分组数据。

length -包长。

address -目标地址。

异常

IllegalArgumentException如果地址类型不支持

从以下版本开始：

一点四

另请参见：

InetAddress

方法详细信息

getAddress

public InetAddress getAddress()

返回的IP地址的机器，这个数据包被发送或从收到的数据报。

结果

IP地址的机器，这个数据包被发送或从收到的数据报。

另请参见：

InetAddress， setAddress(java.net.InetAddress)

getPort

public int getPort()

返回远端端口号，这个数据包被发送或从收到的数据报。

结果

远端端口号，这个数据包被发送或从收到的数据报。

另请参见：

setPort(int)

getData

public byte[] getData()

返回数据缓冲区。数据的接收或发送的数据从缓冲区中的 offset，和运行 length长。

结果

用于接收或发送数据的缓冲区

另请参见：

setData(byte[], int, int)

getOffset

public int getOffset()

返回所要发送的数据的偏移量或所接收的数据的偏移量。

结果

要发送的数据的偏移量或所接收的数据的偏移量。

从以下版本开始：

一点二

getLength

public int getLength()

返回要发送的数据的长度或收到的数据的长度。

结果

要发送的数据的长度或接收到的数据的长度。

另请参见：

setLength(int)

setData

public void setData(byte[] buf,
                    int offset,
                    int length)

为这个数据包设置数据缓冲区。这设置数据包的数据、长度和偏移量。

参数

buf -缓冲设置该分组

offset -偏移到数据

length -数据和/或用于接收数据的缓冲区的长度

异常

NullPointerException -如果参数为空

从以下版本开始：

一点二

另请参见：

getData()， getOffset()， getLength()

setAddress

public void setAddress(InetAddress iaddr)

设置本机的IP地址，这个数据包被发送。

参数

iaddr - InetAddress

从以下版本开始：

JDK1.1

另请参见：

getAddress()

setPort

public void setPort(int iport)

设置远端端口号，这个数据包被发送。

参数

iport -端口号

从以下版本开始：

JDK1.1

另请参见：

getPort()

setSocketAddress

public void setSocketAddress(SocketAddress address)

集SocketAddress（通常是IP地址+端口号）的远程主机的数据报发送。

参数

address - SocketAddress

异常

IllegalArgumentException如果地址为空或是通过这个插座不支持SocketAddress类

从以下版本开始：

一点四

另请参见：

getSocketAddress()

getSocketAddress

public SocketAddress getSocketAddress()

获取SocketAddress（通常是IP地址+端口号）的远程主机，数据包被发送到或来自。

结果

的 SocketAddress

从以下版本开始：

一点四

另请参见：

setSocketAddress(java.net.SocketAddress)

setData

public void setData(byte[] buf)

为这个数据包设置数据缓冲区。与该数据报设置为0的偏移量，并设置为 buf的长度。

参数

buf -缓冲设置该分组。

异常

NullPointerException -如果参数为空。

从以下版本开始：

JDK1.1

另请参见：

getLength()， getData()

setLength

public void setLength(int length)

为这个数据包设置长度。该数据包的长度是从将被发送的数据包的数据缓冲区中的字节数，或将用于接收数据的数据包的数据缓冲区的数量的字节数。长度必须小于或等于偏移量，加上数据包的缓冲区的长度。

参数

length -长度设置该分组。

异常

IllegalArgumentException -如果长度大于分组的数据缓冲区的长度是负的。

从以下版本开始：

JDK1.1

另请参见：

getLength()， setData(byte[], int, int)