javax.ide.extension.spi

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> javax >> ide >> extension >> [ spi overview ]

PREV PACKAGE NEXT PACKAGE

Package javax.ide.extension.spi

The ide package is where all JSR 198 packages are rooted.

See:
Description

Interface Summary

DependencyTree.EnabledExtensionLookup Mechanism used by this class to look up whether an extension is enabled.

ExtensionSource Represents an extension source.

Class Summary

BaseExtensionVisitor A base class for ExtensionVisitor which processes the attributes of the extension tag.

DefaultElementContext A default XML context implementation.

DefaultExtension This class maintains general information about an extension.

DefaultHookVisitorFactory The default implementation of the visitor factory for hooks.

DependenciesVisitor Visitor implementation for <dependencies>

DependencyTree DependencyTree is responsible for determining dependencies between extensions and providing a load order that satisfies those dependencies.

DependencyTree.MinimalExtensionVisitor A minimal visitor which just processes the id, version, esdk-version and dependencies of an extension.

ExtensionVisitor Visitor for the root JSR-198 extension element.

Feature Feature information gathered from processing the feature-hook section of the extension manifest.

FeatureHook

FeatureRegistry The feature registry provides access to information about extensions which are declared as features in their extension manifest.

HookHandlerHook The hook-handler-hook implementation.

JARExtensionSource A default implementation of ExtensionSource which loads an extension manifest from the META-INF/extension.xml entry of a JAR file.

ListenerInfo Records information defining the listener class to be instantiated when an event on the target object occurs.

LocatorImpl

SAXManifestParser An extensible SAX parser.

ScopedMap A map that provides support for scoping.

Stack Convenient implementation of a Last In First Out (LIFO) stack.

Stack.ReverseListIterator Iterator that traverses a list in reverse order.

TypeInfo Record of information identifying an object type.

Package javax.ide.extension.spi Description

The ide package is where all JSR 198 packages are rooted. There are two types of packages in the ide package:

1. Extension writer packages, and

2. Service provider packages.

By convention, the latter are named spi and are located under the corresponding extension writer package. The extension writer packages contain interfaces and classes intended for extension writers to implement and/or use, while the spi packages contain abstract classes and default implementations that must be extended by IDE service providers in order to support JSR 198. Extension writers should never import classes from the spi packages.

The extension writer packages can be grouped into two categories:

1. Extension hook packages, and

2. Support packages.

Extension hook packages contain the interfaces and classes encapsulating an IDE's integration hooks. Integration hooks are the points an IDE defines where extension writers can integrate new IDE functionality. These packages are:

The command package: containing interfaces and classes involved in the definition and execution of commands.

The editor package: containing interfaces and classes used to define new editors and the support to manage them.

The event package: containing interfaces and classes for listeneting to IDE specific events.
The extension package: containing interfaces and classes encapsulaing an extension and its hooks, and the registry to record all extensions.

The log package: containing interfaces and classes used to define new log pages.

The menu package: containing interfaces and classes used to define new actions, and menus.

The model package: contaning interfaces and classes used to access an IDE's data model, and define new document types.

The preference package: containing interfaces and classes used to define new IDE preferences.

The view package: containing interfaces and classes used to define new graphical user interfaces.

The wizard package: containing interfaces anc classes used to define new document creation wizards.

In general, these packages contain "feature" and "listener" interfaces that are usually implemented by the extension writer, and a "manager" interface that must be implemented by the IDE service provider. The "manager" interface provides the API to access and manipulate the extension writer "feature" interface implementations. For example, the editor package declares the Editor "feature" interface, the EditorListener "listener" interface, and the EditorManager "manager" interface. The first two are implemented by extension writers, while the third one by IDE service providers. The IDE service provider implementation can be found under the spi packages. A similar pattern repeats in the other extension hook packages.

Support packages contain supporting interfaces and classes whose implementation are generally provided by IDE service providers and are mainly for the use of extension writers. These packages are:

The net package: contains a virtual file system that uses URIs to address objects on any file system.

The util package: contains utility classes.

In addition to the packages described above, the ide package contains a number of interfaces and classes. One of those interfaces, the IDE interface is the central repository where all other IDE services are accessed. Extension writers can access any of the service implementations using the IDE interface.

Another class in the IDEConstants class. Extension writers can find there IDE constants identifying menus, and views.