public final class SocketConnection extends java.lang.Object implements IStreamConnection
IStreamConnection
zu
verwenden.
Da Ein- und Ausgabestrom nur als Paar auftreten und fester Bestandteil der
IStreamConnection
sind, wird bereits waehrend der Initialisierung
versucht den Ein- und Ausgabestrom des Sockets zu bekommen. Sollte dies nicht
moeglich sein, wird die Verbindung bereits zu Beginn als geschlossen markiert.
Deswegen ist es wichtig SocketConnection nur in Verbindung mit offenen und
verbunden Sockets zu verwenden.
Ausserdem wird angennommen, dass sich Ein- und Ausgabestrom des Sockets nicht
aendern.Modifier and Type | Field and Description |
---|---|
private java.io.InputStream |
m_inputStream
Der Eingabstrom der Verbindung.
|
private int |
m_internalState
Der interne Zustand der Verbindung.
|
private IAddress |
m_localAddress
Die Adresse des lokalen Endpunktes
|
private java.io.OutputStream |
m_outputStream
Der Ausgabestrom der Verbindung.
|
private IAddress |
m_remoteAddress
Die Adresse des entfernten Endpunktes
|
private java.net.Socket |
m_underlyingSocket
Das Socket auf welchem die Verbindung aufbaut
|
ConnectionState_CLOSE, ConnectionState_OPEN
Constructor and Description |
---|
SocketConnection(java.net.Socket a_underlyingSocket)
Erstellt eine neue SocketConnection auf Basis des uebergebenen Sockets.
|
Modifier and Type | Method and Description |
---|---|
void |
close() |
int |
getCurrentState()
Gibt den momentanen Zustand der Verbindung an.
|
java.io.InputStream |
getInputStream()
Liefert den Eingabestrom der Verbinundung, ueber welchen kontinuierlich
Daten empfangen werden koennen.
|
IAddress |
getLocalAddress()
Gibt die Adresse des lokalen Endpunkt der Verbindung an.
|
java.io.OutputStream |
getOutputStream()
Liefert den Ausgabestrom der verbindung, ueber welchem Daten gesendet
werden koennen.
|
IAddress |
getRemoteAddress()
Gibt die Adresse des entfernten Endpunkt an.
|
int |
getTimeout()
Ermittelt den momentanen Wert fuer das Timeout in Millisekunden fuer Lese-
und Schreiboperationen der Verbindung.
|
java.net.Socket |
getUnderlyingSocket() |
private void |
setCLOSE()
Interne Hilfsfunktion, welche beim Wechsel in den CLOSE-Zustand
augerufen, werden sollte.
|
void |
setTimeout(int value)
Setzt den Timeout in Millisekunden fuer die Lese- und Schreiboperationen
der Verbindung.
|
private java.net.Socket m_underlyingSocket
private java.io.OutputStream m_outputStream
private java.io.InputStream m_inputStream
private int m_internalState
private IAddress m_localAddress
private IAddress m_remoteAddress
public SocketConnection(java.net.Socket a_underlyingSocket)
Das uebergebene Socket darf nicht geschlossen sein, da im Sinne einer Verbindung, die Kommunikationsbeziehung bereits eingerichtet sein muss.
a_underlyingSocket
- Das offene und verbunde Socket, welches als Basis der Verbinung
genutzt werden sollprivate void setCLOSE()
public java.io.InputStream getInputStream()
IStreamConnection
getInputStream
in interface IStreamConnection
public java.io.OutputStream getOutputStream()
IStreamConnection
getOutputStream
in interface IStreamConnection
public int getTimeout() throws ConnectionException
IConnection
Socket
folgend, bestimmt 0 ein unendliches Timeout.getTimeout
in interface IConnection
ConnectionException
- Wird geworfen, wenn der Wert nicht ermittelt werden kann.public void setTimeout(int value) throws ConnectionException
IConnection
Socket
folgend, bestimmt 0 ein
unendliches Timeout.setTimeout
in interface IConnection
ConnectionException
- Wird geworfen, wenn das setzen des TimeOut nicht moeglich
war. Insbesondere kann durch eine
UnsupportedCommandException
Ausnahme angegeben werden,
dass das setzen generell nicht moeglich ist.public void close() throws java.io.IOException
close
in interface IConnection
java.io.IOException
public int getCurrentState()
IConnection
Die Belegung sollte dabei den in ConnectionState
definierten
Konstanten folgen.
getCurrentState
in interface IConnection
public IAddress getLocalAddress()
IConnection
Fuer Implementierungen, die eine bereits eingerichtete Verbindung kapseln, um weitere Funktionalitaet bereitzustellen, sollte diese Methode die Adresse der darunter gelegenen Verbindung zurueckgeben.
getLocalAddress
in interface IConnection
public IAddress getRemoteAddress()
IConnection
Fuer Implementierungen, die eine bereits eingerichtete Verbindung kapseln, um weitere Funktionalitaet bereitzustellen, sollte diese Methode die Adresse der darunter gelegenen Verbindung zurueckgeben.
getRemoteAddress
in interface IConnection
public java.net.Socket getUnderlyingSocket()
Copyright © 2023. All rights reserved.