de.bsvrz.dav.daf.communication.lowLevel
Class TelegramUtility

java.lang.Object
  extended by de.bsvrz.dav.daf.communication.lowLevel.TelegramUtility

public class TelegramUtility
extends Object

Diese Hilfsklasse stellt Methoden zur Verfügung, mit denen DatenTelegramme zerlegt und wieder zusammengefügt werden können.

Author:
Kappich Systemberatung

Method Summary
static byte getPriority(ApplicationDataTelegram telegram)
          Diese Methode liefert die Priorität eines Telegramms.
static byte getPriority(SendDataObject applicationData)
          Diese Methode liefert die Priorität eines Telegramms.
static byte getPriority(TransmitterDataTelegram telegram)
          Diese Methode liefert die Priorität eines Telegramms.
static SendDataObject getSendDataObject(ApplicationDataTelegram telegram)
          Diese Methode übersetzt das Telegramm in ein sendDataObject.
static SendDataObject getSendDataObject(ApplicationDataTelegram[] receivedData)
          Diese Methode baut aus dem Übergabeparameter ein vollständiges Datentelegramm und gibt dieses zurück.
static ApplicationDataTelegram[] splitToApplicationTelegrams(SendDataObject dataToSend)
          Diese Methode zerteilt ein Daten Telegramm, wenn es eine maximale Größe überschreitet in mehrere Teiltelegramme.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

splitToApplicationTelegrams

public static ApplicationDataTelegram[] splitToApplicationTelegrams(SendDataObject dataToSend)
Diese Methode zerteilt ein Daten Telegramm, wenn es eine maximale Größe überschreitet in mehrere Teiltelegramme. Wenn ein Datensatz == null ist, wird ein ApplictionDataTelegram ohne Nutzdaten erzeugt und zurückgegeben.

Parameters:
dataToSend - Der zusendende Datensatz
Returns:
Gibt ein Array mit den Teiltelegrammen zurück.
See Also:
getSendDataObject(de.bsvrz.dav.daf.communication.lowLevel.telegrams.ApplicationDataTelegram[])

getSendDataObject

public static SendDataObject getSendDataObject(ApplicationDataTelegram[] receivedData)
Diese Methode baut aus dem Übergabeparameter ein vollständiges Datentelegramm und gibt dieses zurück.

Das Datentelegram wurde zuvor in Teilstücke zerlegt, da es eine maximale Größe überschritten hatte.

Parameters:
receivedData - Array, bestehend aus Teilstücken des Datentelegramms
Returns:
gibt einen vollständigen Datensatz zurück. Gibt null zurück wenn IOException geworfen wurde
Throws:
IllegalArgumentException - die Exception wird geworfen wenn:
- Übergabeparameter ist eine Referenz auf null
- Die Länge des Übergabeparametrs stimmt nicht mit der erwarteten Länge überein.
- wenn ein Element des Arrays eien Referenz auf null ist.
- wenn ein Element an der falschen Position im Array steht.
See Also:
splitToApplicationTelegrams(de.bsvrz.dav.daf.communication.dataRepresentation.datavalue.SendDataObject)

getSendDataObject

public static SendDataObject getSendDataObject(ApplicationDataTelegram telegram)
Diese Methode übersetzt das Telegramm in ein sendDataObject.

Parameters:
telegram - Das vollständige DatenTelegramm.
Returns:
gibt ein sendDataObject zurück.
Throws:
IllegalArgumentException - die Exception wird geworfen wenn:
- Übergabeparameter ist eine Referenz auf null
- Die Zahl der enthaltene Telegramme größer als 1 ist

getPriority

public static byte getPriority(SendDataObject applicationData)
Diese Methode liefert die Priorität eines Telegramms.

Parameters:
applicationData - Telegramm, dessen Priorität zu ermitteln ist.
Returns:
Priorität des Telegramms. Ist der Übergabeparameter eine Refernz auf null wird -1 zurückgegeben.

getPriority

public static byte getPriority(ApplicationDataTelegram telegram)
Diese Methode liefert die Priorität eines Telegramms.

Parameters:
telegram - Datentelegramm, dessen Priorität zu ermitteln ist.
Returns:
Priorität des Telegramms. Ist der Übergabeparameter eine Refernz auf null wird -1 zurückgegeben.

getPriority

public static byte getPriority(TransmitterDataTelegram telegram)
Diese Methode liefert die Priorität eines Telegramms.

Parameters:
telegram - Transmissionstelegramm, dessen Priorität zu ermitteln ist.
Returns:
Priorität des Telegramms. Ist der Übergabeparameter eine Refernz auf null wird -1 zurückgegeben.