blob: 7f80447b7027cb8bda284fbc76d9b9900e9f1f5f [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</HEAD>
<HTML>
<BODY>
<H1><CENTER>Feature Type Factory</CENTER></H1>
<H2>Identifier</H2>
org.eclipse.update.core.featureTypes<H2>Description</H2>
<p>The platform update mechanism supports pluggable feature type
implementations. A new feature type can be registered in order
to support
alternate packaging and verification schemes.
</p>
<p>
The <code>featureTypes</code>
extension point allows alternate feature implementations to be
registered using a symbolic type identifier. Whenever the
type is referenced using this identifier, the supplied factory
is used to create the correct concrete feature implementation.
</p><H2>Markup</H2>
<p><samp>&nbsp;&nbsp; &lt;!ELEMENT extension (feature-factory+)&gt;</samp>
<br><samp>&nbsp;&nbsp; &lt;!ATTLIST extension</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;point&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name&nbsp;&nbsp;CDATA #IMPLIED</samp>
<br><samp>&nbsp;&nbsp; &gt;</samp>
<ul>
<li><b>point</b> - must be specified as <b>org.eclipse.update.core.featureTypes</b></li><li><b>id</b> - must be specified. Identifies the new feature type</li><li><b>name</b> - optional displayable label for the new feature type</li></ul>
<p><samp>&nbsp;&nbsp; &lt;!ELEMENT feature-factory EMPTY&gt;</samp>
<br><samp>&nbsp;&nbsp; &lt;!ATTLIST feature-factory</samp>
<br><samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;class&nbsp;CDATA #REQUIRED</samp>
<br><samp>&nbsp;&nbsp; &gt;</samp>
<ul>
<li><b>class</b> - fully qualified name of the factory class for the identified feature type</li></ul>
<H2>Example</H2>
The following is an example of new feature type registration.
<br><br>
<code>
&lt;extension<br>
&nbsp;&nbsp;&nbsp;id="custom"<br>
&nbsp;&nbsp;&nbsp;point="org.eclipse.update.core.featureTypes"<br>
&nbsp;&nbsp;&nbsp;name="Custom packaged feature"&gt;<br>
<br>
&nbsp;&nbsp;&nbsp;&lt;feature-factory<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;class="com.xyz.update.CustomFeatureFactory"&gt;<br>
&nbsp;&nbsp;&nbsp;&lt;/feature-factory&gt;<br>
&lt;/extension&gt;<br>
</code><H2>API Information</H2>
Registered factory classes must implement
<code><b>org.eclipse.update.core.IFeatureFactory</b></code><H2>Supplied Implementation</H2>
The platform supplies two standard implementations of feature
types. One representing the default packaged feature type, and
the other representing an installed feature type.<br><br><a href="hglegal.htm"><img SRC="ngibmcpy.gif" ALT="Copyright IBM Corp. and others 2000, 2002. All Rights Reserved." BORDER=0></a></BODY>
</HTML>