Interface ConfigurationStore


public interface ConfigurationStore
Deprecated.
Use org.osgi.service.cm.ConfigurationAdmin
A storehouse for configuraitons. This class can be used to add, remove and retrieve configurations. A configuration is named and the name is used to as a key to distinguish between different configurations. To listen to changes to a specific configuration you need to know that configurations name and add a listener to the store in which the configuration resides. The listener will be notified when any configuration in the store changes and it is up to the listener implementation to use the configuration name to distinguish between what is relevant to the listener and what is not.
  • Method Details

    • addConfiguration

      void addConfiguration(Configuration cp)
      Deprecated.
      Adds a new configuration to the store. This will also persist the configuraiton to some storage (database, filesystem...).
      Parameters:
      cp - The new configuration.
    • removeConfiguration

      Configuration removeConfiguration(String name)
      Deprecated.
      Removes a named configuration from the store and also removes the configuration from the storage (which can be any medium).
      Parameters:
      name - The name of the configuration to remove.
      Returns:
      The removed Configuration.
    • getConfiguration

      Configuration getConfiguration(String name)
      Deprecated.
      Returns a named configuration.
      Parameters:
      name - The name of the configuration to be returned.
      Returns:
      A configuration with the name name.
    • addConfigurationListener

      void addConfigurationListener(ConfigurationListener listener)
      Deprecated.
      Adds a listener to this store. The listener will be notified of changes to any of the configurations in the store.
      Parameters:
      listener - The listener to register.
    • removeConfigurationListener

      void removeConfigurationListener(ConfigurationListener listener)
      Deprecated.
      Removes a listener from the store. The listener will not recieve any more events from this store.
      Parameters:
      listener - The listener to remove.
    • createEmptyConfiguration

      Configuration createEmptyConfiguration(String name)
      Deprecated.
      Factory method for convenience. With this a bundle creator will not have to implement her own Configuration. This is only a factory method and therefore, when the configuration is setup properly, it must be added to the store to get persisted.
      Parameters:
      name - The name of the configuration, as remembered by the bundle
      Returns:
      A new configuration (not stored!).