Class ClientHighLevelCommunication
- All Implemented Interfaces:
HighLevelCommunicationCallbackInterface
- Initialisierung und Verhandlung der Protokollversion.
Mit Hilfe der Telegrammverwaltung wird die TCP-Verbindung zum Datenverteiler hergestellt. Anschließend wird dem Datenverteiler in einem Protokollversionsanfrage-Telegramm mitgeteilt, welche Versionen des Kommunikationsprotokolls unterstützt werden. Als Reaktion wird vom Datenverteiler ein Protokollversionsantwort-Telegramm erwartet in dem die zu verwendende Version des Protokolls enthalten ist. - Authentifizierung gegenüber dem Datenverteiler und Verhandlung der Verbindungsparameter.
Zur Authentifizierung wird ein Authentifizierungsbereitschafts-Telegramm übertragen. Als Antwort wird ein vom Datenverteiler generierter Zufallstext im Authentifizierungsaufforderungs-Telegramm erwartet. Dieser Text wird durch das Modul HMAC-MD5-Verschlüsselung verschlüsselt. Als geheimer Schlüssel dient dabei das Passwort des Benutzers. Der verschlüsselte Text wird mit weiteren Informationen zum Datenverteiler übertragen. Als Antwort wird vom Datenverteiler ein Authentifizierungsannahme-Telegramm oder ein Authentifizierungsablehnungs-Telegramm erwartet. Im Falle einer Authentifizierungsablehnung wird der Authentifizierungsvorgang abgebrochen und kann bei Bedarf von der Verwaltung mit anderen Authentifizierungsinformationen wiederholt initiiert werden. Im Falle einer Authentifizierungsannahme werden anschließend die Verbindungsparameter verhandelt. Dazu sendet die Protokollsteuerung ein Verbindungsparameteranfrage-Telegramm an den Datenverteiler und erwartet ein Verbindungsparameterantwort-Telegramm mit der Festlegung der Verbindungsparameter vom Datenverteiler. - Abbruch der Verbindung
Diese Funktion führt zum sofortigen Abbruch der Verbindung zum Datenverteiler mit Hilfe der Abbruch-Funktion der Telegrammverwaltung. - Terminierung der
Verbindung
Zur Terminierung der Verbindung zum Datenverteiler wird ein Applikationsabmeldungs-Telegramm übertragen und die Kommunikationsverbindung terminiert. Dabei wird durch die Telegrammverwaltung sichergestellt, dass alle noch im Sendepuffer befindliche Telegramme vor dem Schließen der Kommunikationsverbindung zum Datenverteiler übertragen werden. - Parametrierung des Datenverteilers
Zur An- bzw. Abmeldung von zu empfangenden bzw. zu sendenden Daten wird ein entsprechendes Telegramm (Empfangsanmeldung, Sendeanmeldung, Empfangsabmeldung, Sendeabmeldung) an den Datenverteiler übertragen. - Entgegennahme von Sendesteuerungs-Telegrammen und Weiterleitung der enthaltenen Information (ob Daten, die von der Applikation zum Senden
angemeldet wurden, vom Datenverteiler benötigt werden oder nicht) an die Verwaltung.
- Senden von Anwendungsdaten
Zu sendende Datenblöcke werden in Telegramme zerlegt und an die Telegrammverwaltung weitergeleitet. - Empfang von Anwendungsdaten
Von der Telegrammverwaltung entgegengenommene Telegramme werden zu Datenblöcken rekombiniert und an das Modul Verwaltung weitergeleitet. - Zerlegung von großen Datenblöcken
in mehrere Datentelegramme beim Senden und Rekombination von zusammengehörigen Datentelegrammen zu einem Datenblock beim
Empfang.
- Telegrammlaufzeitermittlung
Zur Messung von Telegrammlaufzeiten wird ein Telegrammlaufzeitanfrage-Telegramm mit der aktuellen Systemzeit an den Datenverteiler übertragen. Als Antwort wird ein Telegrammlaufzeitantwort-Telegramm erwartet, in dem die ursprünglich übertragene Systemzeit enthalten ist. Durch Vergleich der Zeit zwischen dem Absenden des Anfrage-Telegramms und dem Erhalt der Antwort wird die Laufzeit für Hin- und Rückweg zusammen ermittelt. Andererseits kann auch vom Datenverteiler eine solche Messung durchgeführt werden, d.h. bei Empfang eines Telegrammlaufzeitanfrage-Telegramms wird die enthaltene Systemzeit in einem Telegrammlaufzeitantwort-Telegramm zurück übertragen. - Fehlerbehandlung
Fehlerzustände, die von der Protokollsteuerung erkannt werden oder von der Telegrammverwaltung gemeldet werden, führen zu einem Abbruch der Verbindung und zu einer Benachrichtigung des Moduls Verwaltung.
-
Constructor Summary
ConstructorsConstructorDescriptionDieser Konstruktor wird für JUnit-Tests gebraucht.ClientHighLevelCommunication(ClientDavParameters clientDavParameters, ApplicationCloseActionHandler closer) Dieser Konstruktor erzeugt eine Instanz dieser Klasse mit den übergebenen Parametern. -
Method Summary
Modifier and TypeMethodDescriptionfinal voidcompleteInitialisation(ConfigurationManager configurationManager, CacheManager cacheManager, SubscriptionManager subscriptionManager) Schließt die Initialisierung ab.voiddisconnected(boolean error, String message) Wird von der unteren Kommunikationsschicht in Fehlersituationen zum Abbruch der Kommunikationsverbindung aufgerufen.longGibt die Id der Applikation zurück.final longGibt die Id der Konfiguration zurück.Diese Methode gibt die Eigenschaften dieser Verbindung zurück.final longGibt die Id des Datenverteilers zurück.Gibt die temporäre Liste der Systemtelegramme für interne Synchronisationszwecke zurück.final longgetTelegramTime(long maxWaitingTime) Schickt ein Laufzeitermittlungs-Telegramm zum Datenverteiler und wartet auf seine Antwort, um herauszubekommen, wie viel Zeit die Übertragung in Anspruch nimmt.final longGibt die Id des Benutzers zurück.booleanGibttruezurück, wenn die Verbindung getrennt wurdefinal voidlogin(ClientCredentials clientCredentials) Die Methode erstellt eine logische Verbindung zum Datenverteiler, d. h. die Authentifizierung der Applikation und das Einstellen der Kommunikationsparameter wird durchgeführt, damit der Austausch von Daten sicher durchgeführt werden kann.final voidsendData(SendDataObject dataToSend) Versendet ein Applikationsdatentelegramm an den Datenverteiler.voidsendReceiveSubscription(ReceiveSubscriptionInfo subscription) Es wird einEmpfangsanmeldungstelegrammerstellt und zum Datenverteiler gesendet.final voidsendReceiveUnsubscription(BaseSubscriptionInfo unsubscription) Es wird einEmpfangsabmeldungstelegrammerstellt und zum Datenverteiler gesendet.voidsendSendSubscription(SendSubscriptionInfo subscription) Es wird einSendeanmeldetelegrammerstellt und zum Datenverteiler gesendet.final voidsendSendUnsubscription(BaseSubscriptionInfo unsubscription) Es wird einSendeabmeldetelegrammerstellt und zum Datenverteiler gesendet.final voidSetzt denApplicationCloseActionHandlerdieser Subkomponente.voidsetConnectionListener(DavConnectionListener connectionListener) Meldet einen Beobachter für Zustandsänderungen der Datenverteilerverbindung an.final voidDiese Methode wird vom Anmeldungsmanager aufgerufen, nachdem die Anmeldungen erfolgreich abgeschlossen sind, die eine gerichtete Kommunikation mit der Konfiguration gewährleisten.final voidDie bestehende Verbindung zum Datenverteiler wird terminiert, und der Kommunikationskanal wird geschlossen.final voidterminate(boolean error, String message, DataTelegram terminationTelegram) final voidupdate(DataTelegram telegram) Wird von der unteren Kommunikationsschicht nach Empfang eines Telegramms aufgerufen.final voidupdateConfigData(SendDataObject receivedData) Wenn ein neues Konfigurationstelegramm angekommen ist, wird es an die Verwaltung weitergeleitet.
-
Constructor Details
-
ClientHighLevelCommunication
public ClientHighLevelCommunication(ClientDavParameters clientDavParameters, ApplicationCloseActionHandler closer) throws CommunicationError, ConnectionException Dieser Konstruktor erzeugt eine Instanz dieser Klasse mit den übergebenen Parametern.ClientDavParametersenthält die Adresse und Subadresse des Datenverteilers, spezifiziert das zu verwendende Protokoll durch dessen Namen.ApplicationCloseActionHandlerbestimmt wie die Applikationsfunktion auf einen Kommunikationsfehler reagieren soll.ClientConnectionPropertieswerden erzeugt, die die Eigenschaften dieser Verbindung verkörpern. Sie spezifizieren insbesondere denAuthentificationProcess, das für die Passwortverschlüsselung zuständige Verfahren. Weiter enthalten sie die PID der Konfiguration.Ein Systemtelegramm
ProtocolVersionRequestwird gebildet und zum Datenverteiler gesendet. Es enthält Angaben über die unterstützte Protokollversion. Auf die Antwort wird eine festgelegte Zeit gewartet (maximale Wartezeit auf synchrone Antworten). Wenn die Antwort nicht innerhalb diese Zeit an-gekommen ist oder die Protokollversion vom Datenverteiler nicht unterstützt wird, dann wird eine CommunicationError-Ausnahme erzeugt.- Parameters:
clientDavParameters- Parameterklasse für die Datenverteiler-Applikationsfunktionencloser- bestimmt, wie die Applikationsfunktionen auf einen Kommunikationsfehler reagieren soll- Throws:
CommunicationError- Wenn die Verhandlung der Protokollversion nicht durchgeführt wurde oder die Protokollversion nicht unterstützt wird.ConnectionException- Wenn die Verbindung über die Telegrammverwaltung fehlschlägt.
-
ClientHighLevelCommunication
public ClientHighLevelCommunication()Dieser Konstruktor wird für JUnit-Tests gebraucht.
-
-
Method Details
-
isDisconnecting
public boolean isDisconnecting()Gibttruezurück, wenn die Verbindung getrennt wurde- Returns:
true, wenn die Verbindung getrennt wurde, sonstfalse
-
getEncryptionStatus
-
getAuthenticationStatus
-
completeInitialisation
public final void completeInitialisation(ConfigurationManager configurationManager, CacheManager cacheManager, SubscriptionManager subscriptionManager) Schließt die Initialisierung ab. Diese Methode wird von ClientDavConnection aufgerufen. Es werden Referenzen auf den Konfigurationsmanager, den Cache-Manager und den Anmeldungsmanager festgehalten. Zusätzlich wird eine Referenz auf ClientHighLevelCommunication an den Anmeldungsmanager übergeben.- Parameters:
configurationManager- der KonfigurationsmanagercacheManager- der Cache-ManagersubscriptionManager- der Anmeldungsmanager
-
getApplicationId
public long getApplicationId()Gibt die Id der Applikation zurück.- Returns:
- die Id der Applikation
-
getDataTransmitterId
public final long getDataTransmitterId()Gibt die Id des Datenverteilers zurück.- Returns:
- die Id des Datenverteilers
-
getConfigurationId
public final long getConfigurationId()Gibt die Id der Konfiguration zurück.- Returns:
- die ID der Konfiguration
-
getUserId
public final long getUserId()Gibt die Id des Benutzers zurück.- Returns:
- die ID des Benutzers
-
setReadyForConfigDependantData
public final void setReadyForConfigDependantData()Diese Methode wird vom Anmeldungsmanager aufgerufen, nachdem die Anmeldungen erfolgreich abgeschlossen sind, die eine gerichtete Kommunikation mit der Konfiguration gewährleisten. Dadurch signalisiert der Anmeldungsmanager die Bereitschaft, Datensätze zu empfangen, die Konfigurationsdaten benötigen, um interpretiert zu werden. -
setCloseHandler
Setzt denApplicationCloseActionHandlerdieser Subkomponente. Dieser bestimmt wie die Applikationsfunktion auf einen Kommunikationsfehler reagieren soll.- Parameters:
closer-ApplicationCloseActionHandler
-
login
public final void login(ClientCredentials clientCredentials) throws InconsistentLoginException, CommunicationError Die Methode erstellt eine logische Verbindung zum Datenverteiler, d. h. die Authentifizierung der Applikation und das Einstellen der Kommunikationsparameter wird durchgeführt, damit der Austausch von Daten sicher durchgeführt werden kann. EinAuthentificationTextRequest-Telegramm mit der Konfigurations-PID wird über dieTelegrammverwaltungzum Datenverteiler gesendet, um einen Schlüssel für die Authentifizierung anzufordern. Auf die AntwortAuthentificationTextAnswerwird eine gewisse Zeit gewartet (maximale Wartezeit auf synchrone Antworten). Mit dem vom Datenverteiler erhaltenen Schlüssel wird das Benutzerpasswort durch denAuthentificationProcessverschlüsselt und alsAuthentificationRequestzum Datenverteiler gesendet. Auch hier wird eine gewisse Zeit auf die AntwortAuthentificationAnswergewartet (maximale Wartezeit auf synchrone Antworten). Wenn die Authentifizierung erfolgreich ist, werden die Ids der Applikation, des Datenverteilers, der Konfiguration und des Benutzers übertragen und von dieser Subkomponente festgehalten. Wird als Id der Konfiguration-1zurückgegeben, so war die spezifizierte PID dem System nicht bekannt. Sonst werden die Keep-alive-Parameter und die Durchsatzprüfungsparameter mit dem Datenverteiler verhandelt. EinComParametersRequestwird zum Datenverteiler gesendet. Auch hier wird auf die AntwortComParametersAnswereine gewisse Zeit gewartet (maximale Wartezeit auf synchrone Antworten).- Parameters:
clientCredentials- Passwort oder Login-Token- Throws:
InconsistentLoginException- Wenn die Authentifizierung nicht erfolgreich abgeschlossen werden konnte.CommunicationError- Wenn eine Antwort nicht innerhalb einer parametrierten Zeit vom Datenverteiler beantwortet wird oder wenn als Id der Konfiguration eine-1ermittelt wird.
-
sendReceiveSubscription
Es wird einEmpfangsanmeldungstelegrammerstellt und zum Datenverteiler gesendet.- Parameters:
subscription- die Empfangsanmeldeinformationen
-
sendReceiveUnsubscription
Es wird einEmpfangsabmeldungstelegrammerstellt und zum Datenverteiler gesendet.- Parameters:
unsubscription- die Empfangsabmeldeinformationen
-
sendSendSubscription
Es wird einSendeanmeldetelegrammerstellt und zum Datenverteiler gesendet.- Parameters:
subscription- die Sendeanmeldeinformationen
-
sendSendUnsubscription
Es wird einSendeabmeldetelegrammerstellt und zum Datenverteiler gesendet.- Parameters:
unsubscription- die Sendeabmeldeinformationen
-
sendData
Versendet ein Applikationsdatentelegramm an den Datenverteiler. Falls der zu sendende Datensatz größer ist, als die im System gesetzte maximale Länge eines Telegramms, wird er in Teiltelegramme zerstückelt und zum Datenverteiler gesendet.- Parameters:
dataToSend- die zu sendenden Daten als Bytefeld vorbereitet
-
terminate
Die bestehende Verbindung zum Datenverteiler wird terminiert, und der Kommunikationskanal wird geschlossen. Wenn der Parametererrorgesetzt ist, wird die close-Methode vomApplicationCloseActionHandleraufgerufen.- Parameters:
error- Isttrue, wenn die Verbindung im Fehlerfall abgebrochen werden soll, ohne die noch gepufferten Telegramme zu versenden;false, wenn versucht werden soll alle gepufferten Telegramme zu versenden.message- Fehlermeldung, die die Fehlersituation näher beschreibt.
-
terminate
-
disconnected
Description copied from interface:HighLevelCommunicationCallbackInterfaceWird von der unteren Kommunikationsschicht in Fehlersituationen zum Abbruch der Kommunikationsverbindung aufgerufen.- Specified by:
disconnectedin interfaceHighLevelCommunicationCallbackInterface- Parameters:
error-truesignalisiert eine Fehlersituation der unteren Kommunikationsschicht.message- Fehlermeldung, die die Fehlersituation näher beschreibt.
-
update
Wird von der unteren Kommunikationsschicht nach Empfang eines Telegramms aufgerufen. Erhält ein Aktualisierungsdatum vom Datenverteiler. Diese Methode wird von derLowLevelCommunicationaufgerufen, wenn ein neues Telegramm angekommen ist. Sie reagiert nur auf die Telegramme, die für die Applikation von Interesse sind.Neu ankommende Telegramme werden je nach Typ unterschiedlich weiterverarbeitet:
Wenn das Telegramm vom Typ
AuthentificationTextAnswer,AuthentificationAnswer,ComParametersAnswer,ProtocolVersionAnsweroderTelegramTimeAnswerist, wird es in eine Liste eingefügt und eine Broadcast-Nachricht an alle wartenden Methoden gesendet. Diese überprüfen ob die Nachricht für sie relevant ist. In diesem Falle wird sie aus der Liste entfernt und bearbeitet.
Wenn das Telegramm vom TypTelegramTimeRequestist, wird anhand der übergebenen gemessene Zeit einTelegramTimeAnswergebildet und zum Datenverteiler gesendet.
Wenn das Telegramm vom TypRequestSenderDataTelegramist, wird die MethodenotifySenderApplicationdes Anmeldungsmanagers aufgerufen, um die Applikation zu benachrichtigen.
Wenn das Telegramm vom TypApplicationDataTelegramist, wird zunächst überprüft, ob ein zerstückeltes Telegramm vorliegt. Ist dies der Fall, dann wird es in eine Liste eingefügt und überprüft ob alle Teiltelegramme vorhanden sind. Sind alle vorhanden, wird aus den Telegrammen einSendDataObjecterzeugt, das weiterverarbeitet werden kann. Wenn das Telegramm nicht zerstückelt ist, wird es sofort in einSendDataObjectzur Weiterbearbeitung umgewandelt. Wenn dieses erfolgreich erzeugt wurde, wird anhand seiner Basisanmeldeinformation überprüft, ob es eine Antwort einer Konfigurationsanfrage ist. Ist dies der Fall, so wird das Telegramm derupdate-Methode des Konfigurations-Managers übergeben, wenn nicht, handelt es sich um ein Online-Telegramm und es wird an dieupdate-Methode des Cache-Managers übergeben.
Wenn das Telegramm vom TypClosingTelegramoderTerminateOrderTelegramist, wird die Methodeterminate(boolean, java.lang.String)aufgerufen.Jeder andere Telegrammtyp wird ignoriert.
- Specified by:
updatein interfaceHighLevelCommunicationCallbackInterface- Parameters:
telegram- Das empfangene Telegramm- Throws:
InterruptedException- Wenn der Thread während eines blockierenden Aufrufs unterbrochen wurde
-
updateConfigData
Description copied from interface:HighLevelCommunicationCallbackInterfaceWenn ein neues Konfigurationstelegramm angekommen ist, wird es an die Verwaltung weitergeleitet.- Specified by:
updateConfigDatain interfaceHighLevelCommunicationCallbackInterface- Parameters:
receivedData- das Konfigurationstelegramm
-
getConnectionProperties
Diese Methode gibt die Eigenschaften dieser Verbindung zurück.- Returns:
- die Eigenschaften dieser Verbindung
-
getTelegramTime
Schickt ein Laufzeitermittlungs-Telegramm zum Datenverteiler und wartet auf seine Antwort, um herauszubekommen, wie viel Zeit die Übertragung in Anspruch nimmt.- Parameters:
maxWaitingTime- Zeit in Millisekunden, die maximal auf eine Antwort gewartet wird.- Returns:
- Die Zeit, die benötigt wurde, um ein Telegramm von der Applikation zum Datenverteiler und zurück zu senden oder
-1falls innerhalb der angegebenen Timeout-Zeit keine Antwort empfangen wurde. - Throws:
CommunicationError- Falls die Verbindung zum Datenverteiler gestört ist.
-
setConnectionListener
Meldet einen Beobachter für Zustandsänderungen der Datenverteilerverbindung an.- Parameters:
connectionListener- Beobachter für Zustandsänderungen der Datenverteilerverbindung
-
getSyncSystemTelegramList
Gibt die temporäre Liste der Systemtelegramme für interne Synchronisationszwecke zurück.- Returns:
- die Liste der Systemtelegramme
-