Global Install Handlers

Identifier

org.eclipse.update.core.installHandlers

Description

Extension point for registering global install handlers. Global install handlers can be referenced by features (using the <feature> <install-handler> tags) without having to include a copy of the handler code as part of the downloadable feature.

Markup

   <!ELEMENT extension (install-handler+)>
   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

   <!ELEMENT install-handler EMPTY>
   <!ATTLIST install-handler
     class CDATA #REQUIRED
   >

Example

The following is an example of new global install handler registration.

<extension
   id="custom"
   point="org.eclipse.update.core.installHandlers"
   name="Custom install handler">

   <install-handler
      class="com.xyz.update.CustomInstallHandler">
   </install-handler>
</extension>

API Information

Registered install handler classes must implement org.eclipse.update.core.IInstallHandler interface. Implementers should extend base class org.eclipse.update.core.BaseInstallHandler.

Supplied Implementation

The platform supplies a simple install handler that is registered as org.eclipse.update.core.DefaultInstallHandler. If used, it will copy any non-plug-in data entries provided with the feature into the feature installation directory.

Copyright IBM Corp. and others 2000, 2002.  All Rights Reserved.