- 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:
- Departure from OGC/ISO abstract specification:
Change of name without change in functionality
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 TypeMethodDescriptionCreates a new instance of parameter value initialized with the default value.Returns the default value for the parameter.Returns the maximum parameter value.Returns the minimum parameter value.Unit<?>
getUnit()
Returns the set of allowed values when these are restricted to some finite set or returnsnull
otherwise.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 Details
-
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 bethis
object.- Specified by:
createValue
in interfaceGeneralParameterDescriptor
- Returns:
- A new parameter initialized to its default value.
- Departure from OGC/ISO abstract specification:
Addition of element not in the ISO/OGC 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=OGC_01004) Class<T> getValueClass()Returns the class that describe the type of the parameter.- Returns:
- The type of parameter values.
-
getValidValues
Returns the set of allowed values when these are restricted to some finite set or returnsnull
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 abstract specification:
Addition of element not in the ISO/OGC 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=OGC_01004) T getDefaultValue()Returns the default value for the parameter. The return type can be any type including aNumber
or aString
. If there is no default value, then this method returnsnull
.- Returns:
- The default value, or
null
in none.
-
getMinimumValue
@UML(identifier="GC_ParameterInfo.minimumValue", obligation=OPTIONAL, specification=OGC_01004) 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 returnsnull
.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
), ornull
.
-
getMaximumValue
@UML(identifier="GC_ParameterInfo.maximumValue", obligation=OPTIONAL, specification=OGC_01004) 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 returnsnull
.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
), ornull
.
-
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 ofDouble
).- Returns:
- The unit for numeric value, or
null
if it doesn't apply to the value type. - Departure from OGC/ISO abstract specification:
Addition of element not in the ISO/OGC specification
This method is not part of ISO specification. It is provided as a complement of information.
-