Class DUAUtensilien

java.lang.Object
de.bsvrz.sys.funclib.bitctrl.dua.DUAUtensilien

public final class DUAUtensilien extends Object
Einige hilfreiche Methoden, die an verschiedenen Stellen innerhalb der DUA Verwendung finden.
  • Method Summary

    Modifier and Type
    Method
    Description
    static String
    Ersetzt den letzten Teil eines Attribuspfades durch eine bestimmte Zeichenkette.
    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 von DAVObjektAnmeldung-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 String
    getArgument(String schluessel, List<String> argumentListe)
    Liest eine Argument aus der ArgumentListe der Kommandozeile aus.
    static String
    Erfragt eine Kurzinformation eines Objektarrays.
    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.
    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 int
    getStundenVonTag(long zeitStempel)
    Gibt die Anhahl der Stunden zurück, die dieser Tag hat.
    static String
    getTextZuMesswert(long messwert)
    Erfragt die textliche Entsprechung eines Messwertes, dessen Wertebereich bei 0 (inklusive) beginnt und der die Zustände fehlerhaft, nicht ermittelbar oder nicht ermittelbar/fehlerhaft besitzen kann.
    static String
    getVergleichsIntervallInText(long vergleichsIntervallInMs)
    Wandelt eine Zeitspanne in Millisekunden in einen Text um.
    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.
    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.
    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).
    static boolean
    isWertInWerteBereich(de.bsvrz.dav.daf.main.Data attribut, long wert)
    Ermittelt, ob der uebergebene Wert im Wertebereich des uebergebenen Attributs liegt.
    static String
    runde(double wert, int nachkommastellen)
    Erfragt den gerundeten Wert als Zeichenkette.
    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.
    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.
    static void
    setAlleParameter(de.bsvrz.dav.daf.main.ClientDavInterface dav)
    Parametriert die Parametrierung dergestalt, dass von dieser alle Parameter erfasst werden.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Method Details

    • ersetzeLetztesElemInAttPfad

      public static String ersetzeLetztesElemInAttPfad(String attPfad, String ersetzung)
      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 Statuswert max der formalen Plausibilisierung des Elements a.b.c zugegriffen werden kann
      Parameters:
      attPfad - der orginale Attributpfad
      ersetzung - 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 von DAVObjektAnmeldung-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 Objekt null übergeben worden sein, so wird 'Alle Objekte' angenommen. Gleiches gilt für die Elemente der Datenbeschreibung.
      Parameters:
      obj - ein Systemobjekt (auch Typ)
      datenBeschreibung - eine Datenbeschreibung
      dav - Verbindung zum Datenverteiler
      Returns:
      eine Menge von DAVObjektAnmeldung-Objekten
    • getArgument

      public static String getArgument(String schluessel, List<String> argumentListe)
      Liest eine Argument aus der ArgumentListe der Kommandozeile aus.
      Parameters:
      schluessel - der Schlüssel
      argumentListe - 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 null wenn 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 Parameter obj 'versteckt' sind. Sollte als Objekte null ü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 Argument obj 'versteckt' sind und außerdem innerhalb der übergebenen Konfigurationsbereiche liegen. Sollte als Objekte null übergeben worden sein, so werden alle (finalen) Objekte zurückgegeben.
      Parameters:
      obj - ein Systemobjekt (finales Objekt oder Typ)
      dav - Verbindung zum Datenverteiler
      kBereichsFilter - 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

      public static String getTextZuMesswert(long messwert)
      Erfragt die textliche Entsprechung eines Messwertes, dessen Wertebereich bei 0 (inklusive) beginnt und der die Zustände fehlerhaft, nicht ermittelbar oder nicht ermittelbar/fehlerhaft besitzen 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) Systemobjekt
      datenBeschreibung - 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-Attribut
      wertSkaliert - 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, sonst true
    • 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-Attribut
      wert - der Wert
      Returns:
      false, wenn das uebergebene Attribut ein Ganzzahl-Attribut ist und einen Wertebereich besitzt und dieser durch den uebergebenen Wert verletzt ist, sonst true
    • runde

      public static String runde(double wert, int nachkommastellen)
      Erfragt den gerundeten Wert als Zeichenkette.
      Parameters:
      wert - ein Wert
      nachkommastellen - Rundungsstellen
      Returns:
      der gerundete Wert als Zeichenkette
    • getVergleichsIntervallInText

      public static String getVergleichsIntervallInText(long vergleichsIntervallInMs)
      Wandelt eine Zeitspanne in Millisekunden in einen Text um.
      Parameters:
      vergleichsIntervallInMs - zeit in Millisekunden
      Returns:
      die uebergebene Zeitspanne in Millisekunden als Text
    • getArrayKurzInfo

      public static String getArrayKurzInfo(Object[] objekte)
      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 Systemobjekt
      kbs - eine Menge von Konfigurationsbereichen
      Returns:
      true, wenn das Systemobjekt in einem der uebergebenen Konfigurationsbereiche enthalten ist bzw. wenn die Menge der Konfigurationsbereiche null oder leer ist. Sonst false
    • 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 Meldung
      grade - 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 Datenverteiler
      kbString - Zeichenkette mit den Konfigurationsbereichen
      Returns:
      (ggf. leere) ConfigurationArea-Collection mit allen extrahierten Konfigurationsbereichen.