de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters

Class ObjectListParameter<C>

java.lang.Object

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter<THIS,T>

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ListParameter<ClassListParameter<C>,java.util.List<java.lang.Class<? extends C>>>

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ClassListParameter<C>

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ObjectListParameter<C>

Type Parameters:

C - Class type

All Implemented Interfaces:

Parameter<java.util.List<java.lang.Class<? extends C>>>

public class ObjectListParameter<C>
extends ClassListParameter<C>

Parameter that represents a list of objects (in contrast to a class list parameter, they will be instanced at most once.)

Since:

0.3

Author:

Erich Schubert

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<C>	instances Cache for the generated instances.

Fields inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ClassListParameter

restrictionClass

Fields inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ListParameter

LIST_SEP, SPLIT, VECTOR_SEP, VECTOR_SPLIT

Fields inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter

constraints, defaultValue, givenValue, optionalParameter, optionid, shortDescription

Constructor Summary

Constructors

Constructor and Description
ObjectListParameter(OptionID optionID, java.lang.Class<?> restrictionClass) Constructor for non-optional.
ObjectListParameter(OptionID optionID, java.lang.Class<?> restrictionClass, boolean optional) Constructor with optional flag.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getSyntax() Returns a string representation of the parameter's type.
java.util.List<C>	instantiateClasses(Parameterization config) Returns a list of new instances for the value (i.e., the class name) of this class list parameter.
protected java.util.List<java.lang.Class<? extends C>>	parseValue(java.lang.Object obj) Parse a given value into the destination type.

Methods inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.ClassListParameter

describeValues, formatValue, getDefaultValueAsString, getKnownImplementations, getRestrictionClass, getValueAsString, size, validate

Methods inherited from class de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter

addConstraint, getConstraints, getDefaultValue, getOptionID, getShortDescription, getValue, hasDefaultValue, isDefined, isOptional, isValid, setDefaultValue, setOptional, setShortDescription, setValue, setValueInternal, tookDefaultValue, tryDefaultValue

Methods inherited from class java.lang.Object

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

Field Detail

instances

private java.util.List<C> instances

Cache for the generated instances.

Constructor Detail

ObjectListParameter

public ObjectListParameter(OptionID optionID,
                           java.lang.Class<?> restrictionClass,
                           boolean optional)

Constructor with optional flag.

Parameters:

optionID - Option ID

restrictionClass - Restriction class

optional - optional flag

ObjectListParameter

public ObjectListParameter(OptionID optionID,
                           java.lang.Class<?> restrictionClass)

Constructor for non-optional.

Parameters:

optionID - Option ID

restrictionClass - Restriction class

Method Detail

getSyntax

public java.lang.String getSyntax()

Description copied from class: ClassListParameter

Returns a string representation of the parameter's type.

Specified by:

getSyntax in interface Parameter<java.util.List<java.lang.Class<? extends C>>>

Overrides:

getSyntax in class ClassListParameter<C>

Returns:

"<class_1,...,class_n>"

parseValue

protected java.util.List<java.lang.Class<? extends C>> parseValue(java.lang.Object obj)
                                                           throws ParameterException

Description copied from class: AbstractParameter

Parse a given value into the destination type.

Overrides:

parseValue in class ClassListParameter<C>

Parameters:

obj - Object to parse (may be a string representation!)

Returns:

Parsed object

Throws:

ParameterException - when the object cannot be parsed.

instantiateClasses

public java.util.List<C> instantiateClasses(Parameterization config)

Description copied from class: ClassListParameter

Returns a list of new instances for the value (i.e., the class name) of this class list parameter. The instances have the type of the restriction class of this class list parameter.

If the Class for the class names is not found, the instantiation is tried using the package of the restriction class as package of the class name.

Overrides:

instantiateClasses in class ClassListParameter<C>

Parameters:

config - Parameterization to use (if Parameterizable))

Returns:

a list of new instances for the value of this class list parameter