Class 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.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • 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
        Die Ersetzung erfolgt dabei nur im generierten Teil ein Präfix, der Umlaute enthält behölt diese.
        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 eine NoSimulationException 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 eine NoSimulationException 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.