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

Class ObjectParameter<C>

java.lang.Object

de.lmu.ifi.dbs.elki.utilities.optionhandling.parameters.AbstractParameter<ClassParameter<C>,java.lang.Class<? extends C>>

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

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

Type Parameters:

C - Class type

All Implemented Interfaces:

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

public class ObjectParameter<C>
extends ClassParameter<C>

Parameter class for a parameter representing a single object. It can be parameterized by giving a class name or class to instantiate, or an existing instance.

Since:

0.3

Author:

Steffi Wanka, Erich Schubert

Field Summary

Fields

Modifier and Type	Field and Description
private C	instance The instance to use.

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

restrictionClass

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
ObjectParameter(OptionID optionID, java.lang.Class<?> restrictionClass) Constructs a class parameter with the given optionID, and restriction class.
ObjectParameter(OptionID optionID, java.lang.Class<?> restrictionClass, boolean optional) Constructs a class parameter with the given optionID, restriction class, and optional flag.
ObjectParameter(OptionID optionID, java.lang.Class<?> restrictionClass, java.lang.Class<?> defaultValue) Constructs a class parameter with the given optionID, restriction class, and default value.
ObjectParameter(OptionID optionID, java.lang.Class<?> restrictionClass, T defaultValue) Constructs a class parameter with the given optionID, restriction class, and default value.

Method Summary

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

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

canonicalClassName, canonicalClassName, describeValues, getDefaultValueAsString, getKnownImplementations, getRestrictionClass, getValueAsString, 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, setValueInternal, tookDefaultValue, tryDefaultValue

Methods inherited from class java.lang.Object

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

Field Detail

instance

private C instance

The instance to use.

Constructor Detail

ObjectParameter

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

Constructs a class parameter with the given optionID, restriction class, and default value.

Parameters:

optionID - the unique id of the option

restrictionClass - the restriction class of this class parameter

defaultValue - the default value of this class parameter

ObjectParameter

public ObjectParameter(OptionID optionID,
                       java.lang.Class<?> restrictionClass,
                       T defaultValue)

Constructs a class parameter with the given optionID, restriction class, and default value.

Type Parameters:

T - default value type, to solve generics problems.

Parameters:

optionID - the unique id of the option

restrictionClass - the restriction class of this class parameter

defaultValue - the default instance of this class parameter

ObjectParameter

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

Constructs a class parameter with the given optionID, restriction class, and optional flag.

Parameters:

optionID - the unique id of the option

restrictionClass - the restriction class of this class parameter

optional - specifies if this parameter is an optional parameter

ObjectParameter

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

Constructs a class parameter with the given optionID, and restriction class.

Parameters:

optionID - the unique id of the option

restrictionClass - the restriction class of this class parameter

Method Detail

parseValue

protected 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 ClassParameter<C>

Parameters:

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

Returns:

Parsed object

Throws:

ParameterException - when the object cannot be parsed.

setValue

public void setValue(java.lang.Object obj)
              throws ParameterException

Description copied from interface: Parameter

Sets the value of the option.

Specified by:

setValue in interface Parameter<java.lang.Class<? extends C>>

Overrides:

setValue in class AbstractParameter<ClassParameter<C>,java.lang.Class<? extends C>>

Parameters:

obj - the option's value to be set

Throws:

ParameterException - if the given value is not a valid value for this option.

getSyntax

public java.lang.String getSyntax()

Returns a string representation of the parameter's type.

Specified by:

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

Overrides:

getSyntax in class ClassParameter<C>

Returns:

"<class>"

instantiateClass

public C instantiateClass(Parameterization config)

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

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

Overrides:

instantiateClass in class ClassParameter<C>

Parameters:

config - Parameterization

Returns:

a new instance for the value of this class parameter