Package org.uma.evolver.parameter

Class Parameter<T>

java.lang.Object

org.uma.evolver.parameter.Parameter<T>

Type Parameters:

T - the type of the parameter value

Direct Known Subclasses:

BooleanParameter, CategoricalIntegerParameter, CategoricalParameter, RangeParameter, StringParameter

public abstract class Parameter<T>
extends Object

Represents a configurable parameter with a value of type T, supporting hierarchical sub-parameters.

A Parameter can have:

• Global sub-parameters: Always relevant, regardless of this parameter's value.
• Specific sub-parameters: Only relevant when this parameter has a certain value or condition.
• Non-configurable sub-parameters: Internal or fixed configuration values.

Subclasses must implement the parse(String[]) method to define how the parameter value is parsed from arguments. This class provides fluent methods for adding sub-parameters and utilities for parsing and retrieving them.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Parameter(String name)	Constructs a parameter with the given name.

Method Summary

Modifier and Type	Method	Description
Parameter<T>	addConditionalParameter(Boolean dependsOn, Parameter<?> parameter)	Adds a specific sub-parameter that depends on a boolean value.
Parameter<T>	addConditionalParameter(String dependsOn, Parameter<?> parameter)	Adds a specific sub-parameter that depends on a string value.
Parameter<T>	addGlobalSubParameter(Parameter<?> parameter)	Adds a global sub-parameter to this parameter.
Parameter<T>	addNonConfigurableSubParameter(String parameterName, Object value)	Adds a non-configurable sub-parameter to this parameter.
List<ConditionalParameter<T>>	conditionalParameters()	Returns the list of specific sub-parameters associated with this parameter.
Parameter<?>	findConditionalParameter(String parameterName)	Finds a specific sub-parameter given its name.
List<Parameter<?>>	findConditionalParameters(String parameterValue)	Finds a list of the specific sub-parameters associated with a particular parameter value.
Parameter<?>	findGlobalSubParameter(String parameterName)	Finds a global sub-parameter given its name.
List<Parameter<?>>	globalSubParameters()	Returns the list of global sub-parameters associated with this parameter.
String	name()	Returns the name of this parameter.
Map<String,Object>	nonConfigurableSubParameters()	Returns a map of non-configurable sub-parameters associated with this parameter.
abstract void	parse(String[] arguments)	Parses the value for this parameter from the given arguments.
void	parse(Function<String,T> parseFunction, String[] args)	Parses the value for this parameter using the provided function and arguments, and also parses all global and specific sub-parameters.
String	toString()	Returns a string representation of this parameter, including its value and sub-parameters.
T	value()	Returns the current value of this parameter.
void	value(T value)	Sets the value of this parameter.

Methods inherited from class java.lang.Object

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

Constructor Details

Parameter

protected Parameter(String name)

Constructs a parameter with the given name.

Parameters:

name - the name of the parameter

Method Details

parse

public abstract void parse(String[] arguments)

Parses the value for this parameter from the given arguments. Subclasses must implement this method to define their parsing logic.

Parameters:

arguments - the arguments from which to parse the parameter value

parse

public void parse(Function<String,T> parseFunction,
 String[] args)

Parses the value for this parameter using the provided function and arguments, and also parses all global and specific sub-parameters.

Parameters:

parseFunction - the function to convert a string to the parameter value type

args - the argument array

name

public String name()

Returns the name of this parameter.

Returns:

the parameter name

value

public T value()

Returns the current value of this parameter.

Returns:

the parameter value

value

public void value(T value)

Sets the value of this parameter.

Parameters:

value - the value to set

globalSubParameters

public List<Parameter<?>> globalSubParameters()

Returns the list of global sub-parameters associated with this parameter. Global sub-parameters are always relevant, regardless of the parameter's value.

Returns:

a list of global sub-parameters

addGlobalSubParameter

public Parameter<T> addGlobalSubParameter(Parameter<?> parameter)

Adds a global sub-parameter to this parameter.

Parameters:

parameter - the global sub-parameter to add

conditionalParameters

public List<ConditionalParameter<T>> conditionalParameters()

Returns the list of specific sub-parameters associated with this parameter. Specific sub-parameters are only relevant when the parameter has a certain value or condition.

Returns:

a list of specific sub-parameters

addConditionalParameter

public Parameter<T> addConditionalParameter(String dependsOn,
 Parameter<?> parameter)

Adds a specific sub-parameter that depends on a string value.

Parameters:

dependsOn - the value or condition that activates the sub-parameter

parameter - the specific sub-parameter to add

addConditionalParameter

public Parameter<T> addConditionalParameter(Boolean dependsOn,
 Parameter<?> parameter)

Adds a specific sub-parameter that depends on a boolean value.

Parameters:

dependsOn - the value or condition that activates the sub-parameter

parameter - the specific sub-parameter to add

addNonConfigurableSubParameter

public Parameter<T> addNonConfigurableSubParameter(String parameterName,
 Object value)

Adds a non-configurable sub-parameter to this parameter. These are typically used for internal or fixed configuration values.

Parameters:

parameterName - the name of the sub-parameter

value - the value of the sub-parameter

nonConfigurableSubParameters

public Map<String,Object> nonConfigurableSubParameters()

Returns a map of non-configurable sub-parameters associated with this parameter.

Returns:

a map of non-configurable sub-parameters

findGlobalSubParameter

public Parameter<?> findGlobalSubParameter(String parameterName)

Finds a global sub-parameter given its name.

Parameters:

parameterName - the name of the global sub-parameter

Returns:

the global sub-parameter, or null if not found

findConditionalParameter

public Parameter<?> findConditionalParameter(String parameterName)

Finds a specific sub-parameter given its name.

Parameters:

parameterName - the name of the specific sub-parameter

Returns:

the specific sub-parameter, or null if not found

findConditionalParameters

public List<Parameter<?>> findConditionalParameters(String parameterValue)

Finds a list of the specific sub-parameters associated with a particular parameter value.

Parameters:

parameterValue - the value that activates the specific sub-parameters

Returns:

a list of specific sub-parameters for the given value

toString

public String toString()

Returns a string representation of this parameter, including its value and sub-parameters.

Overrides:

toString in class Object

Returns:

a string representation of the parameter