public class DafConfigurationArea extends DafConfigurationObject implements ConfigurationArea
Applikationsseitige Implementierung der Schnittstelle zum Zugriff auf die Eigenschaften eines Bereichs.
Modifier and Type | Field and Description |
---|---|
private short |
_activeVersion
Aktive Version des Bereichs oder -1 falls diese Version noch nicht abgefragt wurde.
|
private static Debug |
_debug
DebugLogger für Debug-Ausgaben
|
_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 and Description |
---|
DafConfigurationArea(DafDataModel dataModel)
Erzeugt ein neues Objekt dessen Eigenschaften im Anschluss mit der read-Methode eingelesen werden sollten.
|
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
|
Modifier and Type | Method and Description |
---|---|
private void |
checkNameLength(java.lang.String name)
Prüft, ob ein Name länger als 255 Zeichen ist.
|
private void |
checkPidLength(java.lang.String pid)
Prüft, ob die Pid länger als 255 Zeichen ist.
|
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.
|
private ConfigurationRequester |
getRequester() |
private long |
getTime(java.lang.String kindOfTime)
Gibt einen Zeitpunkt zurück, dieser bezieht sich auf den übergebenen Parameter.
|
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.
|
private short |
getVersion(java.lang.String kindOfVersion)
Diese Methode fordert den konfigurierenden Datensatz des Bereichs mit der ATG “atg.konfigurationsBereichÜbernahmeInformationen” und dem Aspekt “asp.eigenschaften” an, aus diesem wird dann eine Version ausgelesen.
|
addSet, duplicate, duplicate, getMutableSet, getNonMutableSet, getNotValidSince, getObjectSet, getObjectSets, getValidSince, isValid, parseToString, read, read, removeSet, revalidate, write
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, setState, storeName, toString
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
addSet, duplicate, duplicate, getMutableSet, getNonMutableSet, getNotValidSince, getObjectSet, getObjectSets, getValidSince, removeSet, revalidate
getConfigurationArea, getConfigurationData, getConfigurationData, getConfigurationData, getDataModel, getId, getInfo, getName, getNameOrPidOrId, getPid, getPidOrId, getPidOrNameOrId, getType, getUsedAttributeGroupUsages, invalidate, isOfType, isOfType, isValid, setConfigurationData, setConfigurationData, setConfigurationData, setName, toString
private static final Debug _debug
DebugLogger für Debug-Ausgaben
private short _activeVersion
Aktive Version des Bereichs oder -1 falls diese Version noch nicht abgefragt wurde. *
public DafConfigurationArea(DafDataModel dataModel)
Erzeugt ein neues Objekt dessen Eigenschaften im Anschluss mit der read-Methode eingelesen werden sollten.
dataModel
- DataModel Implementierung, der das neue Objekt zugeordnet ist.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
public ConfigurationAuthority getConfigurationAuthority()
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.
getConfigurationAuthority
in interface ConfigurationArea
private short getVersion(java.lang.String kindOfVersion) throws java.lang.IllegalStateException
Diese Methode fordert den konfigurierenden Datensatz des Bereichs mit der ATG “atg.konfigurationsBereichÜbernahmeInformationen” und dem Aspekt “asp.eigenschaften” an, aus diesem wird dann eine Version ausgelesen. Die auszulesende Version wird über den übergebenen Parameter festgelegt.
kindOfVersion
- Version, die aus dem Datensatz gelesen werden soll (“übernehmbareVersion” oder “aktivierbareVersion”)java.lang.IllegalStateException
- Die Version konnte nicht ermittelt werdenpublic short getActivatableVersion()
ConfigurationArea
Version eines Bereichs, die zur Übernahme und Aktivierung in anderen Konfigurationen freigegeben ist.
getActivatableVersion
in interface ConfigurationArea
public short getTransferableVersion()
ConfigurationArea
Version eines Bereichs, die zur Übernahme in anderen Konfigurationen freigegeben ist.
getTransferableVersion
in interface ConfigurationArea
public short getModifiableVersion()
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.
getModifiableVersion
in interface ConfigurationArea
public short getActiveVersion()
ConfigurationArea
Version eines Bereichs, die lokal aktiv ist.
getActiveVersion
in interface ConfigurationArea
private long getTime(java.lang.String kindOfTime) throws java.lang.IllegalStateException
Gibt einen Zeitpunkt zurück, dieser bezieht sich auf den übergebenen Parameter. Der Zeitpunkt wird aus einem konfigurierenden Datensatz ausgelesen (atg.konfigurationsBereichÄnderungsZeiten), dieser Datensatz ist am Konfigurationsbereich gespeichert.
kindOfTime
- “LetzteÄnderungszeitDynamischesObjekt”, “LetzteÄnderungszeitKonfigurationsObjekt” oder “LetzteÄnderungszeitDatensatz”java.lang.IllegalStateException
- Der übergebene Parameter ist unbekanntpublic long getTimeOfLastDynamicChange()
ConfigurationArea
Liefert die Zeit vom letzten Erzeugen oder Löschen eines dynamischen Objekts in diesem Konfigurationsbereich.
getTimeOfLastDynamicChange
in interface ConfigurationArea
public long getTimeOfLastNonActiveConfigurationChange()
ConfigurationArea
Liefert die Zeit vom letzten Erzeugen oder Löschen eines Konfigurationsobjekts (in noch nicht aktivierten Versionen) dieses Konfigurationsbereichs.
getTimeOfLastNonActiveConfigurationChange
in interface ConfigurationArea
public long getTimeOfLastActiveConfigurationChange()
ConfigurationArea
Liefert die Zeit der letzten (nicht versionierten) Änderung eines änderbaren konfigurierenden Datensatzes.
getTimeOfLastActiveConfigurationChange
in interface ConfigurationArea
public java.util.Collection<SystemObject> getObjects(java.util.Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification timeSpecification)
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.
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)
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.
getDirectObjects
in interface ConfigurationArea
systemObjectTypes
- die zu betrachtenden ObjekttypentimeSpecification
- gibt den Gültigkeitszeitraum für die gesuchten Objekte anpublic java.util.Collection<SystemObject> getCurrentObjects()
ConfigurationArea
Gibt alle System-Objekte dieses Konfigurationsbereichs zurück, die in der aktuellen Version des Bereichs gültig sind.
getCurrentObjects
in interface ConfigurationArea
public java.util.Collection<SystemObject> getNewObjects()
ConfigurationArea
Gibt alle System-Objekte dieses Konfigurationsbereichs zurück, die in einer zukünftigen Version gültig werden.
getNewObjects
in interface ConfigurationArea
private void checkNameLength(java.lang.String name) throws ConfigurationChangeException
Prüft, ob ein Name länger als 255 Zeichen ist.
name
- Name oder null
ConfigurationChangeException
- Der Name ist länger als 255 Zeichenprivate void checkPidLength(java.lang.String pid) throws ConfigurationChangeException
Prüft, ob die Pid länger als 255 Zeichen ist.
pid
- Pid oder null
ConfigurationChangeException
- Die Pid ist länger als 255 Zeichenpublic ConfigurationObject createConfigurationObject(ConfigurationObjectType type, java.lang.String pid, java.lang.String name, java.util.Collection<? extends ObjectSet> sets) throws ConfigurationChangeException
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.
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
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.
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, java.util.Collection<DataAndATGUsageInformation> dataSets) throws ConfigurationChangeException
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.
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.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.ConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.SystemObject
,
SystemObject.isValid()
private ConfigurationRequester getRequester()