org.lsst.ccs.config

Class Factories

java.lang.Object

org.lsst.ccs.config.Factories

public class Factories
extends Object

A set of static methods to be used on Configuration service client's side : they are hiding some implementation details to the "outside" world. To be used in conjunction with ConfigurationFacade (but these codes may be called locally without referring to a server)

Author:

bamade

Method Summary

Modifier and Type	Method and Description
static ConfigProfile	copyProfile(ConfigProfile toBeCopied, String newName, boolean toEngineering) to be used to create a copy of configuration with different tag, etc.
static ParameterConfiguration	createParameterConfiguration(ParameterDescription description) Factory method to create a ParameterConfiguration object.
static ParameterConfiguration	createParameterConfiguration(ParameterDescription description, String value) Factory method to create a ParameterConfiguration object.
static ParameterDescription	createParameterDescription(ParameterBase parameterBase, String description, String simpleName, String category, int level) factory method to create a new ParameterDescription.
static ParameterDescription	createParameterDescription(ParameterDescription other) Factory method to create a new ParameterDescription from another one.
static ConfigProfile	createRawConfigProfile(SubsystemDescription subsystemDesc, String category, String configName) Creates an empty ConfigProfile.
static SubsystemDescription	createRawSubsystemDescription(String subsystemName, String tag, Serializable configurationData) Creates a new SubsystemDescription object without any ParameterDescription list creation.
static SubsystemDescription	createSubsystemDescription(String subsystemName, String tag, Serializable configurationData, Collection<ParameterDescription> parameterDescriptions) Creates a new SubsystemDescription object and populates it with the given list of parameter descriptions.
static SubsystemDescription	createSubsystemDescriptionCopy(SubsystemDescription desc) creates a new SubsystemDescription from another.
static void	tryCopyParameters(SubsystemDescription newDescription, SubsystemDescription model, DescriptionMismatchListener mismatchListener) tries to copy ParameterDescription from a model to a new subsystem description.

Methods inherited from class java.lang.Object

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

Method Detail

createRawSubsystemDescription

public static SubsystemDescription createRawSubsystemDescription(String subsystemName,
                                                                 String tag,
                                                                 Serializable configurationData)

Creates a new SubsystemDescription object without any ParameterDescription list creation. The object is not registered in the database since it is to be populated by ParameterDescription objects.

To populate the descriptions get the base descriptions from the Subsystemdescription by calling a version of getBaseParameters or getParameterDescriptions and generate the descriptions from these bases.

Parameters:

subsystemName -

tag -

configurationData -

Returns:

a SubsystemDescription object without parameter descriptions

createSubsystemDescription

public static SubsystemDescription createSubsystemDescription(String subsystemName,
                                                              String tag,
                                                              Serializable configurationData,
                                                              Collection<ParameterDescription> parameterDescriptions)

Creates a new SubsystemDescription object and populates it with the given list of parameter descriptions.

Parameters:

subsystemName -

tag -

configurationData -

parameterDescriptions -

Returns:

createSubsystemDescriptionCopy

public static SubsystemDescription createSubsystemDescriptionCopy(SubsystemDescription desc)

creates a new SubsystemDescription from another. The other one could be active of deprecated data: this method is meant to create another subsystemdescription were only the ParameterDescription are to be changed. not that the list of ParameterDescription may be populated (if the model have some) and then that this set is to be modified (the resulting object is not yet persisted in the database).

Parameters:

desc -

Returns:

a deep copy of a the object.

createParameterDescription

public static ParameterDescription createParameterDescription(ParameterBase parameterBase,
                                                              String description,
                                                              String simpleName,
                                                              String category,
                                                              int level)

factory method to create a new ParameterDescription. To be used by tools such as GUI

Parameters:

parameterBase -

description -

simpleName -

category -

level -

Returns:

a ParameterDescription object built out of the issued arguments

createParameterDescription

public static ParameterDescription createParameterDescription(ParameterDescription other)

Factory method to create a new ParameterDescription from another one.

Parameters:

other -

Returns:

a copy of other.

tryCopyParameters

public static void tryCopyParameters(SubsystemDescription newDescription,
                                     SubsystemDescription model,
                                     DescriptionMismatchListener mismatchListener)

tries to copy ParameterDescription from a model to a new subsystem description. each ParameterDescription is checked against the configData (if not compatible it is rejected and a Listener is notified).

NOT IMPLEMENTED YET

Parameters:

newDescription - a subsystem description without any ParameterDescription

model -

mismatchListener - optional code that will be warned when inconsistencies occur

createRawConfigProfile

public static ConfigProfile createRawConfigProfile(SubsystemDescription subsystemDesc,
                                                   String category,
                                                   String configName)

Creates an empty ConfigProfile. This object is associated to a subsystem description, is specified the category of parameters it referes to and is associated a configuration name but it does not contain any ParameterConfiguration list.

Parameters:

subsystemDesc - should be read from the database

level -

category -

configName -

Returns:

an empty ConfigProfile

Throws:

IllegalArgumentException - if subsystemdescription not in database

copyProfile

public static ConfigProfile copyProfile(ConfigProfile toBeCopied,
                                        String newName,
                                        boolean toEngineering)

to be used to create a copy of configuration with different tag, etc. This is used mostly to go back and forth in Engineering mode: for instance start an Engineering mode with modification of parameters "on the fly"

when this is used to create an "engineering mode" profile it is mandatory that the profile to be copied is an active one (not a deprecated one)

Parameters:

toBeCopied - for the moment should be an "active" ConfigProfile (not a deprecated one)

newName -

toEngineering -

Returns:

a copy of the specified configuration profile with different name, user name and level.

createParameterConfiguration

public static ParameterConfiguration createParameterConfiguration(ParameterDescription description,
                                                                  String value)

Factory method to create a ParameterConfiguration object. The object stands for the description parameter description and attempts to assign a configured value to it. This factory method is to be used statically exclusively (ie not when a subsystem is running).

Parameters:

description -

value -

Returns:

a new parameter configuration the value of which is value

createParameterConfiguration

public static ParameterConfiguration createParameterConfiguration(ParameterDescription description)

Factory method to create a ParameterConfiguration object.

Parameters:

description -

Returns:

a parameter configuration object, the value of which is set to the default value as defined in the parameter description