public class ConfigConfigurationArea extends ConfigConfigurationObject implements ConfigurationArea, ConfigConfigurationAreaInterface
Implementierung des Konfigurationsbereichs auf Seiten der Konfiguration.
Constructor and Description |
---|
ConfigConfigurationArea(ConfigDataModel dataModel,
SystemObjectInformationInterface systemObjectInfo)
Konstruktor eines System-Objekt für einen Konfigurationsbereich.
|
Modifier and Type | Method and Description |
---|---|
void |
activateNewAuthority(SystemObject newAuthority)
Wird während der Aktivierung aufgerufen um den neuen KV zu setzen.
|
void |
addAreaDependency(java.util.Collection<ConfigurationAreaDependency> areaDependencies)
Speichert eine Abhängigkeit dieses Bereichs.
|
ConfigurationObject |
createConfigurationObject(ConfigurationObjectType type,
java.lang.String pid,
java.lang.String name,
java.util.Collection<? extends ObjectSet> sets)
Erzeugt ein neues Konfigurationsobjekt eines vorgegebenen Typs mit einer angegebenen PID.
|
DynamicObject |
createDynamicObject(DynamicObjectType type,
java.lang.String pid,
java.lang.String name)
Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs mit einer angegebenen PID.
|
DynamicObject |
createDynamicObject(DynamicObjectType type,
java.lang.String pid,
java.lang.String name,
java.util.Collection<DataAndATGUsageInformation> data)
Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs mit einer angegebenen PID.
|
DynamicObject |
createDynamicObject(DynamicObjectType type,
java.lang.String pid,
java.lang.String name,
java.util.Collection<DataAndATGUsageInformation> data,
short simulationVariant)
Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs mit einer angegebenen PID.
|
DynamicObject |
createDynamicObject(DynamicObjectType type,
java.lang.String pid,
java.lang.String name,
short simulationVariant)
Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs mit einer angegebenen PID.
|
boolean |
dependenciesChecked() |
short |
getActivatableVersion()
Version eines Bereichs, die zur Übernahme und Aktivierung in anderen Konfigurationen freigegeben ist.
|
short |
getActiveVersion()
Version eines Bereichs, die lokal aktiv ist.
|
java.util.Collection<ConfigurationAreaChangeInformation> |
getChangeLogs()
Diese Methode gibt alle eingetragenen Konfigurationsänderungen zurück, die in der Versorgungsdatei eingetragen wurden.
|
ConfigConfigurationArea |
getConfigurationArea()
Liefert den Konfigurationsbereich, zu dem dieses Objekt gehört, zurück.
|
ConfigurationAuthority |
getConfigurationAuthority()
Liefert den Konfigurationsverantwortlichen dieses Konfigurationsbereichs.
|
java.util.Collection<SystemObject> |
getCurrentObjects()
Gibt alle System-Objekte dieses Konfigurationsbereichs zurück, die in der aktuellen Version des Bereichs gültig sind.
|
ConfigDataModel |
getDataModel()
Liefert das zu diesem Objekt gehörende Objekt zum Zugriff auf die Konfiguration zurück.
|
java.util.Collection<ConfigurationAreaDependency> |
getDependencyFromOtherConfigurationAreas()
Gibt alle Abhängigkeiten des Bereichs zu anderen Konfigurationsbereichen zurück.
|
java.util.Collection<SystemObject> |
getDirectObjects(java.util.Collection<SystemObjectType> systemObjectTypes,
ObjectTimeSpecification timeSpecification)
Gibt alle System-Objekte zurück, die zu den angegebenen Objekttypen und zur Zeitangabe passen.
|
short |
getLastModifiedVersion()
Gibt die in Bearbeitung befindliche Version zurück, wenn Änderungen in dieser Version dieses Bereichs stattgefunden haben.
|
short |
getModifiableVersion()
Neue Version eines Bereichs, die weder zur Übernahme freigegeben noch lokal aktiviert ist.
|
java.util.Collection<SystemObject> |
getNewObjects()
Gibt alle System-Objekte dieses Konfigurationsbereichs zurück, die in einer zukünftigen Version gültig werden.
|
java.util.Collection<SystemObject> |
getObjects(java.util.Collection<SystemObjectType> systemObjectTypes,
ObjectTimeSpecification timeSpecification)
Gibt alle System-Objekte zurück, die zu den angegebenen Objekttypen und deren erweiterten Typen und zur Zeitangabe passen.
|
long |
getTimeOfLastActiveConfigurationChange()
Liefert die Zeit der letzten (nicht versionierten) Änderung eines änderbaren konfigurierenden Datensatzes.
|
long |
getTimeOfLastDynamicChange()
Liefert die Zeit vom letzten Erzeugen oder Löschen eines dynamischen Objekts in diesem Konfigurationsbereich.
|
long |
getTimeOfLastNonActiveConfigurationChange()
Liefert die Zeit vom letzten Erzeugen oder Löschen eines Konfigurationsobjekts (in noch nicht aktivierten Versionen) dieses Konfigurationsbereichs.
|
short |
getTransferableVersion()
Version eines Bereichs, die zur Übernahme in anderen Konfigurationen freigegeben ist.
|
void |
initialiseTimeOfLastChanges()
Prüft, ob es einen Wert im Datensatz
atg.konfigurationsBereichÄnderungsZeiten gibt, der Undefiniert (0) ist, und ersetzt diesen mit der aktuellen Zeit. |
void |
setConfigurationData(AttributeGroupUsage atgUsage,
Data data)
Ändert einen konfigurierenden Datensatz dieses Objekts.
|
addSet, duplicate, duplicate, getMutableSet, getNonMutableSet, getNotValidSince, getObjectSet, getObjectSets, getValidSince, invalidate, isValid, removeSet, revalidate, simpleRevalidate
createConfigurationData, equals, getConfigurationData, getConfigurationData, getConfigurationData, getConfigurationData, getConfigurationData, getConfigurationDataBytes, getId, getName, getObjectLookupForData, getPid, getType, getUsedAttributeGroupUsages, hashCode, originalHashCode, removeConfigurationData, setConfigurationData, setName, simpleInvalidation
compareTo, getConfigurationData, getInfo, getNameOrPidOrId, getPidOrId, getPidOrNameOrId, isOfType, isOfType, setConfigurationData, toString
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
addSet, duplicate, duplicate, getMutableSet, getNonMutableSet, getNotValidSince, getObjectSet, getObjectSets, getValidSince, removeSet, revalidate
getConfigurationData, getConfigurationData, getConfigurationData, getId, getInfo, getName, getNameOrPidOrId, getPid, getPidOrId, getPidOrNameOrId, getType, getUsedAttributeGroupUsages, invalidate, isOfType, isOfType, isValid, setConfigurationData, setConfigurationData, setName, toString
public ConfigConfigurationArea(ConfigDataModel dataModel, SystemObjectInformationInterface systemObjectInfo)
Konstruktor eines System-Objekt für einen Konfigurationsbereich.
dataModel
- das Datenmodell, welches alle Konfigurationsbereiche enthältsystemObjectInfo
- das korrespondierende Objekt aus den Konfigurationsdateienpublic ConfigDataModel getDataModel()
de.bsvrz.dav.daf.main.config.SystemObject
getDataModel
in interface SystemObject
getDataModel
in class AbstractConfigSystemObject
public ConfigConfigurationArea getConfigurationArea()
de.bsvrz.dav.daf.main.config.SystemObject
getConfigurationArea
in interface SystemObject
getConfigurationArea
in class AbstractConfigSystemObject
public ConfigurationAuthority getConfigurationAuthority()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getConfigurationAuthority
in interface ConfigurationArea
public void setConfigurationData(AttributeGroupUsage atgUsage, Data data) throws ConfigurationChangeException
de.bsvrz.dav.daf.main.config.SystemObject
setConfigurationData
in interface SystemObject
setConfigurationData
in class ConfigSystemObject
atgUsage
- Attributgruppenverwendung des zu ändernden Datensatzesdata
- Der neue Datensatz. Wird null
angegeben, wird der Datensatz am Objekt gelöscht.ConfigurationChangeException
- Wenn der Datensatz nicht geändert werden konnte.public void activateNewAuthority(SystemObject newAuthority) throws ConfigurationChangeException
Wird während der Aktivierung aufgerufen um den neuen KV zu setzen. Der Weg über setConfigurationData() ist nicht möglich, da dort das Setzen des KV eine Exception produziert.
newAuthority
- ConfigurationChangeException
public short getActivatableVersion()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getActivatableVersion
in interface ConfigurationArea
public short getTransferableVersion()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getTransferableVersion
in interface ConfigurationArea
public short getActiveVersion()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getActiveVersion
in interface ConfigurationArea
public short getModifiableVersion()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getModifiableVersion
in interface ConfigurationArea
public short getLastModifiedVersion()
Gibt die in Bearbeitung befindliche Version zurück, wenn Änderungen in dieser Version dieses Bereichs stattgefunden haben. Änderungen können sein:
Wurden keine Änderungen in der in Bearbeitung befindlichen Version vorgenommen, wird die Version davor zurückgegeben.
public long getTimeOfLastDynamicChange()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getTimeOfLastDynamicChange
in interface ConfigurationArea
public long getTimeOfLastNonActiveConfigurationChange()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getTimeOfLastNonActiveConfigurationChange
in interface ConfigurationArea
public long getTimeOfLastActiveConfigurationChange()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getTimeOfLastActiveConfigurationChange
in interface ConfigurationArea
public java.util.Collection<SystemObject> getObjects(java.util.Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification timeSpecification)
de.bsvrz.dav.daf.main.config.ConfigurationArea
null
übergeben, so gilt dies als Wildcard. D. h. alle Objekttypen werden berücksichtigt.getObjects
in interface ConfigurationArea
systemObjectTypes
- die Objekttypen oder null
, falls alle betrachtet werden sollentimeSpecification
- gibt den Gültigkeitszeitraum für die gesuchten Objekte anpublic java.util.Collection<SystemObject> getDirectObjects(java.util.Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification timeSpecification)
de.bsvrz.dav.daf.main.config.ConfigurationArea
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.getDirectObjects
in interface ConfigurationArea
systemObjectTypes
- die zu betrachtenden ObjekttypentimeSpecification
- gibt den Gültigkeitszeitraum für die gesuchten Objekte anpublic java.util.Collection<SystemObject> getCurrentObjects()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getCurrentObjects
in interface ConfigurationArea
public java.util.Collection<SystemObject> getNewObjects()
de.bsvrz.dav.daf.main.config.ConfigurationArea
getNewObjects
in interface ConfigurationArea
public ConfigurationObject createConfigurationObject(ConfigurationObjectType type, java.lang.String pid, java.lang.String name, java.util.Collection<? extends ObjectSet> sets) throws ConfigurationChangeException
de.bsvrz.dav.daf.main.config.ConfigurationArea
createConfigurationObject
in interface ConfigurationArea
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.ConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.ConfigurationObject
,
SystemObject.isValid()
public DynamicObject createDynamicObject(DynamicObjectType type, java.lang.String pid, java.lang.String name) throws ConfigurationChangeException
de.bsvrz.dav.daf.main.config.ConfigurationArea
createDynamicObject
in interface ConfigurationArea
type
- Typ des neuen Objektspid
- 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.ConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.SystemObject
,
SystemObject.isValid()
public DynamicObject createDynamicObject(DynamicObjectType type, java.lang.String pid, java.lang.String name, short simulationVariant) throws ConfigurationChangeException
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.
type
- Typ des neuen Objektspid
- 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)simulationVariant
- Simulationsvariante des neuen ObjektsConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.public DynamicObject createDynamicObject(DynamicObjectType type, java.lang.String pid, java.lang.String name, java.util.Collection<DataAndATGUsageInformation> data) throws ConfigurationChangeException
de.bsvrz.dav.daf.main.config.ConfigurationArea
createDynamicObject
in interface ConfigurationArea
type
- Typ des neuen Objektspid
- 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.data
- 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.ConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.SystemObject
,
SystemObject.isValid()
public java.util.Collection<ConfigurationAreaDependency> getDependencyFromOtherConfigurationAreas()
ConfigConfigurationAreaInterface
Gibt alle Abhängigkeiten des Bereichs zu anderen Konfigurationsbereichen zurück.
getDependencyFromOtherConfigurationAreas
in interface ConfigConfigurationAreaInterface
public void addAreaDependency(java.util.Collection<ConfigurationAreaDependency> areaDependencies) throws ConfigurationChangeException
Speichert eine Abhängigkeit dieses Bereichs. Besteht bereits eine Abhängigkeit (gleiche Versionen, gleiche Breiche), so wird die Abhängigkeit nicht erneut gespeichert.
Wurde eine Abhängigkeit gespeichert, die den Typ OPTIONAL ConfigurationAreaDependencyKind
und es soll eine Abhängigkeit REQUIRED gespeichert werden, so wird die optionale Abhängigkeit ersetzt. Umgekehrt ist dies nicht möglich.
Ist der Bereich bereits von einem anderen Bereich abhängig (notwendig) und es soll eine Abhängigkeit optional hinzugefügt werden (dessen needed Version > als die notwendige Abhängigkeit), so wird diese Abhängigkeit automatisch auf “notwendig” gesetzt. Damit wird verhindert, das eine Abhängigkeit, die notwendig war, durch Versionswechsel wieder auf optional gesetzt werden kann.
Ist der Konfiguration die Attributgruppe zum speichern der Datensätze nicht bekannt, so die Abhängigkeiten ignoriert und nichts gemacht.
areaDependencies
- Abhängigkeiten, die gespeichert werden soll.ConfigurationChangeException
- Wird geworfen, wenn der Datensatz, der die Abhängigkeiten enthält, nicht gespeichert werden kann.public boolean dependenciesChecked()
dependenciesChecked
in interface ConfigConfigurationAreaInterface
true
, wenn der Bereich bereits auf Abhängigkeiten geprüft wurde; false
, wenn der Bereich nicht auf Abhängigkeiten geprüft wurde.public java.util.Collection<ConfigurationAreaChangeInformation> getChangeLogs()
Diese Methode gibt alle eingetragenen Konfigurationsänderungen zurück, die in der Versorgungsdatei eingetragen wurden.
public DynamicObject createDynamicObject(DynamicObjectType type, java.lang.String pid, java.lang.String name, java.util.Collection<DataAndATGUsageInformation> data, short simulationVariant) throws ConfigurationChangeException
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. Zusätzlich können alle Datensätze übergeben werden.
type
- Typ des neuen Objektspid
- 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)data
- Datensätze für das dynamische ObjektsimulationVariant
- Simulationsvariante des neuen ObjektsConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.public void initialiseTimeOfLastChanges()
Prüft, ob es einen Wert im Datensatz atg.konfigurationsBereichÄnderungsZeiten
gibt, der Undefiniert (0)
ist, und ersetzt diesen mit der aktuellen Zeit.