anon.transport.connection

Interface IConnection

All Known Subinterfaces:

IChunkConnection, IStreamConnection

All Known Implementing Classes:

ChunkConnectionAdapter, ProxyConnection, QueuedChunkConnection, SkypeConnection, SocketConnection

public interface IConnection

Allgemeine Beschreibung einer Verbindung zwischen zwei Endpunkten und der zugehoerenden Primitive. Dieses Interface ist als "abstract" anzusehen, in dem Sinne, das die fundamentalen Primitive zum Empfang und der Uebertragung von Daten erst in aufbauenden Interfaces konkretisiert werden.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ConnectionState_CLOSE Beschreibt den Zustand, in welchem eine Verbinung als geschlossen anzusehen ist und somit keine Uebertragung von Daten moeglich ist.
static int	ConnectionState_OPEN Beschreibt den Zustand, in welchem eine Verbindung als offen angesehen werden kann und zur Uebertragung, sowie dem Empfang von Daten zur Verfuegung steht.

Method Summary

Modifier and Type	Method and Description
void	close()
int	getCurrentState() Gibt den momentanen Zustand der Verbindung an.
IAddress	getLocalAddress() Gibt die Adresse des lokalen Endpunkt der Verbindung an.
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.
void	setTimeout(int value) Setzt den Timeout in Millisekunden fuer die Lese- und Schreiboperationen der Verbindung.

Field Detail

ConnectionState_OPEN

static final int ConnectionState_OPEN

Beschreibt den Zustand, in welchem eine Verbindung als offen angesehen werden kann und zur Uebertragung, sowie dem Empfang von Daten zur Verfuegung steht.

See Also:

Constant Field Values

ConnectionState_CLOSE

static final int ConnectionState_CLOSE

Beschreibt den Zustand, in welchem eine Verbinung als geschlossen anzusehen ist und somit keine Uebertragung von Daten moeglich ist. Der geschlossen Zustand ist der finale Zustand einer Verbindung und kann nach erreichen nicht mehr gewaechselt werden.

See Also:

Constant Field Values

Method Detail

setTimeout

void setTimeout(int value)
         throws ConnectionException

Setzt den Timeout in Millisekunden fuer die Lese- und Schreiboperationen der Verbindung. Der Definition von Socket folgend, bestimmt 0 ein unendliches Timeout.

Throws:

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.

getTimeout

int getTimeout()
        throws ConnectionException

Ermittelt den momentanen Wert fuer das Timeout in Millisekunden fuer Lese- und Schreiboperationen der Verbindung. Der Definition von Socket folgend, bestimmt 0 ein unendliches Timeout.

Throws:

ConnectionException - Wird geworfen, wenn der Wert nicht ermittelt werden kann.

getLocalAddress

IAddress getLocalAddress()

Gibt die Adresse des lokalen Endpunkt der Verbindung an.

Fuer Implementierungen, die eine bereits eingerichtete Verbindung kapseln, um weitere Funktionalitaet bereitzustellen, sollte diese Methode die Adresse der darunter gelegenen Verbindung zurueckgeben.

getRemoteAddress

IAddress getRemoteAddress()

Gibt die Adresse des entfernten Endpunkt an.

Fuer Implementierungen, die eine bereits eingerichtete Verbindung kapseln, um weitere Funktionalitaet bereitzustellen, sollte diese Methode die Adresse der darunter gelegenen Verbindung zurueckgeben.

getCurrentState

int getCurrentState()

Gibt den momentanen Zustand der Verbindung an.

Die Belegung sollte dabei den in ConnectionState definierten Konstanten folgen.

close

void close()
    throws java.io.IOException

Throws:

java.io.IOException