Package de.bsvrz.sys.funclib.bitctrl.dua
Class DUAUtensilien
java.lang.Object
de.bsvrz.sys.funclib.bitctrl.dua.DUAUtensilien
Einige hilfreiche Methoden, die an verschiedenen Stellen innerhalb der DUA
Verwendung finden.
-
Method Summary
Modifier and TypeMethodDescriptionstatic StringersetzeLetztesElemInAttPfad(String attPfad, String ersetzung) Ersetzt den letzten Teil eines Attribuspfades durch eine bestimmte Zeichenkette.static Collection<DAVObjektAnmeldung>getAlleObjektAnmeldungen(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.DataDescription datenBeschreibung, de.bsvrz.dav.daf.main.ClientDavInterface dav) Erfragt die Menge vonDAVObjektAnmeldung-Objekten, die alle Anmeldungen unter der übergebenen Datenbeschreibung für das übergebene Objekt enthält.
Achtung: Das Objekt wird in seine finalen Instanzen aufgelöst.static StringgetArgument(String schluessel, List<String> argumentListe) Liest eine Argument aus der ArgumentListe der Kommandozeile aus.static StringgetArrayKurzInfo(Object[] objekte) Erfragt eine Kurzinformation eines Objektarrays.static de.bsvrz.dav.daf.main.DatagetAttributDatum(String attributPfad, de.bsvrz.dav.daf.main.Data datum) Extrahiert aus einem übergebenen Datum ein darin enthaltenes Datum.static Collection<de.bsvrz.dav.daf.main.config.SystemObject>getBasisInstanzen(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.ClientDavInterface dav) Erfragt die Menge aller Konfigurationsobjekte bzw.static Collection<de.bsvrz.dav.daf.main.config.SystemObject>getBasisInstanzen(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.ClientDavInterface dav, Collection<de.bsvrz.dav.daf.main.config.ConfigurationArea> kBereichsFilter) Erfragt die Menge aller Konfigurationsobjekte bzw.static Collection<de.bsvrz.dav.daf.main.config.ConfigurationArea>getKonfigurationsBereicheAlsObjekte(de.bsvrz.dav.daf.main.ClientDavInterface dav, String kbString) Extrahiert aus einer Zeichenkette alle über Kommata getrennten Konfigurationsbereiche und gibt deren Systemobjekte zurück.static intgetStundenVonTag(long zeitStempel) Gibt die Anhahl der Stunden zurück, die dieser Tag hat.static StringgetTextZuMesswert(long messwert) Erfragt die textliche Entsprechung eines Messwertes, dessen Wertebereich bei 0 (inklusive) beginnt und der die Zuständefehlerhaft,nicht ermittelbarodernicht ermittelbar/fehlerhaftbesitzen kann.static StringgetVergleichsIntervallInText(long vergleichsIntervallInMs) Wandelt eine Zeitspanne in Millisekunden in einen Text um.static StringisKombinationOk(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.DataDescription datenBeschreibung) Erfragt, ob die übergebene Systemobjekt-Attributgruppen-Aspekt- Kombination gültig bzw. kompatibel (bzw. so anmeldbar) ist.static booleanisObjektInKBsEnthalten(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.config.ConfigurationArea[] kbs) Erfragt, ob ein Systemobjekt in einem der uebergebenen Konfigurationsbereiche enthalten ist.static booleanisWertInWerteBereich(de.bsvrz.dav.daf.main.Data attribut, double wertSkaliert) Ermittelt, ob der übergebene Wert im Wertebereich des übergebenen Attributs liegt (für skalierte Ganzzahlen).static booleanisWertInWerteBereich(de.bsvrz.dav.daf.main.Data attribut, long wert) Ermittelt, ob der uebergebene Wert im Wertebereich des uebergebenen Attributs liegt.static Stringrunde(double wert, int nachkommastellen) Erfragt den gerundeten Wert als Zeichenkette.static voidsendeBetriebsmeldung(de.bsvrz.dav.daf.main.ClientDavInterface dav, de.bsvrz.sys.funclib.operatingMessage.MessageGrade grade, de.bsvrz.dav.daf.main.config.SystemObject objekt, String nachricht) Sendet eine Betriebsmeldung.static voidsendeBetriebsmeldung(de.bsvrz.dav.daf.main.ClientDavInterface dav, String id, de.bsvrz.sys.funclib.operatingMessage.MessageGrade grade, de.bsvrz.dav.daf.main.config.SystemObject objekt, String nachricht) Sendet eine Betriebsmeldung.static voidsetAlleParameter(de.bsvrz.dav.daf.main.ClientDavInterface dav) Parametriert die Parametrierung dergestalt, dass von dieser alle Parameter erfasst werden.
-
Method Details
-
ersetzeLetztesElemInAttPfad
Ersetzt den letzten Teil eines Attribuspfades durch eine bestimmte Zeichenkette. Der Aufruf
"a.b.c.Status.PlFormal.WertMax" = ersetzeLetztesElemInAttPfad( "a.b.c.Wert", "Status.PlFormal.WertMax")
bewirkt bspw., dass auf den Statuswertmaxder formalen Plausibilisierung des Elementsa.b.czugegriffen werden kann- Parameters:
attPfad- der orginale Attributpfadersetzung- die Zeichenkette, durch die der letzte Teil des Attributpfades ersetzt werden soll- Returns:
- einen veränderten Attributpfad oder
null, wenn die Ersetzung nicht durchgeführt werden konnte
-
getAlleObjektAnmeldungen
public static Collection<DAVObjektAnmeldung> getAlleObjektAnmeldungen(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.DataDescription datenBeschreibung, de.bsvrz.dav.daf.main.ClientDavInterface dav) Erfragt die Menge vonDAVObjektAnmeldung-Objekten, die alle Anmeldungen unter der übergebenen Datenbeschreibung für das übergebene Objekt enthält.
Achtung: Das Objekt wird in seine finalen Instanzen aufgelöst. Sollte für das Objektnullübergeben worden sein, so wird 'Alle Objekte' angenommen. Gleiches gilt für die Elemente der Datenbeschreibung.- Parameters:
obj- ein Systemobjekt (auch Typ)datenBeschreibung- eine Datenbeschreibungdav- Verbindung zum Datenverteiler- Returns:
- eine Menge von
DAVObjektAnmeldung-Objekten
-
getArgument
Liest eine Argument aus der ArgumentListe der Kommandozeile aus.- Parameters:
schluessel- der SchlüsselargumentListe- alle Argumente der Kommandozeile- Returns:
- das Wert des DAV-Arguments mit dem übergebenen Schlüssel oder
null, wenn der Schlüssel nicht gefunden wurde
-
getAttributDatum
public static de.bsvrz.dav.daf.main.Data getAttributDatum(String attributPfad, de.bsvrz.dav.daf.main.Data datum) Extrahiert aus einem übergebenen Datum ein darin enthaltenes Datum.- Parameters:
attributPfad- gibt den kompletten Pfad zu einem Attribut innerhalb einer Attributgruppe an. Die einzelnen Pfadbestandteile sind jeweils durch einen Punkt '.' separiert. Um z. B. ein Attribut mit dem Namen "maxSichtweite", welches Bestandteil einer variablen Liste (Array) mit dem Namen "ListeDerSichtweiten" zu spezifizieren, ist folgendes einzutragen: "ListeDerSichtweiten.2.maxSichtweite", wobei hier das dritte Arrayelement der Liste angesprochen wird.datum- das Datum, aus dem ein eingebettetes Datum extrahiert werden soll.- Returns:
- das extrahierte Datum oder
nullwenn keine Extraktion möglich war
-
getBasisInstanzen
public static Collection<de.bsvrz.dav.daf.main.config.SystemObject> getBasisInstanzen(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.ClientDavInterface dav) Erfragt die Menge aller Konfigurationsobjekte bzw. Dynamischen Objekte (finale Objekte), die unter Umständen im Parameterobj'versteckt' sind. Sollte als Objektenullübergeben worden sein, so werden alle (finalen) Objekte zurückgegeben.- Parameters:
obj- ein Systemobjekt (finales Objekt oder Typ)dav- Verbindung zum Datenverteiler- Returns:
- eine Menge von finalen Systemobjekten
-
getBasisInstanzen
public static Collection<de.bsvrz.dav.daf.main.config.SystemObject> getBasisInstanzen(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.ClientDavInterface dav, Collection<de.bsvrz.dav.daf.main.config.ConfigurationArea> kBereichsFilter) Erfragt die Menge aller Konfigurationsobjekte bzw. Dynamischen Objekte (finale Objekte), die unter Umständen im Argumentobj'versteckt' sind und außerdem innerhalb der übergebenen Konfigurationsbereiche liegen. Sollte als Objektenullübergeben worden sein, so werden alle (finalen) Objekte zurückgegeben.- Parameters:
obj- ein Systemobjekt (finales Objekt oder Typ)dav- Verbindung zum DatenverteilerkBereichsFilter- eine Menge von Konfigurationsbereichen- Returns:
- eine Menge von finalen Systemobjekten, die innerhalb der übergebenen Konfigurationsbereiche (bzw. im Standardkonfigurationsbereich) definiert sind.
-
getStundenVonTag
public static int getStundenVonTag(long zeitStempel) Gibt die Anhahl der Stunden zurück, die dieser Tag hat.- Parameters:
zeitStempel- ein Zeitpunkt, der innerhalb des entsprechenden Tages liegt- Returns:
- Anzahl der Stunden, die dieser Tag hat
-
getTextZuMesswert
Erfragt die textliche Entsprechung eines Messwertes, dessen Wertebereich bei 0 (inklusive) beginnt und der die Zuständefehlerhaft,nicht ermittelbarodernicht ermittelbar/fehlerhaftbesitzen kann.- Parameters:
messwert- ein Messwert- Returns:
- die textliche Entsprechung eines Messwertes
-
isKombinationOk
public static String isKombinationOk(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.DataDescription datenBeschreibung) Erfragt, ob die übergebene Systemobjekt-Attributgruppen-Aspekt- Kombination gültig bzw. kompatibel (bzw. so anmeldbar) ist.- Parameters:
obj- das (finale) SystemobjektdatenBeschreibung- die Datenbeschreibung- Returns:
null, wenn die übergebene Systemobjekt- Attributgruppen-Aspekt-Kombination gültig ist, entweder. Oder eine die Inkombatibilität beschreibende Fehlermeldung sonst.
-
isWertInWerteBereich
public static boolean isWertInWerteBereich(de.bsvrz.dav.daf.main.Data attribut, double wertSkaliert) Ermittelt, ob der übergebene Wert im Wertebereich des übergebenen Attributs liegt (für skalierte Ganzzahlen).- Parameters:
attribut- das skalierte Ganzzahl-AttributwertSkaliert- der skalierte Wert- Returns:
false, wenn das übergebene Attribut ein skaliertes Ganzzahl-Attribut ist und einen Wertebereich besitzt und dieser durch den übergebenen Wert verletzt ist, sonsttrue
-
isWertInWerteBereich
public static boolean isWertInWerteBereich(de.bsvrz.dav.daf.main.Data attribut, long wert) Ermittelt, ob der uebergebene Wert im Wertebereich des uebergebenen Attributs liegt.- Parameters:
attribut- das Ganzzahl-Attributwert- der Wert- Returns:
false, wenn das uebergebene Attribut ein Ganzzahl-Attribut ist und einen Wertebereich besitzt und dieser durch den uebergebenen Wert verletzt ist, sonsttrue
-
runde
Erfragt den gerundeten Wert als Zeichenkette.- Parameters:
wert- ein Wertnachkommastellen- Rundungsstellen- Returns:
- der gerundete Wert als Zeichenkette
-
getVergleichsIntervallInText
Wandelt eine Zeitspanne in Millisekunden in einen Text um.- Parameters:
vergleichsIntervallInMs- zeit in Millisekunden- Returns:
- die uebergebene Zeitspanne in Millisekunden als Text
-
getArrayKurzInfo
Erfragt eine Kurzinformation eines Objektarrays.- Parameters:
objekte- alle Objekte- Returns:
- eine Kurzinformation eines Objektarrays
-
isObjektInKBsEnthalten
public static boolean isObjektInKBsEnthalten(de.bsvrz.dav.daf.main.config.SystemObject obj, de.bsvrz.dav.daf.main.config.ConfigurationArea[] kbs) Erfragt, ob ein Systemobjekt in einem der uebergebenen Konfigurationsbereiche enthalten ist.- Parameters:
obj- ein Systemobjektkbs- eine Menge von Konfigurationsbereichen- Returns:
true, wenn das Systemobjekt in einem der uebergebenen Konfigurationsbereiche enthalten ist bzw. wenn die Menge der Konfigurationsbereichenulloder leer ist. Sonstfalse
-
setAlleParameter
public static void setAlleParameter(de.bsvrz.dav.daf.main.ClientDavInterface dav) Parametriert die Parametrierung dergestalt, dass von dieser alle Parameter erfasst werden.- Parameters:
dav- Verbindung zum Datenverteiler
-
sendeBetriebsmeldung
public static void sendeBetriebsmeldung(de.bsvrz.dav.daf.main.ClientDavInterface dav, de.bsvrz.sys.funclib.operatingMessage.MessageGrade grade, de.bsvrz.dav.daf.main.config.SystemObject objekt, String nachricht) Sendet eine Betriebsmeldung.- Parameters:
dav- Verbindung zum Datenverteiler.grade- die Art der Meldung (FATAL,ERROR,WARNING,INFORMATION).objekt- Referenziertes Systemobjekt.nachricht- die Betriebsmeldung.
-
sendeBetriebsmeldung
public static void sendeBetriebsmeldung(de.bsvrz.dav.daf.main.ClientDavInterface dav, String id, de.bsvrz.sys.funclib.operatingMessage.MessageGrade grade, de.bsvrz.dav.daf.main.config.SystemObject objekt, String nachricht) Sendet eine Betriebsmeldung.- Parameters:
dav- Verbindung zum Datenverteiler.id- die ID für die Meldunggrade- die Art der Meldung (FATAL,ERROR,WARNING,INFORMATION).objekt- Referenziertes Systemobjekt.nachricht- die Betriebsmeldung.
-
getKonfigurationsBereicheAlsObjekte
public static Collection<de.bsvrz.dav.daf.main.config.ConfigurationArea> getKonfigurationsBereicheAlsObjekte(de.bsvrz.dav.daf.main.ClientDavInterface dav, String kbString) Extrahiert aus einer Zeichenkette alle über Kommata getrennten Konfigurationsbereiche und gibt deren Systemobjekte zurück.- Parameters:
dav- Verbindung zum DatenverteilerkbString- Zeichenkette mit den Konfigurationsbereichen- Returns:
- (ggf. leere)
ConfigurationArea-Collectionmit allen extrahierten Konfigurationsbereichen.
-