org.lsst.ccs.config

Interface ConfigurationProxy

All Known Implementing Classes:

LocalConfigurationProxy

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
ConfigurationInfo	buildConfigurationInfo(ConfigurationState configState, Set<ParameterPath> recentChangesNames) Builds a ConfigurationInfo object reflecting the configuration state and ready to be sent on the buses.
Set<String>	findAvailableConfigurationsForCategory(String category)
Set<String>	getCategorySet()
Map<String,String>	getCurrentValuesForComponent(String componentName, Set<String> categories) Returns the current value of parameters that belong to the given category for the given configurable component
Map.Entry<ConfigurationState,Set<ParameterConfiguration>>	getInitialParameterConfigurations(Map<String,String> taggedCategories) To be invoked before startup.
Map<String,String>	getTaggedCategoriesForCats(Set<String> categories)
String	getTagName() the current tag name (can be null or empty)
boolean	isDirty()
Boolean	isParameterConfigurable(String componentName, String parameterName) Checks if a parameter named parameterName is part of the configuration data.
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	notifyParameterChange(String componentName, String parameterName, String stringValue) second part of a two phase commit.
void	notifyUncheckedParameterChange(String componentName, String parameterName, Object Value) notifies directly of a change without preliminary check to the configuration service.
void	saveChangesForCategoriesAs(Map<String,String> taggedCategories) 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.
void	saveModifications(Map<String,String> categoryProfile)
void	setDefaultValueForParameter(String componentName, String parameterName, Object val)
void	writeMissingDefaultConfigs()

Method Detail

buildConfigurationInfo

ConfigurationInfo buildConfigurationInfo(ConfigurationState configState,
                                         Set<ParameterPath> recentChangesNames)

Builds a ConfigurationInfo object reflecting the configuration state and ready to be sent on the buses.

Parameters:

configState -

recentChangesNames -

Returns:

the ConfigurationInfo object

getCategorySet

Set<String> getCategorySet()

Returns:

the set of categories the subsystem has its parameters split into

getTagName

String getTagName()

the current tag name (can be null or empty)

Returns:

the tag of the subsystem this configuration proxy is running for

getInitialParameterConfigurations

Map.Entry<ConfigurationState,Set<ParameterConfiguration>> getInitialParameterConfigurations(Map<String,String> taggedCategories)

To be invoked before startup. Returns the set of ParameterConfiguration to apply to the subsystem description before startup and the configuration state the associated ConfigurableSubsystem will start with. This state is CONFIGURED if access to the configuration service is successful, UNCONFIGURED if not. In that case, the subsystem is started with parameters set to the default value specified in the subsystem description.

Parameters:

taggedCategories - the name of the initial configuration.

Returns:

the initial configuration state and a set of ParameterConfiguration.

isParameterConfigurable

Boolean isParameterConfigurable(String componentName,
                                String parameterName)

Checks if a parameter named parameterName is part of the configuration data.

Parameters:

componentName - the name of the component

parameterName - the name of the parameter

Returns:

true if the parameter is part of the configuration data, false otherwise.

notifyParameterChange

void notifyParameterChange(String componentName,
                           String parameterName,
                           String stringValue)

second part of a two phase commit. this new value is registered as a new version of configuration data.

Parameters:

componentName -

parameterName -

stringValue -

notifyUncheckedParameterChange

void notifyUncheckedParameterChange(String componentName,
                                    String parameterName,
                                    Object Value)

notifies directly of a change without preliminary check to the configuration service. Use at you own risk!

Parameters:

componentName -

parameterName -

Value -

saveChangesForCategoriesAs

void saveChangesForCategoriesAs(Map<String,String> taggedCategories)
                         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 - a list of pairs categoryName:configurationName

Throws:

ConfigurationServiceException - if the configuration service is not available.

getCurrentValuesForComponent

Map<String,String> getCurrentValuesForComponent(String componentName,
                                                Set<String> categories)

Returns the current value of parameters that belong to the given category for the given configurable component

Parameters:

componentName - the name of the configurable component

categories -

Returns:

a map from parameter name to its current value.

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

saveModifications

void saveModifications(Map<String,String> categoryProfile)

isDirty

boolean isDirty()

getTaggedCategoriesForCats

Map<String,String> getTaggedCategoriesForCats(Set<String> categories)

setDefaultValueForParameter

void setDefaultValueForParameter(String componentName,
                                 String parameterName,
                                 Object val)

writeMissingDefaultConfigs

void writeMissingDefaultConfigs()

findAvailableConfigurationsForCategory

Set<String> findAvailableConfigurationsForCategory(String category)