com.luciad.edit.features

Class FeatureHandlesProvider

java.lang.Object

com.luciad.edit.features.FeatureHandlesProvider

All Implemented Interfaces:

IFeatureHandlesProvider, AutoCloseable

public final class FeatureHandlesProvider
extends Object
implements AutoCloseable, IFeatureHandlesProvider

Default handles provider for features.

It can create a handles for features by:

• creating a handle to translate the entire feature
• delegating to a geometry handles provider.

The delegate geometry handles are created using an IGeometryHandlesProvider. The geometry is extracted from the feature using the IFeatureGeometryProvider that is provided by the feature layer. This IFeatureGeometryProvider can be configured in the feature layer.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	FeatureHandlesProvider.IHandleFactory Allows you to specify the translate handle that is used by this handles provider.

Constructor Summary

Constructors

Constructor and Description
FeatureHandlesProvider() Creates a new instance.

Method Summary

Modifier and Type	Method and Description
boolean	canProvide(Observable<Feature> feature, FeatureEditContext context) Indicates if this handles provider can create handles for the given Feature.
void	close()
protected void	finalize()
IGeometryHandlesProvider	getGeometryHandlesProvider()
FeatureHandlesProvider.IHandleFactory	getHandleFactory()
IEditHandles	provide(Observable<Feature> feature, FeatureEditContext context, IFeatureEditCallback featureEditCallback) Returns handles for the given feature.
void	setGeometryHandlesProvider(IGeometryHandlesProvider handlesProvider) Sets the IGeometryHandlesProvider that is used.
void	setHandleFactory(FeatureHandlesProvider.IHandleFactory handleFactory) Sets the IHandleFactory that is used by this handles provider to create a new translate handle.

Methods inherited from class java.lang.Object

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

Constructor Detail

FeatureHandlesProvider

public FeatureHandlesProvider()

Creates a new instance.

Method Detail

finalize

protected void finalize()

Overrides:

finalize in class Object

close

public void close()

Specified by:

close in interface AutoCloseable

canProvide

public boolean canProvide(@NotNull
                          Observable<Feature> feature,
                          @NotNull
                          FeatureEditContext context)

Indicates if this handles provider can create handles for the given Feature.

Specified by:

canProvide in interface IFeatureHandlesProvider

Parameters:

feature - an observable Feature.

context - the context. Contains additional information about the edited feature.

Returns:

if this handles provider can create handles for the given Feature.

provide

@Nullable
public IEditHandles provide(@NotNull
                                      Observable<Feature> feature,
                                      @NotNull
                                      FeatureEditContext context,
                                      @NotNull
                                      IFeatureEditCallback featureEditCallback)

Returns handles for the given feature.

If this provider doesn't support the given feature, it can return null.

Specified by:

provide in interface IFeatureHandlesProvider

Parameters:

feature - the observable feature for which to create handles.

context - the context. Contains additional information about the edited feature.

featureEditCallback - a callback that notifies the caller when the Feature has changed.

Returns:

handles for the given feature. If this provider doesn't support the given feature, it can return null.

getHandleFactory

@NotNull
public FeatureHandlesProvider.IHandleFactory getHandleFactory()

Returns:

the handle factory used by the handles provider

setHandleFactory

public void setHandleFactory(@NotNull
                             FeatureHandlesProvider.IHandleFactory handleFactory)

Sets the IHandleFactory that is used by this handles provider to create a new translate handle.

If this method is not called, a default handle factory is used. You can change the behavior of this default handle factory by:

• retrieving it
• wrapping it with your own IHandleFactory implementation, by delegating to the default factory
• omitting/replacing the handle that is returned

Parameters:

handleFactory - a handle factory

getGeometryHandlesProvider

@NotNull
public IGeometryHandlesProvider getGeometryHandlesProvider()

Returns:

the IGeometryHandlesProvider that is used.

See Also:

setGeometryHandlesProvider

setGeometryHandlesProvider

public void setGeometryHandlesProvider(@NotNull
                                       IGeometryHandlesProvider handlesProvider)

Sets the IGeometryHandlesProvider that is used.

If this method is not called, or if null is passed, a default implementation is used.

Parameters:

handlesProvider - the IGeometryHandlesProvider to use. Can be null.