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

Deklaration

Beschreibung

Konstruktoren
public	Socket()
protected	Socket(SocketImpl impl)
public	Socket(String host, int port)
public	Socket(InetAddress address, int port)
public	Socket(InetAddress host, int port, boolean stream)       Verworfen in Version 1.2.
public	Socket(String host, int port, boolean stream)       Verworfen in Version 1.2.
public	Socket(InetAddress address, int port, InetAddress localAddr, int localPort)
public	Socket(String host, int port, InetAddress localAddr, int localPort)

Methoden
public void	bind(SocketAddress addr)
public synchronized void	close()
public void	connect(SocketAddress addr)
public void	connect(SocketAddress addr, int timeout)
public SocketChannel	getChannel()
public InetAddress	getInetAddress()
public InputStream	getInputStream()
public boolean	getKeepAlive()
public InetAddress	getLocalAddress()
public int	getLocalPort()
public SocketAddress	getLocalSocketAddress()
public boolean	getOOBOnline()
public OutputStream	getOutputStream()
public int	getPort()
public synchronized int	getReceiveBufferSize()
public SocketAddress	getRemoteSocketAddress()
public boolean	getReuseAddress()
public synchronized int	getSendBufferSize()
public int	getSoLinger()
public synchronized int	getSoTimeout()
public boolean	getTcpNoDelay()
public int	getTrafficClass()
public boolean	isBound()
public boolean	isClosed()
public boolean	isConnected()
public boolean	isInputShutdown()
public boolean	isOutputShutdown()
public void	sendUrgentData(int data)
public void	setKeepAlive(boolean on)
public void	setOOBInline(boolean on)
public synchronized int	setReceiveBufferSize(int size)
public synchronized int	setReuseAddress(boolean on)
public synchronized int	setSendBufferSize(int size)
public static synchronized void	setSocketImplFactory(SocketImplFactory fac)
public void	setSoLinger(boolean on, int val)
public synchronized void	setSoTimeout(int timeout)
public void	setTcpNoDelay(boolean on)
public void	setTrafficClass(int tc)
public void	shutdownInput()
public void	shutdownOutput()
public String	toString()

Konstruktoren im Detail

public Socket()     

Erzeugt einen neuen Socket mit der Standard-Socket-Implementierung, der noch nicht verbunden ist.

protected Socket(SocketImpl impl)     

Erzeugt einen neuen Socket mit der Implementierung impl.

Exception: SocketException

• Falls beim Erzeugen des Sockets ein Fehler aufgetreten ist.

public Socket(String host, int port)

Erzeugt einen neuen Stream-Socket zum Port port an der in host enhaltenen Adresse. Hierbei kann sowohl der Host-Name als auch ein String, der die IP-Adresse enthält, übergeben werden. Lokale Adresse und Port-Nummer sind beliebig.

Exception: UnknownHostException

• Falls der Host-Name nicht aufglöst werden konnte.

Exception: IOException

• Falls beim Erzeugen des Sockets ein Fehler aufgetreten ist.

public Socket(InetAddress address, int port)

Erzeugt einen neuen Stream-Socket zum Port port an der Adresse address. Lokale Adresse und Port-Nummer sind beliebig.

Exception: IOException

• Falls beim Erzeugen des Sockets ein Fehler aufgetreten ist.

public Socket(InetAddress host, int port, boolean stream)

Bei dieser Variante kann zusätzlich mit dem Flag stream festgelegt werden, ob ein Stream- oder ein Datagramm-Socket erzeugt werden soll.

Exception: IOException

• Falls beim Erzeugen des Sockets ein Fehler aufgetreten ist.

public Socket(String host, int port, boolean stream)

Erzeugt einen neuen Socket zum Port port am Host host. Hierbei kann sowohl der Host-Name als auch ein String, der die IP-Adresse enthält, übergeben werden. Lokale Adresse und Port-Nummer sind beliebig. Mit stream wird festgelegt, ob ein Stream- oder ein Datagramm-Socket eröffnet wird.

Exception: IOException

• Falls beim Erzeugen des Sockets ein Fehler aufgetreten ist.

public Socket(InetAddress address, int port, InetAddress localAddr, int localPort)     

Erzeugt einen neuen Stream-Socket zum Port port an der Adresse address. Lokal erhält der Socket die Adresse localAddr und die Port-Nummer localPort.

Exception: IOException

• Falls beim Erzeugen des Sockets ein Fehler aufgetreten ist.

public Socket(String host, int port, InetAddress localAddr, int localPort)     

Erzeugt einen neuen Stream-Socket zum Port port an der in host enhaltenen Adresse. Hierbei kann sowohl der Host-Name als auch ein String, der die IP-Adresse enthält, übergeben werden. Lokal erhält der Socket die Adresse localAddr und die Port-Nummer localPort.

Exception: IOException

• Falls beim Erzeugen des Sockets ein Fehler aufgetreten ist.

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 synchronized void close()

Schließt den Socket.

Exception: IOException

• Falls beim Schließen des Sockets ein Fehler aufgetreten ist.

public void connect(SocketAddress addr)     

Verbindet den Socket an die übergebene Zieladresse.

public void connect(SocketAddress addr, int timeout)     

Bei dieser Variante kann zusätzlich noch ein Timeout in Millisekunden angegeben werden.

public SocketChannel 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 IP-Adresse des entfernten Hosts zurück, mit dem der Socket verbunden ist.

public InputStream getInputStream()

Liefert einen Inputstream, über den Daten aus dem Socket gelesen werden können.

Exception: IOException

• Falls ein Fehler aufgetreten ist.

public boolean getKeepAlive()     

Liefert true, wenn bei diesem Socket die SO_KEEPALIVE-Option gesetzt ist, sonst false.

Exception: SocketException

public InetAddress getLocalAddress()     

Liefert die lokale IP-Adresse, der der Socket zugeordnet ist.

public int getLocalPort()

Liefert die Nummer des lokalen Ports zurück, mit dem der Socket verbunden 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 boolean getOOBOnline()     

Liefert true, wenn bei diesem Socket die OOBINLINE-Option gesetzt ist, sonst false.

Exception: SocketException

public OutputStream getOutputStream()

Liefert einen Outputstream, über den Daten in den Socket geschrieben werden können.

Exception: IOException

public int getPort()

Liefert die Nummer des Ports zurück, an dem der Socket am entfernten Host angeschlossen ist.

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 int getSoLinger()     

Liefert die Einstellung der SO_LINGER-Option.

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 boolean getTcpNoDelay()     

Liefert true, falls die Option TCP_NODELAY gesetzt ist, sonst false.

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 isClosed()     

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

public boolean isConnected()     

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

public boolean isInputShutdown()     

Liefert true, falls der eingehende Kanal der Socket-Verbindung bereits geschlossen ist, sonst false.

public boolean isOutputShutdown()     

Liefert true, falls der ausgehende Kanal der Socket-Verbindung bereits geschlossen ist, sonst false.

public void sendUrgentData(int data)     

Verschickt ein Byte von data als »TCP urgent data«.

Exception: IOException

public void setKeepAlive(boolean on)     

Schaltet in Abhängigkeit von on die Option SO_KEEPALIVE ein oder aus.

Exception: SocketException

public void setOOBInline(boolean on)     

Schaltet in Abhängigkeit von on die Option OOBInline ein oder aus.

Exception: SocketException

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 static synchronized void setSocketImplFactory(SocketImplFactory fac)

Setzt das Factory-Objekt für Socket-Implementierungen auf fac.

Exception: IOException

Exception: SocketException

• Falls das Factory-Objekt bereits gesetzt wurde.

public void setSoLinger(boolean on, int val)     

Schaltet in Abhängigkeit von on die Option SO_LINGER ein oder aus. val gibt die maximale Wartezeit an. Für val kann maximal 65535 angegeben werden, größere Werte werden auf 65535 gesetzt.

Exception: SocketException

• Falls beim Setzen der Option ein Fehler aufgetreten 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 void setTcpNoDelay(boolean on)     

Schaltet in Abhängigkeit von on die Option TCP_NODELAY ein oder aus.

Exception: SocketException

• Falls beim Setzen der Option ein Fehler aufgetreten 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

public void shutdownInput()     

Schließt den eingehenden Kanal des Sockets.

Exception: IOException

public void shutdownOutput()     

Schließt den ausgehenden Kanal des Sockets.

Exception: IOException

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.