org.gvsig.andami.plugins

Interface IExtension

All Known Subinterfaces:

ExclusiveUIExtension, HiddableExtension

All Known Implementing Classes:

About, AboutExpressionFieldExtension, AbstractGeometryMeasurementExtension, AbstractTableEditExtension, AbstractTogglePropertyExtension, AbstractTogglePropertyExtension, AddDependencyExtension, AddEventThemeExtension, AddLayer, AddLayerDropingFile, AddToLocatorExtension, AddXYPointThemeExtension, AnimationSupportExtension, AnnotationAboutExtension, AnnotationExtension, AreaMeasurementExtension, AttributeEditorExtension, AutoCompletePolygonExtension, BasicSymbologyExtension, BingMapsExtension, BrowseSymbolsExtension, CacheExtension, CADExtension, CatalogClientExtension, CenterViewToPointExtension, ChartExtension, ChartLegendExtension, CheckSOAndArquitectureExtension, ClearSelectionExtension, ComplexLegendExtension, ComplexSelectionGeometryExtension, ConfigExtension, Consola, ConsolideTranslationsExtension, CoordinateReferenceSystemExtension, CopyFeaturesToClipboardExtension, CreateDefaultFormDefinitionExtension, CustomizeExtension, DataLocatorExtension, DataTransformExtension, DeleteSearchesExtension, DerivedGeometriesExtension, DisableSnappingExtension, DisplayGridExtension, DisposableManagementExtension, DownloaderExtension, DWGRegisterExtension, DyschromatopsiaExtension, EditingExtension, EditingListenerExtension, EnableSnappingExtension, EnableSnapToGridExtension, ErmapperExtension, ExploitExtension, Export, ExportLayoutExtension, ExportPortableViewToViewExtension, ExporttoLayerExtension, ExporttoPreferencesExtension, ExporttoTableExtension, ExportWebMapContextExtension, ExpressionFieldExtension, ExtDB_Spatial, ExtendedLabelingExtension, Extension, ExtensionDecorator, FFrameLegendExtension, FFrameViewAddLayerExtension, FFrameViewExtension, FFrameViewPanExtension, FFrameViewZoomPrev, FlatnessExtension, FlatnessExtension, GazetteerExtension, GdalExtension, GdalExtension, GdalExtension, GeneratePackagePortableViewExtension, GenericToolBarExtension, GeoprocessExtension, GeoprocessPointSelectionExtension, GeoreferencingExtension, GMLExtension, GoogleMapsExtension, GoogleStreetViewExtension, GPELibraryExtension, GPXClientExtension, HelpExtension, HyperlinkExtension, I18nExtension, ImportPictureMarkerSymbolsExtension, ImportWebMapContextExtension, InfoByRasterPointExtension, InfoByWMSPointExtension, InfoToolExtension, InitializeApplicationExtension, InitialWarningExtension, InitialWarningExtension, InsertLineExtension, InsertMultiPointExtension, InsertPointExtension, InsertPolygonExtension, InsertPolyLineExtension, InstallPackageExtension, InternalPolygonExtension, JCrsExtension, JoinExtension, JoinToolExtension, LayerPropertiesExtension, LayoutAddChartExtension, LayoutCommandStackExtension, LayoutEditableControls, LayoutEditVertexExtension, LayoutExtension, LayoutGraphicControls, LayoutInsertOverViewExtension, LayoutInsertToolsExtension, LayoutMainExtension, LayoutRedoExtension, LayoutUndoExtension, LibraryExtension, LinkConfigExtension, LizardTechExtension, LogViewerExtension, MakeMavenProjectExtension, MakePluginPackageExtension, MapSheetsCreationExtension, MapSheetsManipulationExtension, MapSheetsPrint, MapSheetsPrintExtension, MatrixExtension, MeasureExtension, MetadataPropertiesExtension, MoveGeometryExtension, MultifileClientExtension, NetCDFClientExtension, NewLayerExtension, NewLayerPreferencesExtension, NewPortableViewExtension, NewSkin, OGRExtension, OpenRelatedDocumentExtension, OpenRelatedPortableViewExtension, OpenSourceViewExtension, OSMClientExtension, PaletteViewInfoExtension, PasteFeaturesFromClipboardExtension, PerimeterMeasurementExtension, PortableViewBasicMapControlExtension, PortableViewEditorExtension, PortableViewExtension, PortableViewInfoByPointToolsExtension, PortableViewMeasureToolsExtension, PostGISRasterExtension, PreferencesExtension, PrincipalComponentsExtension, Print, PrintProperties, PrintTable, ProjectExtension, PublishClientExtension, RasterAlgorithmsForSextanteExtension, RasterExtension, RasterMainPluginExtension, RedoTableExtension, RedoViewExtension, RegeneratePortableViewExtension, RemoveTableLink, RemoveTableUnion, ReprojectExtension, RestoreViewInfoExtension, ROIMaskExtension, ScriptingExtension, ScriptLaunchExtension, SeismicClientExtension, SelectAllExtension, SelectByAttributesExtension, SelectByBufferExtension, SelectByCircleExtension, SelectByPolylineExtension, SelectionCountExtension, SelectionGeometryExtension, ServiceExtension, SextanteAlgorithmsExtension, ShowDevelInfoExtension, ShowGraphicsLayerTable, ShowLayerAsForm, ShowTable, ShowTableAsForm, SLDConverterExtension, SnappingExtension, SplitGeometryCADToolExtension, StartEditing, StatusBar, StopEditing, StretchExtension, SymbolInstallerExtension, SystemGCExtension, TableCommandStackExtension, TableEditAttributes, TableEditChangeColumnsExtension, TableEditCopyExtension, TableEditCutExtension, TableEditInsertExtension, TableEditPasteExtension, TableEditRemoveRowExtension, TableEditStartExtension, TableEditStopExtension, TableExtension, TableFieldOperations, TableNumericFieldOperations, TableOperations, TableProperties, TableRefresh, TableRowsOperations, TagExtension, TasseledCapExtension, TimeSupportExtension, ToolbarMenus, TranslationsPackageExtension, UndoTableExtension, UndoViewExtension, ViewCommandStackExtension, ViewControls, ViewInvertSelection, ViewProjectWindow, ViewPropertiesExtension, ViewSelectionByTheme, ViewSelectionControls, ViewSimpleSelectionControl, WCSClientExtension, WebMapClientExtension, WFSClientExtension, WMSClientExtension, WMTSClientExtension, ZoomNext, ZoomPrev, ZoomToSelectExtension

public interface IExtension

Extensions are the way in which plugins extend Andami. Every class implementing this interface is an extension (although this class should not be directly implemented, extending the Extension abstract class is the preferred way). During startup, Andami creates an instance from each extension. Extensions are able to add controls (tools, toolbars and menus) to the user interface (GUI); when these controls are clicked or modified, Andami will call the execute() method from the associated extension. Extensions will also control whether their associated controls are enabled or not, and whether they are visible or hidden.

Besides implementing this interface, extensions are required to have an empty constructor, because it will be invoked to create the extension's instance.

On correctly installed plugins, an instance of every plugin's extension will be created. Then, the initialize() method will be executed for each extension.

Each time the active window is switched and every time the execute method is called, Andami checks the isEnabled() and isVisible() for each extension, to decide whether they will be enabled and visible.

The execute() method will be called from the GUI thread, so it will block the GUI until it finishes. Therefore, execution must be fast. If long process must be started from the execute method, a new thread must be created.

Normally, extensions should not directly implement this interface, but they should extend the Extension abstract class.

See Also:

Extension

Method Summary

Methods

Modifier and Type	Method and Description
void	execute(String actionCommand) This method is executed when the user clicks on any of the controls associated with this extension (menus, tools, etc).
IExtensionStatus	getStatus() Gets the status of the extension, which may be queried to check if the extension has some unsaved data or some associated background tasks.
IExtensionStatus	getStatus(IExtension extension)
void	initialize() Extension's initialization code should be here.
boolean	isEnabled() This method is invoked by Andami to check whether the extension (and its associated controls) is enabled or disabled.
boolean	isVisible() This method is invoked by Andami to check whether the extension (and its associated controls) is visible or hidden.
void	postInitialize() Extension's post-initialization code should be here.
void	terminate() Extension's termination code should be here.

Method Detail

initialize

void initialize()

Extension's initialization code should be here. This method is called for all the extensions during Andami's initialization.

postInitialize

void postInitialize()

Extension's post-initialization code should be here. This method is called for all the extensions during Andami's initialization, after initialize() has been called for ALL the extensions.

terminate

void terminate()

Extension's termination code should be here. This method is called for all the extensions during Andami's termination.

execute

void execute(String actionCommand)

This method is executed when the user clicks on any of the controls associated with this extension (menus, tools, etc).

Parameters:

actionCommand - An String specifying the action to execute. This is useful when there are different controls associated with the same extension.

isEnabled

boolean isEnabled()

This method is invoked by Andami to check whether the extension (and its associated controls) is enabled or disabled. Disabled controls (menus and buttons) are shown in light grey colour, and it is not possible to click on them.

Returns:

true if the extension should be enabled, false otherwise

isVisible

boolean isVisible()

This method is invoked by Andami to check whether the extension (and its associated controls) is visible or hidden.

Returns:

true if the extension should be visible, false otherwise

getStatus

IExtensionStatus getStatus()

Gets the status of the extension, which may be queried to check if the extension has some unsaved data or some associated background tasks.

Returns:

An IExtensionStatus object, containing the status of this extension.

See Also:

IExtensionStatus

getStatus

IExtensionStatus getStatus(IExtension extension)