Class DatagramPacket

public DatagramPacket(byte[] buf,
                      int length)

Initializes a new instance of DatagramPacket for receiving packets from the network.

Parameters:

buf - A buffer for storing the returned packet data

length - The length of the buffer (must be <= buf.length)

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

This method initializes a new instance of DatagramPacket which has the specified buffer, offset, and length.

Parameters:

buf - The buffer for holding the incoming datagram.

offset - The offset into the buffer to start writing.

length - The maximum number of bytes to read.

Since:

1.2

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

Initializes a new instance of DatagramPacket for transmitting packets across the network.

Parameters:

buf - A buffer containing the data to send

offset - The offset into the buffer to start writing from.

length - The length of the buffer (must be <= buf.length)

address - The address to send to

port - The port to send to

Since:

1.2

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

Initializes a new instance of DatagramPacket for transmitting packets across the network.

Parameters:

buf - A buffer containing the data to send

offset - The offset into the buffer to start writing from.

length - The length of the buffer (must be <= buf.length)

address - The socket address to send to

Throws:

SocketException - If an error occurs

IllegalArgumentException - If address type is not supported

Since:

1.4

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

Initializes a new instance of DatagramPacket for transmitting packets across the network.

Parameters:

buf - A buffer containing the data to send

length - The length of the buffer (must be <= buf.length)

address - The address to send to

port - The port to send to

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

Initializes a new instance of DatagramPacket for transmitting packets across the network.

Parameters:

buf - A buffer containing the data to send

length - The length of the buffer (must be <= buf.length)

address - The socket address to send to

Throws:

SocketException - If an error occurs

IllegalArgumentException - If address type is not supported

Since:

1.4

public InetAddress getAddress()

Returns the address that this packet is being sent to or, if it was used to receive a packet, the address that is was received from. If the constructor that doesn not take an address was used to create this object and no packet was actually read into this object, then this method returns null.

Returns:

The address for this packet.

public byte[] getData()

Returns the data buffer for this packet

Returns:

This packet's data buffer

public int getLength()

Returns the length of the data in the buffer

Returns:

The length of the data

public int getOffset()

This method returns the current offset value into the data buffer where data will be sent from.

Returns:

The buffer offset.

Since:

1.2

public int getPort()

Returns the port number this packet is being sent to or, if it was used to receive a packet, the port that it was received from. If the constructor that doesn not take an address was used to create this object and no packet was actually read into this object, then this method will return 0.

Returns:

The port number for this packet

public SocketAddress getSocketAddress()

Gets the socket address of the host this packet will be sent to/is coming from

Returns:

The socket address of the remote host

Since:

1.4

public void setAddress(InetAddress address)

This sets the address to which the data packet will be transmitted.

Parameters:

address - The destination address

Since:

1.1

public void setData(byte[] buf)

Sets the data buffer for this packet.

Parameters:

buf - The new buffer for this packet

Throws:

NullPointerException - If the argument is null

Since:

1.1

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

This method sets the data buffer for the packet.

Parameters:

buf - The byte array containing the data for this packet.

offset - The offset into the buffer to start reading data from.

length - The number of bytes of data in the buffer.

Throws:

NullPointerException - If the argument is null

Since:

1.2

public void setLength(int length)

Sets the length of the data in the buffer.

Parameters:

length - The new length. (Where len <= buf.length)

Throws:

IllegalArgumentException - If the length is negative or if the length is greater than the packet's data buffer length

Since:

1.1

public void setPort(int port)

This sets the port to which the data packet will be transmitted.

Parameters:

port - The destination port

Since:

1.1

public void setSocketAddress(SocketAddress address)
            throws IllegalArgumentException

Sets the address of the remote host this package will be sent

Parameters:

address - The socket address of the remove host

Throws:

IllegalArgumentException - If address type is not supported

Since:

1.4