Examples of org.eclipse.core.runtime.IPluginDescriptor

org.eclipse.core.runtime.IPluginDescriptor

A plug-in descriptor contains information about a plug-in obtained from the plug-in's manifest (plugin.xml) file.

Plug-in descriptors are platform-defined objects that exist in the plug-in registry independent of whether a plug-in has been started. In contrast, a plug-in's runtime object (getPlugin) generally runs plug-in-defined code.

This interface is not intended to be implemented by clients.

@deprecated IPluginDescriptor was refactored in Eclipse 3.0. Most of the functionality has moved to {@link Platform} and the plug-in descriptor has been replaced with the OSGi Bundle object.

This interface must only be used by plug-ins which explicitly require the org.eclipse.core.runtime.compatibility plug-in.

For most uses the bundle object can be treated as an opaque token representing your plug-in to the system -- It must be supplied to various Platform methods but need not be interrogated itself. There are a small number of plug-in descriptor method equivalents supplied by Bundle itself. The details are spelled out in the comments on each IPluginDescriptor method.

Clients of this interface have a reference to an IPluginDescriptor corresponding to a plug-in. To adapt to the deprecation, the bundle corresponding to the plug-in generally needs to be acquired. There are several cases:

the descriptor was discovered using methods such as IPluginRegistry.getPluginDescriptor(). The code should be updated to use one of the bundle discovery mechanisms such as Platform.getBundle().
the descriptor is from the plug-in itself. The code should be updated to use the plug-in's bundle instead.
the descriptor is supplied by a third party. The plug-in writer must cooperate with that party to obtain a bundle rather than a descriptor.

The resulting bundle object can be used to carry out the adaptation steps outlined for each of the IPluginDescriptor methods.

@see #getPlugin()

                javaProject.setRawClasspath(newEntries, null);
        }


        private Path findFileInPlugin(String plugin, String file) throws MalformedURLException, IOException {
                IPluginRegistry registry= Platform.getPluginRegistry();
                IPluginDescriptor descriptor= registry.getPluginDescriptor(plugin);
                URL pluginURL= descriptor.getInstallURL();
                URL jarURL= new URL(pluginURL, file);
                URL localJarURL= Platform.asLocalURL(jarURL);
                return new Path(localJarURL.getPath());
        }

        IClasspathEntry[] jettyJarPaths = getJarPaths(libDir);
        IClasspathEntry[] apacheJarPaths = new IClasspathEntry[0];
        Plugin tomcatPlugin = Platform.getPlugin("org.eclipse.tomcat");
        if (tomcatPlugin != null)
        {
            IPluginDescriptor descriptor = tomcatPlugin.getDescriptor();
            apacheJarPaths = getLibrariesPaths(descriptor, "org.apache.jasper");
        }
        return LibraryHelper.concatenateEntries(jettyJarPaths, apacheJarPaths);
    }

  }


  private Path findFileInPlugin(String plugin, String file)
      throws MalformedURLException, IOException {
    IPluginRegistry registry = Platform.getPluginRegistry();
    IPluginDescriptor descriptor = registry.getPluginDescriptor(plugin);
    URL pluginURL = descriptor.getInstallURL();
    URL jarURL = new URL(pluginURL, file);
    URL localJarURL = Platform.asLocalURL(jarURL);
    return new Path(localJarURL.getPath());
  }

Examples of org.eclipse.core.runtime.IPluginDescriptor

Related Classes of org.eclipse.core.runtime.IPluginDescriptor