org.lsst.ccs.config

Interface ConfigurationProxy

public interface ConfigurationProxy

Subsystem access to configuration information.

BEWARE: there are two potential sources for description and configuration (database or/and local file) and two potential sink when registering changes (database or/and local file). There may be potential concurrency issues (mostly when dealing with the remote database) and so commands that fire the modifications should be sure to get a proper lock from the lock manager.

Author:

bamade

Method Summary

Modifier and Type	Method and Description
Set<String>	findAvailableConfigurationsForCategory(String category)
boolean	isAvailable() Checks whether the configuration service is unavailable or not.
Map<String,Properties>	loadCategories(Map<String,String> taggedCategories) For each pair 'category:configuration' in taggedCategories, the category is loaded with its specified configuration, categories that are not mentioned are left untouched.
void	saveChangesForCategoriesAs(Map<String,String> taggedCategories, List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> values) 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.

Method Detail

saveChangesForCategoriesAs

void saveChangesForCategoriesAs(Map<String,String> taggedCategories,
                                List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> values)
                         throws ConfigurationServiceException

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.

Parameters:

taggedCategories - the categories to save

values - the view of configuration parameters

Throws:

ConfigurationServiceException - if the configuration service is not available.

loadCategories

Map<String,Properties> loadCategories(Map<String,String> taggedCategories)
                               throws ConfigurationServiceException

For each pair 'category:configuration' in taggedCategories, the category is loaded with its specified configuration, categories that are not mentioned are left untouched. The configuration context remains active

Parameters:

taggedCategories - a list of tagged categories

Returns:

a map of component name to properties

Throws:

ConfigurationServiceException

ConfigurationServiceException

findAvailableConfigurationsForCategory

Set<String> findAvailableConfigurationsForCategory(String category)

isAvailable

boolean isAvailable()

Checks whether the configuration service is unavailable or not.

Returns:

true if the configuration service is available, false otherwise.