|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.net.DatagramSocket
A datagram socket is the sending or receiving point for a packet delivery service. Each packet sent or received on a datagram socket is individually addressed and routed. Multiple packets sent from one machine to another may be routed differently, and may arrive in any order.
UDP broadcasts sends and receives are always enabled on a DatagramSocket.
DatagramPacket
Constructor Summary | |
DatagramSocket()
Constructs a datagram socket and binds it to any available port on the local host machine. |
|
DatagramSocket(int port,
InetAddress laddr)
Creates a datagram socket, bound to the specified local address. |
|
DatagramSocket(int port)
Constructs a datagram socket and binds it to the specified port on the local host machine. |
Method Summary | |
void | close()
Closes this datagram socket. |
InetAddress | getLocalAddress()
Gets the local address to which the socket is bound. |
int | getLocalPort()
Returns the port number on the local host to which this socket is bound. |
int | getReceiveBufferSize()
Get value of the SO_RCVBUF option for this socket, that is the buffer size used by the platform for input on the this Socket. |
int | getSendBufferSize()
Get value of the SO_SNDBUF option for this socket, that is the buffer size used by the platform for output on the this Socket. |
int | getSoTimeout()
Retrive setting for SO_TIMEOUT. 0 returns implies that the option is disabled (i.e. |
void | receive(DatagramPacket p)
Receives a datagram packet from this socket. |
void | send(DatagramPacket p)
Sends a datagram packet from this socket. |
void | setReceiveBufferSize(int size)
Sets the SO_RCVBUF option to the specified value for this DatagramSocket. |
void | setSendBufferSize(int size)
Sets the SO_SNDBUF option to the specified value for this DatagramSocket. |
void | setSoTimeout(int timeout)
Enable/disable SO_TIMEOUT with the specified timeout, in milliseconds. |
Methods inherited from class java.lang.Object | |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait |
Constructor Detail |
public DatagramSocket() throws SocketException
public DatagramSocket(int port) throws SocketException
local
- port to use.public DatagramSocket(int port, InetAddress laddr) throws SocketException
port
- local port to use
laddr
- local address to bindMethod Detail |
public void send(DatagramPacket p) throws IOException
DatagramPacket
includes information indicating the
data to be sent, its length, the IP address of the remote host,
and the port number on the remote host.
p
- the DatagramPacket
to be sent.DatagramPacket
public void receive(DatagramPacket p) throws IOException
DatagramPacket
's buffer is filled with
the data received. The datagram packet also contains the sender's
IP address, and the port number on the sender's machine.
This method blocks until a datagram is received. The
length
field of the datagram packet object contains
the length of the received message. If the message is longer than
the packet's length, the message is truncated.
p
- the DatagramPacket
into which to place
the incoming data.DatagramPacket
,
DatagramSocket
public InetAddress getLocalAddress()
public int getLocalPort()
public void setSoTimeout(int timeout) throws SocketException
public int getSoTimeout() throws SocketException
public void setSendBufferSize(int size) throws SocketException
Increasing buffer size can increase the performance of network I/O for high-volume connection, while decreasing it can help reduce the backlog of incoming data. For UDP, this sets the maximum size of a packet that may be sent on this socket.
Because SO_SNDBUF is a hint, applications that want to
verify what size the buffers were set to should call
size
- the size to which to set the send buffer
size. This value must be greater than 0.
public int getSendBufferSize() throws SocketException
setSendBufferSize(int)
public void setReceiveBufferSize(int size) throws SocketException
Increasing buffer size can increase the performance of network I/O for high-volume connection, while decreasing it can help reduce the backlog of incoming data. For UDP, this sets the maximum size of a packet that may be sent on this socket.
Because SO_RCVBUF is a hint, applications that want to
verify what size the buffers were set to should call
size
- the size to which to set the receive buffer
size. This value must be greater than 0.
public int getReceiveBufferSize() throws SocketException
setReceiveBufferSize(int)
public void close()
|
Java Platform 1.2 Beta 4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |