File	Doc	Category	Size	Date	Package
UDPClient.java	API Doc	Example	3879	Thu Apr 03 15:25:34 BST 1997	None

UDPClient

• java.lang.Object

Fields Summary
InetAddress	ia
int	port
DatagramSocket	ds

Constructors Summary
public UDPClient(InetAddress ia, int port) Creates a new UDPClient. param ia The InetAddress of the remote host to which data will be sent param port The port on the remote host to which data will be sent throws SocketException this.ia = ia; this.port = port; ds = new DatagramSocket();
public UDPClient(String hostname, int port) this(InetAddress.getByName(hostname), port);

Methods Summary
public java.net.InetAddress	getAddress() return the InetAddress which this client sends data to return ia;
public int	getLocalPort() return the port which this client is bound to return ds.getLocalPort();
public int	getPort() return the port which this object sends data to return port;
public synchronized byte[]	receive() This method blocks until a UDP Datagram is received from the host with which this UDPClient communicates. This can be an indefinite amount of time if the host is unreachable so calls to this method should be placed in a separate thread from the main program. return the data received as a byte array throws IOException byte[] buffer = new byte[65507]; DatagramPacket incoming = new DatagramPacket(buffer, buffer.length); ds.receive(incoming); // a client should only receive data from the host to while ( !incoming.getAddress().equals(ia)) { ds.receive(incoming); } return incoming.getData();
public synchronized java.lang.String	receiveString() This method blocks until a UDP Datagram is received from the host with which this UDPClient communicates. This can be an indefinite amount of time if the host is unreachable so calls to this method should be placed in a separate thread from the main program. When data is received it is converted into an ISO-latin-1 String and returned. return the data received as a byte array throws IOException byte[] data = receive(); return new String(data, 0, 0, data.length);
public void	send(byte[] buffer) This method sends data to the remote host via UDP. If the byte is longer than the maximum reliable length of a UDP Datagram (64900) bytes then an IOException is thrown param buffer A byte array containing the data to be sent throws IOException if (buffer.length > 64900) throw new IOException(); DatagramPacket dp = new DatagramPacket(buffer, buffer.length, ia, port); ds.send(dp);
public void	send(java.lang.String s) This method sends an ISO-Latin-1 string to the remote host via UDP. The string will be truncated to ISO-Latin-1 even if it's Unicode. param s The string to be sent throws IOException byte[] data = new byte[s.length()]; s.getBytes(0, s.length(), data, 0); send(data);
public void	send() This method sends an empty datagram to the remote host via UDP. throws IOException byte[] b = new byte[1]; send(b);
public java.lang.String	toString() return a String showning the remote host and port which this client sends data to return ia + ":" + port;