public interface ConfigurationRequester
Modifier and Type | Method and Description |
---|---|
ConsistencyCheckResultInterface |
activateConfigurationAreas(Collection<ConfigAreaAndVersion> configurationAreas)
Die Implementierung dieser Methode beauftragt die Konfiguration die angebenen Konfigurationsbereiche zu aktivieren (siehe TPuK1-142).
|
BackupResult |
backupConfigurationFiles(String targetDirectory,
ConfigurationAuthority configurationAuthority,
BackupProgressCallback callback)
Veranlasst die Konfiguration, die Konfigurationsdateien zu sichern.
|
void |
changeElements(ObjectSet set,
SystemObject[] addElements,
SystemObject[] removeElements)
Mittels dieser Methode lassen sich Mengen verändern.
|
void |
changeUserPassword(String orderer,
String ordererPassword,
String user,
String newUserPassword)
Beauftragt die Konfiguration das Passwort eines Benutzers zu ändern.
|
void |
changeUserRights(String orderer,
String ordererPassword,
String user,
boolean adminRights)
Beauftragt die Konfiguration die Rechte eines Benutzers zu ändern.
|
ConsistencyCheckResultInterface |
checkConsistency(Collection<ConfigAreaAndVersion> configurationAreas)
Die Implementierung dieser Methode beauftragt die Konfiguration alle Konfigurationsbereiche einer Konsistenzprüfung zu unterziehen (siehe TPuK1-138).
|
void |
clearSingleServingPasswords(String orderer,
String ordererPassword,
String username)
Löscht alle Einmalpasswörter für einen angegebenen Benutzer.
|
ConfigurationArea |
createConfigurationArea(String name,
String pid,
String authorityPid)
Die Implementierung dieser Methode legt einen neuen Konfigurationsbereich in der lokalen Konfiguration an.
|
ConfigurationObject |
createConfigurationObject(ConfigurationArea configurationArea,
ConfigurationObjectType type,
String pid,
String name,
Collection<? extends ObjectSet> sets)
Verschickt an eine entfernte Konfiguration einen Auftrag ein Konfigurationsobjekt anzulegen.
|
ConfigurationObject |
createConfigurationObject(ConfigurationObjectType type,
String pid,
String name,
Collection<? extends ObjectSet> sets)
Verschickt an eine entfernte Konfiguration einen Auftrag ein Konfigurationsobjekt anzulegen.
|
DynamicObject |
createDynamicObject(ConfigurationArea configurationArea,
DynamicObjectType type,
String pid,
String name)
Verschickt an eine entfernte Konfiguration einen Auftrag ein dynamisches Objekt anzulegen.
|
DynamicObject |
createDynamicObject(ConfigurationArea configurationArea,
DynamicObjectType type,
String pid,
String name,
List<DataAndATGUsageInformation> data)
* Verschickt an eine entfernte Konfiguration einen Auftrag ein dynamisches Objekt anzulegen.
|
DynamicObject |
createDynamicObject(DynamicObjectType type,
String pid,
String name)
Verschickt an eine entfernte Konfiguration einen Auftrag ein dynamisches Objekt anzulegen.
|
void |
createNewUser(String orderer,
String ordererPassword,
String newUsername,
String newUserPid,
String newPassword,
boolean adminRights,
String pidConfigurationArea)
Beauftragt die Konfiguration ein neues Benutzerkonto anzulegen.
|
void |
createNewUser(String orderer,
String ordererPassword,
String newUsername,
String newUserPid,
String newPassword,
boolean adminRights,
String pidConfigurationArea,
Collection<DataAndATGUsageInformation> data)
Beauftragt die Konfiguration ein neues Benutzerkonto anzulegen.
|
void |
createSingleServingPassword(String orderer,
String ordererPassword,
String username,
String singleServingPassword)
Beauftragt die Konfiguration ein Einmal-Passwort zu erzeugen.
|
void |
deleteUser(String orderer,
String ordererPassword,
String userToDelete)
Beauftragt die Konfiguration ein Benutzerkonto zu löschen.
|
SystemObject |
duplicate(SystemObject systemObject,
Map<String,String> substitutePids)
Verschickt an eine entfernte Konfiguration einen Auftrag die Kopie eines Objekts zu erstellen.
|
void |
editConfigurationSet(ConfigurationObject configurationObject,
ObjectSet set,
boolean addSet) |
void |
exportConfigurationAreas(File exportPath,
Collection<String> configurationAreaPids)
Die Implementierung dieser Methode exportiert aus der bestehenden Konfiguration die Versorgungsdateien zu den angegebenen Pids in das angegebene
Verzeichnis.
|
short |
getActiveVersion(ConfigurationArea configurationArea)
Fordert für den angegebenen Bereich die Version an, in der der Bereich aktiv ist.
|
Map<String,ConfigurationArea> |
getAllConfigurationAreas()
Alle Konfigurationsbereichseinträge in der Verwaltungsdatei werden zurückgegeben.
|
byte[][] |
getConfigurationData(SystemObject[] systemObject,
AttributeGroupUsage attributeGroupUsage)
Liefert für die angegebenen Systemobjekte jeweils einen konfigurierenden Datensatz der angegebenen Attributgruppenverwendung zurück.
|
Collection<SystemObject> |
getDirectObjects(ConfigurationArea area,
Collection<SystemObjectType> systemObjectTypes,
ObjectTimeSpecification timeSpecification)
Stellt eine Anfrage an eine entferne Konfiguration und fordert die Objekte an, die direkt von den übergebenen Typen abstammen.
|
SystemObject[] |
getElements(MutableSet set,
long startTime,
long endTime,
boolean validDuringEntirePeriod)
Liefert alle Elemente einer Dynamischen Menge.
|
short |
getModifiableVersion(ConfigurationArea configurationArea)
Neue Version eines Bereichs, die weder zur Übernahme freigegeben noch lokal aktiviert ist.
|
Collection<SystemObject> |
getNewObjects(ConfigurationArea configurationArea)
Beauftragt die Konfiguration alle neuen Objekte eine Konfigurationsbereichs zurückzugeben.
|
Collection<SystemObject> |
getObjects(Collection<ConfigurationArea> configurationAreas,
Collection<SystemObjectType> systemObjectTypes,
ObjectTimeSpecification objectTimeSpecification)
Stellt eine Anfrage an eine entfernte Konfiguration und gibt die Objekte zurück, die in einem der angegebenen Konfigurationsbereiche sind und deren
Objekttyp in der angegebenen Objekttyp-Menge ist.
|
List<SystemObject> |
getObjects(long... id)
Liefert die System-Objekte mit den angegebenen Objekt-IDs zurück.
|
List<SystemObject> |
getObjects(String... pid)
Liefert die System-Objekte mit den angegebenen PIDs zurück.
|
Collection<SystemObject> |
getObjects(String pid,
long startTime,
long endTime)
Verschickt an eine entfernte Konfiguration einen Anfrage, in der alle Objekte, die zu einer Pid gehören, zurückgegeben werden, die im angegebenen
Zeitbereich gültig waren.
|
List<SystemObject> |
getObjectsOfType(SystemObjectType type)
Gibt alle Objekte des angegebenen Typs zurück
|
Collection<SystemObject> |
getSetElements(ObjectSet set,
ObjectTimeSpecification objectTimeSpecification)
Verschickt eine Anfrage an die Konfigration alle Elemente einer Menge zurückzugeben, die zu einem Zeitpunkt/Zeitbereich aktiv waren.
|
Collection<SystemObject> |
getSetElementsInAllVersions(ObjectSet set,
short fromVersion,
short toVersion)
Verschickt einen Auftrag an die Konfiguration alle Elemente einer Menge zurückzugeben, die im angegebenen Versionsbereich durchgängig gültig gewesen sind.
|
Collection<SystemObject> |
getSetElementsInAnyVersions(ObjectSet set,
short fromVersion,
short toVersion)
Verschickt einen Auftrag an die Konfiguration alle Elemente einer Menge zurückzugeben, die im angegebnen Versionsbereich gültig waren.
|
Collection<SystemObject> |
getSetElementsInNextVersion(ObjectSet set)
Verschickt einen Auftrag an die Konfiguration alle Elemente zurückzugeben, die in der nächsten Version gültig werden.
|
Collection<SystemObject> |
getSetElementsInVersion(ObjectSet set,
short version)
Verschickt einen Auftrag an die Konfiguration alle Elemente einer Menge, die in der angegebenen Version gültig gewesen sind, zurückzugeben.
|
int |
getSingleServingPasswordCount(String orderer,
String ordererPassword,
String username)
Ermittelt die Anzahl der noch vorhandenen, gültigen Einmal-Passwörter.
|
void |
importConfigurationAreas(File importPath,
Collection<String> configurationAreaPids)
Die Implementierung dieser Methode importiert die Versorgungsdateien der angegebenen Pids vom angegebenen Verzeichnis in die bestehende Konfiguration.
|
void |
init(long localApplicationId)
Initialisiert den Requester
|
void |
invalidate(SystemObject object)
Verschickt einen Auftrag, ein Objekt zu löschen
|
boolean |
isUserAdmin(String orderer,
String ordererPassword,
String username)
Prüft, ob ein angegebener Benutzer Admin-Rechte besitzt.
|
boolean |
isUserValid(String orderer,
String ordererPassword,
String username)
Prüft, ob ein angegebener Benutzername gültig ist, d.h.
|
void |
releaseConfigurationAreasForActivation(Collection<ConfigAreaAndVersion> configurationAreas)
Die Implementierung dieser Methode beauftragt die Konfiguration die angegebenen Konfigurationsbereiche in den Status "Freigabe zur Aktivierung" zu
überführen.
|
ConsistencyCheckResultInterface |
releaseConfigurationAreasForActivationWithoutCAActivation(Collection<ConfigAreaAndVersion> configurationAreas)
Beauftragt die Konfiguration die angegebenen Bereiche in den vorgegebenen Version für andere Konfiguraiton zur Aktivierung freizugeben obwohl die Bereiche
durch den Konfigurationsverantwortlichen der Bereiche noch nicht lokal aktiviert wurden.
|
ConsistencyCheckResultInterface |
releaseConfigurationAreasForTransfer(Collection<ConfigAreaAndVersion> configurationAreas)
Die Implementierung dieser Methode beauftragt die Konfiguration die angebenen Konfigurationsbereiche in den Status "Freigabe zur Übernahme" zu überführen
(siehe TPuK1-143).
|
void |
revalidate(SystemObject object)
Verschickt einen Auftrag, ein Objekt wiederherzustellen
|
void |
setConfigurationData(AttributeGroupUsage attributeGroupUsage,
SystemObject systemObject,
byte[] data)
Legt an einem Objekt einen konfigurierenden Datensatz fest.
|
void |
setMutableCollectionChangeListener(MutableCollectionChangeListener notifyingMutableCollectionChangeListener)
Setzt den Listener zur Verarbeitung und Verteilung von Aktualisierungsnachrichten bzgl.
|
void |
setName(SystemObject object,
String name)
Verschickt einen Auftrag, ein Objekt umzubenennen
|
void |
subscribe(MutableSet set,
long time)
Meldet die Dynamische Menge bei der Konfiguration an, um sie immer auf dem neuesten Stand zu halten.
|
int |
subscribeConfigurationCommunicationChanges(SystemObject object) |
Collection<SystemObject> |
subscribeMutableCollectionChanges(MutableCollection mutableCollection,
short simVariant)
Sendet ein Anmeldungstelgramm für Aktualisierungsnachrichten bzgl.
|
List<SystemObject> |
subscribeUserChangeListener(MutableCollectionChangeListener listener)
Erstellt einen Listener der Änderungen an den Benutzern überwacht und eine aktuelle Liste aller Benutzer zurückgibt
|
void |
unsubscribe(MutableSet set)
Meldet die Dynamische Menge bei der Konfiguration auf Änderungen wieder ab.
|
void |
unsubscribeConfigurationCommunicationChanges(SystemObject object) |
void |
unsubscribeMutableCollectionChanges(MutableCollection mutableCollection,
short simVariant)
Sendet ein Abmeldungstelgramm zu einer vorher getätigten Anmeldung für Aktualisierungsnachrichten bzgl.
|
void |
unsubscribeUserChangeListener(MutableCollectionChangeListener listener)
Entfernt den mit subscribeUserChangeListener erstellten Listener
|
void init(long localApplicationId) throws CommunicationError
localApplicationId
- Eigene Applikations-IDCommunicationError
List<SystemObject> getObjects(String... pid) throws RequestException
pid
- Die permanente ID des System-Objekts (oder mehrere Pids)RequestException
- Wenn bei der Kommunikation mit der Konfiguration Fehler aufgetreten sind.List<SystemObject> getObjects(long... id) throws RequestException
id
- Die Objekt-ID des System-Objekts (oder mehrere IDs für mehrere Objekte)RequestException
- Wenn bei der Kommunikation mit der Konfiguration Fehler aufgetreten sind.SystemObject[] getElements(MutableSet set, long startTime, long endTime, boolean validDuringEntirePeriod) throws RequestException
set
- die Dynamische MengestartTime
- Startzeitpunkt des zu betrachtenden ZeitraumesendTime
- Endzeitpunkt des zu betrachtenden ZeitraumesvalidDuringEntirePeriod
- ob die Elemente während des gesamten Zeitraumes gültig gewesen sein müssenRequestException
- Wenn bei der Kommunikation mit der Konfiguration Fehler aufgetreten sind.void changeElements(ObjectSet set, SystemObject[] addElements, SystemObject[] removeElements) throws ConfigurationChangeException, RequestException
set
- Menge, in der Elemente hinzugefügt und/oder gelöscht werden könnenaddElements
- Elemente, die der Menge hinzugefügt werden sollen. Sollen keine Elemente hinzugefügt werden, muss null
übergeben werden.removeElements
- Elemente, die aus der Menge entfernt werden sollen. Sollen keine Elemente entfernt werden, muss null
übergeben werden.ConfigurationChangeException
- Wenn eines der übergebenen Objekte nicht in die Menge aufgenommen werden konnte und noch nicht in der Menge enthalten
war.RequestException
- Wenn bei der Kommunikation mit der Konfiguration Fehler aufgetreten sind.void subscribe(MutableSet set, long time) throws RequestException
set
- die Dynamische Mengetime
- Zeitpunkt, ab wann die Dynamische Menge auf Änderungen angemeldet werden soll.RequestException
- Wenn Fehler beim Versand des Telegramms oder bei der Verarbeitung der entsprechenden Antwort aufgetreten sind.void unsubscribe(MutableSet set) throws RequestException
set
- die Dynamische MengeRequestException
- Wenn Fehler beim Versand des Telegramms oder bei der Verarbeitung der entsprechenden Antwort aufgetreten sind.byte[][] getConfigurationData(SystemObject[] systemObject, AttributeGroupUsage attributeGroupUsage) throws RequestException
systemObject
- Array mit Systemobjekten für die Datensätze abgefragt werden sollen.attributeGroupUsage
- Attributgruppenverwendung, die Attributgruppe und Aspekt des Datensatzes festlegt.RequestException
- Wenn bei der Kommunikation mit der Konfiguration Fehler aufgetreten sind.SerializingFactory
void setConfigurationData(AttributeGroupUsage attributeGroupUsage, SystemObject systemObject, byte[] data) throws ConfigurationChangeException, RequestException
attributeGroupUsage
- AttributgruppenverwendungsystemObject
- Objekt, für das der konfigurierende Datensatz gedacht istdata
- Datensatz, der mit einem Serialisierer(Version2) in ein byte-Array zerlegt wurde. Soll ein Datensatz gelöscht werden, wird ein
byte-Array der Größe 0 übergeben.ConfigurationChangeException
- Die Konfiguration konnte den Datensatz nicht dem übergebenen Systemobjekt hinzufügen/entfernen. Ein Grund wäre zum
Beispiel, dass der Konfigurationsverantwortliche nicht die Rechte besitzt Datensätze an dem Objekt zu ändern.RequestException
- Fehler bei der Übertragung. Entweder konnte der Auftrag nicht verschickt werden oder die Antwort der Konfiguration
konnte nicht entschlüsselt werden.void createSingleServingPassword(String orderer, String ordererPassword, String username, String singleServingPassword) throws ConfigurationTaskException
ordererPassword
wird zum verschlüsseln der Nachricht benutzt und darf nicht übertragen werden. In der verschlüsselten Nachricht ist ausserdem
ein Zufallstext enthalten, der von der Konfiguration angefordert werden muss.
Damit dieser Auftrag ausgeführt werden kann, muss der Auftraggeber orderer
besondere Rechte besitzen. Besitzt der Auftraggeber diese Rechte
nicht, wird der Auftrag zwar zur Konfiguration übertragen, dort aber nicht ausgeführt.orderer
- Benutzername des AuftraggebersordererPassword
- Passwort des Auftraggebers, dies wird zum verschlüsseln benutzt und darf nicht mit übertragen werdenusername
- Benutzername, dem ein Einmal-Passwort hinzugefügt werden soll. Der Name ist zu verschlüsseln.singleServingPassword
- Einmal-Passwort das dem Benutzer, der mit username
identifiziert wird, hinzugefügt wird. Das Einmal-Passwort darf
nur verschlüsselt übertragen werdenConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber
zum Beispiel nicht die nötigen Rechte besitzen ein Einmal-Passwort anzulegen oder das Passwort existiert bereits, usw..
Wird der Auftrag mit den richtigen Parametern übertragen, wird die Konfiguration ihn ausführen.int getSingleServingPasswordCount(String orderer, String ordererPassword, String username) throws ConfigurationTaskException
orderer
- Benutzername des AuftraggebersordererPassword
- Passwort des Auftraggebers, dies wird zum verschlüsseln benutzt und darf nicht mit übertragen werdenusername
- Benutzername, dessen Einmalpasswörter geprüft werden sollen.ConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen.void clearSingleServingPasswords(String orderer, String ordererPassword, String username) throws ConfigurationTaskException
orderer
- Benutzername des AuftraggebersordererPassword
- Passwort des Auftraggebers, dies wird zum verschlüsseln benutzt und darf nicht mit übertragen werdenusername
- Benutzername, dessen Einmalpasswörter gelöscht werden sollen.ConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen.void createNewUser(String orderer, String ordererPassword, String newUsername, String newUserPid, String newPassword, boolean adminRights, String pidConfigurationArea) throws ConfigurationTaskException
orderer
- Benutzername des AuftraggebersordererPassword
- Passwort des Auftraggebers. Das Passwort wird nicht übertragen.newUsername
- Benutzername des neuen BenutzersnewUserPid
- Pid des neuen Benutzers. Wird der Leerstring ("") übergeben, wird dem Benutzer keine explizite Pid zugewiesennewPassword
- Passwort des neuen BenutzersadminRights
- true = Der Benutzer besitzt spezielle Rechte; false = Der Benutzer besitzt keine speziellen RechtepidConfigurationArea
- Pid des Konfigurationsbereichs, in dem der neue Benutzer angelegt werden sollConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber
zum Beispiel nicht die nötigen Rechte besitzen einen neuen Benutzer anzulegen. Wird der Auftrag mit den richtigen
Parametern übertragen, wird die Konfiguration ihn ausführen.void createNewUser(String orderer, String ordererPassword, String newUsername, String newUserPid, String newPassword, boolean adminRights, String pidConfigurationArea, Collection<DataAndATGUsageInformation> data) throws ConfigurationTaskException
orderer
- Benutzername des Auftraggebers.ordererPassword
- Passwort des Auftraggebers.newUsername
- Benutzername des neuen Benutzers.newUserPid
- Pid des neuen Benutzers. Wird der Leerstring ("") übergeben, wird dem Benutzer keine explizite Pid zugewiesen.newPassword
- Passwort des neuen Benutzers.adminRights
- true
, wenn der neue Benutzer die Rechte eines Administrators besitzen soll; false
, wenn der Benutzer
keine speziellen Rechte besitzen soll.pidConfigurationArea
- Pid des Konfigurationsbereichs, in dem der neue Benutzer angelegt werden soll.data
- Konfigurierende Datensätze mit den dazugehörigen Attributgruppenverwendungen, die für das neue Benutzer-Objekt gespeichert
werden sollen. Wird null übergeben, werden keine Konfigurationsdaten angelegt.ConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber zum Beispiel nicht die
nötigen Rechte besitzen einen neuen Benutzer anzulegen.ConfigurationArea.createDynamicObject(de.bsvrz.dav.daf.main.config.DynamicObjectType, String, String, java.util.Collection)
void deleteUser(String orderer, String ordererPassword, String userToDelete) throws ConfigurationTaskException
orderer
- Benutzername des Auftraggebers.ordererPassword
- Passwort des Auftraggebers.userToDelete
- Benutzername des zu löschenden Benutzers.ConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen.boolean isUserAdmin(String orderer, String ordererPassword, String username) throws ConfigurationTaskException
orderer
- Benutzername des Auftraggebers.ordererPassword
- Passwort des Auftraggebers.username
- Name des zu prüfenden BenutzersConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen.boolean isUserValid(String orderer, String ordererPassword, String username) throws ConfigurationTaskException
subscribeUserChangeListener(de.bsvrz.dav.daf.main.config.MutableCollectionChangeListener)
liefert, tatsächlichen zu einem gültigen Benutzer gehören, da subscribeUserChangeListener nur die Systemobjekte berücksichtigt.orderer
- Benutzername des Auftraggebers.ordererPassword
- Passwort des Auftraggebers.username
- Name des zu prüfenden BenutzersConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen.List<SystemObject> subscribeUserChangeListener(MutableCollectionChangeListener listener)
listener
- Objekt, an das Rückmeldungen gesendet werden sollen. null
, wenn nur die Liste der aktuellen Benutzer geholt werden soll.void unsubscribeUserChangeListener(MutableCollectionChangeListener listener)
listener
- Objekt, and das keien Rückmeldungen mehr gesendet werden sollen.void changeUserRights(String orderer, String ordererPassword, String user, boolean adminRights) throws ConfigurationTaskException
orderer
- Auftraggeber, der die Rechte eines Benuters ändern möchteordererPassword
- Passwort des Auftraggebers. Das Passwort wird nicht übertragenuser
- Benutzer, dessen Rechte geändert werden sollenadminRights
- true = Der Benutzer, der mit user
identifiziert wird, erhält spezielle Rechte; false = Der Benutzer der mit
user
identifiziert wird, erhält normale RechteConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber
zum Beispiel nicht die nötigen Rechte besitzen die Rechte eines anderen Benutzers zu ändern. Wird der Auftrag mit den
richtigen Parametern übertragen, wird die Konfiguration ihn ausführen.void changeUserPassword(String orderer, String ordererPassword, String user, String newUserPassword) throws ConfigurationTaskException
ordererPassword
des Auftraggebers orderer
benutzt. Das Passwort ordererPassword
darf nicht
übertragen werden.orderer
- Benutzername des AuftraggebersordererPassword
- derzeit gültiges Passwort, falls der Benutzername orderer
und user
identisch sind. Sind die Parameter nicht
identisch, muss der Benutzer, der mit orderer
identifiziert wird, spezielle Rechte besitzen und sein Passwort übergebenuser
- Benutzername des Benutzerkontos, dessen Passwort geändert werden sollnewUserPassword
- Neues Passwort des Benutzers, der mit user
identifiziert wurdeConfigurationTaskException
- Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber
zum Beispiel nicht die nötigen Rechte besitzen das Passwort eines anderen Benutzers zu ändern oder das Passwort zum
ändern ist falsch. Wird der Auftrag mit den richtigen Parametern übertragen, wird die Konfiguration ihn ausführen.ConsistencyCheckResultInterface checkConsistency(Collection<ConfigAreaAndVersion> configurationAreas) throws RequestException
activateConfigurationAreas(java.util.Collection<de.bsvrz.dav.daf.main.config.management.ConfigAreaAndVersion>)
oder Freigabe releaseConfigurationAreasForTransfer(java.util.Collection<de.bsvrz.dav.daf.main.config.management.ConfigAreaAndVersion>)
stattfinden.configurationAreas
- Definiert alle Konfigurationsbereiche, die einer Konsistenzprüfung unterzogen werden sollen. Der Bereich wird über seine Pid
identifiziert, zusätzlich wird die Version angegeben in der der Konfigurationsbereich geprüft werden soll. Alle Bereiche der
Konfiguration, die nicht angegeben werden, werden in die Prüfung einbezogen und zwar mit ihrer aktuellen Version und müssen somit
nicht expliziet angegeben werden.RequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConsistencyCheckResultInterface activateConfigurationAreas(Collection<ConfigAreaAndVersion> configurationAreas) throws RequestException, ConfigurationChangeException
configurationAreas
- Konfigurationsbereiche, die in der jeweiligen Version aktiviert werden sollenRequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationChangeException
- Falls mindestens ein Konfigurationsbereich nicht aktiviert werden konnte. ConsistencyCheckResultInterface releaseConfigurationAreasForTransfer(Collection<ConfigAreaAndVersion> configurationAreas) throws RequestException, ConfigurationChangeException
configurationAreas
- Konfigurationsbereiche, die in der jeweiligen Version freigegeben werden sollenRequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationChangeException
- Falls mindestens ein Konfigurationsbereich nicht zur Übernahme freigegeben werden konnte. void releaseConfigurationAreasForActivation(Collection<ConfigAreaAndVersion> configurationAreas) throws RequestException, ConfigurationChangeException
activateConfigurationAreas(java.util.Collection<de.bsvrz.dav.daf.main.config.management.ConfigAreaAndVersion>)
wurde.
Es werden entweder alle angegebenen Konfigurationsbereiche in der jeweils geforderten Version aktiviert oder keiner.configurationAreas
- Konfigurationsbereiche, die in der jeweiligen Version für andere Konfigurationen freigegeben werden sollenRequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationChangeException
- Falls mindestens ein Konfigurationsbereich nicht zur Aktivierung freigegeben werden konnte. activateConfigurationAreas(java.util.Collection<de.bsvrz.dav.daf.main.config.management.ConfigAreaAndVersion>)
.ConsistencyCheckResultInterface releaseConfigurationAreasForActivationWithoutCAActivation(Collection<ConfigAreaAndVersion> configurationAreas) throws RequestException, ConfigurationChangeException
configurationAreas
- Bereiche und die jeweiligen Versionen, die für andere freigegeben werden sollen.RequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationChangeException
- Die Konfiguration konnte den Auftrag nicht ausführen (mangelnde Rechte, usw.)Map<String,ConfigurationArea> getAllConfigurationAreas() throws RequestException
RequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationArea createConfigurationArea(String name, String pid, String authorityPid) throws RequestException, ConfigurationChangeException
name
- Name des neuen Konfigurationsbereichspid
- eindeutige Pid des neuen KonfigurationsbereichsauthorityPid
- die Pid des Konfigurationsverantwortlichen des neuen KonfigurationsbereichsRequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationChangeException
- Falls kein neuer Konfigurationsbereich angelegt werden konnte.void importConfigurationAreas(File importPath, Collection<String> configurationAreaPids) throws RequestException, ConfigurationChangeException
exportiert
werden.importPath
- Verzeichnis der VersorgungsdateienconfigurationAreaPids
- Pids der zu importierenden KonfigurationsbereicheRequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationChangeException
- Falls während des Imports Fehler auftreten. Nach Korrektur des Fehlers kann der Import wiederholt werden.void exportConfigurationAreas(File exportPath, Collection<String> configurationAreaPids) throws RequestException, ConfigurationTaskException
importiert
werden.exportPath
- Verzeichnis der VersorgungsdateienconfigurationAreaPids
- Pids der zu exportierenden KonfigurationsbereicheRequestException
- Es ist zu einem Kommunikationsfehler bei der Anfrage gekommen.ConfigurationTaskException
- Die angegebenen Bereiche konnte nicht exportiert werden. Dies kann mehrere Gründe haben (zu einer Pid wurde kein
Konfigurationsbereich gefunden, eine Versorgungsdatei konnte nicht geschrieben werden, usw.).BackupResult backupConfigurationFiles(String targetDirectory, ConfigurationAuthority configurationAuthority, BackupProgressCallback callback) throws ConfigurationTaskException, RequestException
targetDirectory
- Relatives Zielverzeichnis innerhalb des in der Konfiguration (mit dem Parameter -sicherungsVerzeichnis)
festgelegten Sicherungsordners. Wird null oder ein Leerstring angegeben, generiert die Konfiguration aus
aktuellem Datum und Uhrzeit einen neuen Pfadnamen.configurationAuthority
- Verantwortlicher, dessen Konfigurationsdateien gesichert werden sollencallback
- Objekt, an das Statusmeldungen gesendet werdenConfigurationTaskException
- Der Backup-Vorgang konnte nicht durchgeführt werden, beispielsweise weil das Zielverzeichnis falsch
war. Falls das Sichern einzelner Dateien fehlschlägt wird keine solche Exception geworfen,
stattdessen findet man innerhalb vom callback eventuelle Fehlschläge und BackupResult.getFailed ist
größer 0.RequestException
- Fehler bei der Übertragung der Anfrage oder beim Empfang von Statusmeldungen der Konfiguration.
Achtung: Man kann nicht zwingend darauf schließen, dass der Backupvorgang nicht erfolgreich war, wenn
eine Exception geworfen wurde. Wenn während des Vorgangs beispielsweise die Verbindung zwischen
Datenverteiler und Konfiguration abbricht, wird eine Exception geworfen, aber die Konfiguration wird
den Vorgang vermutlich dennoch korrekt beenden.short getActiveVersion(ConfigurationArea configurationArea) throws RequestException
configurationArea
- Bereich, dessen aktive Version angefordert werden sollRequestException
- Fehler bei der Datenübertragungshort getModifiableVersion(ConfigurationArea configurationArea) throws RequestException
configurationArea
- Bereich für den die Version angefordert werden sollRequestException
- Fehler bei der DatenübertragungCollection<SystemObject> getObjects(String pid, long startTime, long endTime) throws RequestException
pid
- Pid der Objekte, die gültig sein sollenstartTime
- StartzeitpunktendTime
- EndzeitpunktRequestException
- Technischer Fehler bei der Übetragung der AnfrageCollection<SystemObject> getObjects(Collection<ConfigurationArea> configurationAreas, Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification objectTimeSpecification) throws RequestException
configurationAreas
- Bereiche, die geprüft werden sollensystemObjectTypes
- Objekttypen, die zu berücksichtigen sindobjectTimeSpecification
- Definiert den zu betrachtenen ZeitbereichRequestException
- Technisches Problem bei der AnfrageCollection<SystemObject> getDirectObjects(ConfigurationArea area, Collection<SystemObjectType> systemObjectTypes, ObjectTimeSpecification timeSpecification) throws RequestException
area
- Bereich, in dem Objekte von den übergebenen Typen gesucht werden sollensystemObjectTypes
- Typen, von dem die Objekte sein müssen, ableitungen werden nicht berücksichtigttimeSpecification
- Zeit, in der die Objekte gültig sein müssenRequestException
- Technisches Problem bei der AnfrageConfigurationObject createConfigurationObject(ConfigurationArea configurationArea, ConfigurationObjectType type, String pid, String name, Collection<? extends ObjectSet> sets) throws ConfigurationChangeException, RequestException
ConfigurationArea.createConfigurationObject(de.bsvrz.dav.daf.main.config.ConfigurationObjectType, java.lang.String, java.lang.String, java.util.Collection<? extends de.bsvrz.dav.daf.main.config.ObjectSet>)
beschrieben.configurationArea
- Bereich, in dem das Objekt angelegt werden solltype
- Typ des neuen Objekts.pid
- Pid des neuen Objekts.name
- Name des neuen Objekts.sets
- Mengen des neuen Objekts.ConfigurationChangeException
- Die Konfiguration kann das Objekt nicht anlegenRequestException
- Technisches Problem bei der Übertragung AnfrageDynamicObject createDynamicObject(ConfigurationArea configurationArea, DynamicObjectType type, String pid, String name) throws ConfigurationChangeException, RequestException
ConfigurationArea.createDynamicObject(de.bsvrz.dav.daf.main.config.DynamicObjectType, String, String)
beschrieben.configurationArea
- Bereich, in dem das Objekt angelegt werden solltype
- Typ des neuen Objekts.pid
- Pid des neuen Objekts.name
- Name des neuen Objekts.ConfigurationChangeException
- Die Konfiguration kann das Objekt nicht anlegenRequestException
- Technisches Problem bei der Übertragung AnfrageDynamicObject createDynamicObject(ConfigurationArea configurationArea, DynamicObjectType type, String pid, String name, List<DataAndATGUsageInformation> data) throws ConfigurationChangeException, RequestException
ConfigurationArea.createDynamicObject(de.bsvrz.dav.daf.main.config.DynamicObjectType,String,String,java.util.Collection)
beschrieben.configurationArea
- Konfigurationsbereich in dem das neue Objekt erzeugt werden soll.type
- Typ des neuen Objekts.pid
- Pid des neuen Objekts.name
- Name des neuen Objekts.data
- Datensätze, die am neuen Objekt gespeichert werden sollen.ConfigurationChangeException
- Die Konfiguration kann das Objekt nicht anlegenRequestException
- Technisches Problem bei der Übertragung AnfrageSystemObject duplicate(SystemObject systemObject, Map<String,String> substitutePids) throws ConfigurationChangeException, RequestException
systemObject
- Objekt, von dem eine Kopie erstellt werden soll.substitutePids
- Enthält Pids, die durch andere Pids ersetzt werden (Key = zu ersetzende Pid; Value = Pid, die den Key ersetzt)ConfigurationChangeException
- Falls das Objekt kein freies Objekt ist und das Duplizieren nicht erlaubt ist oder das Duplikat nicht erstellt werden
konnte.RequestException
- Technisches Problem bei der Übertragung AnfrageCollection<SystemObject> getNewObjects(ConfigurationArea configurationArea) throws RequestException
configurationArea
- Bereich, aus dem alle neuen Objekte angefordert werden sollenRequestException
- Technisches Problem bei der Übertragung AnfrageCollection<SystemObject> getSetElements(ObjectSet set, ObjectTimeSpecification objectTimeSpecification) throws RequestException
set
- Menge, dessen Elemente angefordert werden sollenobjectTimeSpecification
- Legt fest ob ein Zeitpunkt, eine Zeitdauer/Bereich angefragt werden soll.objectTimeSpecification
, gültig waren.RequestException
- Technisches Problem bei der Übertragung AnfrageCollection<SystemObject> getSetElementsInNextVersion(ObjectSet set) throws RequestException
set
- Menge, aus der die Elemente angefordert werden sollen.RequestException
- Technisches Problem bei der Übertragung AnfrageCollection<SystemObject> getSetElementsInVersion(ObjectSet set, short version) throws RequestException
set
- Menge, aus der die Elemente angefordert werden sollen.version
- Version, in der die Elemente gültig gewesen sein müssen.RequestException
- Technisches Problem bei der Übertragung AnfrageCollection<SystemObject> getSetElementsInAllVersions(ObjectSet set, short fromVersion, short toVersion) throws RequestException
set
- Menge, aus der die Elemente angefordert werden sollen.fromVersion
- ab VersiontoVersion
- bis zur VersionRequestException
- Technisches Problem bei der Übertragung AnfrageCollection<SystemObject> getSetElementsInAnyVersions(ObjectSet set, short fromVersion, short toVersion) throws RequestException
set
- Menge, aus der die Elemente angefordert werden sollen.fromVersion
- ab VersiontoVersion
- bis VersionRequestException
- Technisches Problem bei der Übertragung Anfragevoid editConfigurationSet(ConfigurationObject configurationObject, ObjectSet set, boolean addSet) throws ConfigurationChangeException, RequestException
configurationObject
- Konfigurationsobjekt, an dem eine Menge gelöscht oder eine neue Menge hinzugefügt werden soll.set
- Menge, die an dem Objekt gelöscht oder hinzugefügt werden soll.addSet
- true = Die übergebene Menge soll am Objekt hinzugefügt werden; false = Die übergebene Menge soll am Objekt entfernt werden.ConfigurationChangeException
- Die Konfiguration führt den Auftrag nicht aus, weil sie zum Beispiel nicht der Konfigurationsverantwortliche für das zu
ändernde Objekt ist.RequestException
- Technisches Problem bei der Übertragung Anfragevoid setMutableCollectionChangeListener(MutableCollectionChangeListener notifyingMutableCollectionChangeListener)
notifyingMutableCollectionChangeListener
- Listener zur Verarbeitung und Verteilung von Aktualisierungsnachrichten.Collection<SystemObject> subscribeMutableCollectionChanges(MutableCollection mutableCollection, short simVariant) throws RequestException
mutableCollection
- dynamische Menge oder dynamischer Typ, dessen Änderungen von Interesse sind.simVariant
- Simulationsvariante unter der die dynamische Menge oder der dynamische Typ betrachtet werden soll.RequestException
- Wenn Fehler beim Versand des Telegramms oder bei der Verarbeitung der entsprechenden Antwort aufgetreten sind.void unsubscribeMutableCollectionChanges(MutableCollection mutableCollection, short simVariant) throws RequestException
mutableCollection
- dynamische Menge oder dynamischer Typ der zugehörigen Anmeldung.simVariant
- Simulationsvariante der zugehörigen Anmeldung.RequestException
- Wenn Fehler beim Versand des Telegramms oder bei der Verarbeitung der entsprechenden Antwort aufgetreten sind.int subscribeConfigurationCommunicationChanges(SystemObject object) throws RequestException
RequestException
void unsubscribeConfigurationCommunicationChanges(SystemObject object) throws RequestException
RequestException
List<SystemObject> getObjectsOfType(SystemObjectType type) throws RequestException
type
- Systemobjekt-TypRequestException
- Fehler bei Verarbeitung des TelegrammsConfigurationObject createConfigurationObject(ConfigurationObjectType type, String pid, String name, Collection<? extends ObjectSet> sets) throws ConfigurationChangeException, RequestException
ConfigurationArea.createConfigurationObject(de.bsvrz.dav.daf.main.config.ConfigurationObjectType, java.lang.String, java.lang.String, java.util.Collection<? extends de.bsvrz.dav.daf.main.config.ObjectSet>)
beschrieben. Das Objekt wird im Default-Bereich angelegt.type
- Typ des neuen Objekts.pid
- Pid des neuen Objekts.name
- Name des neuen Objekts.sets
- Mengen des neuen Objekts.ConfigurationChangeException
- Die Konfiguration kann das Objekt nicht anlegenRequestException
- Technisches Problem bei der Übertragung AnfrageDynamicObject createDynamicObject(DynamicObjectType type, String pid, String name) throws ConfigurationChangeException, RequestException
ConfigurationArea.createDynamicObject(de.bsvrz.dav.daf.main.config.DynamicObjectType,String,String,java.util.Collection)
beschrieben. Das Objekt wird im Default-Bereich angelegt.type
- Typ des neuen Objekts.pid
- Pid des neuen Objekts.name
- Name des neuen Objekts.ConfigurationChangeException
- Die Konfiguration kann das Objekt nicht anlegenRequestException
- Technisches Problem bei der Übertragung Anfragevoid invalidate(SystemObject object) throws ConfigurationChangeException, RequestException
object
- ObjektConfigurationChangeException
- Die Konfiguration kann das Objekt nicht löschenRequestException
- Technisches Problem bei der Übertragung Anfragevoid revalidate(SystemObject object) throws ConfigurationChangeException, RequestException
object
- ObjektConfigurationChangeException
- Die Konfiguration kann das Objekt nicht wiederherstellenRequestException
- Technisches Problem bei der Übertragung Anfragevoid setName(SystemObject object, String name) throws ConfigurationChangeException, RequestException
object
- Objektname
- neuer NameConfigurationChangeException
- Die Konfiguration kann das Objekt nicht umbenennenRequestException
- Technisches Problem bei der Übertragung Anfrage