org.lsst.ccs.localdb.configdb.model

Class HibernateDAO

java.lang.Object

org.lsst.ccs.localdb.configdb.model.HibernateDAO

public class HibernateDAO
extends Object

Low level Data Access to Configuration Objects. An hibernate connection is started using begin and ended with end. Between those calls the hibernate session is persistent. An hibernate session is confined to the thread that opens it, by the use of a ThreadLocal

Author:

LSST CCS Team

Constructor Summary

Constructors

Constructor and Description
HibernateDAO(org.hibernate.SessionFactory fac)

Method Summary

Modifier and Type	Method and Description
void	begin()
void	cleanupConfigurationRuns(Description desc, long time) If Configuration runs are found with no tstop, they are considered as suspicious : they are removed.
void	close()
void	end()
void	endRun(Description description, long endTime)
List<String>	findAvailableConfigurationsForCategory(Description desc, String category)
Description	findDescriptionOrCreate(AgentDesc ad, List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> cpis) Finds or creates a Description entity corresponding to the input arguments.
Description	findDescriptionOrNull(String agentName, List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> cpis)
GlobalConfiguration	findGlobalConfiguration(Description desc, String name, int version)
GlobalConfiguration	findGlobalConfigurationOrCreate(Description desc, String name, Map<String,Configuration> newConfigs)
ConfigurationRun	getActiveConfigurationRun(Description desc, String category)
Map<String,ConfigurationRun>	getActiveConfigurationRuns(Description desc)
String	getActiveValueAt(Description desc, String category, String parameterPath, long date)
Configuration	getConfigRunningAt(Description desc, String category, long date)
ConfigurationInfoData	getConfigurationInfoData(Description desc, long date)
Configuration	getConfigurationOrCreate(Description desc, String name, String cat, int version, List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> cpis, long date, ConfigurationRun previousRun) Cascading process to determine which configuration is running.
Configuration	getConfigurationOrNull(Description desc, String name, String cat, int version)
ConfigurationRun	getConfigurationRunAt(Description desc, String category, long date)
Description	getDescription(long id)
Configuration	getLatestRunningConfiguration(Description desc, String category)
void	persist(Object obj)
ConfigurationRun	populateRunFromPreviousRun(ConfigurationRun previousRun, ConfigurationRun newRun, List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> changes)
ConfigurationRun	populateRunFromScratch(ConfigurationRun run, List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> changes)

Methods inherited from class java.lang.Object

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

Constructor Detail

HibernateDAO

public HibernateDAO(org.hibernate.SessionFactory fac)

Method Detail

begin

public void begin()

end

public void end()
         throws Exception

Throws:

Exception - if the persistence layer fails at committing

close

public void close()

persist

public void persist(Object obj)

getDescription

public Description getDescription(long id)

getConfigurationOrNull

public Configuration getConfigurationOrNull(Description desc,
                                            String name,
                                            String cat,
                                            int version)

getConfigurationOrCreate

public Configuration getConfigurationOrCreate(Description desc,
                                              String name,
                                              String cat,
                                              int version,
                                              List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> cpis,
                                              long date,
                                              ConfigurationRun previousRun)

Cascading process to determine which configuration is running. If the version number is well defined, it is fetched by version number, otherwise its checksum is computed. If not found, a new version for the given tag is created.

Parameters:

desc -

name -

cat -

version -

cpis -

date -

previousRun -

Returns:

populateRunFromScratch

public ConfigurationRun populateRunFromScratch(ConfigurationRun run,
                                               List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> changes)

populateRunFromPreviousRun

public ConfigurationRun populateRunFromPreviousRun(ConfigurationRun previousRun,
                                                   ConfigurationRun newRun,
                                                   List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> changes)

cleanupConfigurationRuns

public void cleanupConfigurationRuns(Description desc,
                                     long time)

If Configuration runs are found with no tstop, they are considered as suspicious : they are removed.

Parameters:

desc -

getLatestRunningConfiguration

public Configuration getLatestRunningConfiguration(Description desc,
                                                   String category)

getConfigRunningAt

public Configuration getConfigRunningAt(Description desc,
                                        String category,
                                        long date)

getActiveValueAt

public String getActiveValueAt(Description desc,
                               String category,
                               String parameterPath,
                               long date)

endRun

public void endRun(Description description,
                   long endTime)

findDescriptionOrCreate

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

Finds or creates a Description entity corresponding to the input arguments.

Parameters:

ad - the agent description

cpis -

Returns:

a Description object in persisted state.

findDescriptionOrNull

public Description findDescriptionOrNull(String agentName,
                                         List<org.lsst.ccs.bus.data.ConfigurationParameterInfo> cpis)

getActiveConfigurationRun

public ConfigurationRun getActiveConfigurationRun(Description desc,
                                                  String category)

getConfigurationInfoData

public ConfigurationInfoData getConfigurationInfoData(Description desc,
                                                      long date)

getConfigurationRunAt

public ConfigurationRun getConfigurationRunAt(Description desc,
                                              String category,
                                              long date)

getActiveConfigurationRuns

public Map<String,ConfigurationRun> getActiveConfigurationRuns(Description desc)

findAvailableConfigurationsForCategory

public List<String> findAvailableConfigurationsForCategory(Description desc,
                                                           String category)

findGlobalConfiguration

public GlobalConfiguration findGlobalConfiguration(Description desc,
                                                   String name,
                                                   int version)

findGlobalConfigurationOrCreate

public GlobalConfiguration findGlobalConfigurationOrCreate(Description desc,
                                                           String name,
                                                           Map<String,Configuration> newConfigs)