java.lang.Object
   |
   +--java.net.DatagramSocket

Deklaration

Beschreibung

Konstruktoren
public	DatagramSocket()
public	DatagramSocket(int port)
public	DatagramSocket(int port, InetAddress laddr)
public	DatagramSocket(SocketAddress addr)

Methoden
public void	bind(SocketAddress addr)
public void	close()
public void	connect(InetAddress laddr, int port)
public void	connect(SocketAddress addr)
public void	disconnect()
public boolean	getBroadcast()
public DatagramChannel	getChannel()
public InetAddress	getInetAddress()
public InetAddress	getLocalAddress()
public int	getLocalPort()
public SocketAddress	getLocalSocketAddress()
public int	getPort()
public synchronized int	getReceiveBufferSize()
public SocketAddress	getRemoteSocketAddress()
public boolean	getReuseAddress()
public synchronized int	getSendBufferSize()
public synchronized int	getSoTimeout()
public int	getTrafficClass()
public boolean	isBound()
public boolean	isConnected()
public synchronized void	receive(DatagramPacket p)
public void	send(DatagramPacket p)
public void	setBroadcast(boolean on)
public static void	setDatagramSocketImplFactory(DatagramSocketImplFactory fac)
public synchronized int	setReceiveBufferSize(int size)
public synchronized int	setReuseAddress(boolean on)
public synchronized int	setSendBufferSize(int size)
public synchronized void	setSoTimeout(int timeout)
public void	setTrafficClass(int tc)

Konstruktoren im Detail

public DatagramSocket()

Erzeugt einen neuen UDP-Socket, der an einem beliebigen lokalen Port angeschlossen ist.

Exception: SocketException

• Falls der Socket nicht geöffnet werden konnte.

public DatagramSocket(int port)

Erzeugt einen neuen UDP-Socket, der am lokalen Port port angeschlossen ist.

Exception: SocketException

• Falls der Socket nicht geöffnet werden konnte oder der Port port bereits benutzt wird.

Exception: IllegalArgumentException

• Wenn port kleiner als null oder größer als 65535 (0xFFFF) ist.

public DatagramSocket(int port, InetAddress laddr)     

Erzeugt einen neuen UDP-Socket, der an der lokalen Adresse laddr und dem Port port angeschlossen ist.

Exception: SocketException

• Falls der Socket nicht geöffnet werden konnte, der Port port bereits benutzt wird oder die Adresse laddr nicht zugewiesen werden konnte.

Exception: IllegalArgumentException

• Wenn port kleiner als null oder größer als 65535 (0xFFFF) ist.

public DatagramSocket(SocketAddress addr)     

Erzeugt einen neuen UDP-Socket, der an der lokalen Adresse addr angeschlossen ist.

Exception: SocketException

• Falls der Socket nicht geöffnet werden konnte, der Port port bereits benutzt wird oder die Adresse laddr nicht zugewiesen werden konnte.

Methoden im Detail

public void bind(SocketAddress addr)     

Bindet den Socket an die übergebene lokale Adresse. Wird null übergeben, wird ein beliebiger freier Port gewählt.

public void close()

Schließt den Socket.

public void connect(InetAddress laddr, int port)     

Verbindet den Socket an die übergebene Zieladresse. Verbinden heißt hier, daß Datagramme über diesen Socket nur an diese Adresse geschickt bzw. nur von dieser Adresse empfangen werden können.

public void connect(SocketAddress addr)     

Verbindet den Socket an die übergebene Zieladresse. Verbinden heißt hier, daß Datagramme über diesen Socket nur an diese Adresse geschickt bzw. nur von dieser Adresse empfangen werden können.

public void disconnect()     

Hebt die Verbindung wieder auf.

public boolean getBroadcast()     

Liefert true, falls Broadcasting bei dem Socket aktiviert ist, sonst false.

public DatagramChannel getChannel()     

Liefert das Channel-Objekt für den Socket zurück. Falls noch kein Channel besteht, ist der Rückgabewert null.

public InetAddress getInetAddress()     

Liefert die entfernte Adresse, mit der der UDP-Socket verbunden ist. Der Rückgabewert ist null, falls der Socket mit keiner Adresse verbunden ist (d. h., connect() wurde noch nicht aufgerufen).

public InetAddress getLocalAddress()     

Liefert die lokale Adresse, an die der UDP-Socket angeschlossen ist.

public int getLocalPort()

Liefert die Nummer des lokalen Ports, an dem der UDP-Socket angeschlossen ist.

public SocketAddress getLocalSocketAddress()     

Liefert die Adresse und die Portnummer zurück, an die der Socket lokal gebunden ist. Ist der Socket noch nicht gebunden, ist der Rückgabewert null.

public int getPort()     

Liefert den entfernten Port, mit dem der UDP-Socket verbunden ist. Der Rückgabewert ist -1, falls der Socket mit keiner Adresse verbunden ist (d. h., connect() wurde noch nicht aufgerufen).

public synchronized int getReceiveBufferSize()     

Liefert die Größe des Empfangspuffers zurück.

Exception: SocketException

• Falls beim Ermitteln der Option ein Fehler aufgetreten ist.

public SocketAddress getRemoteSocketAddress()     

Liefert die Adresse und die Portnummer zurück, an die der Socket entfernt gebunden ist. Ist der Socket noch nicht gebunden, ist der Rückgabewert null.

public boolean getReuseAddress()     

Liefert true, falls die Option SO_REUSEADDR bei diesem Socket gesetzt ist, sonst false.

public synchronized int getSendBufferSize()     

Liefert die Größe des Sendepuffers zurück.

Exception: SocketException

• Falls beim Ermitteln der Option ein Fehler aufgetreten ist.

public synchronized int getSoTimeout()     

Liefert den Timeout beim Empfangen. Der Wert null signalisiert einen unendlichen Timeout.

Exception: SocketException

• Falls beim Ermitteln der Option ein Fehler aufgetreten ist.

public int getTrafficClass()     

Liefert den Wert des Type-Of-Service-Felds im IP-Header zurück.

public boolean isBound()     

Liefert true, falls der Socket bereits an eine lokale Adresse gebunden ist, sonst false.

public boolean isConnected()     

Liefert true, falls der Socket bereits mit einer Zieladresse verbunden ist, sonst false.

public synchronized void receive(DatagramPacket p)

Empfängt ein Paket über den Socket und trägt es in p ein, wobei die Daten gegebenenfalls auf die Pufferlänge von p gekürzt werden (der Rest wird verworfen). Diese Methode blockiert so lange, bis ein Paket empfangen wird. Das Paket enthält Adresse und Port-Nummer des Absenders. Falls ein SecurityManager installiert ist, werden alle eingehenden Pakete verworfen, die von Host/Port-Kombinationen stammen, die der SecurityManager nicht erlaubt.

Exception: IOException

• Falls beim Lesen des Pakets ein Fehler aufgetreten ist.

public void send(DatagramPacket p)

Sendet das Datagrammpaket p an die in p eingetragene Adresse. Falls ein SecurityManager installiert ist, wird zunächst geprüft, ob Pakete an die spezifizierte Adresse erlaubt sind (SecurityManager.checkConnect()). Falls es sich um eine Multicast-Adresse handelt, wird geprüft, ob Multicasting zulässig ist (SecurityManager.checkMulticast()).

Exception: IOException

• Falls beim Senden des Pakets ein Fehler aufgetreten ist.

public void setBroadcast(boolean on)     

Stellt in Abhängigkeit von on Broadcasting ein.

Exception: SocketException

public static void setDatagramSocketImplFactory(DatagramSocketImplFactory fac)     

Setzt das Fabrik-Objekt zur Erzeugung neuer Exemplare auf fac.

Exception: IOException

public synchronized int setReceiveBufferSize(int size)     

Setzt die Größe des Empfangspuffers auf size Bytes.

Exception: SocketException

• Falls beim Einstellen der Option ein Fehler aufgetreten ist.

Exception: IllegalArgumentException

• Wenn size negativ ist.

public synchronized int setReuseAddress(boolean on)     

Stellt in Abhängigkeit von on die SO_REUSEADDR-Option für den Socket ein.

Exception: SocketException

public synchronized int setSendBufferSize(int size)     

Setzt die Größe des Sendepuffers auf size Bytes.

Exception: SocketException

• Falls beim Einstellen der Option ein Fehler aufgetreten ist.

Exception: IllegalArgumentException

• Wenn size negativ ist.

public synchronized void setSoTimeout(int timeout)     

Mit dieser Methode wird ein Timeout von timeout Millisekunden für die Methode receive() eingestellt. Falls innerhalb dieser Zeit kein Paket empfangen wird, kehrt die receice() mit einer Exception zurück. Mit dem Wert 0 (Voreinstellung) wird ein unendlicher Timeout spezifiziert.

Exception: SocketException

• Falls beim Einstellen der Option ein Fehler aufgetreten ist.

Exception: InterruptedIOException

• Wenn der Timeout abgelaufen ist, ohne daß ein Paket eingetroffen ist.

public void setTrafficClass(int tc)     

Setzt das Type-Of-Service-Feld im IP-Header auf tc. die Größe des Sendepuffers auf size Bytes.

Exception: SocketException