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

Deklaration

Beschreibung

Konstruktoren
public	ServerSocket()
public	ServerSocket(int port)
public	ServerSocket(int port, int backlog)
public	ServerSocket(int port, int backlog, InetAddress bindAddr)

Methoden
public Socket	accept()
public void	bind(SocketAddress addr)
public void	bind(SocketAddress addr, int backlog)
public void	close()
public ServerSocketChannel	getChannel()
public InetAddress	getInetAddress()
public int	getLocalPort()
public SocketAddress	getLocalSocketAddress()
public synchronized int	getReceiveBufferSize()
public boolean	getReuseAddress()
public synchronized int	getSoTimeout()
protected final void	implAccept(Socket s)
public boolean	isBound()
public boolean	isClosed()
public synchronized int	setReceiveBufferSize(int size)
public synchronized int	setReuseAddress(boolean on)
public static synchronized void	setSocketFactory(SocketImplFactory fac)
public synchronized void	setSoTimeout(int timeout)
public String	toString()

Konstruktoren im Detail

public ServerSocket()

Erzeugt einen neuen ServerSocket, der noch an keinen Port gebunden ist.

Exception: IOException

• Falls beim Öffnen des Sockets ein Fehler aufgetreten ist.

public ServerSocket(int port)

Erzeugt einen neuen ServerSocket am Port port, der eine Warteschlange für 50 unbearbeitete Verbindungen hat. Der ServerSocket akzeptiert eingehende Verbindungen für alle lokalen Adressen.

Exception: IOException

• Falls beim Öffnen des Sockets ein Fehler aufgetreten ist.

public ServerSocket(int port, int backlog)

Erzeugt einen neuen ServerSocket am Port port, der eine Warteschlange für backlog unbearbeitete Verbindungen hat. Der ServerSocket akzeptiert eingehende Verbindungen für alle lokalen Adressen.

Exception: IOException

• Falls beim Öffnen des Sockets ein Fehler aufgetreten ist.

public ServerSocket(int port, int backlog, InetAddress bindAddr)     

Erzeugt einen neuen ServerSocket am Port port, der eine Warteschlange für backlog unbearbeitete Verbindungen hat. Der ServerSocket akzeptiert nur die eingehenden Verbindungen, die an die lokale Adresse bindAddr gerichtet sind. Wenn für bindAddr null übergeben wird, werden alle eingehenden Verbindungen an den Port akzeptiert.

Exception: IOException

• Falls beim Öffnen des Sockets ein Fehler aufgetreten ist.

Methoden im Detail

public Socket accept()

Wartet auf eine eingehende Verbindung und blockiert so lange, bis eine Verbindungsanfrage von einem Client eintrifft. Der Rückgabewert ist ein Socket für die aufgebaute Verbindung.

Exception: IOException

• Falls beim Annehmen einer Verbindung ein Fehler auftritt.

public void bind(SocketAddress addr)     

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

Exception: IOException

public void bind(SocketAddress addr, int backlog)     

Bindet den Socket an die übergebene lokale Adresse mit einer Warteschlange von maximal backlog Verbindungen. Wird für die Adresse null übergeben, wird ein beliebiger freier Port gewählt.

Exception: IOException

public void close()

Schließt den Socket.

Exception: IOException

• Falls beim Schließen des Sockets ein Fehler auftritt.

public ServerSocketChannel 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 Adresse, für die der ServerSocket Verbindungen annimmt.

public int getLocalPort()

Liefert die Nummer des lokalen Ports zurück, an dem der Socket lauscht.

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 synchronized int getReceiveBufferSize()     

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

Exception: SocketException

• Falls beim Ermitteln der Option ein Fehler aufgetreten ist.

public boolean getReuseAddress()     

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

public synchronized int getSoTimeout()     

Liefert den Timeout für Lese- und Schreibeoperationen in Millisekunden. Der Rückgabewert 0 steht für einen unendlichen Timeout.

Exception: IOException

• Falls beim Ermitteln der Option ein Fehler aufgetreten ist.

protected final void implAccept(Socket s)     

Veranlaßt die Socket-Implementierung auf eine eingehende Verbindung zu warten. Kann in einer Unterklasse beim Überschreiben von accept() benutzt werden.

Exception: IOException

• Wenn ein anderer Fehler aufgetreten ist.

Exception: SecurityException

• Falls der SecurityManager das Annehmen von Verbindungen verweigert.

public boolean isBound()     

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

public boolean isClosed()     

Liefert true, falls der Socket bereits geschlossen ist, sonst false.

public synchronized int setReceiveBufferSize(int size)     

Setzt die Größe des Empfangspuffers für die von diesem Socket gelieferten Sockets 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 static synchronized void setSocketFactory(SocketImplFactory fac)

Setzt die SocketImplFactory neu. Sie kann nur einmal eingestellt werden.

Exception: IOException

• Falls beim Setzen der SocketImplFactory ein Fehler aufgetreten ist.

Exception: SocketException

• Falls die Factory bereits gesetzt ist.

public synchronized void setSoTimeout(int timeout)     

Setzt den Timeout für Lese- und Schreibeoperationen auf timeout Millisekunden. Der Wert 0 steht für einen unendlichen Timeout.

Exception: SocketException

• Falls beim Setzen der Option ein Fehler aufgetreten ist.

public String toString()

Liefert einen String, der die lokale IP-Adresse, mit der die Verbindung besteht, sowie die entfernte und die lokale Port-Nummer enthält.