de.bsvrz.kex.tls.osi2osi3.osi2.api
Interface DataLinkLayer

All Known Implementing Classes:
AbstractDataLinkLayer, AbstractTc57, Client, Primary, Server, WanCom, Wiretapper

public interface DataLinkLayer

Schnittstelle für Protokolle der Sicherungsschicht (OSI 2).

Author:
Kappich Systemberatung

Nested Class Summary
static interface DataLinkLayer.Link
          Schnittstellenklasse die eine logische Verbindung mit einem Kommunikationspartner darstellt.
 
Method Summary
 void abort()
          Beendet die Kommunikation dieses Protokolls.
 void addEventListener(DataLinkLayerListener dataLinkLayerListener)
           
 DataLinkLayer.Link createLink(int remoteAddress)
          Erzeugt eine neue logische Verbindung zu einem bestimmten Kommunikationspartner.
 int getLocalAddress()
          Bestimmt die OSI2-Adresse bzw.
 int getMaximumDataSize()
          Bestimmt die maximale Anzahl von Nutzdatenbytes in einem OSI-2 Paket (Telegramm).
 String getProperty(String name)
          Bestimmt den Wert eines bestimmten Protokoll-Parameters.
 boolean isStarted()
          Bestimmt, ob die Kommunikation dieses Protokolls bereits mit dr Methode start() aktiviert wurde.
 void removeEventListener(DataLinkLayerListener dataLinkLayerListener)
           
 void setDavConnection(ClientDavInterface connection)
          Nimmmt die Verbindung zum Datenverteiler entgegen.
 void setLocalAddress(int port)
          Setzt die OSI2-Adresse bzw.
 void setProperties(Properties properties)
          Setzt einen neuen Satz von Protokoll-Parametern.
 void shutdown()
          Beendet die Kommunikation dieses Protokolls.
 void start()
          Aktiviert die Kommunikation dieses Protokolls.
 

Method Detail

setDavConnection

void setDavConnection(ClientDavInterface connection)
Nimmmt die Verbindung zum Datenverteiler entgegen. Diese Methode wird vom OSI-3 Modul nach dem Erzeugen des OSI-2 Moduls durch den jeweiligen Konstruktor aufgerufen. Eine Implementierung eines Protokollmoduls kann sich bei Bedarf die übergebene Datenverteilerverbindung intern merken, um zu späteren Zeitpunkten auf die Datenverteiler-Applikationsfunktionen zuzugreifen.

Parameters:
connection - Verbindung zum Datenverteiler

getLocalAddress

int getLocalAddress()
Bestimmt die OSI2-Adresse bzw. Portnummer des eigenen Kommunikationsendpunkts.

Returns:
Eigene OSI2-Adresse bzw. Portnummer.

setLocalAddress

void setLocalAddress(int port)
Setzt die OSI2-Adresse bzw. Portnummer des eigenen Kommunikationsendpunkts.

Parameters:
port - Eigene OSI2-Adresse bzw. Portnummer.

getProperty

String getProperty(String name)
Bestimmt den Wert eines bestimmten Protokoll-Parameters.

Parameters:
name - Name des Protokoll-Parameters.
Returns:
Wert des Protokoll-Parameters.

setProperties

void setProperties(Properties properties)
Setzt einen neuen Satz von Protokoll-Parametern. Diese dienen auch als Defaultwerte für die Verbindungsparameter.

Parameters:
properties - Neue Verbindungsparameter.
See Also:
DataLinkLayer.Link.getProperty(java.lang.String)

getMaximumDataSize

int getMaximumDataSize()
Bestimmt die maximale Anzahl von Nutzdatenbytes in einem OSI-2 Paket (Telegramm).

Returns:
Maximale Anzahl Nutzdatenbytes.

addEventListener

void addEventListener(DataLinkLayerListener dataLinkLayerListener)

removeEventListener

void removeEventListener(DataLinkLayerListener dataLinkLayerListener)

start

void start()
Aktiviert die Kommunikation dieses Protokolls.


shutdown

void shutdown()
Beendet die Kommunikation dieses Protokolls. Alle noch verbundenen Links werden mit der Methode DataLinkLayer.Link.shutdown() terminiert. Dabei wird sichergestellt, dass Daten, die zuvor an die Methode DataLinkLayer.Link.send(byte[], int) übergeben wurden, auch übertragen werden.


abort

void abort()
Beendet die Kommunikation dieses Protokolls. Alle noch verbundenen Links werden mit der Methode DataLinkLayer.Link.abort() terminiert.


isStarted

boolean isStarted()
Bestimmt, ob die Kommunikation dieses Protokolls bereits mit dr Methode start() aktiviert wurde.

Returns:
true, wenn die Kommunikation dieses Protokolls bereits aktiviert wurde, sonst false.

createLink

DataLinkLayer.Link createLink(int remoteAddress)
Erzeugt eine neue logische Verbindung zu einem bestimmten Kommunikationspartner.

Parameters:
remoteAddress - OSI-2 Adresse bzw. Portnummer des gewünschten Kommunikationspartners.
Returns:
Logische Verbindung zum Kommunikationspartner.