org.lsst.ccs.localdb.configdb

Class ConfigurationFacade

java.lang.Object

org.lsst.ccs.localdb.configdb.ConfigurationFacade

public class ConfigurationFacade
extends Object

Configuration database high level facade. Each of its public methods is responsible for opening a session, starting a transaction and committing it, and must perform a rollback in case of a failure.

Author:

LSST CCS Team

Constructor Summary

Constructors

Constructor and Description
ConfigurationFacade(HibernateDAO dbInterface)

Method Summary

Modifier and Type	Method and Description
Set<String>	findAvailableConfigurationsForCategory(BaseDescription desc, String category)
org.lsst.ccs.config.ConfigurationView	loadConfiguration(BaseDescription desc, org.lsst.ccs.config.ConfigurationDescription configDesc)
org.lsst.ccs.config.ConfigurationView	loadGlobalConfiguration(BaseDescription desc, String name, int version)
void	registerConfiguration(Description desc, org.lsst.ccs.bus.data.ConfigurationInfo ci, ConfigurationInfoData cid) Registration of an incoming ConfigurationInfo object via the Status Bus.
Description	registerDescription(AgentDesc ad, List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> cpis) Finds or registers in database the agent description corresponding to the given ConfigurationInfo object.
org.lsst.ccs.config.ConfigurationDescription	registerStandaloneConfiguration(Description desc, org.lsst.ccs.bus.data.ConfigurationInfo ci) Registration of configuration information coming from the Command bus.
void	registerStandaloneStatusConfigurationInfo(Description desc, ConfigurationInfoData cid) This methods resolves the association between the ConfigurationInfo registered previously via the command bus and the subsequent
void	stopConfigurationRuns(Description desc, long time)

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigurationFacade

public ConfigurationFacade(HibernateDAO dbInterface)

Method Detail

registerDescription

public Description registerDescription(AgentDesc ad,
                                       List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> cpis)
                                throws Exception

Finds or registers in database the agent description corresponding to the given ConfigurationInfo object.

Parameters:

ad - the agent description

cpis - the list of configuration parameter info.

Returns:

the id of the corresponding BaseDescription entity

Throws:

Exception

stopConfigurationRuns

public void stopConfigurationRuns(Description desc,
                                  long time)
                           throws Exception

Throws:

Exception

registerStandaloneConfiguration

public org.lsst.ccs.config.ConfigurationDescription registerStandaloneConfiguration(Description desc,
                                                                                    org.lsst.ccs.bus.data.ConfigurationInfo ci)
                                                                             throws Exception

Registration of configuration information coming from the Command bus. There is no associated StatusConfigurationInfo yet.

Parameters:

desc -

ci -

Returns:

Throws:

Exception

registerStandaloneStatusConfigurationInfo

public void registerStandaloneStatusConfigurationInfo(Description desc,
                                                      ConfigurationInfoData cid)
                                               throws Exception

This methods resolves the association between the ConfigurationInfo registered previously via the command bus and the subsequent

Parameters:

desc - the subsystem description

cid - the ConfigurationInfoData to persist

Throws:

Exception

registerConfiguration

public void registerConfiguration(Description desc,
                                  org.lsst.ccs.bus.data.ConfigurationInfo ci,
                                  ConfigurationInfoData cid)
                           throws Exception

Registration of an incoming ConfigurationInfo object via the Status Bus. The registration happens by comparing the received ConfigurationInfo with the previous configuration state persisted in the current ConfigurationRun

Parameters:

desc -

ci -

cid - the associated ConfigurationInfoData entity

Throws:

Exception

loadConfiguration

public org.lsst.ccs.config.ConfigurationView loadConfiguration(BaseDescription desc,
                                                               org.lsst.ccs.config.ConfigurationDescription configDesc)
                                                        throws Exception

Throws:

Exception

loadGlobalConfiguration

public org.lsst.ccs.config.ConfigurationView loadGlobalConfiguration(BaseDescription desc,
                                                                     String name,
                                                                     int version)
                                                              throws Exception

Throws:

Exception

findAvailableConfigurationsForCategory

public Set<String> findAvailableConfigurationsForCategory(BaseDescription desc,
                                                          String category)
                                                   throws Exception

Throws:

Exception