org.opengis.parameter

Interface ParameterDescriptor<T>

Type Parameters:

T - The type of parameter values.

All Superinterfaces:

GeneralParameterDescriptor, IdentifiedObject

@UML(identifier="CC_OperationParameter",
     specification=ISO_19111)
public interface ParameterDescriptor<T>
extends GeneralParameterDescriptor

The definition of a parameter used by an operation method. Most parameter values are numeric, but other types of parameter values are possible.

Since:

2.0

See Also:

ParameterValue, ParameterDescriptorGroup

Departure from OGC/ISO specification:
GeoAPI uses a name which contains the "Descriptor" word for consistency with other libraries in Java (e.g. ParameterListDescriptor in Java Advanced Imaging).

Field Summary

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Method Summary

Modifier and Type	Method and Description
ParameterValue<T>	createValue() Creates a new instance of parameter value initialized with the default value.
T	getDefaultValue() Returns the default value for the parameter.
Comparable<T>	getMaximumValue() Returns the maximum parameter value.
Comparable<T>	getMinimumValue() Returns the minimum parameter value.
Unit<?>	getUnit() Returns the unit for default, minimum and maximum values.
Set<T>	getValidValues() Returns the set of allowed values when these are restricted to some finite set or returns null otherwise.
Class<T>	getValueClass() Returns the class that describe the type of the parameter.

Methods inherited from interface GeneralParameterDescriptor

getMaximumOccurs, getMinimumOccurs

Methods inherited from interface IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Method Detail

createValue

ParameterValue<T> createValue()

Creates a new instance of parameter value initialized with the default value. The parameter value descriptor for the created parameter value will be this object.

Specified by:

createValue in interface GeneralParameterDescriptor

Returns:

A new parameter initialized to its default value.

Departure from OGC/ISO specification:
This method is not part of the ISO specification. It is provided in GeoAPI as a kind of factory method.

getValueClass

@UML(identifier="GC_ParameterInfo.type",
     obligation=MANDATORY,
     specification=ISO_19111)
Class<T> getValueClass()

Returns the class that describe the type of the parameter.

Returns:

The type of parameter values.

getValidValues

Set<T> getValidValues()

Returns the set of allowed values when these are restricted to some finite set or returns null otherwise. The returned set usually contains code list or enumeration elements.

Returns:

A finite set of valid values (usually from a code list), or null if it doesn't apply.

Departure from OGC/ISO specification:
This method is not part of ISO specification. It is provided as a complement of information.

getDefaultValue

@UML(identifier="GC_ParameterInfo.defaultValue",
     obligation=OPTIONAL,
     specification=ISO_19111)
T getDefaultValue()

Returns the default value for the parameter. The return type can be any type including a Number or a String. If there is no default value, then this method returns null.

Returns:

The default value, or null in none.

getMinimumValue

@UML(identifier="GC_ParameterInfo.minimumValue",
     obligation=OPTIONAL,
     specification=ISO_19111)
Comparable<T> getMinimumValue()

Returns the minimum parameter value. If there is no minimum value, or if minimum value is inappropriate for the parameter type, then this method returns null.

When the getValueClass() is an array or Collection getMinimumValue may be used to constrain the contained elements.

Returns:

The minimum parameter value (often an instance of Double), or null.

getMaximumValue

@UML(identifier="GC_ParameterInfo.maximumValue",
     obligation=OPTIONAL,
     specification=ISO_19111)
Comparable<T> getMaximumValue()

Returns the maximum parameter value. If there is no maximum value, or if maximum value is inappropriate for the parameter type, then this method returns null.

When the getValueClass() is an array or Collection getMaximumValue may be used to constraint the contained elements.

Returns:

The minimum parameter value (often an instance of Double), or null.

getUnit

Unit<?> getUnit()

Returns the unit for default, minimum and maximum values. This attribute apply only if the values is of numeric type (usually an instance of Double).

Returns:

The unit for numeric value, or null if it doesn't apply to the value type.

Departure from OGC/ISO specification:
This method is not part of ISO specification. It is provided as a complement of information.