Package de.bsvrz.sys.funclib.bitctrl.daf
Class DavTools
- java.lang.Object
-
- de.bsvrz.sys.funclib.bitctrl.daf.DavTools
-
public final class DavTools extends java.lang.ObjectAllgemeine Funktionen im Zusammenhang mit Datenverteiler-Applikationsfunktionen.
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringASP_EIGENSCHAFTENStandardaspekt für Konfigurationsdaten.static java.lang.StringASP_PARAMETER_DEFAULTAspekt für den Standardwert eines Parameters.static java.lang.StringASP_PARAMETER_ISTAspekt für den Ist-Zustand eines Parameters.static java.lang.StringASP_PARAMETER_SOLLAspekt für Soll-Angaben eines Parameter.static java.lang.StringASP_PARAMETER_VORGABEAspekt für das Einstellen eines Parameter.static java.lang.StringTYP_ASPEKTDer Typ Aspekt.static java.lang.StringTYP_ATTRIBUTGRUPPEDer Typ Attributgruppe.static java.lang.StringTYP_TYPDer Typ Typ.
-
Method Summary
Modifier and Type Method Description static java.lang.StringabsoluteZeit(long zeitstempel)Konvertiert einen Zeitstempel in eine lesbare absolute Zeit.static booleanbool2Int(int wert)Liefert einen boolean-Wert, der als int-Ersatz für JaNein-Werte innerhalb einer Datenverteiler-Attributgruppe verschickt werden kann.static java.lang.StringgenerierePID(java.lang.String name, java.lang.String praefix)Generiert aus einem Objektnamen eine gültige PID.static java.lang.StringgenerierePID(java.lang.String name, java.lang.String praefix, boolean ersetzeUmlaute)Generiert aus einem Objektnamen eine gültige PID.static de.bsvrz.dav.daf.main.config.ConfigurationAreagetDefaultKonfigurationsBereich(de.bsvrz.dav.daf.main.ClientDavInterface verbindung)Liefert den Standardkonfigurationsbereich für übergebene Datenverteilerverbindung.static java.util.Collection<de.bsvrz.dav.daf.main.config.SystemObject>getObjekte(de.bsvrz.dav.daf.main.ClientDavInterface dav, boolean typenAufloesen, boolean bereicheAufloesen, java.lang.String... pids)Sucht zu einer Menge von PIDs die dazugehörigen Systemobjekte.static java.util.Collection<de.bsvrz.dav.daf.main.config.SystemObject>getObjekte(de.bsvrz.dav.daf.main.config.ConfigurationArea kb, java.lang.String... pidTypen)Gibt alle Systemobjekte aus einem Konfigurationsbereich zurück.static de.bsvrz.dav.daf.main.config.SystemObjectTypegetSuperType(java.util.Collection<de.bsvrz.dav.daf.main.config.SystemObject> objects)Bestimmt den Supertyp einer Menge von Objekten.static java.util.Set<de.bsvrz.dav.daf.main.config.SystemObjectType>getSuperTypes(de.bsvrz.dav.daf.main.config.SystemObjectType objectType)Bestimmt rekursiv alle Supertypen eines Systemobjekttyps.static intint2Bool(boolean wert)Liefert einen int-Wert, der als Boolean-Ersatz für JaNein-Werte innerhalb einer Datenverteiler-Attributgruppe verschickt werden kann.static java.util.List<? extends de.bsvrz.dav.daf.main.config.SystemObject>sortiere(java.util.List<? extends de.bsvrz.dav.daf.main.config.SystemObject> objekte)Sortiert eine Liste von Systemobjekten nach deren Namen.static voidvalidiereEchteSimulationsVariante(short sim)Überprüft ob der übergebene Wert eine echte Simulationsvariante ist.static voidvalidiereSimulationsVariante(short sim)Überprüft ob der übergebene Wert eine gültige Simulationsvariante ist.
-
-
-
Field Detail
-
TYP_TYP
public static final java.lang.String TYP_TYP
Der Typ Typ.- See Also:
- Constant Field Values
-
TYP_ATTRIBUTGRUPPE
public static final java.lang.String TYP_ATTRIBUTGRUPPE
Der Typ Attributgruppe.- See Also:
- Constant Field Values
-
TYP_ASPEKT
public static final java.lang.String TYP_ASPEKT
Der Typ Aspekt.- See Also:
- Constant Field Values
-
ASP_EIGENSCHAFTEN
public static final java.lang.String ASP_EIGENSCHAFTEN
Standardaspekt für Konfigurationsdaten.- See Also:
- Constant Field Values
-
ASP_PARAMETER_SOLL
public static final java.lang.String ASP_PARAMETER_SOLL
Aspekt für Soll-Angaben eines Parameter.- See Also:
- Constant Field Values
-
ASP_PARAMETER_VORGABE
public static final java.lang.String ASP_PARAMETER_VORGABE
Aspekt für das Einstellen eines Parameter.- See Also:
- Constant Field Values
-
ASP_PARAMETER_IST
public static final java.lang.String ASP_PARAMETER_IST
Aspekt für den Ist-Zustand eines Parameters.- See Also:
- Constant Field Values
-
ASP_PARAMETER_DEFAULT
public static final java.lang.String ASP_PARAMETER_DEFAULT
Aspekt für den Standardwert eines Parameters.- See Also:
- Constant Field Values
-
-
Method Detail
-
absoluteZeit
public static java.lang.String absoluteZeit(long zeitstempel)
Konvertiert einen Zeitstempel in eine lesbare absolute Zeit.- Parameters:
zeitstempel- ein Zeitstempel.- Returns:
- die entsprechende Zeit als lesbaren String.
-
generierePID
public static java.lang.String generierePID(java.lang.String name, java.lang.String praefix)Generiert aus einem Objektnamen eine gültige PID. Es wird jedes Zeichen nach einem Leerzeichen in einen Großbuchstaben verwandelt, danach alle Leerzeichen entfernt und der erste Buchstabe des Namens in einen Kleinbuchstaben umgewandelt.- Parameters:
name- der Objektname.praefix- der Präfix für die PID (mit Punkt abgeschlossen).- Returns:
- die gültige PID zum Objektnamen.
-
generierePID
public static java.lang.String generierePID(java.lang.String name, java.lang.String praefix, boolean ersetzeUmlaute)Generiert aus einem Objektnamen eine gültige PID. Es wird jedes Zeichen nach einem Leerzeichen in einen Großbuchstaben verwandelt, danach alle Leerzeichen entfernt und der erste Buchstabe des Namens in einen Kleinbuchstaben umgewandelt. Mit dem Parameter ersetzteUmlaute kann erzwungen werden, dass Umlaute ersetzt werden. Die Ersetzung erfolgt wir folgt:- ä wird ae
- ö wird oe
- ü wird ue
- Ä wird Äe
- Ö wird Oe
- Ü wird Ue
- ß wird sz
- Parameters:
name- der Objektname.praefix- der Präfix für die PID (mit Punkt abgeschlossen).ersetzeUmlaute- Umlaute in der generierten PID ersetzen?- Returns:
- die gültige PID zum Objektnamen.
-
int2Bool
public static int int2Bool(boolean wert)
Liefert einen int-Wert, der als Boolean-Ersatz für JaNein-Werte innerhalb einer Datenverteiler-Attributgruppe verschickt werden kann.Hinweis: Setzt Verwendung des vorhandenen Standardattribitts att.jaNein voraus, in dem
falsedurch 0 repräsentiert wird.- Parameters:
wert- ein boolean-Wert.- Returns:
- der int-Wert.
-
bool2Int
public static boolean bool2Int(int wert)
Liefert einen boolean-Wert, der als int-Ersatz für JaNein-Werte innerhalb einer Datenverteiler-Attributgruppe verschickt werden kann.Hinweis: Setzt Verwendung des vorhandenen Standardattribitts att.jaNein voraus, in dem
falsedurch 0 repräsentiert wird.- Parameters:
wert- der int-Wert.- Returns:
- der boolean-wert.
-
sortiere
public static java.util.List<? extends de.bsvrz.dav.daf.main.config.SystemObject> sortiere(java.util.List<? extends de.bsvrz.dav.daf.main.config.SystemObject> objekte)
Sortiert eine Liste von Systemobjekten nach deren Namen. Beim Sortieren werden deutsche Umlaute berücksichtigt.Hinweis: Das Ergebnis wird im Parameter abgelegt, der Rückgabewert ist identisch und für chaining-Aufrufe gedacht.
- Parameters:
objekte- die zu sortierende Liste.- Returns:
- die sortierte Liste.
-
getSuperType
public static de.bsvrz.dav.daf.main.config.SystemObjectType getSuperType(java.util.Collection<de.bsvrz.dav.daf.main.config.SystemObject> objects)
Bestimmt den Supertyp einer Menge von Objekten.- Parameters:
objects- die Menge- Returns:
- der Typ. Kann null sein.
-
getSuperTypes
public static java.util.Set<de.bsvrz.dav.daf.main.config.SystemObjectType> getSuperTypes(de.bsvrz.dav.daf.main.config.SystemObjectType objectType)
Bestimmt rekursiv alle Supertypen eines Systemobjekttyps.- Parameters:
objectType- ein Systemobjekttyp.- Returns:
- alle Typen, die der übergebene Typ direkt oder indirekt erweitert.
-
validiereSimulationsVariante
public static void validiereSimulationsVariante(short sim)
Überprüft ob der übergebene Wert eine gültige Simulationsvariante ist. Liegt die Simulationsvariante nicht im Bereich 0..999, wird eineNoSimulationExceptionaugelöst.- Parameters:
sim- die zu prüfende Simulationsvariante.- Throws:
java.lang.RuntimeException- wenn der Wert keine echte Simulationsvariante ist.
-
validiereEchteSimulationsVariante
public static void validiereEchteSimulationsVariante(short sim) throws NoSimulationExceptionÜberprüft ob der übergebene Wert eine echte Simulationsvariante ist. Liegt die Simulationsvariante nicht im Bereich 1..999, wird eineNoSimulationExceptionaugelöst.- Parameters:
sim- die zu prüfende Simulationsvariante.- Throws:
NoSimulationException- wenn der Wert keine echte Simulationsvariante ist.
-
getDefaultKonfigurationsBereich
public static de.bsvrz.dav.daf.main.config.ConfigurationArea getDefaultKonfigurationsBereich(de.bsvrz.dav.daf.main.ClientDavInterface verbindung) throws de.bsvrz.dav.daf.main.impl.InvalidArgumentExceptionLiefert den Standardkonfigurationsbereich für übergebene Datenverteilerverbindung. Der Standardkonfigurationsbereich wird verwendet um dynamische Objekte abzulegen, sofern kein expliziter Zielbereich für diesen Zweck definiert wurde.- Parameters:
verbindung- die Verbindung, deren Standardbereich ermittelt werden soll- Returns:
- den ermittelten Konfigurationsbereich.
- Throws:
de.bsvrz.dav.daf.main.impl.InvalidArgumentException- wenn für die übergebene Verbindung kein entsprechender Konfigurationsbereich ermittelt werden.
-
getObjekte
public static java.util.Collection<de.bsvrz.dav.daf.main.config.SystemObject> getObjekte(de.bsvrz.dav.daf.main.ClientDavInterface dav, boolean typenAufloesen, boolean bereicheAufloesen, java.lang.String... pids)Sucht zu einer Menge von PIDs die dazugehörigen Systemobjekte. Kann in für die PID eines Konfigurationsbereichs die enthalten Systemobjekte und für die PID eines Typs alle dazugehörigen Instanzen ermitteln. Praktische Funktion für die Auswertung von PIDs bei Kommandozeilenargumenten.- Parameters:
dav- die Datenverteilerverbindung, die zu Abfrage genutzt werden soll.typenAufloesen-true, wenn zu Objekttypen alle Objekte dieser Typen bestimmt werden sollen. Anderfalls wird der Typ selbst ins Ergebnis aufgenommen.bereicheAufloesen-true, wenn zu Konfigurationsbereichen alle Objekte, die in den jeweiligen Bereich enthalten sind, bestimmt werden sollen. Anderfalls wird der Konfigurationsbereich selbst ins Ergebnis aufgenommen. Typen in Konfigurationsbereichen werden nicht rekursiv aufgelöst.pids- eine Liste von PIDs von Systemobjekttypen.- Returns:
- die Liste der gesuchten Systemobjekte.
-
getObjekte
public static java.util.Collection<de.bsvrz.dav.daf.main.config.SystemObject> getObjekte(de.bsvrz.dav.daf.main.config.ConfigurationArea kb, java.lang.String... pidTypen)Gibt alle Systemobjekte aus einem Konfigurationsbereich zurück. Mit dem zweitem Parameter kann der Typ der gesuchten Objekte eingeschränkt werden. Praktische Funktion für die Auswertung von PIDs bei Kommandozeilenargumenten.- Parameters:
kb- ein Konfigurationsbereich.pidTypen- ein optionales Feld von PIDs von Systemobjekttypen.- Returns:
- die Liste der gesuchten Systemobjekte.
-
-