org.geotools.parameter

Class DefaultParameterDescriptorGroup

Object

Formattable

AbstractIdentifiedObject

AbstractParameterDescriptor

DefaultParameterDescriptorGroup

All Implemented Interfaces:

Serializable, GeneralParameterDescriptor, ParameterDescriptorGroup, IdentifiedObject

Direct Known Subclasses:

ImagingParameterDescriptors, MatrixParameterDescriptors

public class DefaultParameterDescriptorGroup
extends AbstractParameterDescriptor
implements ParameterDescriptorGroup

The definition of a group of related parameters used by an operation method.

Since:

2.1

Author:

Martin Desruisseaux (IRD)

See Also:

ParameterGroup, DefaultParameterDescriptor, Serialized Form

Field Summary

Fields inherited from class AbstractIdentifiedObject

EMPTY_ALIAS_ARRAY, EMPTY_IDENTIFIER_ARRAY, IDENTIFIER_COMPARATOR, NAME_COMPARATOR, REMARKS_COMPARATOR

Fields inherited from class Formattable

SINGLE_LINE

Fields inherited from interface IdentifiedObject

ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Constructor Summary

Constructors

Constructor and Description
DefaultParameterDescriptorGroup(Citation authority, String name, GeneralParameterDescriptor... parameters) Constructs a parameter group from a name and an authority.
DefaultParameterDescriptorGroup(Map<String,?> properties, GeneralParameterDescriptor... parameters) Constructs a parameter group from a set of properties.
DefaultParameterDescriptorGroup(Map<String,?> properties, int minimumOccurs, int maximumOccurs, GeneralParameterDescriptor... parameters) Constructs a parameter group from a set of properties.
DefaultParameterDescriptorGroup(ParameterDescriptorGroup group) Constructs a group with the same values than the specified one.
DefaultParameterDescriptorGroup(String name, GeneralParameterDescriptor... parameters) Constructs a parameter group from a name.

Method Summary

Modifier and Type	Method and Description
ParameterValueGroup	createValue() Creates a new instance of parameter value group initialized with the default values.
GeneralParameterDescriptor	descriptor(String name) Returns the first parameter in this group for the specified identifier code.
List<GeneralParameterDescriptor>	descriptors() Returns the parameters in this group.
boolean	equals(AbstractIdentifiedObject object, boolean compareMetadata) Compares the specified object with this parameter group for equality.
int	getMaximumOccurs() The maximum number of times that values for this parameter group are required.
int	hashCode() Returns a hash value for this parameter.

Methods inherited from class AbstractParameterDescriptor

formatWKT, getMinimumOccurs

Methods inherited from class AbstractIdentifiedObject

asSet, ensureAngularUnit, ensureLinearUnit, ensureNonNull, ensureNonNull, ensureTimeUnit, equals, equals, equals, equals, getAlias, getIdentifier, getIdentifier, getIdentifiers, getName, getName, getName, getProperties, getProperties, getRemarks, nameMatches, nameMatches, nameMatches

Methods inherited from class Formattable

cleanupThreadLocals, toString, toWKT, toWKT, toWKT, toWKT

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface GeneralParameterDescriptor

getMinimumOccurs

Methods inherited from interface IdentifiedObject

getAlias, getIdentifiers, getName, getRemarks, toWKT

Constructor Detail

DefaultParameterDescriptorGroup

public DefaultParameterDescriptorGroup(ParameterDescriptorGroup group)

Constructs a group with the same values than the specified one. This copy constructor may be used in order to wraps an arbitrary implementation into a Geotools one.

Since:

2.2

DefaultParameterDescriptorGroup

public DefaultParameterDescriptorGroup(String name,
                                       GeneralParameterDescriptor... parameters)

Constructs a parameter group from a name. This parameter group will be required exactly once.

Parameters:

name - The parameter group name.

parameters - The parameter descriptors for this group.

DefaultParameterDescriptorGroup

public DefaultParameterDescriptorGroup(Citation authority,
                                       String name,
                                       GeneralParameterDescriptor... parameters)

Constructs a parameter group from a name and an authority. This parameter group will be required exactly once.

Parameters:

authority - The authority (e.g. OGC).

name - The parameter group name.

parameters - The parameter descriptors for this group.

Since:

2.2

DefaultParameterDescriptorGroup

public DefaultParameterDescriptorGroup(Map<String,?> properties,
                                       GeneralParameterDescriptor... parameters)

Constructs a parameter group from a set of properties. This parameter group will be required exactly once. The properties map is given unchanged to the super-class constructor.

Parameters:

properties - Set of properties. Should contains at least "name".

parameters - The parameter descriptors for this group.

DefaultParameterDescriptorGroup

public DefaultParameterDescriptorGroup(Map<String,?> properties,
                                       int minimumOccurs,
                                       int maximumOccurs,
                                       GeneralParameterDescriptor... parameters)

Constructs a parameter group from a set of properties. The properties map is given unchanged to the super-class constructor.

Parameters:

properties - Set of properties. Should contains at least "name".

minimumOccurs - The minimum number of times that values for this parameter group are required.

maximumOccurs - The maximum number of times that values for this parameter group are required.

parameters - The parameter descriptors for this group.

Method Detail

getMaximumOccurs

public int getMaximumOccurs()

The maximum number of times that values for this parameter group are required.

Specified by:

getMaximumOccurs in interface GeneralParameterDescriptor

Specified by:

getMaximumOccurs in class AbstractParameterDescriptor

Returns:

The maximum occurence.

See Also:

AbstractParameterDescriptor.getMinimumOccurs()

createValue

public ParameterValueGroup createValue()

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

Specified by:

createValue in interface GeneralParameterDescriptor

Specified by:

createValue in interface ParameterDescriptorGroup

Specified by:

createValue in class AbstractParameterDescriptor

Returns:

A new parameter initialized to its default value.

descriptors

public List<GeneralParameterDescriptor> descriptors()

Returns the parameters in this group.

Specified by:

descriptors in interface ParameterDescriptorGroup

Returns:

The descriptor of this group.

descriptor

public GeneralParameterDescriptor descriptor(String name)
                                      throws ParameterNotFoundException

Returns the first parameter in this group for the specified identifier code.

Specified by:

descriptor in interface ParameterDescriptorGroup

Parameters:

name - The case insensitive identifier code of the parameter to search for.

Returns:

The parameter for the given identifier code.

Throws:

ParameterNotFoundException - if there is no parameter for the given identifier code.

equals

public boolean equals(AbstractIdentifiedObject object,
                      boolean compareMetadata)

Compares the specified object with this parameter group for equality.

Overrides:

equals in class AbstractParameterDescriptor

Parameters:

object - The object to compare to this.

compareMetadata - true for performing a strict comparaison, or false for comparing only properties relevant to transformations.

Returns:

true if both objects are equal.

hashCode

public int hashCode()

Returns a hash value for this parameter.

Overrides:

hashCode in class AbstractParameterDescriptor

Returns:

The hash code value. This value doesn't need to be the same in past or future versions of this class.