anon.transport.connector
Interface IConnector

Type Parameters:

AdressType - Die Klasse von Adressen, welche zur Bestimmung des Endpunktes herangezogen werden.

ConnectionType - Eine von IConnection abgeleitet Schnittstelle, welche die Art der zurueckgegeben Verbindung bestimmt.

All Known Implementing Classes:

LocalForwarder, SkypeConnector, TcpIpConnector

public interface IConnector

Ein Connector stellt die Funktionalitaet bereit um auf Basis eines bestimmten Adresstype Verbindungen einzurichten. Er ist im generellen an einen bestimmten Transportmechanismus gebunden und kapselt die darauf aufbauenden Befehle zur Bereitsstellung und Initialisierung der Verbindung.

Method Summary

IConnection

connect(IAddress a_address) Zentrale Methode der Schnittstelle, welche auf Basis der uebergebenen Adresse versucht, den entfernte Endpunkt zu kontaktieren und eine Verbindung einzurichten.

Method Detail

connect

IConnection connect(IAddress a_address)
                    throws ConnectionException

Zentrale Methode der Schnittstelle, welche auf Basis der uebergebenen Adresse versucht, den entfernte Endpunkt zu kontaktieren und eine Verbindung einzurichten.

Sollte dies erfolgreich sein, wird die entsprechende Verbindung zurueckgegeben. Andernfalls wird das Scheitern des Versuches durch eine Ausnahme angezeigt

Parameters:

address - Die Adresse des zu kontaktierenden Endpunktes

Throws:

ConnectionException - wird geworfen, wenn Aufgrund verschiedener Probleme keine Verbindung eingerichtet werden konnte.

Zur genaueren Beschreibung des Fehlers, sollte CommunicationException zur Anzeige von Fehlern bei der Kommunikation mit dem Endpunkt (ungueltige Adresse, Fehler im Transportmedium) verwendetet werden und Instanzen von RequestException um anzuzeigen, dass der Verbindungsversuch vom Endpunkt abgelehnt wurde.