Module org.opengis.geoapi

Package org.opengis.feature

Interface Operation

All Superinterfaces:

IdentifiedType, PropertyType

@Classifier(METACLASS)
@UML(identifier="Operation",
     specification=ISO_19109)
public interface Operation
extends PropertyType

Describes the behaviour of a feature type as a function or a method. Operations can:

• Compute values from the attributes.
• Perform actions that change the attribute values.

Example: a mutator operation may raise the height of a dam. This changes may affect other properties like the watercourse and the reservoir associated with the dam.

This Operation type is used for defining the required parameters and expected result.

Since:

3.1

Method Summary

Modifier and Type	Method	Description
Property	apply(Feature feature, ParameterValueGroup parameters)	Executes the operation on the specified feature with the specified parameters.
ParameterDescriptorGroup	getParameters()	Returns a description of the input parameters.
IdentifiedType	getResult()	Returns the expected result type, or null if none.

Methods inherited from interface org.opengis.feature.IdentifiedType

getDefinition, getDescription, getDesignation, getName

Method Details

getParameters

@UML(identifier="signature",
     obligation=MANDATORY,
     specification=ISO_19109)
ParameterDescriptorGroup getParameters()

Returns a description of the input parameters.

Returns:

description of the input parameters.

getResult

@UML(identifier="signature",
     obligation=MANDATORY,
     specification=ISO_19109)
IdentifiedType getResult()

Returns the expected result type, or null if none.

Returns:

the type of the result, or null if none.

apply

Property apply(Feature feature,
 ParameterValueGroup parameters)
        throws FeatureOperationException

Executes the operation on the specified feature with the specified parameters. The parameters argument should be an instance created like below, where the text in italic shall be replaced by operation-specific text:

ParameterValueGroup p = operation.getParameters().createValue();
p.parameter("a parameter 1").setValue(aValue1);
p.parameter("a parameter 2").setValue(aValue2);

The value returned by this method depends on the value returned by getResult():

• If getResult() returns null, then this method should return null.
• If getResult() returns an instance of AttributeType, then this method shall return an instance of Attribute and the Attribute.getType() == getResult() relation should hold.
• If getResult() returns an instance of FeatureAssociationRole, then this method shall return an instance of FeatureAssociation and the FeatureAssociation.getRole() == getResult() relation should hold.

Analogy with Java reflection: if we compare Operation to Method in the Java language, then this method is equivalent to Method.invoke(Object, Object...). The Feature argument is equivalent to this in the Java language, and may be null if the operation does not need a feature instance (like static methods in the Java language).

API note: the method signature is compatible with BiFunction<Feature, ParameterValueGroup, Property> from the java.util.function package.

Parameters:

feature - the feature on which to execute the operation. Can be null if the operation does not need feature instance.

parameters - the parameters to use for executing the operation. Can be null if the operation does not take any parameters.

Returns:

the operation result, or null if this operation does not produce any result.

Throws:

FeatureOperationException - if the operation cannot complete.