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.Object
Allgemeine Funktionen im Zusammenhang mit Datenverteiler-Applikationsfunktionen.
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
ASP_EIGENSCHAFTEN
Standardaspekt für Konfigurationsdaten.static java.lang.String
ASP_PARAMETER_DEFAULT
Aspekt für den Standardwert eines Parameters.static java.lang.String
ASP_PARAMETER_IST
Aspekt für den Ist-Zustand eines Parameters.static java.lang.String
ASP_PARAMETER_SOLL
Aspekt für Soll-Angaben eines Parameter.static java.lang.String
ASP_PARAMETER_VORGABE
Aspekt für das Einstellen eines Parameter.static java.lang.String
TYP_ASPEKT
Der Typ Aspekt.static java.lang.String
TYP_ATTRIBUTGRUPPE
Der Typ Attributgruppe.static java.lang.String
TYP_TYP
Der Typ Typ.
-
Method Summary
Modifier and Type Method Description static java.lang.String
absoluteZeit(long zeitstempel)
Konvertiert einen Zeitstempel in eine lesbare absolute Zeit.static boolean
bool2Int(int wert)
Liefert einen boolean-Wert, der als int-Ersatz für JaNein-Werte innerhalb einer Datenverteiler-Attributgruppe verschickt werden kann.static java.lang.String
generierePID(java.lang.String name, java.lang.String praefix)
Generiert aus einem Objektnamen eine gültige PID.static java.lang.String
generierePID(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.ConfigurationArea
getDefaultKonfigurationsBereich(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.SystemObjectType
getSuperType(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 int
int2Bool(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 void
validiereEchteSimulationsVariante(short sim)
Überprüft ob der übergebene Wert eine echte Simulationsvariante ist.static void
validiereSimulationsVariante(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
false
durch 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
false
durch 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 eineNoSimulationException
augelö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 eineNoSimulationException
augelö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.InvalidArgumentException
Liefert 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.
-
-