org.lsst.ccs.config.remote

Class LocalToRemoteMigrationDAO

java.lang.Object

org.lsst.ccs.config.remote.LocalToRemoteMigrationDAO

All Implemented Interfaces:

AutoCloseable, ConfigurationDAO

public class LocalToRemoteMigrationDAO
extends Object
implements ConfigurationDAO

A DAO for migrating from local files to remote files. It reads all files locally, but makes a copy of each file read in the remote file server. Newly saved files are only stored remotely.

Author:

tonyj

Constructor Summary

Constructors

Constructor and Description
LocalToRemoteMigrationDAO(String subsystemName)

Method Summary

Modifier and Type	Method and Description
void	close() Called when the DAO is no longer used (typically at shutdown).
boolean	hasCategoryTagData(SingleCategoryTag singleCategoryTag) Utility method to test if the DAO has data for a SingleCategoryTag.
SingleCategoryTagData	loadCategoryTag(SingleCategoryTag singleCategoryTag) Load the configuration data for a SingleCategoryTag.
SingleCategoryTag	saveCategoryTagData(SingleCategoryTagData singleCategoryTagData) Save the data included in the provided SingleCategoryTag object.

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalToRemoteMigrationDAO

public LocalToRemoteMigrationDAO(String subsystemName)

Method Detail

loadCategoryTag

public SingleCategoryTagData loadCategoryTag(SingleCategoryTag singleCategoryTag)
                                      throws ConfigurationServiceException

Description copied from interface: ConfigurationDAO

Load the configuration data for a SingleCategoryTag. The provided SingleCategoryTag could contain generic versions as: default, latest, working. It is the responsibility of the DAO to resolve this version and return it as part of the SingleCategoryTag object it returns.

Specified by:

loadCategoryTag in interface ConfigurationDAO

Parameters:

singleCategoryTag - The object describing the data to be loaded for a single category tag.

Returns:

a SingleCategoryTagData containing the loaded configuration values and the comments associated to them. This object contains a SingleCategoryTag instance to clarify the version of the data that was actually loaded.

Throws:

ConfigurationServiceException - if the data cannot be found or loaded for the given SingleCategoryTag instance.

saveCategoryTagData

public SingleCategoryTag saveCategoryTagData(SingleCategoryTagData singleCategoryTagData)
                                      throws ConfigurationServiceException

Description copied from interface: ConfigurationDAO

Save the data included in the provided SingleCategoryTag object. It is the responsibility of the DAO to resolve the version of the saved data and return it as part of the SingleCategoryTag object it returns.

Specified by:

saveCategoryTagData in interface ConfigurationDAO

Parameters:

singleCategoryTagData - The data to be saved; it includes the configuration parameter values and associated comments.

Returns:

a SingleCategoryTag instance containing the version in which the provided data was saved.

Throws:

ConfigurationServiceException - if the data could not be saved.

hasCategoryTagData

public boolean hasCategoryTagData(SingleCategoryTag singleCategoryTag)

Description copied from interface: ConfigurationDAO

Utility method to test if the DAO has data for a SingleCategoryTag. This method is currently used as we migrate from implicit to explicit source definition in the configuration loading/saving operations.

Specified by:

hasCategoryTagData in interface ConfigurationDAO

Parameters:

singleCategoryTag - a SingleCategoryTag object describing the requested data.

Returns:

false if there is no data available for the provided SingleCategoryTag. true otherwise.

close

public void close()

Description copied from interface: ConfigurationDAO

Called when the DAO is no longer used (typically at shutdown).

Specified by:

close in interface AutoCloseable

Specified by:

close in interface ConfigurationDAO