Skip to content

Most visited

Recently visited

navigation
Added in API level 1

DatagramPacket

public final class DatagramPacket
extends Object

java.lang.Object
   ↳ java.net.DatagramPacket


This class represents a datagram packet which contains data either to be sent or received through a DatagramSocket. It holds additional information such as its source or destination host.

See also:

Summary

Public constructors

DatagramPacket(byte[] data, int length)

Constructs a new DatagramPacket object to receive data up to length bytes.

DatagramPacket(byte[] data, int offset, int length)

Constructs a new DatagramPacket object to receive data up to length bytes with a specified buffer offset.

DatagramPacket(byte[] data, int offset, int length, InetAddress host, int aPort)

Constructs a new DatagramPacket object to send data to the port aPort of the address host.

DatagramPacket(byte[] data, int length, InetAddress host, int port)

Constructs a new DatagramPacket object to send data to the port aPort of the address host.

DatagramPacket(byte[] data, int length, SocketAddress sockAddr)

Constructs a new DatagramPacket object to send data to the address sockAddr.

DatagramPacket(byte[] data, int offset, int length, SocketAddress sockAddr)

Constructs a new DatagramPacket object to send data to the address sockAddr.

Public methods

InetAddress getAddress()

Gets the sender or destination IP address of this datagram packet.

byte[] getData()

Gets the data of this datagram packet.

int getLength()

Gets the length of the data stored in this datagram packet.

int getOffset()

Gets the offset of the data stored in this datagram packet.

int getPort()

Gets the port number of the target or sender host of this datagram packet.

SocketAddress getSocketAddress()

Gets the host address and the port to which this datagram packet is sent as a SocketAddress object.

void setAddress(InetAddress addr)

Sets the IP address of the target host.

void setData(byte[] buf)

Sets the data buffer for this datagram packet.

void setData(byte[] data, int offset, int byteCount)

Sets the data buffer for this datagram packet.

void setLength(int length)

Sets the length of the datagram packet.

void setPort(int aPort)

Sets the port number of the target host of this datagram packet.

void setSocketAddress(SocketAddress sockAddr)

Sets the SocketAddress for this datagram packet.

Inherited methods

From class java.lang.Object

Public constructors

DatagramPacket

Added in API level 1
DatagramPacket (byte[] data, 
                int length)

Constructs a new DatagramPacket object to receive data up to length bytes.

Parameters
data byte: a byte array to store the read characters.
length int: the length of the data buffer.

DatagramPacket

Added in API level 1
DatagramPacket (byte[] data, 
                int offset, 
                int length)

Constructs a new DatagramPacket object to receive data up to length bytes with a specified buffer offset.

Parameters
data byte: a byte array to store the read characters.
offset int: the offset of the byte array where the bytes is written.
length int: the length of the data.

DatagramPacket

Added in API level 1
DatagramPacket (byte[] data, 
                int offset, 
                int length, 
                InetAddress host, 
                int aPort)

Constructs a new DatagramPacket object to send data to the port aPort of the address host. The length must be lesser than or equal to the size of data. The first length bytes from the byte array position offset are sent.

Parameters
data byte: a byte array which stores the characters to be sent.
offset int: the offset of data where to read from.
length int: the length of data.
host InetAddress: the address of the target host.
aPort int: the port of the target host.

DatagramPacket

Added in API level 1
DatagramPacket (byte[] data, 
                int length, 
                InetAddress host, 
                int port)

Constructs a new DatagramPacket object to send data to the port aPort of the address host. The length must be lesser than or equal to the size of data. The first length bytes are sent.

Parameters
data byte: a byte array which stores the characters to be sent.
length int: the length of data.
host InetAddress: the address of the target host.
port int: the port of the target host.

DatagramPacket

Added in API level 1
DatagramPacket (byte[] data, 
                int length, 
                SocketAddress sockAddr)

Constructs a new DatagramPacket object to send data to the address sockAddr. The length must be lesser than or equal to the size of data. The first length bytes of the data are sent.

Parameters
data byte: the byte array to store the data.
length int: the length of the data.
sockAddr SocketAddress: the target host address and port.
Throws
SocketException if an error in the underlying protocol occurs.

DatagramPacket

Added in API level 1
DatagramPacket (byte[] data, 
                int offset, 
                int length, 
                SocketAddress sockAddr)

Constructs a new DatagramPacket object to send data to the address sockAddr. The length must be lesser than or equal to the size of data. The first length bytes of the data are sent.

Parameters
data byte: the byte array to store the data.
offset int: the offset of the data.
length int: the length of the data.
sockAddr SocketAddress: the target host address and port.
Throws
SocketException if an error in the underlying protocol occurs.

Public methods

getAddress

Added in API level 1
InetAddress getAddress ()

Gets the sender or destination IP address of this datagram packet.

Returns
InetAddress the address from where the datagram was received or to which it is sent.

getData

Added in API level 1
byte[] getData ()

Gets the data of this datagram packet.

Returns
byte[] the received data or the data to be sent.

getLength

Added in API level 1
int getLength ()

Gets the length of the data stored in this datagram packet.

Returns
int the length of the received data or the data to be sent.

getOffset

Added in API level 1
int getOffset ()

Gets the offset of the data stored in this datagram packet.

Returns
int the position of the received data or the data to be sent.

getPort

Added in API level 1
int getPort ()

Gets the port number of the target or sender host of this datagram packet.

Returns
int the port number of the origin or target host.

getSocketAddress

Added in API level 1
SocketAddress getSocketAddress ()

Gets the host address and the port to which this datagram packet is sent as a SocketAddress object.

Returns
SocketAddress the SocketAddress of the target host.

setAddress

Added in API level 1
void setAddress (InetAddress addr)

Sets the IP address of the target host.

Parameters
addr InetAddress: the target host address.

setData

Added in API level 1
void setData (byte[] buf)

Sets the data buffer for this datagram packet. The length of the datagram packet is set to the buffer length.

Parameters
buf byte: the buffer to store the data.

setData

Added in API level 1
void setData (byte[] data, 
                int offset, 
                int byteCount)

Sets the data buffer for this datagram packet.

Parameters
data byte
offset int
byteCount int

setLength

Added in API level 1
void setLength (int length)

Sets the length of the datagram packet. This length plus the offset must be lesser than or equal to the buffer size.

Parameters
length int: the length of this datagram packet.

setPort

Added in API level 1
void setPort (int aPort)

Sets the port number of the target host of this datagram packet.

Parameters
aPort int: the target host port number.

setSocketAddress

Added in API level 1
void setSocketAddress (SocketAddress sockAddr)

Sets the SocketAddress for this datagram packet.

Parameters
sockAddr SocketAddress: the SocketAddress of the target host.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.