IExtensionRegistry. Most of the IPluginRegistry function
is directly supported on the new interface without change. Most clients
of IPluginRegistry need only to change their references to use
IExtensionRegistry. The only exceptions are
methods that return IPluginDescriptors. See the relevant method
comments for details.
This interface must only be used by plug-ins which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
public interface IPluginRegistry
The plug-in registry can be queried, by name, for plug-ins, extension points, and extensions.
This interface is not intended to be implemented by clients.
| Modifier and Type | Method and Description |
|---|---|
IConfigurationElement[] |
getConfigurationElementsFor(String extensionPointId)
Deprecated.
|
IConfigurationElement[] |
getConfigurationElementsFor(String pluginId,
String extensionPointName)
Deprecated.
|
IConfigurationElement[] |
getConfigurationElementsFor(String pluginId,
String extensionPointName,
String extensionId)
Deprecated.
|
IExtension |
getExtension(String extensionPointId,
String extensionId)
Deprecated.
Replaced by
IExtensionRegistry.getExtension(String, String). |
IExtension |
getExtension(String pluginId,
String extensionPointName,
String extensionId)
Deprecated.
|
IExtensionPoint |
getExtensionPoint(String extensionPointId)
Deprecated.
Replaced by
IExtensionRegistry.getExtensionPoint(String). |
IExtensionPoint |
getExtensionPoint(String pluginId,
String extensionPointName)
Deprecated.
Replaced by
IExtensionRegistry.getExtensionPoint(String, String). |
IExtensionPoint[] |
getExtensionPoints()
Deprecated.
Replaced by
IExtensionRegistry.getExtensionPoints(). |
IPluginDescriptor |
getPluginDescriptor(String pluginId)
Deprecated.
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptor() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details. |
IPluginDescriptor |
getPluginDescriptor(String pluginId,
PluginVersionIdentifier version)
Deprecated.
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptor() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details. |
IPluginDescriptor[] |
getPluginDescriptors()
Deprecated.
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptors() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details. |
IPluginDescriptor[] |
getPluginDescriptors(String pluginId)
Deprecated.
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptors() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details. |
IConfigurationElement[] getConfigurationElementsFor(String extensionPointId)
IExtensionRegistry.getConfigurationElementsFor(String).extensionPointId - the unique identifier of the extension point
(e.g. "org.eclipse.core.resources.builders")IConfigurationElement[] getConfigurationElementsFor(String pluginId, String extensionPointName)
IExtensionRegistry.getConfigurationElementsFor(String, String).pluginId - the unique identifier of the plug-in
(e.g. "org.eclipse.core.resources")extensionPointName - the simple identifier of the
extension point (e.g. "builders")IConfigurationElement[] getConfigurationElementsFor(String pluginId, String extensionPointName, String extensionId)
IExtensionRegistry.getConfigurationElementsFor(String, String, String).pluginId - the unique identifier of the plug-in
(e.g. "org.eclipse.core.resources")extensionPointName - the simple identifier of the
extension point (e.g. "builders")extensionId - the unique identifier of the extension
(e.g. "com.example.acme.coolbuilder)IExtension getExtension(String extensionPointId, String extensionId)
IExtensionRegistry.getExtension(String, String).null if there is no such extension.
The first parameter identifies the extension point, and the second
parameter identifies an extension plugged in to that extension point.extensionPointId - the unique identifier of the extension point
(e.g. "org.eclipse.core.resources.builders")extensionId - the unique identifier of the extension
(e.g. "com.example.acme.coolbuilder")nullIExtension getExtension(String pluginId, String extensionPointName, String extensionId)
IExtensionRegistry.getExtension(String, String, String).null if there is no such extension.
The first two parameters identify the extension point, and the third
parameter identifies an extension plugged in to that extension point.pluginId - the unique identifier of the plug-in
(e.g. "org.eclipse.core.resources")extensionPointName - the simple identifier of the
extension point (e.g. "builders")extensionId - the unique identifier of the extension
(e.g. "com.example.acme.coolbuilder")nullIExtensionPoint getExtensionPoint(String extensionPointId)
IExtensionRegistry.getExtensionPoint(String).null if there is no such
extension point.extensionPointId - the unique identifier of the extension point
(e.g., "org.eclipse.core.resources.builders")nullIExtensionPoint getExtensionPoint(String pluginId, String extensionPointName)
IExtensionRegistry.getExtensionPoint(String, String).null if there is no such extension point.pluginId - the unique identifier of the plug-in
(e.g. "org.eclipse.core.resources")extensionPointName - the simple identifier of the
extension point (e.g. " builders")nullIExtensionPoint[] getExtensionPoints()
IExtensionRegistry.getExtensionPoints().IPluginDescriptor getPluginDescriptor(String pluginId)
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptor() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details.null if there is no such
plug-in. If there are multiple versions of the identified plug-in,
one will be non-deterministically chosen and returned.pluginId - the unique identifier of the plug-in
(e.g. "com.example.acme").nullIPluginDescriptor getPluginDescriptor(String pluginId, PluginVersionIdentifier version)
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptor() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details.null if
there is no such plug-in.pluginId - the unique identifier of the plug-in
(e.g. "org.eclipse.core.resources")version - plug-in version identifier. If null is specified,
a non-deterministically chosen version of the identified plug-in (if any)
will be returnednullIPluginDescriptor[] getPluginDescriptors()
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptors() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details.IPluginDescriptor[] getPluginDescriptors(String pluginId)
IPluginDescriptor was refactored in Eclipse 3.0.
The getPluginDescriptors() method may only be called by plug-ins
which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
See the comments on IPluginDescriptor and its methods for details.pluginId - the unique identifier of the plug-in
(e.g. "org.eclipse.core.resources").Guidelines for using Eclipse APIs. Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.