Package org.java.plugin.registry
Interface ExtensionPoint
-
- All Superinterfaces:
Documentable<ExtensionPoint>,Identity,PluginElement<ExtensionPoint>,UniqueIdentity
- All Known Implementing Classes:
MockExtensionPoint
public interface ExtensionPoint extends UniqueIdentity, PluginElement<ExtensionPoint>
This interface abstracts the extension point - a place where the functionality of plug-in can be extended.Extension point UID is a combination of declaring plug-in ID and extension point ID that is unique within whole set of registered plug-ins.
- Version:
- $Id$
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interfaceExtensionPoint.ParameterDefinitionThis interface abstracts parameter definition - a parameter "type declaration".
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description ExtensiongetAvailableExtension(java.lang.String uniqueId)java.util.Collection<Extension>getAvailableExtensions()Returns a collection of all extensions that available for this point.ExtensiongetConnectedExtension(java.lang.String uniqueId)java.util.Collection<Extension>getConnectedExtensions()Returns a collection of all extensions that was successfully "connected" to this point.java.util.Collection<ExtensionPoint>getDescendants()Looks for all available (valid) successors of this extension point.ExtensionMultiplicitygetMultiplicity()ExtensionPoint.ParameterDefinitiongetParameterDefinition(java.lang.String id)java.util.Collection<ExtensionPoint.ParameterDefinition>getParameterDefinitions()Returns collection of all top level parameter definitions declared in this extension point and all it parents.java.lang.StringgetParentExtensionPointId()java.lang.StringgetParentPluginId()booleanisExtensionAvailable(java.lang.String uniqueId)Checks if extension is available for this extension point.booleanisExtensionConnected(java.lang.String uniqueId)Checks if extension is in valid state and successfully "connected" to this extension point.booleanisSuccessorOf(ExtensionPoint extensionPoint)booleanisValid()-
Methods inherited from interface org.java.plugin.registry.Documentable
getDocsPath, getDocumentation
-
Methods inherited from interface org.java.plugin.registry.PluginElement
getDeclaringPluginDescriptor, getDeclaringPluginFragment
-
Methods inherited from interface org.java.plugin.registry.UniqueIdentity
getUniqueId
-
-
-
-
Method Detail
-
getMultiplicity
ExtensionMultiplicity getMultiplicity()
- Returns:
- multiplicity of this extension point
-
getParameterDefinitions
java.util.Collection<ExtensionPoint.ParameterDefinition> getParameterDefinitions()
Returns collection of all top level parameter definitions declared in this extension point and all it parents.- Returns:
- collection of
ExtensionPoint.ParameterDefinitionobjects
-
getParameterDefinition
ExtensionPoint.ParameterDefinition getParameterDefinition(java.lang.String id)
- Parameters:
id- ID of parameter definition to look for- Returns:
- parameter definition with given ID
-
getAvailableExtensions
java.util.Collection<Extension> getAvailableExtensions()
Returns a collection of all extensions that available for this point.- Returns:
- collection of
Extensionobjects
-
getAvailableExtension
Extension getAvailableExtension(java.lang.String uniqueId)
- Parameters:
uniqueId- unique ID of extension- Returns:
- extension that is available for this point
-
isExtensionAvailable
boolean isExtensionAvailable(java.lang.String uniqueId)
Checks if extension is available for this extension point. If this method returnstrue, the methodgetAvailableExtension(String)should return valid extension for the same UID.- Parameters:
uniqueId- unique ID of extension- Returns:
trueif extension is available for this extension point
-
getConnectedExtensions
java.util.Collection<Extension> getConnectedExtensions()
Returns a collection of all extensions that was successfully "connected" to this point.- Returns:
- collection of
Extensionobjects
-
getConnectedExtension
Extension getConnectedExtension(java.lang.String uniqueId)
- Parameters:
uniqueId- unique ID of extension- Returns:
- extension that was successfully "connected" to this point
-
isExtensionConnected
boolean isExtensionConnected(java.lang.String uniqueId)
Checks if extension is in valid state and successfully "connected" to this extension point. If this method returnstrue, the methodgetConnectedExtension(String)should return valid extension for the same UID.- Parameters:
uniqueId- unique ID of extension- Returns:
trueif extension was successfully "connected" to this extension point
-
isValid
boolean isValid()
- Returns:
trueif extension point is considered to be valid
-
getParentPluginId
java.lang.String getParentPluginId()
- Returns:
- parent extension point plug-in ID or
null
-
getParentExtensionPointId
java.lang.String getParentExtensionPointId()
- Returns:
- parent extension point ID or
null
-
isSuccessorOf
boolean isSuccessorOf(ExtensionPoint extensionPoint)
- Parameters:
extensionPoint- extension point- Returns:
trueif this point is successor of given extension point
-
getDescendants
java.util.Collection<ExtensionPoint> getDescendants()
Looks for all available (valid) successors of this extension point. The search should be done recursively including all descendants of this extension point.- Returns:
- collection of
ExtensionPointobjects
-
-