org.lsst.ccs.config.remote

Class CCSBusesConfigurationDAO

java.lang.Object

org.lsst.ccs.config.remote.CCSBusesConfigurationDAO

All Implemented Interfaces:

ConfigurationDAO

public class CCSBusesConfigurationDAO
extends Object
implements ConfigurationDAO

Implementation of the remote configuration proxy, through the CCS Buses. It interacts with the server side configuration system through the CCS Buses

Author:

LSST CCS Team

Constructor Summary

Constructors

Constructor and Description
CCSBusesConfigurationDAO(AgentMessagingLayer aml, String sourceName)

Method Summary

Modifier and Type	Method and Description
Set<String>	findAvailableConfigurationsForCategory(String category)
boolean	isAvailable() Checks whether the configuration service is unavailable or not.
ConfigurationView	loadConfiguration(ConfigurationDescription configDesc) Load the provided ConfigurationDescription.
ConfigurationView	loadGlobalConfiguration(String name, int version) Loads a pre-defined combination of category configurations.
ConfigurationDescription	registerConfiguration(org.lsst.ccs.bus.data.ConfigurationInfo configInfo) Request for a registration to the remote configuration server
ConfigurationDescription	saveChangesForCategoriesAs(ConfigurationDescription configDesc, org.lsst.ccs.bus.data.ConfigurationInfo configInfo) Changes made in the specified categories are saved under the newly specified name for this category, changes on parameters that belong to other categories are left unchanged.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.lsst.ccs.config.ConfigurationDAO

locateConfigurations

Constructor Detail

CCSBusesConfigurationDAO

public CCSBusesConfigurationDAO(AgentMessagingLayer aml,
                                String sourceName)

Method Detail

saveChangesForCategoriesAs

public ConfigurationDescription saveChangesForCategoriesAs(ConfigurationDescription configDesc,
                                                           org.lsst.ccs.bus.data.ConfigurationInfo configInfo)
                                                    throws ConfigurationServiceException

Description copied from interface: ConfigurationDAO

Changes made in the specified categories are saved under the newly specified name for this category, changes on parameters that belong to other categories are left unchanged.

Specified by:

saveChangesForCategoriesAs in interface ConfigurationDAO

Parameters:

configDesc - the categories to save and their new tag

configInfo - the current configuration info

Returns:

for each category, the name and version of the resulted configuration

Throws:

ConfigurationServiceException - if the configuration service is not available.

loadConfiguration

public ConfigurationView loadConfiguration(ConfigurationDescription configDesc)
                                    throws ConfigurationServiceException

Description copied from interface: ConfigurationDAO

Load the provided ConfigurationDescription. The configuration context remains active

Specified by:

loadConfiguration in interface ConfigurationDAO

Parameters:

configDesc - the description of the configuration to load.

Returns:

a ConfigurationView representing the new values to apply to the parameters. Return null if there is no configuration for the provided description.

Throws:

ConfigurationServiceException - TO-DO: with the current implementation the method signature could be changed to: loadConfiguration(String category, String tag, int version);

loadGlobalConfiguration

public ConfigurationView loadGlobalConfiguration(String name,
                                                 int version)

Description copied from interface: ConfigurationDAO

Loads a pre-defined combination of category configurations.

Specified by:

loadGlobalConfiguration in interface ConfigurationDAO

version - the version of the global configuration tag. If negative, returns the latest version

Returns:

findAvailableConfigurationsForCategory

public Set<String> findAvailableConfigurationsForCategory(String category)

Specified by:

findAvailableConfigurationsForCategory in interface ConfigurationDAO

isAvailable

public boolean isAvailable()

Description copied from interface: ConfigurationDAO

Checks whether the configuration service is unavailable or not.

Specified by:

isAvailable in interface ConfigurationDAO

Returns:

true if the configuration service is available, false otherwise.

registerConfiguration

public ConfigurationDescription registerConfiguration(org.lsst.ccs.bus.data.ConfigurationInfo configInfo)
                                               throws ConfigurationServiceException

Description copied from interface: ConfigurationDAO

Request for a registration to the remote configuration server

Specified by:

registerConfiguration in interface ConfigurationDAO

Parameters:

configInfo - a ConfigurationInfo object that describes the current subsystem's configuration state

Returns:

for each category, the name and version of the resulted configuration

Throws:

ConfigurationServiceException