org.lsst.ccs.localdb.configdb.model

Interface DBInterface

All Known Implementing Classes:

HibernateDAO, HqlDAO

public interface DBInterface

defines the basic methods implemented by a Data Access Object. Note that many org.lsst.gruth.types are package protected so implementors whould be in the same package.

Author:

bamade

Method Summary

Modifier and Type	Method and Description
void	begin() starts a transaction
void	close() claose all
void	deleteActiveConfigProfile(org.lsst.ccs.localdb.configdb.model.AConfigProfile oldProfile) delectes the active profile from DB
void	deleteActiveSubsystemDescription(ASubsystemDescription oldDescription) deletes an active description
void	end() end a transaction
void	fail() failure: must close transaction
void	fail(Throwable th) same as fail but a Throwable can be used to log.
org.lsst.ccs.localdb.configdb.model.AConfigProfile	getActiveConfigProfile(String subsystemName, String descriptionName, String name, String tag) get configProfile with name and tag
Collection<org.lsst.ccs.localdb.configdb.model.AConfigProfile>	getActiveProfilesForSubsystem(ASubsystemDescription description, String category) gets the active configProfiles that references an active SubsystemDescription
ASubsystemDescription	getActiveSubsystemDescription(long id) gets a subsystem description by its id
ASubsystemDescription	getActiveSubsystemDescription(String name, String tag) gets a SubsystemDescription in the corresponding active object table.
org.lsst.ccs.localdb.configdb.model.GhostSubsystemDescription	getGhostDescription(long id) returns ghost with corresponding id
Collection<org.lsst.ccs.localdb.configdb.model.PastConfigProfile>	getProfilesForSubsystem(org.lsst.ccs.localdb.configdb.model.GhostSubsystemDescription description) get the deprecated ConfigProfile that referenced a subsystemDescription (active or deprecated)
void	modifyParmConfig(org.lsst.ccs.localdb.configdb.model.AParameterConfiguration config) registers a modified parameter
void	saveConfigProfile(org.lsst.ccs.localdb.configdb.model.AConfigProfile newProfile) saves the new argument: ID is modified and argument becomes immutable.
void	saveGhostDescriptions(org.lsst.ccs.localdb.configdb.model.GhostSubsystemDescription ghosts) saves the argument
void	savePastProfile(org.lsst.ccs.localdb.configdb.model.PastConfigProfile deprecatedProfile) saves argument
void	saveRun(RunHistory runHistory) saves a run history
void	saveSubsystemDescription(ASubsystemDescription newDescription) saves the argument: which must now becomes immutable and be numbered (with an ID)
List<?>	simpleHQLRequest(String hqlString) execut simple request (read only: select of From)

Method Detail

begin

void begin()

starts a transaction

end

void end()

end a transaction

fail

void fail()

failure: must close transaction

fail

void fail(Throwable th)

same as fail but a Throwable can be used to log.

Parameters:

th -

saveSubsystemDescription

void saveSubsystemDescription(ASubsystemDescription newDescription)

saves the argument: which must now becomes immutable and be numbered (with an ID)

Parameters:

newDescription -

saveGhostDescriptions

void saveGhostDescriptions(org.lsst.ccs.localdb.configdb.model.GhostSubsystemDescription ghosts)

saves the argument

Parameters:

ghosts -

getActiveSubsystemDescription

ASubsystemDescription getActiveSubsystemDescription(String name,
                                                    String tag)

gets a SubsystemDescription in the corresponding active object table.

Parameters:

name -

tag -

Returns:

null if not found

getActiveSubsystemDescription

ASubsystemDescription getActiveSubsystemDescription(long id)

gets a subsystem description by its id

Parameters:

id -

Returns:

the active subsystem description that matches the given id

getGhostDescription

org.lsst.ccs.localdb.configdb.model.GhostSubsystemDescription getGhostDescription(long id)

returns ghost with corresponding id

Parameters:

id -

Returns:

null if not found

deleteActiveSubsystemDescription

void deleteActiveSubsystemDescription(ASubsystemDescription oldDescription)

deletes an active description

Parameters:

oldDescription -

saveConfigProfile

void saveConfigProfile(org.lsst.ccs.localdb.configdb.model.AConfigProfile newProfile)

saves the new argument: ID is modified and argument becomes immutable.

Parameters:

newProfile -

savePastProfile

void savePastProfile(org.lsst.ccs.localdb.configdb.model.PastConfigProfile deprecatedProfile)

saves argument

Parameters:

deprecatedProfile -

getActiveConfigProfile

org.lsst.ccs.localdb.configdb.model.AConfigProfile getActiveConfigProfile(String subsystemName,
                                                                          String descriptionName,
                                                                          String name,
                                                                          String tag)

get configProfile with name and tag

Parameters:

subsystemName - the subsystem name

descriptionName - the description name

name -

tag -

Returns:

null if not found

deleteActiveConfigProfile

void deleteActiveConfigProfile(org.lsst.ccs.localdb.configdb.model.AConfigProfile oldProfile)

delectes the active profile from DB

Parameters:

oldProfile -

modifyParmConfig

void modifyParmConfig(org.lsst.ccs.localdb.configdb.model.AParameterConfiguration config)

registers a modified parameter

Parameters:

config -

getActiveProfilesForSubsystem

Collection<org.lsst.ccs.localdb.configdb.model.AConfigProfile> getActiveProfilesForSubsystem(ASubsystemDescription description,
                                                                                             String category)

gets the active configProfiles that references an active SubsystemDescription

Parameters:

description -

Returns:

a Collection of active AConfigProfile for the active ASubsystemDescription

getProfilesForSubsystem

Collection<org.lsst.ccs.localdb.configdb.model.PastConfigProfile> getProfilesForSubsystem(org.lsst.ccs.localdb.configdb.model.GhostSubsystemDescription description)

get the deprecated ConfigProfile that referenced a subsystemDescription (active or deprecated)

Parameters:

description -

Returns:

a Collection of config profiles that referenced the subsystem description

saveRun

void saveRun(RunHistory runHistory)

saves a run history

Parameters:

runHistory -

simpleHQLRequest

List<?> simpleHQLRequest(String hqlString)

execut simple request (read only: select of From)

Parameters:

hqlString -

Returns:

an HQL request

close

void close()

claose all