Interface ConfigurationObject

    • Method Detail

      • getValidSince

        short getValidSince()
        Liefert die Versionsnummer der Konfiguration ab der dieses Konfigurationsobjekt gültig ist.
        Returns:
        Version ab der das Objekt gültig ist.
      • getNotValidSince

        short getNotValidSince()
        Liefert die Versionsnummer der Konfiguration ab der dieses Konfigurationsobjekt nicht mehr gültig ist.
        Returns:
        Versionsnummer der Konfiguration ab der dieses Konfigurationsobjekt nicht mehr gültig ist. Wenn das Objekt noch nicht mit der Methode SystemObject.invalidate() ungültig gemacht worden ist, dann wird der Wert 0 zurückgegeben.
      • getNonMutableSet

        NonMutableSet getNonMutableSet​(java.lang.String name)
        Liefert eine diesem Konfigurations-Objekt zugeordnete nicht online änderbare Menge zurück.
        Parameters:
        name - Der Name der gewünschten Menge
        Returns:
        Gewünschte Konfigurationsmenge oder null, wenn die spezifizierte Menge nicht vorhanden ist.
      • getMutableSet

        MutableSet getMutableSet​(java.lang.String name)
        Liefert eine diesem Konfigurations-Objekt zugeordnete online änderbare Menge zurück.
        Parameters:
        name - Der Name der gewünschten Menge
        Returns:
        Gewünschte dynamische Menge oder null, wenn die spezifizierte Menge nicht vorhanden ist.
      • getObjectSet

        ObjectSet getObjectSet​(java.lang.String name)
        Liefert eine diesem Konfigurations-Objekt zugeordnete Objekt-Menge zurück. Wenn die spezifizierte Objekt-Menge nicht online änderbar ist, dann unterstützt die zurückgegebene Menge die Schnittstelle für nicht online änderbare Mengen. Wenn die Menge online änderbar ist, dann unterstützt das zurückgegebene Mengenobjekt die Schnittstelle für online änderbare Mengen.
        Parameters:
        name - Der Name der gewünschten Menge
        Returns:
        Menge von System-Objekten oder null, wenn die spezifizierte Menge nicht vorhanden ist.
      • revalidate

        void revalidate()
                 throws ConfigurationChangeException
        Macht ein bereits als ungültig markiertes Objekt wieder gültig. Wenn ein Konfigurationsobjekt mit der Methode SystemObject.invalidate() für eine zukünftige Konfigurationsversion als ungültig markiert wurde und diese Konfigurationsversion noch nicht aktiviert wurde, dann kann das Objekt durch Aufruf dieser Methode wieder gültig gemacht werden.
        Throws:
        ConfigurationChangeException - Wenn das Objektes nicht wieder gültig gemacht werden konnte.
      • duplicate

        SystemObject duplicate()
                        throws ConfigurationChangeException
        Dupliziert ein Konfigurationsobjekt. Es ist zu beachten, dass Komponenten nicht isoliert dupliziert werden können, sondern im Sinne der Komposition immer nur ganze Objekt-Einheiten zusammen dupliziert werden können, d.h. ausgehend von einem freien Objekt wird das Objekt mit all seinen Komponenten rekursiv dupliziert. Das Duplikat wird mit Aktivierung der in Bearbeitung befindlichen neuen Version des jeweiligen Konfigurationsbereichs gültig. Da die Pids gleich bleiben, muss zuvor das "alte" Objekt gelöscht werden.
        Returns:
        Das Duplikat dieses Konfigurationsobjekts.
        Throws:
        ConfigurationChangeException - Falls das Objekt kein freies Objekt ist und das Duplizieren nicht erlaubt ist oder das Duplikat nicht erstellt werden konnte.
        See Also:
        duplicate(java.util.Map)
      • duplicate

        SystemObject duplicate​(java.util.Map<java.lang.String,​java.lang.String> substitudePids)
                        throws ConfigurationChangeException
        Dupliziert ein Konfigurationsobjekt. Es ist zu beachten, dass Komponenten nicht isoliert dupliziert werden können, sondern im Sinne der Komposition immer nur ganze Objekt-Einheiten zusammen dupliziert werden können, d.h. ausgehend von einem freien Objekt wird das Objekt mit all seinen Komponenten rekursiv dupliziert. Das Duplikat wird mit Aktivierung der in Bearbeitung befindlichen neuen Version des jeweiligen Konfigurationsbereichs gültig.

        Zu ersetzende Pids der Komponenten können in der Map (altePid, neuePid) übergeben werden. Nicht ersetzte Pids, deren Objekte aber durch Komposition an die Objekt-Einheit gebunden sind, müssen vor Aktivierung gelöscht werden.

        Parameters:
        substitudePids - Map, die die Wert-Paare (altePid, neuePid) enthält.
        Returns:
        Das Duplikat dieses Konfigurationsobjekts.
        Throws:
        ConfigurationChangeException - Falls das Objekt kein freies Objekt ist und das Duplizieren nicht erlaubt ist oder das Duplikat nicht erstellt werden konnte.
        See Also:
        duplicate()
      • addSet

        void addSet​(ObjectSet set)
             throws ConfigurationChangeException
        Ordnet dem Konfigurationsobjekt eine weitere Menge zu. Die Zuordnung wird erst mit der nächsten Konfigurationsversion gültig.
        Parameters:
        set - Menge, die dem Konfigurationsobjekt zugeordnet werden soll.
        Throws:
        ConfigurationChangeException - Wenn die Menge nicht hinzugefügt werden konnte.
      • removeSet

        void removeSet​(ObjectSet set)
                throws ConfigurationChangeException
        Entfernt die Zuordnung von diesem Konfigurationsobjekt zu einer Menge. Die Änderung wird erst mit der nächsten Konfigurationsversion gültig.
        Parameters:
        set - Menge, die entfernt werden soll.
        Throws:
        ConfigurationChangeException - Wenn die Menge nicht entfernt werden konnte.