Class DafConfigurationArea

All Implemented Interfaces:
ConfigurationArea, ConfigurationObject, SystemObject, Comparable

public class DafConfigurationArea extends DafConfigurationObject implements ConfigurationArea
Applikationsseitige Implementierung der Schnittstelle zum Zugriff auf die Eigenschaften eines Bereichs.
  • Constructor Details

    • DafConfigurationArea

      public DafConfigurationArea(DafDataModel dataModel)
      Erzeugt ein neues Objekt dessen Eigenschaften im Anschluss mit der read-Methode eingelesen werden sollten.
      Parameters:
      dataModel - DataModel Implementierung, der das neue Objekt zugeordnet ist.
    • DafConfigurationArea

      public DafConfigurationArea(long id, String pid, String name, long typId, byte state, String error, DafDataModel dataModel, short validFromVersionNumber, short validToVersionNumber, long responsibleObjectId, long[] setIds)
      Erzeugt ein neues Objekt mit den angegebenen Eigenschaften
  • Method Details

    • getConfigurationAuthority

      public ConfigurationAuthority getConfigurationAuthority()
      Description copied from interface: ConfigurationArea
      Liefert den Konfigurationsverantwortlichen dieses Konfigurationsbereichs. Die Konfigurationapplikation, die über Aufrufparameter dem hier zurückgelieferten Konfigurationsverantwortlichen zugeordnet ist, ist als einzige für Änderungen im Bereich zuständig und verantwortlich.
      Specified by:
      getConfigurationAuthority in interface ConfigurationArea
      Returns:
      Verantwortliche Instanz für den Konfigurationsbereich.
    • getActivatableVersion

      public short getActivatableVersion()
      Description copied from interface: ConfigurationArea
      Version eines Bereichs, die zur Übernahme und Aktivierung in anderen Konfigurationen freigegeben ist.
      Specified by:
      getActivatableVersion in interface ConfigurationArea
      Returns:
      Nummer der Version, die zur Übernahme und Aktivierung freigegeben ist.
      See Also:
      • "TPuK1-103"
    • getTransferableVersion

      public short getTransferableVersion()
      Description copied from interface: ConfigurationArea
      Version eines Bereichs, die zur Übernahme in anderen Konfigurationen freigegeben ist.
      Specified by:
      getTransferableVersion in interface ConfigurationArea
      Returns:
      Nummer der Version, die zur Übernahme freigegeben ist.
      See Also:
      • "TPuK1-103"
    • getModifiableVersion

      public short getModifiableVersion()
      Description copied from interface: ConfigurationArea
      Neue Version eines Bereichs, die weder zur Übernahme freigegeben noch lokal aktiviert ist. Dies ist die in Bearbeitung befindliche Version, auf die sich versionierte Konfigurationsänderungen beziehen.
      Specified by:
      getModifiableVersion in interface ConfigurationArea
      Returns:
      Nummer der Version, die sich in Bearbeitung befindet.
      See Also:
      • "TPuK1-103"
    • getActiveVersion

      public short getActiveVersion()
      Description copied from interface: ConfigurationArea
      Version eines Bereichs, die lokal aktiv ist.
      Specified by:
      getActiveVersion in interface ConfigurationArea
      Returns:
      Nummer der Version, die lokal aktiv ist.
      See Also:
      • "TPuK1-100"
    • getTimeOfLastDynamicChange

      public long getTimeOfLastDynamicChange()
      Description copied from interface: ConfigurationArea
      Liefert die Zeit vom letzten Erzeugen oder Löschen eines dynamischen Objekts in diesem Konfigurationsbereich.
      Specified by:
      getTimeOfLastDynamicChange in interface ConfigurationArea
      Returns:
      Zeit in Millisekunden seit 1970
    • getTimeOfLastNonActiveConfigurationChange

      public long getTimeOfLastNonActiveConfigurationChange()
      Description copied from interface: ConfigurationArea
      Liefert die Zeit vom letzten Erzeugen oder Löschen eines Konfigurationsobjekts (in noch nicht aktivierten Versionen) dieses Konfigurationsbereichs.
      Specified by:
      getTimeOfLastNonActiveConfigurationChange in interface ConfigurationArea
      Returns:
      Zeit in Millisekunden seit 1970
    • getTimeOfLastActiveConfigurationChange

      public long getTimeOfLastActiveConfigurationChange()
      Description copied from interface: ConfigurationArea
      Liefert die Zeit der letzten (nicht versionierten) Änderung eines änderbaren konfigurierenden Datensatzes.
      Specified by:
      getTimeOfLastActiveConfigurationChange in interface ConfigurationArea
      Returns:
      Zeit in Millisekunden seit 1970
    • getObjects

      public Collection<SystemObject> getObjects(Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification timeSpecification)
      Description copied from interface: ConfigurationArea
      Gibt alle System-Objekte zurück, die zu den angegebenen Objekttypen und deren erweiterten Typen und zur Zeitangabe passen. Wird beim Parameter für die Objekttypen null übergeben, so gilt dies als Wildcard. D. h. alle Objekttypen werden berücksichtigt.
      Specified by:
      getObjects in interface ConfigurationArea
      Parameters:
      systemObjectTypes - die Objekttypen oder null, falls alle betrachtet werden sollen
      timeSpecification - gibt den Gültigkeitszeitraum für die gesuchten Objekte an
      Returns:
      Die System-Objekte, für die die Bedingungen (siehe Parameter) zutreffen.
    • getDirectObjects

      public Collection<SystemObject> getDirectObjects(Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification timeSpecification)
      Description copied from interface: ConfigurationArea
      Gibt alle System-Objekte zurück, die zu den angegebenen Objekttypen und zur Zeitangabe passen. Es werden im Gegensatz zur ConfigurationArea.getObjects(java.util.Collection<de.bsvrz.dav.daf.main.config.SystemObjectType>, de.bsvrz.dav.daf.main.config.ObjectTimeSpecification)-Methode keine Typen betrachtet, die die angegebenen Typen erweitern.
      Specified by:
      getDirectObjects in interface ConfigurationArea
      Parameters:
      systemObjectTypes - die zu betrachtenden Objekttypen
      timeSpecification - gibt den Gültigkeitszeitraum für die gesuchten Objekte an
      Returns:
      Die System-Objekte, für die die Bedingungen (siehe Parameter) zutreffen.
    • getCurrentObjects

      public Collection<SystemObject> getCurrentObjects()
      Description copied from interface: ConfigurationArea
      Gibt alle System-Objekte dieses Konfigurationsbereichs zurück, die in der aktuellen Version des Bereichs gültig sind.
      Specified by:
      getCurrentObjects in interface ConfigurationArea
      Returns:
      alle gültigen Objekte dieses Konfigurationsbereichs
    • getNewObjects

      public Collection<SystemObject> getNewObjects()
      Description copied from interface: ConfigurationArea
      Gibt alle System-Objekte dieses Konfigurationsbereichs zurück, die in einer zukünftigen Version gültig werden.
      Specified by:
      getNewObjects in interface ConfigurationArea
      Returns:
      alle zukünftig aktuellen Objekte dieses Konfigurationsbereichs
    • createConfigurationObject

      public ConfigurationObject createConfigurationObject(ConfigurationObjectType type, String pid, String name, Collection<? extends ObjectSet> sets) throws ConfigurationChangeException
      Description copied from interface: ConfigurationArea
      Erzeugt ein neues Konfigurationsobjekt eines vorgegebenen Typs mit einer angegebenen PID. Optional kann der Name des neuen Objekts vorgegeben werden. Die verantwortliche Instanz des neuen Objektes kann nicht spezifiziert werden, da sie von der jeweiligen Konfiguration vergeben wird. Das neue Objekt wird erst mit Aktivierung der nächsten Konfigurationsversion gültig.
      Specified by:
      createConfigurationObject in interface ConfigurationArea
      Parameters:
      type - Typ des neuen Objekts.
      pid - PID des neuen Objekts. Der leere String ("") oder null wird als "keine PID" interpretiert.
      name - Name des neuen Objekts (kann später verändert werden). Der leere String ("") oder null wird als "kein Name" interpretiert.
      sets - Liste der Mengen des neuen Objekts oder null, wenn keine Mengen vergeben werden sollen.
      Returns:
      Stellvertreterobjekt für das neu angelegte Konfigurationsobjekt.
      Throws:
      ConfigurationChangeException - Wenn das Objekt nicht erzeugt werden konnte.
      See Also:
    • createDynamicObject

      public DynamicObject createDynamicObject(DynamicObjectType type, String pid, String name) throws ConfigurationChangeException
      Description copied from interface: ConfigurationArea
      Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs mit einer angegebenen PID. Optional kann der Name des neuen Objekts vorgegeben werden. Das neue Objekt wird sofort gültig.
      Specified by:
      createDynamicObject in interface ConfigurationArea
      Parameters:
      type - Typ des neuen Objekts
      pid - PID des neuen Objekts. Der leere String ("") oder null wird als "keine PID" interpretiert.
      name - Name des neuen Objekts (kann später verändert werden). Der leere String ("") oder null wird als "kein Name" interpretiert.
      Returns:
      Stellvertreterobjekt für das neu angelegte dynamische Objekt.
      Throws:
      ConfigurationChangeException - Wenn das Objekt nicht erzeugt werden konnte.
      See Also:
    • createDynamicObject

      public DynamicObject createDynamicObject(DynamicObjectType type, String pid, String name, Collection<DataAndATGUsageInformation> dataSets) throws ConfigurationChangeException
      Description copied from interface: ConfigurationArea
      Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs mit einer angegebenen PID. Optional kann der Name des neuen Objekts vorgegeben werden. Diese Methode stellt sicher, dass zumindest alle für dieses Objekt notwendigen konfigurierenden Datensätze beim Erzeugen vorhanden sind.
      Specified by:
      createDynamicObject in interface ConfigurationArea
      Parameters:
      type - Typ des neuen Objekts
      pid - PID des neuen Objekts. Der leere String ("") oder null wird als "keine PID" interpretiert.
      name - Name des neuen Objekts (kann später verändert werden). Der leere String ("") oder null wird als "kein Name" interpretiert.
      dataSets - Enthält alle konfigurierenden Datensätze mit den dazugehörigen Attributgruppenverwendungen, die am neuen Objekt gespeichert werden sollen. Wird eine leere Liste oder null übergeben, so werden keine Datensätze am neu erzeugten Objekt angelegt.
      Returns:
      Stellvertreterobjekt für das neu angelegte dynamische Objekt.
      Throws:
      ConfigurationChangeException - Wenn das Objekt nicht erzeugt werden konnte.
      See Also: