Module org.opengis.geoapi
Package org.opengis.feature
package org.opengis.feature
Defines the structure and content of views of real-world phenomenon.
A feature acts as a model of a real world entity. As such it has many similarities to object oriented programming
ideas of classes, fields and methods. A
FeatureType
is similar to a
Class
in Java and can contain three kinds of properties:
AttributeType
holds information about an attribute (similar to aField
in Java).FeatureAssociationRole
defines a relationship a feature is involved in (aggregation, composition, etc.).Operation
describes functionality a feature is able to perform (similar toMethod
in Java).
Record
instances.
An important aspect of a Feature
is the fact that it is a dynamic data construct defined at runtime.
Traditionally the Java programming language represents dynamic data structures using java.util.Map
.
One could think of a Feature
as a Map
in which the keys (i.e. the property names) are well defined.
Feature types model is described in the ISO 19109 specification. The following table shows the class hierarchy:
Types (from ISO 19109) | Instances (GeoAPI specific) |
---|---|
IdentifiedType ├─ FeatureType └─ PropertyType ├─ AttributeType ├─ FeatureAssociationRole └─ Operation |
Feature Property ├─ Attribute └─ FeatureAssociation |
- Since:
- 3.1
-
ClassDescriptionAttribute<V>An instance of an
AttributeType
containing the value of an attribute in a feature.Definition of an attribute in a feature type.An instance of aDynamicAttributeType
containing time-dependent values of an attribute.Definition of a dynamic attribute in a moving feature type.An instance of aFeatureType
containing values for a real-world phenomena.An instance of anFeatureAssociationRole
containing the associated feature.Indicates the role played by the association between two features.Thrown whenFeatureType.newInstance()
is invoked but the feature cannot be instantiated.Thrown whenOperation.apply(…)
is invoked but the operation cannot complete.Abstraction of a real-world phenomena.Identification and description information inherited by property types and feature types.Thrown when anAttribute
value or aFeatureAssociation
does not met the constraints (other than Java class) specified by its type.Indicates that an operation cannot be completed properly because of a mismatch in the attribute or feature type of operands.Thrown whenAttribute.getValue()
orFeatureAssociation.getValue()
is invoked on a property containing more than one value.Describes the behaviour of a feature type as a function or a method.Thrown when the temporal position given to a dynamic attribute is outside the period of validity.An instance of aPropertyType
.Thrown when a property requested by its name is not found in aFeature
orFeatureType
.Characteristics that may be associated with aFeatureType
.
FeatureType
is now defined in theorg.opengis.feature
package.