org.ws4d.java.communication.connection.udp

Class Datagram

java.lang.Object

org.ws4d.java.communication.connection.udp.Datagram

public class Datagram
extends java.lang.Object

This class is needed for compatibility reasons with the J2ME Datagram class.

Constructor Summary

Constructors

Constructor and Description
Datagram(DatagramSocket socket, byte[] data, int len) Constructs a new datagram with the given address and data.

Method Summary

Modifier and Type	Method and Description
void	closeSocket()
byte[]	getData() Gets the contents of the data buffer.
long	getIdentifier() Returns the identifier for this datagram.
IPAddress	getIPAddress() Gets the address of the datagram.
java.lang.Object	getJavaDatagram()
int	getLength() Returns the length of this datagram.
int	getPort() Gets the port of the datagram.
IPAddress	getSocketAddress() Returns the address from which the datagram was send.
int	getSocketPort() Returns the port from which the datagram was send.
void	release() Returns this datagram into the pool of reusable datagram objects.
void	send()
void	sendMonitored(Message message, AttributedURI optionalMessageId, ConnectionInfo connectionInfo)
void	setAddress(IPAddress address) Sets the address of the datagram.
void	setJavaDatagram(java.lang.Object javaDatagram)
void	setPort(int port) Sets the port of the datagram.
void	setSocket(DatagramSocket socket)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Datagram

public Datagram(DatagramSocket socket,
                byte[] data,
                int len)

Constructs a new datagram with the given address and data.

Parameters:

socket - the datagram socket from which this datagram was created

data - the data of the datagram.

len - length of the real data.

Method Detail

send

public void send()
          throws java.io.IOException

Throws:

java.io.IOException

sendMonitored

public void sendMonitored(Message message,
                          AttributedURI optionalMessageId,
                          ConnectionInfo connectionInfo)
                   throws java.io.IOException

Throws:

java.io.IOException

setSocket

public void setSocket(DatagramSocket socket)

closeSocket

public void closeSocket()
                 throws java.io.IOException

Throws:

java.io.IOException

setAddress

public void setAddress(IPAddress address)

Sets the address of the datagram.

Parameters:

address - the address of the datagram.

getJavaDatagram

public java.lang.Object getJavaDatagram()

setJavaDatagram

public void setJavaDatagram(java.lang.Object javaDatagram)

getPort

public int getPort()

Gets the port of the datagram.

Returns:

the datagram port.

setPort

public void setPort(int port)

Sets the port of the datagram.

Parameters:

port - the port of the datagram.

getIPAddress

public IPAddress getIPAddress()

Gets the address of the datagram.

Returns:

the address in string form, or null if no address was set

getSocketAddress

public IPAddress getSocketAddress()

Returns the address from which the datagram was send.

NOTICE: this information is not always available (eg CLDC).

Returns:

the address from which the datagram was send, or null if no address available.

getSocketPort

public int getSocketPort()

Returns the port from which the datagram was send.

NOTICE: this information is not always available (eg CLDC).

Returns:

the port from which the datagram was send, or null if no address available.

getLength

public int getLength()

Returns the length of this datagram.

Returns:

the length.

getData

public byte[] getData()

Gets the contents of the data buffer.

Depending on the implementation, this operation may return the internal buffer or a copy of it. However, the user must not assume that the contents of the internal data buffer can be manipulated by modifying the data returned by this operation.

Returns:

the data buffer as a byte array.

release

public void release()

Returns this datagram into the pool of reusable datagram objects.

getIdentifier

public long getIdentifier()

Returns the identifier for this datagram.

Returns:

the identifier.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object