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 context (session and transaction) 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	closeSession()
ConfigurationParameter	createConfigurationParameter(String agentName, String componentName, String parameterName, String description, String typeName, String categoryName, String finalValue)
void	end() End of a unit of work : transaction commit.
void	endRun(Description description, long endTime)
List<String>	findAvailableConfigurationsForCategory(BaseDescription desc, String category)
GlobalConfiguration	findGlobalConfiguration(BaseDescription desc, String name, int version)
GlobalConfiguration	findGlobalConfigurationOrCreate(BaseDescription 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)
Map<ParameterPath,List<ConfigurationParameter>>	getAllConfigurationParameters(String agentName)
Configuration	getConfigRunningAt(Description desc, String category, long date)
ConfigurationInfoData	getConfigurationInfoData(Description desc, long date)
Configuration	getConfigurationOrCreate(BaseDescription 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(BaseDescription desc, String name, String cat, int version)
ConfigurationRun	getConfigurationRunAt(Description desc, String category, long date)
Description	getDescription(AgentDesc ad, List<ConfigurationParameter> parameters) Get an existing Description entity or creates it if it does not exist already.
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)
void	rollback()

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

End of a unit of work : transaction commit.

Throws:

Exception - if the persistence layer fails at committing

rollback

public void rollback()
              throws Exception

Throws:

Exception

closeSession

public void closeSession()

persist

public void persist(Object obj)

getConfigurationOrNull

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

getConfigurationOrCreate

public Configuration getConfigurationOrCreate(BaseDescription 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)

createConfigurationParameter

public ConfigurationParameter createConfigurationParameter(String agentName,
                                                           String componentName,
                                                           String parameterName,
                                                           String description,
                                                           String typeName,
                                                           String categoryName,
                                                           String finalValue)

getAllConfigurationParameters

public Map<ParameterPath,List<ConfigurationParameter>> getAllConfigurationParameters(String agentName)

getDescription

public Description getDescription(AgentDesc ad,
                                  List<ConfigurationParameter> parameters)

Get an existing Description entity or creates it if it does not exist already.

Parameters:

ad -

parameters -

Returns:

getDescription

public Description getDescription(long id)

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(BaseDescription desc,
                                                           String category)

findGlobalConfiguration

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

findGlobalConfigurationOrCreate

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