Application extension registry filtering

 

The extension registry exposes the registry filter extension point. The registry filter removes elements within the extension registry for client applications. Extensions that are attached to the registry filter extension point and that also implement this interface are called as necessary when a client operates on a named registry instance that matches the target specification.

You can create a filter extension for all registry instances or for named instances that are specified by the extension. In the first case, the filter is applied to all instances of the extension registry, and all client applications use the filter without requesting the filter. In the latter case, a client application must predefine the registry name by defining an extension, called RegistryInstance, which is another extension point that is exposed by the extension registry. After the registry name is defined, the client can obtain the named registry instance and use that registry instance. The filter extension is invoked by the named registry instance as necessary.

 

Registry filter API

Supported arguments include:

org.eclipse.core.runtime.IExtension[]

doFilter(org.eclipse.core.runtime.IExtension[] extensions)

This code returns an array of IExtension objects that are included in the valid extension list.

 

Registry instance extension point

The extension registry exposes the RegistryInstance . The instance name is declared in the application's plugin.xml file, and the application requests an registry instance for that name at runtime.

---

 

Related concepts

Application extension registry

 

Related tasks

Defining an extension for the registry filter

 

Related Reference

plugin.xml file