|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectde.jstacs.parameters.Parameter
de.jstacs.parameters.ParameterSetContainer
public class ParameterSetContainer
Class for a ParameterSetContainer
that contains a
ParameterSet
as value. This ParameterSet
can be set either
using the constructor or using the method setValue(Object)
and can
be obtained by the method getValue()
. ParameterSetContainer
s
can be used to build tree-structures of Parameter
s.
Field Summary | |
---|---|
protected String |
errorMessage
The message of the last error or null if no error occurred. |
Fields inherited from class de.jstacs.parameters.Parameter |
---|
neededReference, neededReferenceId, parent |
Constructor Summary | |
---|---|
ParameterSetContainer(StringBuffer representation)
The standard constructor for the interface Storable . |
|
ParameterSetContainer(String name,
String comment,
ParameterSet content)
Creates an new ParameterSetContainer out of a
ParameterSet . |
Method Summary | |
---|---|
boolean |
checkValue(Object value)
Checks the value for correctness, e.g. for numerical parameters this might be checking if the value is within specified bounds. |
ParameterSetContainer |
clone()
|
void |
fromGalaxy(String namePrefix,
StringBuffer command)
Parses the contents of command in the format defined by configBuffer of GalaxyConvertible.toGalaxy(String, String, int, StringBuffer, StringBuffer)
and sets the values of the Parameter or ParameterSet accordingly. |
protected void |
fromXML(StringBuffer representation)
Parses a Parameter from a XML representation as returned by
Parameter.toXML() . |
String |
getComment()
Returns a comment on this Parameter that tells something about
useful values, domains, usage of this parameter, etc. |
DataType |
getDatatype()
Returns the data type of the Parameter . |
String |
getErrorMessage()
If a value could not be set successfully this method returns the corresponding error message. |
String |
getName()
Returns the name of the Parameter . |
int |
getNumberOfValues()
Returns the number of values in the collection. |
Parameter |
getRangedInstance()
Returns an instance of RangeIterator that has the same properties
as the current instance, but accepts a range or list of values. |
ParameterSet |
getValue()
Returns the current value of this Parameter . |
boolean |
hasDefaultOrIsSet()
Returns true if the parameter either has a default value or
the value was set by the user, false otherwise. |
boolean |
isAtomic()
Returns true if the parameter is of an atomic data type,
false otherwise. |
boolean |
isRangeable()
Returns true if the parameters can be varied over a range of
values. |
boolean |
isRanged()
Returns true if this RangeIterator is ranging over a
set of values. |
boolean |
isRequired()
Returns true if the Parameter is required,
false otherwise. |
boolean |
isSet()
Returns true if the parameter was set by the user,
false otherwise. |
boolean |
next()
Switches to the next value in the collection of values in the specified range. |
void |
reset()
Resets the parameter and its contents to the default values or null if no defaults are given. |
void |
resetToFirst()
Resets the current value in the collection to the first value. |
void |
setDefault(Object defaultValue)
Sets the default value of the Parameter to
defaultValue . |
void |
setValue(Object value)
Sets the value of this Parameter to value . |
void |
simplify()
Simplifies the Parameter and its contents to the relevant
information. |
void |
toGalaxy(String namePrefix,
String configPrefix,
int depth,
StringBuffer descBuffer,
StringBuffer configBuffer)
Creates an Galaxy XML-representation of the parameters and appends it to descBuffer
and variable configuration and appends it to configBuffer . |
StringBuffer |
toXML()
This method returns an XML representation as StringBuffer of an
instance of the implementing class. |
String |
valuesToString()
Returns a String representation of the set of values. |
Methods inherited from class de.jstacs.parameters.Parameter |
---|
getId, getNeededReference, getNeededReferenceId, getParent, setNeededReference, setParent |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected String errorMessage
null
if no error occurred.
Constructor Detail |
---|
public ParameterSetContainer(String name, String comment, ParameterSet content)
ParameterSetContainer
out of a
ParameterSet
.
name
- the name of the ParameterSetContainer
comment
- a comment on the ParameterSetContainer
content
- the content of the ParameterSetContainer
(the
contained ParameterSet
)public ParameterSetContainer(StringBuffer representation) throws NonParsableException
Storable
.
Creates a new ParameterSetContainer
from its XML representation.
representation
- the XML representation as StringBuffer
NonParsableException
- if the StringBuffer
representation
could
not be parsedMethod Detail |
---|
public ParameterSetContainer clone() throws CloneNotSupportedException
clone
in class Parameter
CloneNotSupportedException
public String getName()
Parameter
Parameter
.
getName
in class Parameter
Parameter
public DataType getDatatype()
Parameter
Parameter
.
getDatatype
in class Parameter
Parameter
public String getComment()
Parameter
Parameter
that tells something about
useful values, domains, usage of this parameter, etc.
getComment
in class Parameter
public boolean isRequired()
Parameter
true
if the Parameter
is required,
false
otherwise.
isRequired
in class Parameter
true
if the Parameter
is required,
false
otherwisepublic boolean checkValue(Object value)
Parameter
checkValue
in class Parameter
value
- the value to be checked
true
if the value is valid, false
otherwisepublic void setValue(Object value) throws SimpleParameter.IllegalValueException
Parameter
Parameter
to value
.
setValue
in class Parameter
value
- the new value of the Parameter
SimpleParameter.IllegalValueException
- if the specified value is not valid for this
Parameter
public ParameterSet getValue()
Parameter
Parameter
.
getValue
in class Parameter
Parameter
public boolean hasDefaultOrIsSet()
Parameter
true
if the parameter either has a default value or
the value was set by the user, false
otherwise.
hasDefaultOrIsSet
in class Parameter
true
if value has a default value or was set,
false
otherwisepublic boolean isSet()
Parameter
true
if the parameter was set by the user,
false
otherwise.
isSet
in class Parameter
true
if the parameter was set, false
otherwisepublic boolean isAtomic()
Parameter
true
if the parameter is of an atomic data type,
false
otherwise.
isAtomic
in class Parameter
true
if the parameter is atomic, false
otherwisepublic String getErrorMessage()
Parameter
getErrorMessage
in class Parameter
public void simplify()
Parameter
Parameter
and its contents to the relevant
information. This could be e.g. to reset the contents of those values of
a CollectionParameter
that are not selected.
simplify
in class Parameter
public void reset()
Parameter
null
if no defaults are given.
reset
in class Parameter
public void setDefault(Object defaultValue) throws Exception
Parameter
Parameter
to
defaultValue
.
setDefault
in class Parameter
defaultValue
- the default value
Exception
- if the default value is not an appropriate value for this
Parameter
public StringBuffer toXML()
Storable
StringBuffer
of an
instance of the implementing class.
toXML
in interface Storable
toXML
in class Parameter
protected void fromXML(StringBuffer representation) throws NonParsableException
Parameter
Parameter
from a XML representation as returned by
Parameter.toXML()
.
fromXML
in class Parameter
representation
- the XML representation as StringBuffer
NonParsableException
- if the XML code could not be parsedParameter.toXML()
public boolean isRangeable()
Rangeable
true
if the parameters can be varied over a range of
values.
isRangeable
in interface Rangeable
true
if the parameter can be varied,
false
otherwisepublic Parameter getRangedInstance() throws Exception
Rangeable
RangeIterator
that has the same properties
as the current instance, but accepts a range or list of values. These
values can be obtained by the methods of RangeIterator
.
getRangedInstance
in interface Rangeable
Exception
- is thrown if Rangeable.isRangeable()
returns
false
or the ranged instance could not be
created for some other reasonpublic boolean next() throws ParameterException
RangeIterator
next
in interface RangeIterator
true
if the next element exists, false
otherwise
ParameterException
- if the next value could not be fetchedpublic void resetToFirst()
RangeIterator
resetToFirst
in interface RangeIterator
public boolean isRanged()
RangeIterator
true
if this RangeIterator
is ranging over a
set of values.
isRanged
in interface RangeIterator
true
if this RangeIterator
is ranging over a
set of values, false
otherwisepublic int getNumberOfValues()
RangeIterator
getNumberOfValues
in interface RangeIterator
public String valuesToString()
RangeIterator
String
representation of the set of values.
valuesToString
in interface RangeIterator
String
representationpublic void toGalaxy(String namePrefix, String configPrefix, int depth, StringBuffer descBuffer, StringBuffer configBuffer) throws Exception
GalaxyConvertible
descBuffer
and variable configuration and appends it to configBuffer
. The variable configuation
is also used to parse user-supplied values returned by Galaxy.
toGalaxy
in interface GalaxyConvertible
namePrefix
- the prefix of the variable name used in GalaxyconfigPrefix
- the prefix for conditionalsdepth
- the depth in the parameter hierarchy, used for graphical representation of nestingdescBuffer
- the buffer for the parameter descriptionconfigBuffer
- the buffer for the configuration line
Exception
- if the conversion failspublic void fromGalaxy(String namePrefix, StringBuffer command) throws Exception
GalaxyConvertible
command
in the format defined by configBuffer
of GalaxyConvertible.toGalaxy(String, String, int, StringBuffer, StringBuffer)
and sets the values of the Parameter
or ParameterSet
accordingly.
fromGalaxy
in interface GalaxyConvertible
namePrefix
- the prefix of the variable namecommand
- the command string
Exception
- if the command string could not be parsed
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |