|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectde.bsvrz.dav.daf.main.impl.config.DafDataModel
public class DafDataModel
Applikationsseitige Implementierung der DataModel Schnittstelle, die Zugriffe auf die Datenmodelle und Versorgungsdaten ermöglicht.
Constructor Summary | |
---|---|
DafDataModel(ClientDavInterface connection)
Erzeugt ein neues Objekt zum Zugriff auf die Konfiguration über eine vorgegebene Datenverteilerverbindung. |
Method Summary | |
---|---|
void |
close()
Diese Methode sollte beim Terminieren der Datenverteilerverbindung aufgerufen werden. |
ConfigurationObject |
createConfigurationObject(ConfigurationObjectType type,
String pid,
String name,
List sets)
Erzeugt ein neues Konfigurationsobjekt eines vorgegebenen Typs. |
DynamicObject |
createDynamicObject(SystemObjectType type,
String pid,
String name)
Erzeugt ein neues dynamisches System-Objekt eines vorgegebenen Typs. |
short |
getActiveVersion(ConfigurationArea configurationArea)
Gibt die aktive Version des angegebenen Konfigurationsbereichs zurück. |
Aspect |
getAspect(String pid)
Liefert den Aspekt mit der angegebenen PID zurück. |
AttributeGroup |
getAttributeGroup(String pid)
Liefert die Attributgruppe mit der angegebenen PID zurück. |
AttributeGroupUsage |
getAttributeGroupUsage(long usageIdentification)
Bestimmt die Attributgruppenverwendung mit der angegebenen Datenverteiler-Identifizierung. |
AttributeType |
getAttributeType(String pid)
Liefert den Attribut-Typ mit der angegebenen PID zurück. |
List |
getBaseTypes()
Liefert die Basistypen, also die Typ-Objekte, die keinen anderen Typ erweitern, zurück. |
DafConfigurationArea |
getConfigurationArea(String pid)
Liefert zu der angegebenen Pid den passenden Konfigurationsbereich. |
ConfigurationAuthority |
getConfigurationAuthority()
Liefert den lokalen Verantwortlichen der gesamten Konfiguration. |
long |
getConfigurationAuthorityId()
Gibt die Objekt-Id des Konfigurationsverantwortlichen zurück. |
String |
getConfigurationAuthorityPid()
Liefert die Pid des lokalen Verantwortlichen der gesamten Konfiguration. |
Data[] |
getConfigurationData(Collection<SystemObject> objects,
AttributeGroup atg)
Liefert die konfigurierenden Datensätze einer Attributgruppe für mehrere Objekte zurück. |
Data[] |
getConfigurationData(Collection<SystemObject> objects,
AttributeGroup atg,
Aspect asp)
Liefert die konfigurierenden Datensätze einer Attributgruppe und eines Aspekts für mehrere Objekte zurück. |
Data[] |
getConfigurationData(Collection<SystemObject> objects,
AttributeGroupUsage usage)
Liefert die konfigurierenden Datensätze einer Attributgruppenverwendung für mehrere Objekte zurück. |
Data[] |
getConfigurationData(SystemObject[] objects,
AttributeGroup atg)
Liefert die konfigurierenden Datensätze einer Attributgruppe für mehrere Objekte zurück. |
Data[] |
getConfigurationData(SystemObject[] objects,
AttributeGroup atg,
Aspect aspect)
Liefert die konfigurierenden Datensätze einer Attributgruppe und eines Aspekts für mehrere Objekte zurück. |
Data[] |
getConfigurationData(SystemObject[] objects,
AttributeGroupUsage usage)
Liefert die konfigurierenden Datensätze einer Attributgruppenverwendung für mehrere Objekte zurück. |
ConfigurationManager |
getConfigurationManager()
Liefert das Objekt zur Verwaltung der Kommunikation mit der Konfiguration zurück. |
ClientDavInterface |
getConnection()
Gibt die aktuelle Verbindung zum Datenverteiler zurück. |
SystemObject |
getObject(long id)
Liefert das System-Objekt mit der angegebenen Objekt-ID zurück. |
SystemObject |
getObject(String pid)
Liefert das System-Objekt mit der angegebenen PID zurück. |
List |
getObjectDataValues(SystemObject object,
AttributeGroup attributeGroup)
Deprecated. Zum Lesen von konfigurierenden Datensätzen sollten die Methoden getConfigurationData(java.util.Collection und SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup) verwendet werden. |
Collection<SystemObject> |
getObjects(Collection<ConfigurationArea> configurationAreas,
Collection<SystemObjectType> systemObjectTypes,
ObjectTimeSpecification objectTimeSpecification)
Gibt die Objekte zurück, die in einem der angegebenen Konfigurationsbereiche sind und deren Objekttyp in der angegebenen Objekttyp-Menge ist. |
Collection<SystemObject> |
getObjects(String pid,
long startTime,
long endTime)
Gibt die Objekte zurück, die zu der angegebenen Pid in dem angegebenen Zeitraum gültig waren. |
ObjectSetType |
getObjectSetType(String pid)
Liefert das Mengen-Typ-Objekt mit der angegebenen PID zurück. |
ConfigurationRequester |
getRequester()
Mit dem zurückgegebenen Objekt können Anfragen an eine Konfiguration gestellt werden. |
SystemObjectType |
getType(String pid)
Liefert das Typ-Objekt mit der angegebenen PID zurück. |
SystemObjectType |
getTypeTypeObject()
Liefert das Systemobjekt, das den Typ von Typobjekten darstellt. |
UserAdministration |
getUserAdministration()
Gibt ein Objekt zurück, mit dem die Benutzer der Konfiguration verwaltet werden können. |
void |
init(ConfigurationManager configurationManager,
long configurationAuthorityId)
Initialisiert dieses Objekt nach erfolgreichem Verbindungsaufbau mit dem Datenverteiler |
void |
loadLocalConfigurationCache()
Liest lokal zwischengespeicherte Konfigurationsobjekte und konfigurierende Datensätze ein, falls in dem entsprechenden Aufrufparameter ein Verzeichnis angegeben wurde und dort eine passende Datei vorhanden ist. |
void |
newDynamicObjectCreated(long objectId,
long typeId)
Diese Methode wird aufgerufen, wenn die Konfiguration propagiert, dass ein neues dynamisches Objekt erzeugt wurde. |
void |
update(ConfigTelegram telegram)
Diese Methode wird aufgerufen, wenn eine Antwort auf eine Konfigurationsanfrage empfangen wurde. |
void |
updateName(long objectId,
long typeId,
String newName)
Diese Methode wird aufgerufen, wenn die Konfiguration eine Namensänderung eines dynamischen Objekts propagiert hat. |
void |
updateNotValidSince(long objectId,
long typeId,
long invalidTime)
Diese Methode wird aufgerufen, wenn die Konfiguration propagiert, dass ein dynamisches Objekt ungültig wurde. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public DafDataModel(ClientDavInterface connection)
connection
- Verbindung zum Datenverteiler.Method Detail |
---|
public void init(ConfigurationManager configurationManager, long configurationAuthorityId)
configurationManager
- Objekt zur Verwaltung der Kommunikation mit der KonfigurationconfigurationAuthorityId
- Die Objekt-Id des Konfigurationsverantwortlichenpublic void loadLocalConfigurationCache()
public final void close()
public ConfigurationRequester getRequester()
public ClientDavInterface getConnection()
public final ConfigurationManager getConfigurationManager()
null
, falls es noch nicht gesetzt wurde.init(de.bsvrz.dav.daf.main.impl.ConfigurationManager,long)
public final Aspect getAspect(String pid)
DataModel
getAspect
in interface DataModel
pid
- Die permanente ID des Aspekts.
null
, wenn es kein Objekt mit der gewünschten PID gibt.public final AttributeGroup getAttributeGroup(String pid)
DataModel
getAttributeGroup
in interface DataModel
pid
- Die permanente ID der Attributgruppe
null
, wenn es kein Objekt mit der gewünschten PID gibt.public final AttributeType getAttributeType(String pid)
DataModel
getAttributeType
in interface DataModel
pid
- Die permanente ID des Attribut-Typs
null
, wenn es kein Objekt mit der angegebenen PID gibt.public final SystemObjectType getType(String pid)
DataModel
getType
in interface DataModel
pid
- Die permanente ID des Typ-Objekts
null
, wenn es kein Objekt mit der angegebenen PID gibt.public final ObjectSetType getObjectSetType(String pid)
DataModel
getObjectSetType
in interface DataModel
pid
- Die permanente ID des Mengen-Typ-Objekts
null
, wenn es kein Objekt mit der angegebenen PID gibt.public final SystemObjectType getTypeTypeObject()
DataModel
getTypeTypeObject
in interface DataModel
public final List getBaseTypes()
DataModel
getBaseTypes
in interface DataModel
public final SystemObject getObject(long id)
DataModel
getObject
in interface DataModel
getObject
in interface ObjectLookup
id
- Die Objekt-ID des System-Objekts
null
, wenn es kein Objekt mit der angegebenen ID gibt.DataModel
public SystemObject getObject(String pid)
DataModel
getObject
in interface DataModel
getObject
in interface ObjectLookup
pid
- Die permanente ID des System-Objekts
null
, wenn es kein Objekt mit der angegebenen PID gibt.DataModel
public final ConfigurationObject createConfigurationObject(ConfigurationObjectType type, String pid, String name, List sets) throws ConfigurationChangeException
DataModel
createConfigurationObject
in interface DataModel
type
- Typ des neuen Objekts.pid
- PID des neuen Objekts.name
- Name des neuen Objekts.sets
- Liste der Mengen des neuen Objekts oder null
, wenn kein Mengen vergeben werden sollen.
ConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.ConfigurationObject
,
SystemObject.isValid()
public final DynamicObject createDynamicObject(SystemObjectType type, String pid, String name) throws ConfigurationChangeException
DataModel
createDynamicObject
in interface DataModel
type
- Typ des neuen Objektspid
- PID des neuen Objekts.name
- Name des neuen Objekts.
ConfigurationChangeException
- Wenn das Objekt nicht erzeugt werden konnte.SystemObject
,
SystemObject.isValid()
public DafConfigurationArea getConfigurationArea(String pid)
DataModel
getConfigurationArea
in interface DataModel
pid
- die Pid des Konfigurationsbereichs
public ConfigurationAuthority getConfigurationAuthority()
DataModel
getConfigurationAuthority
in interface DataModel
public String getConfigurationAuthorityPid()
DataModel
getConfigurationAuthorityPid
in interface DataModel
public Collection<SystemObject> getObjects(String pid, long startTime, long endTime)
DataModel
getObjects
in interface DataModel
pid
- die Pid der gewünschten ObjektestartTime
- der zu betachtende Startzeitpunkt des AnfragezeitraumsendTime
- der zu betrachtende Endzeitpunkt des Anfragezeitraums
public Collection<SystemObject> getObjects(Collection<ConfigurationArea> configurationAreas, Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification objectTimeSpecification)
DataModel
getObjects
in interface DataModel
configurationAreas
- Konfigurationsbereiche, die zu berücksichtigen sind. Wird null
übergeben, so gilt dies als Wildcard und alle
Konfigurationsbereiche werden betrachtet.systemObjectTypes
- Objekttypen, die zu berücksichtigen sind. Wird null
übergeben, so gilt dies als Wildcard und alle Objekttypen
werden betrachtet.objectTimeSpecification
- Gibt den Gültigkeitsbereich der geforderten Objekte an.
public UserAdministration getUserAdministration()
DataModel
getUserAdministration
in interface DataModel
@Deprecated public final List getObjectDataValues(SystemObject object, AttributeGroup attributeGroup)
getConfigurationData(java.util.Collection, de.bsvrz.dav.daf.main.config.AttributeGroup)
und SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup)
verwendet werden.
object
- Objekt des gewünschten DatensatzesattributeGroup
- Attributgruppe des gewünschten Datensatzes
public final void update(ConfigTelegram telegram)
telegram
- Telegramm mit der empfangenen Antwort aus der Konfiguration.public Data[] getConfigurationData(Collection<SystemObject> objects, AttributeGroup atg)
DataModel
asp.eigenschaften
angenommen.
Die zurückgelieferten Datensätze werden auch lokal zwischengespeichert und können mit der Methode SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup)
ohne weitere
Konfigurationsanfrage abgefragt werden. Die Methode kann somit zur Minimierung der Anzahl von Konfigurationsanfragen und den damit verbundenen
Verzögerungszeiten eingesetzt werden.
getConfigurationData
in interface DataModel
objects
- Systemobjekte
der gewünschten konfigurierenden Datensätze.atg
- Attributgruppe der gewünschten Datensätze.
objects
einen
korrespondierender konfigurierender Datensatz oder null
, wenn das Objekt keinen Datensatz der angegebenen Attributgruppe-Aspekt
Kombination hat.public void updateName(long objectId, long typeId, String newName)
UpdateDynamicObjects
SystemObject.setName(String)
Methode benutzt werden, weil dadurch erneut eine Anfrage an die Konfiguration
verschickt werden würde.
Der beschriebene Mechanismus muss nur durchgeführt werden wenn: Sich das Objekt im Cache des Meta-Datamodells befindet oder ein Listener auf
Namensänderungen für den Typ des Objekt angemeldet ist.
Sind beide Bedingungen nicht erfüllt kann die Namensänderung verworfen werden.
updateName
in interface UpdateDynamicObjects
objectId
- Id des Objekts, dessen Name aktualisiert werden solltypeId
- Typ des Objekts, der informiert wird, dass sich der Name eines Objekts geändert hatnewName
- Neuer Name des Objektspublic void updateNotValidSince(long objectId, long typeId, long invalidTime)
UpdateDynamicObjects
SystemObject.isValid()
muss false zurück geben. Der Typ des Objekts muss ebenfalls informatiert werden, dass das
Objekt nicht mehr gültig ist. Dies ist nötig, weil eventuell Listener auf diese Änderungen angemeldet sind.
Der beschriebene Mechanismus muss nur durchgeführt werden wenn: Sich das Objekt im Cache des Meta-Datamodells befindet oder ein Listener auf Invalidation
für den Typ des Objekt angemeldet ist.
Sind beide Bedingungen nicht erfüllt kann die Änderung verworfen werden.
updateNotValidSince
in interface UpdateDynamicObjects
objectId
- Id des Objekts, dessen UngültigAb-Wert aktualisiert werden solltypeId
- Typ des Objekts, der informiert wird, dass das Objekt ungültig geworden istinvalidTime
- Zeitpunkt, an dem das Objekt ungültig wurdepublic void newDynamicObjectCreated(long objectId, long typeId)
UpdateDynamicObjects
newDynamicObjectCreated
in interface UpdateDynamicObjects
objectId
- Objekt, das neu angelegt wurdetypeId
- Typ des neuen Objekts. Dieser Typ wird darüber informiert, dass ein neues Objekt angelegt wurde.public Data[] getConfigurationData(Collection<SystemObject> objects, AttributeGroupUsage usage)
SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup)
ohne weitere Konfigurationsanfrage
abgefragt werden. Die Methode kann somit zur Minimierung der Anzahl von Konfigurationsanfragen und den damit verbundenen Verzögerungszeiten eingesetzt
werden.
objects
- Liste der Systemobjekten
der gewünschten konfigurierenden Datensätze.usage
- Attributgruppenverwendung der gewünschten Datensätze.
objects
einen
korrespondierender konfigurierender Datensatz oder null
, wenn das Objekt keinen Datensatz der angegebenen Attributgruppenverwendung
Kombination hat.public Data[] getConfigurationData(Collection<SystemObject> objects, AttributeGroup atg, Aspect asp)
DataModel
SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup)
ohne weitere Konfigurationsanfrage abgefragt werden. Die
Methode kann somit zur Minimierung der Anzahl von Konfigurationsanfragen und den damit verbundenen Verzögerungszeiten eingesetzt werden.
getConfigurationData
in interface DataModel
objects
- Liste der Systemobjekte
der gewünschten konfigurierenden Datensätze.atg
- Attributgruppe der gewünschten Datensätze.asp
- Aspekt der gewünschten Datensätze.
objects
einen
korrespondierender konfigurierender Datensatz oder null
, wenn das Objekt keinen Datensatz der angegebenen Attributgruppe-Aspekt
Kombination hat.public Data[] getConfigurationData(SystemObject[] objects, AttributeGroup atg)
DataModel
asp.eigenschaften
angenommen.
Die zurückgelieferten Datensätze werden auch lokal zwischengespeichert und können mit der Methode SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup)
ohne weitere
Konfigurationsanfrage abgefragt werden. Die Methode kann somit zur Minimierung der Anzahl von Konfigurationsanfragen und den damit verbundenen
Verzögerungszeiten eingesetzt werden.
getConfigurationData
in interface DataModel
objects
- Array mit den Systemobjekten
der gewünschten konfigurierenden Datensätze.atg
- Attributgruppe der gewünschten Datensätze.
objects
einen
korrespondierender konfigurierender Datensatz oder null
, wenn das Objekt keinen Datensatz der angegebenen Attributgruppe-Aspekt
Kombination hat.public Data[] getConfigurationData(SystemObject[] objects, AttributeGroup atg, Aspect aspect)
DataModel
SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup)
ohne weitere Konfigurationsanfrage abgefragt werden. Die
Methode kann somit zur Minimierung der Anzahl von Konfigurationsanfragen und den damit verbundenen Verzögerungszeiten eingesetzt werden.
getConfigurationData
in interface DataModel
objects
- Array mit den Systemobjekten
der gewünschten konfigurierenden Datensätze.atg
- Attributgruppe der gewünschten Datensätze.aspect
- Aspekt der gewünschten Datensätze.
objects
einen
korrespondierender konfigurierender Datensatz oder null
, wenn das Objekt keinen Datensatz der angegebenen Attributgruppe-Aspekt
Kombination hat.public Data[] getConfigurationData(SystemObject[] objects, AttributeGroupUsage usage)
SystemObject.getConfigurationData(de.bsvrz.dav.daf.main.config.AttributeGroup)
ohne weitere Konfigurationsanfrage
abgefragt werden. Die Methode kann somit zur Minimierung der Anzahl von Konfigurationsanfragen und den damit verbundenen Verzögerungszeiten eingesetzt
werden.
objects
- Array mit den Systemobjekten
der gewünschten konfigurierenden Datensätze.usage
- Attributgruppenverwendung der gewünschten Datensätze.
objects
einen
korrespondierender konfigurierender Datensatz oder null
, wenn das Objekt keinen Datensatz der angegebenen Attributgruppenverwendung
Kombination hat.public short getActiveVersion(ConfigurationArea configurationArea)
DataModel
getActiveVersion
in interface DataModel
configurationArea
- der Konfigurationsbereich
public final long getConfigurationAuthorityId()
public AttributeGroupUsage getAttributeGroupUsage(long usageIdentification)
DataModel
getAttributeGroupUsage
in interface DataModel
usageIdentification
- Identifizierung dieser Attributgruppenverwendung bei der Kommunikation über den Datenverteiler.
null
, wenn es keine Attributgruppenverwendung mit der angegebenen
Identifizierung gibt.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |