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.

Configuration 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
   >

Examples: 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.