blob: 856af902d2b708541615d279c97292a0ed9c1920 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Runtime Types</title>
<style type="text/css">@import url("../../book.css");</style>
<style type="text/css">@import url("../../schema.css");</style>
</HEAD>
<BODY>
<H1 style="text-align:center">Runtime Types</H1>
<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>org.eclipse.wst.server.core.runtimeTypes<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Since: </h6>1.0
<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Description: </h6>This extension point is used to provide a new runtime target handler. Runtime target handlers are called whenever a runtime target is added or removed from a project. They can be used to switch Java classpaths, setup default resources, etc.
This extension point as well as the classes required to implement it are deprecated due to the addition of facets in WTP 1.0. If you were using this extension point for classpath then you can use the org.eclipse.jst.server.core.runtimeClasspathProviders extension point instead.<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6>
<p></p>
<p class="code SchemaDtd">&lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.runtimeTargetHandler">runtimeTargetHandler</a>+)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST extension</p>
<p class="code SchemaDtdAttlist">point&nbsp;CDATA #REQUIRED<p class="code SchemaDtdAttlist">id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;CDATA #IMPLIED&gt;</p>
<p></p>
<ul class="ConfigMarkupAttlistDesc">
<li><b>point</b> - a fully qualified identifier of the target extension point</li>
<li><b>id</b> - an optional identifier of the extension instance</li>
<li><b>name</b> - an optional name of the extension instance</li>
</ul>
<br><div style="color: red; font-style: italic;">The <b>runtimeTargetHandler</b> element is deprecated</div> <p class="code SchemaDtd">&lt;!ELEMENT <a name="e.runtimeTargetHandler">runtimeTargetHandler</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST runtimeTargetHandler</p>
<p class="code SchemaDtdAttlist">id&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED<p class="code SchemaDtdAttlist">runtimeTypeIds&nbsp;CDATA #REQUIRED<p class="code SchemaDtdAttlist">class&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED<p class="code SchemaDtdAttlist">order&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED&gt;</p>
<p></p>
<ul class="ConfigMarkupAttlistDesc">
<li><b>id</b> - specifies a unique identifier for this extension point</li>
<li><b>runtimeTypeIds</b> - a comma separated list of runtime type ids that this handler may support. Used for memory & performance reasons</li>
<li><b>class</b> - specifies the fully qualified name of the Java class that extends <samp>RuntimeTargetHandlerDelegate</samp>.
Runtime target handler instances of this type will delegate to instances of this class.</li>
<li><b>order</b> - an integer order used to sort handlers relative to each other</li>
</ul>
<br><h6 class="CaptionFigColumn SchemaHeader">Examples: </h6>The following is an example of a runtime target handler extension point:
<pre class="Example"><span class="code SchemaTag">
&lt;extension
point=</span><span class="code SchemaCstring">&quot;org.eclipse.wst.server.core.runtimeTargetHandlers&quot;</span><span class="code SchemaTag">&gt;
&lt;runtimeTargetHandler
id=</span><span class="code SchemaCstring">&quot;com.example.runtimeTargetHandler&quot;</span><span class="code SchemaTag">
runtimeTypeIds=</span><span class="code SchemaCstring">&quot;com.example.runtime, com.example2.*&quot;</span><span class="code SchemaTag">
class=</span><span class="code SchemaCstring">&quot;com.example.ExampleRuntimeTargetHandler&quot;</span><span class="code SchemaTag">/&gt;
&lt;/extension&gt;
</span></pre>
<p></p>
<br>
<p class="note SchemaCopyright">
Copyright (c) 2000, 2005 IBM Corporation and others.<br>
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License 2.0 which accompanies
this distribution, and is available at
<a href="https://www.eclipse.org/legal/epl-2.0/">https://www.eclipse.org/legal/epl-2.0/</a>
</p>
</BODY>
</HTML>