de.bsvrz.dav.daf.main
Class ClientDavParameters

java.lang.Object
  extended by de.bsvrz.dav.daf.main.ClientDavParameters

public class ClientDavParameters
extends Object

Parameter für die Datenverteiler-Applikationsfunktionen. Diese Klasse implementiert die Schnittstelle DatenverteilerApplikationsfunktionen-Starter. Beim Erzeugen eines Objekts dieser Klasse werden die Parameter auf die in den Aufrufargumenten der Applikation angegebenen Werte bzw. auf die festgelegten Default-Werte gesetzt. Einzelne Parameter können mit den entsprechenden Zugriffsmethoden gesetzt und abgefragt werden.

Author:
Kappich Systemberatung

Nested Class Summary
(package private)  class ClientDavParameters.AttributeGroupAspectObject
           
 
Field Summary
private  String _address
          Datenverteiler-Adresse
private  String _applicationName
          Der Applikationsname (Default: Testapplikation)
private  String _applicationTypePid
          Die Pid der Applikationstyp (Default: typ.applikation)
private  Hashtable<ClientDavParameters.AttributeGroupAspectObject,ClientDavParameters.AttributeGroupAspectObject> _aspectToSubstituteTable
          Tabelle der Informationen über Umleitungen der Aspekte
private  String _authentificationProcessName
          Der Authentifikationsprozessname (Default: HMAC-MD5)
private  CommunicationParameters _communicationParameters
          Enthält die Parameter für die Kommunikation zwischen Applikation und Datenverteiler.
private  long _communicationSendFlushDelay
          Die Verzögerungszeit zur Übertragung von gepufferten und zu versendenden Telegrammen.
private  String _configurationPath
          Speicherort der lokalen Konfiguration.
private  String _configurationPid
          Die Pid der Konfiguration
private  boolean _connectionForTests
          Speichert, ob die Verbindung zu Testzwecken aufgebaut wird.
private static Debug _debug
          Der Debug-Logger der Klasse
private  int _deliveryBufferSize
          Die Größe des Auslieferungspuffers in Bytes, der zur Zwischenspeicherung von Datensätzen genutzt wird, die an einen Empfänger der Applikation versendet werden sollen.
private  String _incarnationName
          Enthält den via Aufrufparameter von Start/Stopp vorgegebenen Inkarnationsnamen oder "", falls das Aufrufargument nicht angegeben wurde.
private  int _inputBufferSize
          Die Größe des Empfangspuffers in Bytes, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
private  String _lowLevelCommunicationName
          Der Name des Kommunikationsprotokolls (Default: TCP-IP)
private  int _maxTelegramSize
          Die maximale Größe von Datentelegrammen.
private  int _outputBufferSize
          Die Größe des Sendepuffers in Bytes, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
private  ResourceBundle _resourceBundle
          Die Ressourcen des Clients.
private  short _simulationVariant
          Die Standardmäßig zu verwendende Simulationsvariante.
private  int _subAddress
          die Subadresse des Datenverteilers
private  Hashtable<ClientDavParameters.AttributeGroupAspectObject,ClientDavParameters.AttributeGroupAspectObject> _substituteToAspectTable
          Tabelle der Informationen über Umleitungen der Aspekte
private  String _userName
          Der Name des Benutzers
private  String _userPassword
          Der Passwort des Benutzers
private static String ADDRESS_SUBADDRESS_KEY
          Parameter Schlüssel
private static String ASPECT_REDIRECTION_KEY
          Parameter Schlüssel
private static String AUTHENTIFICATION_FILE_KEY
          Parameter Schlüssel
private static String AUTHENTIFICATION_PROCESS_KEY
          Parameter Schlüssel
private static String BUFFER_KEY
          Aufrufargument zur Einstellung der Puffergrößen.
private static String CONFIGURATION_PATH_KEY
          Parameter Schlüssel
private static String CONFIGURATION_PID_KEY
          Parameter Schlüssel
private static String FLOW_CONTROL_PARAMETERS_KEY
          Parameter Schlüssel
private static String INCARNATION_KEY
          Aufrufargument mit dem Inkarnationsname der von Start/Stopp vorgegeben wird, um eine eindeutige Zuordnung zwischen gestartetem Prozeß und dem entsprechenden Applikationsobjekt herzustellen.
private static String PARAMETER_SEPARATOR
          Parameter Schlüssel
private static String RECEIVE_KEEP_ALIVE_TIMEOUT_KEY
          Parameter Schlüssel
private static String SEND_KEEP_ALIVE_TIMEOUT_KEY
          Parameter Schlüssel
private static String SIMULATION_VARIANT_KEY
          Parameter Schlüssel
private static String TEST_CONNECTION_KEY
          Parameter Schlüssel
private static String USER_NAME_KEY
          Parameter Schlüssel
 
Constructor Summary
ClientDavParameters()
          Erzeugt einen neuen Parametersatz mit Defaultwerten für die einzelnen Parameter.
ClientDavParameters(ArgumentList argumentList)
          Erzeugt einen neuen Parametersatz mit Defaultwerten für die einzelnen Parameter und setzt die in den übergebenen Aufrufargumenten angegebenen Parameter mit den jeweils angegebenen Werten.
ClientDavParameters(String[] startArguments)
          Erzeugt einen neuen Parametersatz mit Defaultwerten für die einzelnen Parameter und setzt die in den übergebenen Aufrufargumenten angegebenen Parameter mit den jeweils angegebenen Werten.
ClientDavParameters(String configurationPid, String address, int subAddress, String userName, String userPassword, String applicationName, String authentificationProcessName, int maxTelegramSize, long receiveKeepAliveTimeout, long sendKeepAliveTimeout, int outputBufferSize, int inputBufferSize, String communicationProtocolName)
          Erzeugt einen neuen Parametersatz mit den angegebenen Werten.
 
Method Summary
 void addAspectRedirection(String attributeGroupPid, String aspectPid, String substituteAspectPid)
          Setzt eine Aspektumleitung für eine Kombination von Attributgruppe und Aspekt.
 String aspectToSubstitute(String attributeGroupPid, String aspectPid)
          Gibt die Aspektumleitung für eine Kombination von Attributgruppe und Aspekt zurück.
 String getApplicationName()
          Bestimmt den Namen der Applikation.
 String getApplicationTypePid()
          Bestimmt den Typ der Applikation.
 String getAuthentificationProcessName()
          Bestimmt das bei der Authentifizierung zu verwendende Verfahren.
 float getCacheThresholdPercentage()
          Deprecated. Wird durch getThroughputControlSendBufferFactor() ersetzt.
 int getCommunicationInputBufferSize()
          Bestimmt die Größe des Empfangspuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
 int getCommunicationOutputBufferSize()
          Bestimmt die Größe des Sendepuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
 CommunicationParameters getCommunicationParameters()
          Gibt die Parameter für die Kommunikation zwischen Applikation und Datenverteiler zurück.
 long getCommunicationSendFlushDelay()
          Bestimmt die Verzögerungszeit zur Übertragung von gepufferten und zu versendenden Telegrammen.
 String getConfigurationPath()
          Bestimmt den Ort zum Zwischenspeichern der Konfiguration.
 String getConfigurationPid()
          Bestimmt die PID der zu verwendenden Konfiguration.
 String getDavCommunicationAddress()
          Bestimmt die Kommunikationsaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll.
 int getDavCommunicationSubAddress()
          Bestimmt die Kommunikationssubaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll.
 int getDeliveryBufferSize()
          Liefert die Größe des Auslieferungspuffers, der zur Zwischenspeicherung von Datensätzen genutzt wird, die an einen Empfänger der Applikation versendet werden sollen.
 long getFlowControlThresholdTime()
          Deprecated. Wird durch getThroughputControlInterval() ersetzt.
 String getIncarnationName()
          Liefert den via Aufrufparameter von Start/Stopp vorgegebenen Inkarnationsnamen.
 String getLowLevelCommunicationName()
          Bestimmt das auf unterster Ebene einzusetzende Kommunikationsprotokoll für die Kommunikation mit dem Datenverteiler.
 int getMaxDataTelegramSize()
          Bestimmt die maximale Größe von Datentelegrammen.
 int getMinConnectionSpeed()
          Deprecated. Wird durch getMinimumThroughput() ersetzt.
 int getMinimumThroughput()
          Deprecated. Wert kann aus den CommunicationParameters gelesen werden.
private  String getParameter(String[] arguments, String key)
          Sucht in den angegebenen Argumenten nach dem Parameter, der mit dem spezifizierten Schlüssel anfängt.
 long getReceiveKeepAliveTimeout()
          Deprecated. Wert kann aus den CommunicationParameters gelesen werden.
 long getSendKeepAliveTimeout()
          Deprecated. Wert kann aus den CommunicationParameters gelesen werden.
 short getSimulationVariant()
          Bestimmt die Standardmäßig zu verwendende Simulationsvariante.
 long getThroughputControlInterval()
          Deprecated. Wert kann aus den CommunicationParameters gelesen werden.
 float getThroughputControlSendBufferFactor()
          Deprecated. Wert kann aus den CommunicationParameters gelesen werden.
 String getUserName()
          Bestimmt den bei der Authentifizierung zu verwendenden Benutzernamen.
 String getUserPassword()
          Bestimmt das bei der Authentifizierung zu verwendende Passwort.
 boolean isConnectionForTests()
          Gibt an, ob die Verbindung für Testzwecken aufgebaut werden soll.
static void printArgumentsList()
          Gibt die eingestellten Parameter auf die Standardausgabe aus.
 void setApplicationName(String applicationName)
          Setzt den Namen der Applikation.
 void setApplicationTypePid(String applicationTypePid)
          Setzt den Typ der Applikation.
 void setAuthentificationProcessName(String authentificationProcessName)
          Setzt das bei der Authentifizierung zu verwendende Verfahren.
 void setCacheThresholdPercentage(float cacheThresholdPercentage)
          Deprecated. Wird durch setThroughputControlSendBufferFactor(float) ersetzt.
 void setCommunicationInputBufferSize(int bufferSize)
          Setzt die Größe des Empfangspuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
 void setCommunicationOutputBufferSize(int bufferSize)
          Setzt die Größe des Sendepuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
 void setCommunicationSendFlushDelay(long delay)
          Setzt die Verzögerungszeit zur Übertragung von gepufferten und zu versendenden Telegrammen.
 void setConfigurationPath(String configurationPath)
          Setzt den Ort zum Zwischenspeichern der Konfiguration.
 void setConfigurationPid(String configurationPid)
          Setzt die PID der zu verwendenden Konfiguration.
 void setConnectionForTests(boolean connectionForTests)
          Legt fest, ob eine Verbindung für Testzwecke aufgebaut werden soll.
 void setDavCommunicationAddress(String address)
          Setzt die Kommunikationsaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll.
 void setDavCommunicationSubAddress(int subAddress)
          Setzt die Kommunikationssubaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll.
 void setDeliveryBufferSize(int deliveryBufferSize)
          Setzt die Größe des Auslieferungspuffers, der zur Zwischenspeicherung von Datensätzen genutzt wird, die an einen Empfänger der Applikation versendet werden sollen.
 void setFlowControlThresholdTime(long flowControlThresholdTime)
          Deprecated. Wird durch setThroughputControlInterval(long) ersetzt.
 void setLowLevelCommunicationName(String lowLevelCommunicationName)
          Setzt das auf unterster Ebene einzusetzende Kommunikationsprotokoll.
 void setMaxDataTelegramSize(int maxTelegramSize)
          Setzt die maximale Größe von Datentelegrammen.
 void setMinConnectionSpeed(int minConnectionSpeed)
          Deprecated. Wird durch setMinimumThroughput(int) ersetzt.
 void setMinimumThroughput(int throughput)
          Deprecated. Wert kann in den CommunicationParameters gesetzt werden.
 void setReceiveKeepAliveTimeout(long timeout)
          Deprecated. Wert kann in den CommunicationParameters gesetzt werden.
 void setSendKeepAliveTimeout(long timeout)
          Deprecated. Wert kann in den CommunicationParameters gesetzt werden.
 void setSimulationVariant(short variant)
          Setzt die Standardmäßig zu verwendende Simulationsvariante.
 void setThroughputControlInterval(long interval)
          Deprecated. Wert kann in den CommunicationParameters gesetzt werden.
 void setThroughputControlSendBufferFactor(float sendBufferFactor)
          Deprecated. Wert kann in den CommunicationParameters gesetzt werden.
 void setUserName(String userName)
          Setzt den bei der Authentifizierung zu verwendenden Benutzernamen.
 void setUserPassword(String userPassword)
          Setzt das bei der Authentifizierung zu verwendende Passwort.
 String substituteToAspect(String attributeGroupPid, String aspectPid)
          Gibt den Original-Aspekt eines ersetzten Aspekts einer Attributgruppe zurück.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

_debug

private static final Debug _debug
Der Debug-Logger der Klasse


BUFFER_KEY

private static final String BUFFER_KEY
Aufrufargument zur Einstellung der Puffergrößen. Mit diesem Aufrufargument müssen drei durch Doppelpunkt getrennte Zahlen angegeben werden:

-puffer=sendepuffer:empfangspuffer:auslieferungspuffer

Alle Angaben sind als Anzahl von Bytes zu verstehen. sendepuffer und empfangspuffer spezifizieren die Größe der Puffer, die bei der Datenverteilerkommunikation zur Zwischenspeicherung von zu sendenden bzw. empfangenen Telegrammen verwendet werden. auslieferungspuffer spezifiziert die Größe des Auslieferungspuffers, der zur Zwischenspeicherung von an die Applikation auszuliefernden Datensätzen verwendet wird.

See Also:
Constant Field Values

INCARNATION_KEY

private static final String INCARNATION_KEY
Aufrufargument mit dem Inkarnationsname der von Start/Stopp vorgegeben wird, um eine eindeutige Zuordnung zwischen gestartetem Prozeß und dem entsprechenden Applikationsobjekt herzustellen.

See Also:
Constant Field Values

ADDRESS_SUBADDRESS_KEY

private static final String ADDRESS_SUBADDRESS_KEY
Parameter Schlüssel

See Also:
Constant Field Values

CONFIGURATION_PID_KEY

private static final String CONFIGURATION_PID_KEY
Parameter Schlüssel

See Also:
Constant Field Values

CONFIGURATION_PATH_KEY

private static final String CONFIGURATION_PATH_KEY
Parameter Schlüssel

See Also:
Constant Field Values

USER_NAME_KEY

private static final String USER_NAME_KEY
Parameter Schlüssel

See Also:
Constant Field Values

AUTHENTIFICATION_FILE_KEY

private static final String AUTHENTIFICATION_FILE_KEY
Parameter Schlüssel

See Also:
Constant Field Values

AUTHENTIFICATION_PROCESS_KEY

private static final String AUTHENTIFICATION_PROCESS_KEY
Parameter Schlüssel

See Also:
Constant Field Values

SEND_KEEP_ALIVE_TIMEOUT_KEY

private static final String SEND_KEEP_ALIVE_TIMEOUT_KEY
Parameter Schlüssel

See Also:
Constant Field Values

RECEIVE_KEEP_ALIVE_TIMEOUT_KEY

private static final String RECEIVE_KEEP_ALIVE_TIMEOUT_KEY
Parameter Schlüssel

See Also:
Constant Field Values

ASPECT_REDIRECTION_KEY

private static final String ASPECT_REDIRECTION_KEY
Parameter Schlüssel

See Also:
Constant Field Values

SIMULATION_VARIANT_KEY

private static final String SIMULATION_VARIANT_KEY
Parameter Schlüssel

See Also:
Constant Field Values

FLOW_CONTROL_PARAMETERS_KEY

private static final String FLOW_CONTROL_PARAMETERS_KEY
Parameter Schlüssel

See Also:
Constant Field Values

PARAMETER_SEPARATOR

private static final String PARAMETER_SEPARATOR
Parameter Schlüssel

See Also:
Constant Field Values

TEST_CONNECTION_KEY

private static final String TEST_CONNECTION_KEY
Parameter Schlüssel

See Also:
Constant Field Values

_resourceBundle

private ResourceBundle _resourceBundle
Die Ressourcen des Clients.


_address

private String _address
Datenverteiler-Adresse


_configurationPid

private String _configurationPid
Die Pid der Konfiguration


_configurationPath

private String _configurationPath
Speicherort der lokalen Konfiguration.


_userName

private String _userName
Der Name des Benutzers


_userPassword

private String _userPassword
Der Passwort des Benutzers


_subAddress

private int _subAddress
die Subadresse des Datenverteilers


_simulationVariant

private short _simulationVariant
Die Standardmäßig zu verwendende Simulationsvariante. Wenn die Methode nicht aufgerufen wird, wird die Variante 0 benutzt.


_aspectToSubstituteTable

private Hashtable<ClientDavParameters.AttributeGroupAspectObject,ClientDavParameters.AttributeGroupAspectObject> _aspectToSubstituteTable
Tabelle der Informationen über Umleitungen der Aspekte


_substituteToAspectTable

private Hashtable<ClientDavParameters.AttributeGroupAspectObject,ClientDavParameters.AttributeGroupAspectObject> _substituteToAspectTable
Tabelle der Informationen über Umleitungen der Aspekte


_applicationName

private String _applicationName
Der Applikationsname (Default: Testapplikation)


_applicationTypePid

private String _applicationTypePid
Die Pid der Applikationstyp (Default: typ.applikation)


_authentificationProcessName

private String _authentificationProcessName
Der Authentifikationsprozessname (Default: HMAC-MD5)


_lowLevelCommunicationName

private String _lowLevelCommunicationName
Der Name des Kommunikationsprotokolls (Default: TCP-IP)


_outputBufferSize

private int _outputBufferSize
Die Größe des Sendepuffers in Bytes, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.


_inputBufferSize

private int _inputBufferSize
Die Größe des Empfangspuffers in Bytes, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.


_deliveryBufferSize

private int _deliveryBufferSize
Die Größe des Auslieferungspuffers in Bytes, der zur Zwischenspeicherung von Datensätzen genutzt wird, die an einen Empfänger der Applikation versendet werden sollen.

See Also:
ClientReceiverInterface.update(ResultData[])

_communicationSendFlushDelay

private long _communicationSendFlushDelay
Die Verzögerungszeit zur Übertragung von gepufferten und zu versendenden Telegrammen. Die Übertragung der gesammelten Daten im Sendepuffer findet erst statt, wenn die hier angegebene Zeit lang keine Daten mehr in der Puffer geschrieben wurden oder der Sendepuffer voll ist.


_maxTelegramSize

private int _maxTelegramSize
Die maximale Größe von Datentelegrammen.


_connectionForTests

private boolean _connectionForTests
Speichert, ob die Verbindung zu Testzwecken aufgebaut wird. true bedeutet "Ja" und bestimmte Tests, die normalerweise die Anmeldung verhindern würden, werden nicht durchgeführt; false bedeutet "nein".

Der default-Wert ist "nein".


_communicationParameters

private final CommunicationParameters _communicationParameters
Enthält die Parameter für die Kommunikation zwischen Applikation und Datenverteiler.


_incarnationName

private final String _incarnationName
Enthält den via Aufrufparameter von Start/Stopp vorgegebenen Inkarnationsnamen oder "", falls das Aufrufargument nicht angegeben wurde.

Constructor Detail

ClientDavParameters

public ClientDavParameters()
                    throws MissingParameterException
Erzeugt einen neuen Parametersatz mit Defaultwerten für die einzelnen Parameter.

Throws:
MissingParameterException - Bei formalen Fehlern beim Lesen der Defaultwerte.

ClientDavParameters

public ClientDavParameters(ArgumentList argumentList)
                    throws MissingParameterException
Erzeugt einen neuen Parametersatz mit Defaultwerten für die einzelnen Parameter und setzt die in den übergebenen Aufrufargumenten angegebenen Parameter mit den jeweils angegebenen Werten. Der Konstruktor implementiert die Starterschnittstelle der Datenverteilerapplikationsfunktionen. Bekannte Aufrufargumente werden nach der Umsetzung auf null gesetzt, um der Applikation zu signalisieren, daß diese Argumente bereits interpretiert wurden. Unbekannte Aufrufargumente werden ignoriert. Es ist Aufgabe der Applikation die verbleibenden Argumente zu interpretieren, bzw. eine ensprechende Fehlermeldung zu erzeugen, wenn die Argumente nicht interpretiert werden können.

Parameters:
argumentList - Argumentliste mit den beim Programmstart übergebenen Aufrufargumenten.
Throws:
MissingParameterException - Bei formalen Fehlern beim Lesen der Aufrufargumente oder der Defaultwerte.

ClientDavParameters

public ClientDavParameters(String[] startArguments)
                    throws MissingParameterException
Erzeugt einen neuen Parametersatz mit Defaultwerten für die einzelnen Parameter und setzt die in den übergebenen Aufrufargumenten angegebenen Parameter mit den jeweils angegebenen Werten. Der Konstruktor implementiert die Starterschnittstelle der Datenverteilerapplikationsfunktionen. Bekannte Aufrufargumente werden nach der Umsetzung auf null gesetzt, um der Applikation zu signalisieren, daß diese Argumente bereits interpretiert wurden. Unbekannte Aufrufargumente werden ignoriert. Es ist Aufgabe der Applikation die verbleibenden Argumente zu interpretieren, bzw. eine ensprechende Fehlermeldung zu erzeugen, wenn die Argumente nicht interpretiert werden können.

Parameters:
startArguments - Die beim Programmstart übergebenen Aufrufargumente
Throws:
MissingParameterException - Bei formalen Fehlern beim Lesen der Aufrufargumente oder der Defaultwerte.

ClientDavParameters

public ClientDavParameters(String configurationPid,
                           String address,
                           int subAddress,
                           String userName,
                           String userPassword,
                           String applicationName,
                           String authentificationProcessName,
                           int maxTelegramSize,
                           long receiveKeepAliveTimeout,
                           long sendKeepAliveTimeout,
                           int outputBufferSize,
                           int inputBufferSize,
                           String communicationProtocolName)
                    throws MissingParameterException
Erzeugt einen neuen Parametersatz mit den angegebenen Werten.

Parameters:
configurationPid - Pid der Konfiguration
address - Kommunikationsadresse des Datenverteilers (IP-Adresse oder Rechnername)
subAddress - Kommunikationssubadresse des Datenverteilers (TCP-Portnummer)
userName - Benutzername
userPassword - Benutzerpasswort
applicationName - Applikationsname
authentificationProcessName - Klasse, die zur Authentifizierung genutzt werden soll
maxTelegramSize - Maximale Telegrammgröße
receiveKeepAliveTimeout - KeepAlive-Timeout beim Empfang von Telegrammen in Millisekunden.
sendKeepAliveTimeout - KeepAlive-Timeout beim Versand von Telegrammen in Millisekunden.
outputBufferSize - Größe des Sendepuffers in Bytes, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
inputBufferSize - Größe des Empfangspuffers in Bytes, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.
communicationProtocolName - Klassenname des zu verwendenden Kommunikationsprotokolls
Throws:
MissingParameterException - Bei formalen Fehlern beim Lesen der Aufrufargumente oder der Defaultwerte.
Method Detail

isConnectionForTests

public boolean isConnectionForTests()
Gibt an, ob die Verbindung für Testzwecken aufgebaut werden soll.

Wird die Verbindung für Testzwecken aufgebaut, so können zum Beispiel Anmeldungen stattfinden, die mit einer normalen Verbindung nicht möglich sind.

Wurde dieser Wert nicht gesetzt (im Konstruktor oder über den Setter) so wird immer false zurückgegeben.

Returns:
true = Die Verbindung soll für Testzwecken aufgebaut werden; false = Es handelt sich um eine normale Verbindung, es werden alle Prüfungen vollzogen.

setConnectionForTests

public void setConnectionForTests(boolean connectionForTests)
Legt fest, ob eine Verbindung für Testzwecke aufgebaut werden soll.

Parameters:
connectionForTests - true = Ja, es handelt sich um eine Verbindung, die nur für Testzwecke benutzt wird; false = Es handelt sich um eine normale Verbindung, die zum Datenverteiler aufgebaut werden soll.
See Also:
isConnectionForTests()

getParameter

private String getParameter(String[] arguments,
                            String key)
Sucht in den angegebenen Argumenten nach dem Parameter, der mit dem spezifizierten Schlüssel anfängt.

Parameters:
arguments - enthält die Parameter für den Datenverteiler
key - der Schlüssel
Returns:
Gibt den Parameter zum angegebenen Schlüssel zurück, oder null, wenn der Parameter nicht existiert oder bereits ausgelesen wurde.

getThroughputControlSendBufferFactor

@Deprecated
public final float getThroughputControlSendBufferFactor()
Deprecated. Wert kann aus den CommunicationParameters gelesen werden.

Bestimmt den Füllgrad des Sendepuffers bei dem die Durchsatzprüfung gestartet wird.

Returns:
Füllgrad des Sendepuffers als Wert zwischen 0 und 1.
See Also:
getCommunicationParameters()

getCacheThresholdPercentage

@Deprecated
public final float getCacheThresholdPercentage()
Deprecated. Wird durch getThroughputControlSendBufferFactor() ersetzt.

Bestimmt den Füllgrad des Sendepuffers bei dem die Durchsatzprüfung gestartet wird.

Returns:
Füllgrad des Sendepuffers als Wert zwischen 0 und 1.

setThroughputControlSendBufferFactor

@Deprecated
public final void setThroughputControlSendBufferFactor(float sendBufferFactor)
Deprecated. Wert kann in den CommunicationParameters gesetzt werden.

Definiert den Füllgrad des Sendepuffers bei dem die Durchsatzprüfung gestartet wird.

Parameters:
sendBufferFactor - Füllgrad des Sendepuffers als Wert zwischen 0 und 1.
See Also:
getCommunicationParameters()

setCacheThresholdPercentage

@Deprecated
public final void setCacheThresholdPercentage(float cacheThresholdPercentage)
Deprecated. Wird durch setThroughputControlSendBufferFactor(float) ersetzt.

Definiert den Füllgrad des Sendepuffers bei dem die Durchsatzprüfung gestartet wird.

Parameters:
cacheThresholdPercentage - Füllgrad des Sendepuffers als Wert zwischen 0 und 1.

getThroughputControlInterval

@Deprecated
public final long getThroughputControlInterval()
Deprecated. Wert kann aus den CommunicationParameters gelesen werden.

Bestimmt die Intervalldauer für die Durchsatzmessung bei aktivierter Durchsatzprüfung.

Returns:
Intervalldauer in Millisekunden.
See Also:
getCommunicationParameters()

getFlowControlThresholdTime

@Deprecated
public final long getFlowControlThresholdTime()
Deprecated. Wird durch getThroughputControlInterval() ersetzt.

Bestimmt die Intervalldauer für die Durchsatzmessung bei aktivierter Durchsatzprüfung.

Returns:
Intervalldauer in Millisekunden.

setThroughputControlInterval

@Deprecated
public final void setThroughputControlInterval(long interval)
Deprecated. Wert kann in den CommunicationParameters gesetzt werden.

Setzt die Intervalldauer für die Durchsatzmessung bei aktivierter Durchsatzprüfung.

Parameters:
interval - Intervalldauer in Millisekunden.
See Also:
getCommunicationParameters()

setFlowControlThresholdTime

@Deprecated
public final void setFlowControlThresholdTime(long flowControlThresholdTime)
Deprecated. Wird durch setThroughputControlInterval(long) ersetzt.

Setzt die Intervalldauer für die Durchsatzmessung bei aktivierter Durchsatzprüfung.

Parameters:
flowControlThresholdTime - Intervalldauer in Millisekunden.

getMinimumThroughput

@Deprecated
public final int getMinimumThroughput()
Deprecated. Wert kann aus den CommunicationParameters gelesen werden.

Bestimmt den minimal erlaubten Verbindungsdurchsatz bei aktivierter Durchsatzprüfung.

Returns:
Mindestdurchsatz in Byte pro Sekunde.
See Also:
getCommunicationParameters()

getMinConnectionSpeed

@Deprecated
public final int getMinConnectionSpeed()
Deprecated. Wird durch getMinimumThroughput() ersetzt.

Bestimmt der minimum Verbindungsdurchsatz

Returns:
den minimalen Verbindungsdurchsatz

setMinimumThroughput

@Deprecated
public final void setMinimumThroughput(int throughput)
Deprecated. Wert kann in den CommunicationParameters gesetzt werden.

Setzt den minimal erlaubten Verbindungsdurchsatz bei aktivierter Durchsatzprüfung.

Parameters:
throughput - Mindestdurchsatz in Byte pro Sekunde.
See Also:
getCommunicationParameters()

setMinConnectionSpeed

@Deprecated
public final void setMinConnectionSpeed(int minConnectionSpeed)
Deprecated. Wird durch setMinimumThroughput(int) ersetzt.

Setzt den minimal erlaubten Verbindungsdurchsatz bei aktivierter Durchsatzprüfung.

Parameters:
minConnectionSpeed - Mindestdurchsatz in Byte pro Sekunde.

getApplicationName

public final String getApplicationName()
Bestimmt den Namen der Applikation.

Returns:
Name des zu erzeugenden Applikations-Objekts.
See Also:
setApplicationName(java.lang.String)

setApplicationName

public final void setApplicationName(String applicationName)
Setzt den Namen der Applikation. Nach erfolgreicher Authentifizierung der Applikation wird vom Datenverteiler ein Applikations-Objekt mit dem angegebenem Namen erzeugt. Wenn diese Methode nicht aufgerufen wird, dann wird als Default der Name "TestApplikation" benutzt.

Parameters:
applicationName - Name des zu erzeugenden Applikations-Objekts
See Also:
setApplicationTypePid(java.lang.String)

getApplicationTypePid

public final String getApplicationTypePid()
Bestimmt den Typ der Applikation.

Returns:
PID, die den Typ des zu erzeugenden Applikations-Objekts spezifiziert.
See Also:
setApplicationTypePid(java.lang.String)

setApplicationTypePid

public final void setApplicationTypePid(String applicationTypePid)
Setzt den Typ der Applikation. Nach erfolgreicher Authentifizierung der Applikation wird vom Datenverteiler ein Applikations-Objekt erzeugt. Der Typ dieses Objekts entspricht dem hier übergebenen Typ. Wenn diese Methode nicht aufgerufen wird, dann wird als Default der Typ "typ.applikation" benutzt.

Parameters:
applicationTypePid - PID, die den Typ des zu erzeugenden Applikations-Objekts spezifiziert.
See Also:
setApplicationName(java.lang.String)

getAuthentificationProcessName

public final String getAuthentificationProcessName()
Bestimmt das bei der Authentifizierung zu verwendende Verfahren.

Returns:
Klassenname des Authentifizierungs-Verfahrens.

setAuthentificationProcessName

public final void setAuthentificationProcessName(String authentificationProcessName)
Setzt das bei der Authentifizierung zu verwendende Verfahren. Wird die Methode nicht aufgerufen, dann wird das Verfahren HMAC-MD5 benutzt.

Parameters:
authentificationProcessName - Klassenname des Verfahrens

getLowLevelCommunicationName

public final String getLowLevelCommunicationName()
Bestimmt das auf unterster Ebene einzusetzende Kommunikationsprotokoll für die Kommunikation mit dem Datenverteiler.

Returns:
Klassenname des Kommunikationsverfahrens.

setLowLevelCommunicationName

public final void setLowLevelCommunicationName(String lowLevelCommunicationName)
Setzt das auf unterster Ebene einzusetzende Kommunikationsprotokoll. Wird diese Methode nicht aufgerufen, dann wird das TCP-Protokoll benutzt.

Parameters:
lowLevelCommunicationName - Klassenname des Kommunikationsverfahrens.

getDavCommunicationAddress

public final String getDavCommunicationAddress()
Bestimmt die Kommunikationsaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll.

Returns:
Kommunikationsadresse des Datenverteilers.
See Also:
setDavCommunicationAddress(java.lang.String)

setDavCommunicationAddress

public final void setDavCommunicationAddress(String address)
Setzt die Kommunikationsaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll. Wenn als Kommunikationsprotokoll TCP eingesetzt wird, dann kann hier der Rechnername oder die IP-Addresse des Rechners auf dem der Datenverteiler läuft angegeben werden.

Parameters:
address - Kommunikationsadresse des Datenverteilers (IP-Addresse oder Rechnername bei TCP).

getDavCommunicationSubAddress

public final int getDavCommunicationSubAddress()
Bestimmt die Kommunikationssubaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll.

Returns:
Kommunikationssubadresse des Datenverteilers.
See Also:
setDavCommunicationSubAddress(int)

setDavCommunicationSubAddress

public final void setDavCommunicationSubAddress(int subAddress)
Setzt die Kommunikationssubaddresse des Datenverteilers, die für den Verbindungsaufbau benutzt werden soll. Wenn als Kommunikationsprotokoll TCP eingesetzt wird, dann kann hier die TCP-Portnummer, auf der der Datenverteiler Verbindungen entgegennimmt, angegeben werden.

Parameters:
subAddress - Kommunikationssubadresse des Datenverteilers.

getConfigurationPid

public final String getConfigurationPid()
Bestimmt die PID der zu verwendenden Konfiguration.

Returns:
PID der zu verwendenden Konfiguration.

setConfigurationPid

public final void setConfigurationPid(String configurationPid)
Setzt die PID der zu verwendenden Konfiguration. Wenn die Methode nicht aufgerufen wird, dann wird die Standard-Konfiguration des Datenverteilers benutzt.

Parameters:
configurationPid - PID der zu verwendenden Konfiguration.

getConfigurationPath

public final String getConfigurationPath()
Bestimmt den Ort zum Zwischenspeichern der Konfiguration.

Returns:
Pfad im lokalen Dateisystem in dem die Konfigurationsdaten zwischengespeichert werden oder null, wenn die Konfigurationsdaten nicht lokal zwischengespeichert werden.

setConfigurationPath

public final void setConfigurationPath(String configurationPath)
Setzt den Ort zum Zwischenspeichern der Konfiguration. Wenn kein Ort spezifiziert wurde, dann wird die Konfiguration nicht zwischengespeichert.

Parameters:
configurationPath - Pfad im lokalen Dateisystem in dem die Konfigurationsdaten zwischengespeichert werden sollen oder null, falls die Konfigurationsdaten nicht lokal zwischengespeichert werden sollen.

getUserName

public final String getUserName()
Bestimmt den bei der Authentifizierung zu verwendenden Benutzernamen.

Returns:
Name des Benutzers.

setUserName

public final void setUserName(String userName)
Setzt den bei der Authentifizierung zu verwendenden Benutzernamen.

Parameters:
userName - Name des Benutzers.

getUserPassword

public final String getUserPassword()
Bestimmt das bei der Authentifizierung zu verwendende Passwort.

Returns:
Passwort des Benutzers.

setUserPassword

public final void setUserPassword(String userPassword)
Setzt das bei der Authentifizierung zu verwendende Passwort.

Parameters:
userPassword - Passwort des Benutzers.

getSendKeepAliveTimeout

@Deprecated
public final long getSendKeepAliveTimeout()
Deprecated. Wert kann aus den CommunicationParameters gelesen werden.

Bestimmt das Timeout zum Senden von KeepAlive-Telegrammen. Der Wert dient als Vorschlag für die Verhandlung mit dem Datenverteiler, der den zu verwendenden Wert festlegt.

Returns:
Vorschlag für das Timeout zum Senden von KeepAlive-Telegrammen in Millisekunden.
See Also:
getCommunicationParameters()

setSendKeepAliveTimeout

@Deprecated
public final void setSendKeepAliveTimeout(long timeout)
Deprecated. Wert kann in den CommunicationParameters gesetzt werden.

Setzt das Timeout zum Senden von KeepAlive-Telegrammen. Der Wert dient als Vorschlag für die Verhandlung mit dem Datenverteiler, der den zu verwendenden Wert festlegt.

Parameters:
timeout - Vorschlag für das Timeout zum Senden von KeepAlive-Telegrammen in Millisekunden.
See Also:
getCommunicationParameters()

getReceiveKeepAliveTimeout

@Deprecated
public final long getReceiveKeepAliveTimeout()
Deprecated. Wert kann aus den CommunicationParameters gelesen werden.

Bestimmt das KeepAlive-Timeout beim Empfang von Telegrammen. Der Wert dient als Vorschlag für die Verhandlung mit dem Datenverteiler, der den zu verwendenden Wert festlegt.

Returns:
Vorschlag für das KeepAlive-Timeout beim Empfang von Telegrammen in Millisekunden.
See Also:
getCommunicationParameters()

setReceiveKeepAliveTimeout

@Deprecated
public final void setReceiveKeepAliveTimeout(long timeout)
Deprecated. Wert kann in den CommunicationParameters gesetzt werden.

Setzt das KeepAlive-Timeout beim Empfang von Telegrammen. Der Wert dient als Vorschlag für die Verhandlung mit dem Datenverteiler, der den zu verwendenden Wert festlegt.

Parameters:
timeout - Vorschlag für das KeepAlive-Timeout beim Empfang von Telegrammen in Millisekunden.
See Also:
getCommunicationParameters()

getSimulationVariant

public final short getSimulationVariant()
Bestimmt die Standardmäßig zu verwendende Simulationsvariante.

Returns:
Zu verwendende Simulationsvariante
See Also:
setSimulationVariant(short)

setSimulationVariant

public final void setSimulationVariant(short variant)
Setzt die Standardmäßig zu verwendende Simulationsvariante. Wenn die Methode nicht aufgerufen wird, wird die Variante 0 benutzt, wenn sie nicht explizit angegeben wurde.

Parameters:
variant - Zu verwendende Simulationsvariante.
See Also:
DataDescription

getCommunicationSendFlushDelay

public final long getCommunicationSendFlushDelay()
Bestimmt die Verzögerungszeit zur Übertragung von gepufferten und zu versendenden Telegrammen.

Returns:
Sende-Verzögerungszeit in Millisekunden.
See Also:
setCommunicationSendFlushDelay(long)

setCommunicationSendFlushDelay

public final void setCommunicationSendFlushDelay(long delay)
Setzt die Verzögerungszeit zur Übertragung von gepufferten und zu versendenden Telegrammen. Die Übertragung der gesammelten Daten im Sendepuffer findet erst statt, wenn die hier angegebene Zeit lang keine Daten mehr in der Puffer geschrieben wurden oder der Sendepuffer voll ist.

Parameters:
delay - Sende-Verzögerungszeit in Millisekunden.

getCommunicationOutputBufferSize

public final int getCommunicationOutputBufferSize()
Bestimmt die Größe des Sendepuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.

Returns:
Größe des Sendepuffers in Bytes.

setCommunicationOutputBufferSize

public final void setCommunicationOutputBufferSize(int bufferSize)
Setzt die Größe des Sendepuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.

Parameters:
bufferSize - Größe des Sendepuffers in Bytes.

getCommunicationInputBufferSize

public final int getCommunicationInputBufferSize()
Bestimmt die Größe des Empfangspuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.

Returns:
Größe des Empfangspuffers in Bytes.

setCommunicationInputBufferSize

public final void setCommunicationInputBufferSize(int bufferSize)
Setzt die Größe des Empfangspuffers, der bei der Kommunikation mit dem Datenverteiler eingesetzt wird.

Parameters:
bufferSize - Größe des Empfangspuffers in Bytes.

getMaxDataTelegramSize

public final int getMaxDataTelegramSize()
Bestimmt die maximale Größe von Datentelegrammen. Größere Telegramme werden in mehrere Telegramme zerlegt.

Returns:
Maximale Größe von versendeten Datentelegrammen als Anzahl von Bytes.

setMaxDataTelegramSize

public final void setMaxDataTelegramSize(int maxTelegramSize)
Setzt die maximale Größe von Datentelegrammen. Größere Telegramme werden in mehrere Telegramme zerlegt.

Parameters:
maxTelegramSize - Maximale Größe von versendeten Datentelegrammen als Anzahl von Bytes.

getCommunicationParameters

public CommunicationParameters getCommunicationParameters()
Gibt die Parameter für die Kommunikation zwischen Applikation und Datenverteiler zurück.

Returns:
die Parameter für die Kommunikation zwischen Applikation und Datenverteiler

addAspectRedirection

public final void addAspectRedirection(String attributeGroupPid,
                                       String aspectPid,
                                       String substituteAspectPid)
Setzt eine Aspektumleitung für eine Kombination von Attributgruppe und Aspekt. Ein von der Applikation angegebener Aspekt beim Anmelden, Lesen, Schreiben und Abmelden einer Attributgruppe, wird durch einen anderen Aspekt ersetzt. Damit besteht die Möglichkeit den Datenfluß einer Applikation zu modifizieren und damit beispielsweise einen anderen Prozess in eine Bearbeitungskette einzufügen.

Parameters:
attributeGroupPid - PID der Attributgruppe für die eine Umleitung eingefügt werden soll.
aspectPid - PID des Aspekts für den eine Umleitung eingefügt werden soll.
substituteAspectPid - PID des statt aspectPid zu verwendenden Aspekts.

aspectToSubstitute

public final String aspectToSubstitute(String attributeGroupPid,
                                       String aspectPid)
Gibt die Aspektumleitung für eine Kombination von Attributgruppe und Aspekt zurück. Wenn keine entsprechende Aspektumleitung besteht, wird der übergebene Original-Aspekt zurückgegeben.

Parameters:
attributeGroupPid - PID der Attributgruppe.
aspectPid - PID des Original-Aspekts.
Returns:
Pid des Aspekts, der anstelle des angegebenen Aspektes benutzt werden soll. Wenn dieser Aspekt nicht existiert, wird der angegebene Aspekt zurückgegeben.
See Also:
addAspectRedirection(java.lang.String, java.lang.String, java.lang.String)

substituteToAspect

public final String substituteToAspect(String attributeGroupPid,
                                       String aspectPid)
Gibt den Original-Aspekt eines ersetzten Aspekts einer Attributgruppe zurück. Wenn keine entsprechende Aspektumleitung besteht, wird der übergebene Aspekt unverändert zurückgegeben.

Parameters:
attributeGroupPid - PID der Attributgruppe.
aspectPid - PID des ersetzten Aspekts.
Returns:
Pid des Original-Aspekts.
See Also:
addAspectRedirection(java.lang.String, java.lang.String, java.lang.String)

getDeliveryBufferSize

public int getDeliveryBufferSize()
Liefert die Größe des Auslieferungspuffers, der zur Zwischenspeicherung von Datensätzen genutzt wird, die an einen Empfänger der Applikation versendet werden sollen.

Returns:
Größe des Auslieferungspuffers in Bytes.

setDeliveryBufferSize

public void setDeliveryBufferSize(int deliveryBufferSize)
Setzt die Größe des Auslieferungspuffers, der zur Zwischenspeicherung von Datensätzen genutzt wird, die an einen Empfänger der Applikation versendet werden sollen.

Parameters:
deliveryBufferSize - Größe des Auslieferungspuffers in Bytes.

getIncarnationName

public String getIncarnationName()
Liefert den via Aufrufparameter von Start/Stopp vorgegebenen Inkarnationsnamen.

Returns:
Inkarnationsname oder "", falls das entsprechende Aufrufargument nicht angegeben wurde.

printArgumentsList

public static void printArgumentsList()
Gibt die eingestellten Parameter auf die Standardausgabe aus.