Class DafConfigurationArea
java.lang.Object
de.bsvrz.dav.daf.main.impl.config.DafSystemObject
de.bsvrz.dav.daf.main.impl.config.DafConfigurationObject
de.bsvrz.dav.daf.main.impl.config.DafConfigurationArea
- All Implemented Interfaces:
ConfigurationArea
,ConfigurationObject
,SystemObject
,java.lang.Comparable
public class DafConfigurationArea extends DafConfigurationObject implements ConfigurationArea
Applikationsseitige Implementierung der Schnittstelle zum Zugriff auf die Eigenschaften eines Bereichs.
-
Field Summary
Fields inherited from class de.bsvrz.dav.daf.main.impl.config.DafSystemObject
_configurationAreaId, _dataModel, _internType, ASPECT, ATTRIBUTE, ATTRIBUTE_GROUP, ATTRIBUTE_GROUP_USAGE, ATTRIBUTE_LIST_TYPE, CLIENT_APPLICATION, CONFIGURATION_APPLICATION, CONFIGURATION_AREA, CONFIGURATION_AUTHORITY, CONFIGURATION_OBJECT, CONFIGURATION_OBJECT_TYPE, DAV_APPLICATION, DYNAMIC_OBJECT, DYNAMIC_OBJECT_TYPE, FLOATING_POINT_NUMBER_ATTRIBUTE_TYPE, INTEGER_ATTRIBUTE_TYPE, INTEGER_VALUE_RANGE, INTEGER_VALUE_STATE, MUTABLE_SET, NON_MUTABLE_SET, NULL_OBJECT, OBJECT_DELETED, OBJECT_EXISTS, OBJECT_INVALID, OBJECT_SET_TYPE, OBJECT_SET_USE, REFERENCE_ATTRIBUTE_TYPE, STRING_ATTRIBUTE_TYPE, SYSTEM_OBJECT_TYPE, TIME_ATTRIBUTE_TYPE
-
Constructor Summary
Constructors Constructor Description DafConfigurationArea(long id, java.lang.String pid, java.lang.String name, long typId, byte state, java.lang.String error, DafDataModel dataModel, short validFromVersionNumber, short validToVersionNumber, long responsibleObjectId, long[] setIds)
Erzeugt ein neues Objekt mit den angegebenen EigenschaftenDafConfigurationArea(DafDataModel dataModel)
Erzeugt ein neues Objekt dessen Eigenschaften im Anschluss mit der read-Methode eingelesen werden sollten. -
Method Summary
Modifier and Type Method Description 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> dataSets)
Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs mit einer angegebenen PID.short
getActivatableVersion()
Version eines Bereichs, die zur Übernahme und Aktivierung in anderen Konfigurationen freigegeben ist.short
getActiveVersion()
Version eines Bereichs, die lokal aktiv ist.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.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
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.Methods inherited from class de.bsvrz.dav.daf.main.impl.config.DafConfigurationObject
addSet, duplicate, duplicate, getMutableSet, getNonMutableSet, getNotValidSince, getObjectSet, getObjectSets, getValidSince, isValid, parseToString, read, read, removeSet, revalidate, write
Methods inherited from class de.bsvrz.dav.daf.main.impl.config.DafSystemObject
compareTo, equals, getConfigurationArea, getConfigurationAreaId, getConfigurationData, getConfigurationData, getConfigurationData, getDataModel, getId, getInfo, getInternType, getName, getNameOrPidOrId, getObject, getPid, getPidOrId, getPidOrNameOrId, getState, getType, getUsedAttributeGroupUsages, hashCode, invalidate, isOfType, isOfType, setConfigurationData, setConfigurationData, setConfigurationData, setName, storeName, toString
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.lang.Comparable
compareTo
Methods inherited from interface de.bsvrz.dav.daf.main.config.ConfigurationObject
addSet, duplicate, duplicate, getMutableSet, getNonMutableSet, getNotValidSince, getObjectSet, getObjectSets, getValidSince, removeSet, revalidate
Methods inherited from interface de.bsvrz.dav.daf.main.config.SystemObject
getConfigurationArea, getConfigurationData, getConfigurationData, getConfigurationData, getDataModel, getId, getInfo, getName, getNameOrPidOrId, getPid, getPidOrId, getPidOrNameOrId, getType, getUsedAttributeGroupUsages, invalidate, isOfType, isOfType, isValid, setConfigurationData, setConfigurationData, setConfigurationData, setName, toString
-
Constructor Details
-
DafConfigurationArea
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, java.lang.String pid, java.lang.String name, long typId, byte state, java.lang.String error, DafDataModel dataModel, short validFromVersionNumber, short validToVersionNumber, long responsibleObjectId, long[] setIds)Erzeugt ein neues Objekt mit den angegebenen Eigenschaften
-
-
Method Details
-
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 interfaceConfigurationArea
- 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 interfaceConfigurationArea
- 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 interfaceConfigurationArea
- 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 interfaceConfigurationArea
- 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 interfaceConfigurationArea
- 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 interfaceConfigurationArea
- 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 interfaceConfigurationArea
- 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 interfaceConfigurationArea
- Returns:
- Zeit in Millisekunden seit 1970
-
getObjects
public java.util.Collection<SystemObject> getObjects(java.util.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 Objekttypennull
übergeben, so gilt dies als Wildcard. D. h. alle Objekttypen werden berücksichtigt.- Specified by:
getObjects
in interfaceConfigurationArea
- Parameters:
systemObjectTypes
- die Objekttypen odernull
, falls alle betrachtet werden sollentimeSpecification
- gibt den Gültigkeitszeitraum für die gesuchten Objekte an- Returns:
- Die System-Objekte, für die die Bedingungen (siehe Parameter) zutreffen.
-
getDirectObjects
public java.util.Collection<SystemObject> getDirectObjects(java.util.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 zurConfigurationArea.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 interfaceConfigurationArea
- Parameters:
systemObjectTypes
- die zu betrachtenden ObjekttypentimeSpecification
- gibt den Gültigkeitszeitraum für die gesuchten Objekte an- Returns:
- Die System-Objekte, für die die Bedingungen (siehe Parameter) zutreffen.
-
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 interfaceConfigurationArea
- Returns:
- alle gültigen Objekte dieses Konfigurationsbereichs
-
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 interfaceConfigurationArea
- Returns:
- alle zukünftig aktuellen Objekte dieses Konfigurationsbereichs
-
createConfigurationObject
public ConfigurationObject createConfigurationObject(ConfigurationObjectType type, java.lang.String pid, java.lang.String name, java.util.Collection<? extends ObjectSet> sets) throws ConfigurationChangeExceptionDescription 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 interfaceConfigurationArea
- Parameters:
type
- Typ des neuen Objekts.pid
- PID des neuen Objekts. Der leere String ("") odernull
wird als "keine PID" interpretiert.name
- Name des neuen Objekts (kann später verändert werden). Der leere String ("") odernull
wird als "kein Name" interpretiert.sets
- Liste der Mengen des neuen Objekts odernull
, 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:
ConfigurationObject
,SystemObject.isValid()
-
createDynamicObject
public DynamicObject createDynamicObject(DynamicObjectType type, java.lang.String pid, java.lang.String name) throws ConfigurationChangeExceptionDescription 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 interfaceConfigurationArea
- Parameters:
type
- Typ des neuen Objektspid
- PID des neuen Objekts. Der leere String ("") odernull
wird als "keine PID" interpretiert.name
- Name des neuen Objekts (kann später verändert werden). Der leere String ("") odernull
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:
SystemObject
,SystemObject.isValid()
,ClientDavInterface.getDefaultConfigurationArea(DynamicObjectType)
-
createDynamicObject
public DynamicObject createDynamicObject(DynamicObjectType type, java.lang.String pid, java.lang.String name, java.util.Collection<DataAndATGUsageInformation> dataSets) throws ConfigurationChangeExceptionDescription 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 interfaceConfigurationArea
- Parameters:
type
- Typ des neuen Objektspid
- PID des neuen Objekts. Der leere String ("") odernull
wird als "keine PID" interpretiert.name
- Name des neuen Objekts (kann später verändert werden). Der leere String ("") odernull
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 odernull
ü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:
SystemObject
,SystemObject.isValid()
,ClientDavInterface.getDefaultConfigurationArea(DynamicObjectType)
-