Package org.apache.sis.parameter
Class AbstractParameterDescriptor
Object
FormattableObject
AbstractIdentifiedObject
AbstractParameterDescriptor
- All Implemented Interfaces:
- Serializable,- Formattable,- Deprecable,- LenientComparable,- GeneralParameterDescriptor,- IdentifiedObject
- Direct Known Subclasses:
- DefaultParameterDescriptor,- DefaultParameterDescriptorGroup
public abstract class AbstractParameterDescriptor
extends AbstractIdentifiedObject
implements GeneralParameterDescriptor
Abstract definition of a parameter or group of parameters used by a coordinate operation or a process.
 This interface combines information provided by Referencing by Coordinates (ISO 19111),
 Service Metadata (ISO 19115) and Web Processing Services (WPS) standards.
 The main information are:
 
   
| Getter method | ISO 19111 | WPS | ISO 19115 | Remarks | 
|---|---|---|---|---|
| getName() | name | Identifier | name | See Parameters.getMemberName(ParameterDescriptor)forMemberName↔Identifiermapping. | 
| AbstractIdentifiedObject.getDescription() | Abstract | description | Also known as “definition”. | |
| getDirection() | direction | Tells if the parameter is a WPS InputorOutputstructure. | ||
| getMinimumOccurs() | minimumOccurs | MinOccurs | optionality | optionality   = (minimumOccurs > 0) | 
| getMaximumOccurs() | maximumOccurs | MaxOccurs | repeatability | repeatability = (maximumOccurs > 1) | 
- Since:
- 0.5
- See Also:
Defined in the sis-referencing module
- 
Field SummaryFields inherited from class AbstractIdentifiedObjectDEPRECATED_KEY, LOCALE_KEYFields inherited from interface IdentifiedObjectALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY
- 
Constructor SummaryConstructorsModifierConstructorDescriptionprotectedAbstractParameterDescriptor(Map<String, ?> properties, int minimumOccurs, int maximumOccurs) Constructs a parameter descriptor from a set of properties.protectedConstructs a new parameter descriptor with the same values than the specified one.
- 
Method SummaryModifier and TypeMethodDescriptionbooleanequals(Object object, ComparisonMode mode) Compares the specified object with this parameter for equality.protected StringFormats this descriptor as a pseudo-Well Known Text element.Class<? extends GeneralParameterDescriptor>Returns the GeoAPI interface implemented by this class.intThe maximum number of times that values for this parameter group or parameter can be included.intThe minimum number of times that values for this parameter group or parameter are required.voidprint()Prints a string representation of this descriptor to the standard output stream.Returns a string representation of this descriptor.Methods inherited from class AbstractIdentifiedObjectcastOrCopy, computeHashCode, equals, formatTo, getAlias, getDescription, getIdentifiers, getName, getRemarks, hashCode, isDeprecated, isHeuristicMatchForNameMethods inherited from class FormattableObjecttoString, toWKTMethods inherited from class Objectclone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface GeneralParameterDescriptorcreateValueMethods inherited from interface IdentifiedObjectgetAlias, getIdentifiers, getName, getRemarks, toWKT
- 
Constructor Details- 
AbstractParameterDescriptorprotected AbstractParameterDescriptor(Map<String, ?> properties, int minimumOccurs, int maximumOccurs) Constructs a parameter descriptor from a set of properties. The properties map is given unchanged to the super-class constructor. The following table is a reminder of main (not all) properties:Recognized properties (non exhaustive list) Property name Value type Returned by "name" ReferenceIdentifierorStringAbstractIdentifiedObject.getName()"alias" GenericNameorCharSequence(optionally as array)AbstractIdentifiedObject.getAlias()"identifiers" ReferenceIdentifier(optionally as array)AbstractIdentifiedObject.getIdentifiers()"remarks" InternationalStringorStringAbstractIdentifiedObject.getRemarks()- Parameters:
- properties- the properties to be given to the identified object.
- minimumOccurs- the minimum number of times that values for this parameter group are required, or 0 if no restriction.
- maximumOccurs- the maximum number of times that values for this parameter group are required, or- Integer.MAX_VALUEif no restriction.
 
- 
AbstractParameterDescriptorConstructs a new parameter descriptor with the same values than the specified one. This copy constructor provides a way to convert an arbitrary implementation into a SIS one or a user-defined one (as a subclass), usually in order to leverage some implementation-specific API.This constructor performs a shallow copy, i.e. the properties are not cloned. - Parameters:
- descriptor- the object to shallow copy.
 
 
- 
- 
Method Details- 
getInterfaceReturns the GeoAPI interface implemented by this class. The default implementation returnsGeneralParameterDescriptor.class. Subclasses implementing a more specific GeoAPI interface shall override this method.- Overrides:
- getInterfacein class- AbstractIdentifiedObject
- Returns:
- the parameter descriptor interface implemented by this class.
 
- 
getMinimumOccurspublic int getMinimumOccurs()The minimum number of times that values for this parameter group or parameter are required. A value of 0 means an optional parameter.- Specified by:
- getMinimumOccursin interface- GeneralParameterDescriptor
- Returns:
- the minimum occurrence.
 
- 
getMaximumOccurspublic int getMaximumOccurs()The maximum number of times that values for this parameter group or parameter can be included. A value greater than 1 means a repeatable parameter.- Specified by:
- getMaximumOccursin interface- GeneralParameterDescriptor
- Returns:
- the maximum occurrence.
 
- 
equalsCompares the specified object with this parameter for equality.- Specified by:
- equalsin interface- LenientComparable
- Overrides:
- equalsin class- AbstractIdentifiedObject
- Parameters:
- object- the object to compare to- this.
- mode- the strictness level of the comparison.
- Returns:
- trueif both objects are equal according the given comparison mode.
- See Also:
 
- 
toStringReturns a string representation of this descriptor.This method is for information purpose only and may change in future SIS version. - Overrides:
- toStringin class- FormattableObject
- Returns:
- the Well Known Text (WKT) or an alternative representation of this object.
 
- 
printPrints a string representation of this descriptor to the standard output stream. If a console is attached to the running JVM (i.e. if the application is run from the command-line and the output is not redirected to a file) and if Apache SIS thinks that the console supports the ANSI escape codes (a.k.a. X3.64), then a syntax coloring will be applied.This is a convenience method for debugging purpose and for console applications. - Overrides:
- printin class- FormattableObject
 
- 
formatToFormats this descriptor as a pseudo-Well Known Text element. The WKT specification does not define any representation of parameter descriptors. Apache SIS fallbacks on a list of descriptors. The text formatted by this method is flagged as invalid WKT.- Overrides:
- formatToin class- AbstractIdentifiedObject
- Parameters:
- formatter- the formatter where to format the inner content of this WKT element.
- Returns:
- "Parameter"or- "ParameterGroup".
- See Also:
 
 
-