de.bsvrz.sys.funclib.losb.kernsoftware
Class ConnectionManager

java.lang.Object
  extended by de.bsvrz.sys.funclib.losb.kernsoftware.ConnectionManager

public class ConnectionManager
extends java.lang.Object

Verwaltet die An- und Abmeldungen als Sender / Empfänger beim Dav. Verhindert, dass die gleichen Datenidentifikationen mehrfach zum Senden / Empfangen angemeldet werden. Außerdem werden Abmeldungen erst dann durchgeführt, wenn es keinen Sender / Empfänger mehr gibt. Mehrfachanmeldungen eines Senders / Empfängers für die gleiche Datenidentifikation sind nicht möglich, auch wenn er sich mit unterschiedlichen Rollen anmeldet.
Die Anmeldungen werden nach Datenverteilerverbindung getrennt verwaltet.
Mittels noSubscriptions(ClientDavInterface) kann geprüft werden, ob es noch offene Anmeldungen gibt.
Alle Methoden sind Threadsafe.

Version:
$Revision: 1.1 $ / $Date: 2008/01/22 16:55:52 $ / ($Author: yvonnes $)
Author:
beck et al. projects GmbH, Martin Hilgers

Constructor Summary
ConnectionManager()
           
 
Method Summary
static java.util.List<java.lang.String> getReceiverInformation(ClientDavInterface dav)
           
static java.util.List<java.lang.String> getSenderInformation(ClientDavInterface dav)
           
static boolean noSubscriptions(ClientDavInterface dav)
           
static int numberReceivers(ClientDavInterface dav)
           
static int numberSenders(ClientDavInterface dav)
           
static void printStatus()
          Gibt den Status aus.
static void resetSubscriptionMarkers(ClientDavInterface dav)
          Loescht die Tabelle, in der alle Anmeldungen vermerkt sind.
static void subscrDrainNormal(ClientDavInterface dav, ClientReceiverInterface receiver, SystemObject so, java.lang.String atgPid, java.lang.String aspPid)
          Anmeldung zum Empfangen von Daten.
static void subscribeReceiver(ClientDavInterface dav, ClientReceiverInterface receiver, SystemObject object, DataDescription dataDescription, ReceiveOptions options, ReceiverRole role)
          Anmeldung zum Empfangen von Daten.
static void subscribeSender(ClientDavInterface dav, ClientSenderInterface sender, SystemObject object, DataDescription dataDescription, SenderRole role)
          Anmeldung zum Senden von Daten.
static void subscrRecNormal(ClientDavInterface dav, ClientReceiverInterface receiver, SystemObject so, java.lang.String atgPid, java.lang.String aspPid)
          Anmeldung zum Empfangen von Daten.
static void unsubscribeAll(ClientDavInterface dav)
          Meldet alle Sender und Empfänger ab.
static void unsubscribeReceiver(ClientDavInterface dav, ClientReceiverInterface receiver, SystemObject object, DataDescription dataDescription)
          Meldet den Empfang von Daten ab.
static void unsubscribeReceiver(ClientDavInterface dav, ClientReceiverInterface receiver, SystemObject so, java.lang.String atgPid, java.lang.String aspPid)
          Meldet den Empfang von Daten ab, die aud dem Konfigurationsverantwortlichen angemeldet waren.
static void unsubscribeSender(ClientDavInterface dav, ClientSenderInterface sender, SystemObject object, DataDescription dataDescription)
          Meldet das Senden von Daten ab.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ConnectionManager

public ConnectionManager()
Method Detail

printStatus

public static void printStatus()
Gibt den Status aus. Loglevel ist info


subscribeReceiver

public static void subscribeReceiver(ClientDavInterface dav,
                                     ClientReceiverInterface receiver,
                                     SystemObject object,
                                     DataDescription dataDescription,
                                     ReceiveOptions options,
                                     ReceiverRole role)
                              throws ConfigurationException,
                                     FailureException
Anmeldung zum Empfangen von Daten. Die Anmeldung wird nur durchgeführt, falls die übergebene Datenidentifikation noch nicht angemeldet wurde.

Parameters:
dav - Verbindung zum Datenverteiler
receiver - Empfänger
object - Objekt. Objekt-Teil der Datenidentifikation.
dataDescription - Datenbeschreibung. Attributgruppe und Aspekt der Datenidentifikation.
options - Empfangsoptionen. Delta oder Normaldaten.
role - Anmeldung als Empfänger oder Senke.
Throws:
ConfigurationException - Fehler bei der Kommunikation mit der Konfiguration.
FailureException - Mehrfach-Anmeldung des gleichen Receivers
See Also:
ClientDavInterface#subscribeReceiver(ClientReceiverInterface, SystemObject, DataDescription, ReceiveOptions, ReceiverRole)

subscrDrainNormal

public static void subscrDrainNormal(ClientDavInterface dav,
                                     ClientReceiverInterface receiver,
                                     SystemObject so,
                                     java.lang.String atgPid,
                                     java.lang.String aspPid)
                              throws ConfigurationException,
                                     FailureException
Anmeldung zum Empfangen von Daten. Angemeldet wird auf den Konfigurationsverantwortlichen unter ReceiveOptions.normal() und ReceiverRole.drain().

Parameters:
dav - Verbindung zum Datenverteiler
receiver - Empfänger
atgPid - Pid der Attributgruppe
aspPid - Pis des Aspektes
Throws:
ConfigurationException
FailureException

subscrRecNormal

public static void subscrRecNormal(ClientDavInterface dav,
                                   ClientReceiverInterface receiver,
                                   SystemObject so,
                                   java.lang.String atgPid,
                                   java.lang.String aspPid)
                            throws ConfigurationException,
                                   FailureException
Anmeldung zum Empfangen von Daten. Angemeldet wird auf den Konfigurationsverantwortlichen unter ReceiveOptions.normal() und ReceiverRole.receiver().

Parameters:
dav - Verbindung zum Datenverteiler
receiver - Empfänger
atgPid - Pid der Attributgruppe
aspPid - Pis des Aspektes
Throws:
ConfigurationException
FailureException

unsubscribeReceiver

public static void unsubscribeReceiver(ClientDavInterface dav,
                                       ClientReceiverInterface receiver,
                                       SystemObject so,
                                       java.lang.String atgPid,
                                       java.lang.String aspPid)
                                throws ConfigurationException
Meldet den Empfang von Daten ab, die aud dem Konfigurationsverantwortlichen angemeldet waren.

Parameters:
dav -
receiver -
atgPid -
aspPid -
Throws:
ConfigurationException
FailureException

unsubscribeReceiver

public static void unsubscribeReceiver(ClientDavInterface dav,
                                       ClientReceiverInterface receiver,
                                       SystemObject object,
                                       DataDescription dataDescription)
                                throws ConfigurationException
Meldet den Empfang von Daten ab. Die Abmeldung wird nur durchgeführt, wenn es keine weiteren Abnehmer für die Daten gibt.

Parameters:
dav - Verbindung zum Datenverteiler.
receiver - Empfänger
object - Objekt. Objekt-Teil der Datenidentifikation.
dataDescription - Datenbeschreibung. Attributgruppe und Aspekt der Datenidentifikation.
Throws:
ConfigurationException - Fehler bei der Kommunikation mit der Konfiguration.
See Also:
ClientDavInterface#unsubscribeReceiver(ClientReceiverInterface, SystemObject, DataDescription)

subscribeSender

public static void subscribeSender(ClientDavInterface dav,
                                   ClientSenderInterface sender,
                                   SystemObject object,
                                   DataDescription dataDescription,
                                   SenderRole role)
                            throws ConfigurationException,
                                   OneSubscriptionPerSendData
Anmeldung zum Senden von Daten. Die Anmeldung wird nur durchgeführt, falls die übergebene Datenidentifikation noch nicht angemeldet wurde. Wenn sich ein Sender für die gleiche Datenidentifikation anmeldet, so wird nur die erste Anmeldung durchgeführt. Die weiteren Anmeldungen werden NICHT durchgeführt. ConnectionManager ruft die ClientSenderInterface#dataRequest(SystemObject, DataDescription, byte) Methode mit dem zuletzt gültigen Wert der Sendesteuerung auf. Dies ist nötig, falls der Sender, der sich anmelden will, vor dem Senden auf eine positive Sendesteuereung wartet. (Falls der Sender die Sendesteuerung nicht benutzt, wird diese auch nicht aufgerufen.

Parameters:
dav - Verbindung zum Datenverteiler
sender - Sender.
object - Objekt. Objekt-Teil der Datenidentifikation.
dataDescription - Datenbeschreibung. Attributgruppe und Aspekt der Datenidentifikation.
role - Anmeldung als Sender oder Quelle.
Throws:
ConfigurationException - Fehler bei der Kommunikation mit der Konfiguration.
OneSubscriptionPerSendData - Falls bereits eine Anmeldung für diese Datenidentifikation existiert. Kann auftreten, wenn Anmeldungen zum Senden nicht nur durch ConnectionManager durchgeführt werden.
See Also:
ClientDavInterface#subscribeSender(ClientSenderInterface, SystemObject, DataDescription, SenderRole)

unsubscribeSender

public static void unsubscribeSender(ClientDavInterface dav,
                                     ClientSenderInterface sender,
                                     SystemObject object,
                                     DataDescription dataDescription)
                              throws ConfigurationException
Meldet das Senden von Daten ab. Die Abmeldung wird nur durchgeführt, wenn es keine weiteren Sender für die Daten gibt.

Parameters:
dav - Verbindung zum Datenverteiler.
sender - Sender.
object - Objekt. Objekt-Teil der Datenidentifikation.
dataDescription - Datenbeschreibung. Attributgruppe und Aspekt der Datenidentifikation.
Throws:
ConfigurationException - Fehler bei der Kommunikation mit der Konfiguration.
See Also:
ClientDavInterface#unsubscribeSender(ClientSenderInterface, SystemObject, DataDescription)

resetSubscriptionMarkers

public static void resetSubscriptionMarkers(ClientDavInterface dav)
Loescht die Tabelle, in der alle Anmeldungen vermerkt sind. Dies ist bei einem DAV-Absturz Anotwendig, wenn keine Zeit zum Abmelden mehr war.

Parameters:
dav - Verbindung zum Datenverteiler.

numberSenders

public static int numberSenders(ClientDavInterface dav)
Parameters:
dav - Verbindung zum Datenverteiler.
Returns:
Anzahl der registrierten Sender / Quellen.

numberReceivers

public static int numberReceivers(ClientDavInterface dav)
Parameters:
dav - Verbindung zum Datenverteiler.
Returns:
Anzahl der registrierten Empfänger / Senken.

noSubscriptions

public static boolean noSubscriptions(ClientDavInterface dav)
Parameters:
dav - Verbindung zum Datenverteiler.
Returns:
true falls es keine Anmeldungen mehr gibt. false sonst.

unsubscribeAll

public static void unsubscribeAll(ClientDavInterface dav)
Meldet alle Sender und Empfänger ab.

Parameters:
dav - Verbindung zum Datenverteiler

getReceiverInformation

public static java.util.List<java.lang.String> getReceiverInformation(ClientDavInterface dav)
Parameters:
dav - Verbindung zum Datenverteiler.
Returns:
Liefert Informationen über alle Empfänger.

getSenderInformation

public static java.util.List<java.lang.String> getSenderInformation(ClientDavInterface dav)
Parameters:
dav - Verbindung zum Datenverteiler.
Returns:
Liefert Informationen über alle Sender.


Copyright © 2005-2008 beck et al. projects GmbH All Rights Reserved.