Package com.luciad.models.features

Class DefaultFeatureGeometryProvider

java.lang.Object

com.luciad.models.features.DefaultFeatureGeometryProvider

All Implemented Interfaces:

IFeatureGeometryProvider, AutoCloseable

public final class DefaultFeatureGeometryProvider
extends Object
implements AutoCloseable, IFeatureGeometryProvider

Default geometry provider that works for Features with a DataType using a GeometryDataAnnotation.

It is implemented as follows:

• getGeometry: Calls Feature#findGeometry
• applyGeometry: Uses Feature#asBuilder to copy-and-edit a feature, and replaces the Geometry value of the property in the GeometryDataAnnotation by a new Geometry

This class should not be used when:

• The geometry of the feature is not exposed using Feature#findGeometry. The geometry isn't an explicit part of the feature, for example, but you can derive it from other properties on the feature.
• The returned geometry is not the same as the geometry exposed by Feature#findGeometry. It can be useful to display a distinct geometry when a user edits a feature. For example, when users edit the location and orientation of a vessel, you can show an Ellipse, which also has a location and an orientation.
• The feature has properties that are derived from the geometry. A simple example is a feature that has a Geometry property, and a property with the length of that geometry. When the Geometry property changes, the length property needs to change as well. You can do so by providing a custom implementation of IFeatureGeometryProvider#applyGeometry that changes the geometry, but also changes the length property.

In these cases, a custom IFeatureGeometryProvider implementation needs to be used.

Constructor Summary

Constructors

Constructor	Description
DefaultFeatureGeometryProvider()

Method Summary

Modifier and Type	Method	Description
Feature	applyGeometry(Feature originalFeature, Geometry newGeometry)	Updates the original Feature using the modified Geometry, and returns it.
void	close()
protected void	finalize()
Geometry	getGeometry(Feature feature)	Return the geometry for a Feature (for example a Geometry using which a Geometry can be edited or created).

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DefaultFeatureGeometryProvider

public DefaultFeatureGeometryProvider()

Method Details

finalize

protected void finalize()

Overrides:

finalize in class Object

close

public void close()

Specified by:

close in interface AutoCloseable

getGeometry

@Nullable
public Geometry getGeometry(@NotNull
 Feature feature)

Return the geometry for a Feature (for example a Geometry using which a Geometry can be edited or created).

This Geometry is not necessarily the same geometry as the one used for painting.

See IFeatureGeometryProvider for more information.

Specified by:

getGeometry in interface IFeatureGeometryProvider

Parameters:

feature - the Feature to edit

Returns:

the Geometry using which a Feature can be edited, or null if the Feature can not be edited using a Geometry

applyGeometry

@Nullable
public Feature applyGeometry(@NotNull
 Feature originalFeature,
 @NotNull
 Geometry newGeometry)

Updates the original Feature using the modified Geometry, and returns it.

This Geometry is not necessarily the same geometry as the one used for painting. See IFeatureGeometryProvider for an example.

Specified by:

applyGeometry in interface IFeatureGeometryProvider

Parameters:

originalFeature - the original Feature

newGeometry - a new Geometry to apply on the Feature

Returns:

a new Feature, based on a modified Geometry