org.ws4d.java.communication.connection.udp

Interface DatagramSocket

All Known Implementing Classes:

SEDatagramSocket

public interface DatagramSocket

Datagram socket for UDP connections.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the connection.
NetworkInterface	getIface() Returns the interface.
IPAddress	getSocketAddress() Returns the address this socket is bound to.
int	getSocketPort() Returns the port this socket is bound to.
Datagram	receive() Receives a datagram.
void	release(Datagram datagram) Returns datagram to this socket for reusability.
void	send(Datagram datagram) Sends a datagram.

Method Detail

send

void send(Datagram datagram)
   throws java.io.IOException

Sends a datagram. The Datagram object includes the information indicating what data to send, its length, and the address of the receiver. The method sends length bytes starting at the current offset of the Datagram object, where length and offset are internal state variables of the Datagram object.

Parameters:

datagram - A datagram.

Throws:

java.io.IOException

receive

Datagram receive()
          throws java.io.IOException

Receives a datagram. When this method returns, the internal buffer in the Datagram object is filled with the data received, starting at the location determined by the offset state variable. The data is ready to be read using the methods of the DataInput interface. This method remains idle until a datagram is received. The internal length state variable in the Datagram object contains the length of the received datagram. If the received data is longer than the length of the internal buffer minus offset, the data is truncated. This method does not change the internal read/write state variable of the Datagram object. Use method Datagram.reset to change the pointer before reading if necessary.

Returns:

A datagram.

Throws:

java.io.IOException

close

void close()
    throws java.io.IOException

Closes the connection.

Throws:

java.io.IOException

release

void release(Datagram datagram)

Returns datagram to this socket for reusability.

Parameters:

datagram - the datagram, which can be reused by this socket

getSocketAddress

IPAddress getSocketAddress()

Returns the address this socket is bound to.

Returns:

the address.

getSocketPort

int getSocketPort()

Returns the port this socket is bound to.

Returns:

the port.

getIface

NetworkInterface getIface()

Returns the interface.

Returns:

the interface.