Attachment 64952 Details for Bug 173546 – Snippet from the What's New document

Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Snippet from the What's New document

presets.html (text/html), 4.38 KB, created by Konstantin Komissarchik

on 2007-04-25 20:02:45 EDT

(hide)

Description:

Filename:

MIME Type:

Creator: Konstantin Komissarchik

Created: 2007-04-25 20:02:45 EDT

Size: 4.38 KB

patch

obsolete

><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
>"http://www.w3.org/TR/html4/loose.dtd">
><html>
><head>
><meta
> http-equiv="Content-Type"
> content="text/html; charset=iso-8859-1">
><title>Improvements to Presets</title>
></head>
>
><body>
>
>
><a name="presets">2. Improvements to Presets</a>
>
>
>Significant improvements have been made to the presets facility for the 2.0 release. A new type of
>preset, referred to as a dynamic preset, is now available. A dynamic preset uses an extender-supplied
>factory to synthesize the preset definition on the fly based on the context in which it will be
>used. The "old-style" declarative presets are still available and are now referred to as static
>presets. Static presets have also been improved to allow them to extend other presets. A static
>preset can even extend a dynamic preset.
>
>There is also a new preset that's part of the framework. It's a dynamic preset with id of
>"default.configuration" and whose contents are synthesized as follows:
>
><ol>
> <li>If a runtime is selected, this preset will contain default facets as specified by
> IRuntime.getDefaultFacets(Set).</li>
> <li>If no runtime is selected, this preset will contain default versions for all of the fixed
> facets as specified by IProjectFacet.getDefaultVersion().</li>
></ol>
>
>New Extension Point
>
><table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor="#E2E2E2">
><pre>
>&lt;extension point="org.eclipse.wst.common.project.facet.core.presets"&gt;
> &lt;static-preset id="{string}" extends="{string}"&gt;
> &lt;label&gt;{string}&lt;/label&gt; (optional)
> &lt;description&gt;{string}&lt;/description&gt; (optional)
> &lt;facet id="{string}" version="{string}"/&gt; (1 or more)
> &lt;/static-preset&gt; (0 or more)
> &lt;dynamic-preset id="{string}"&gt;
> &lt;factory class="{class:org.eclipse.wst.common.project.facet.core.IPresetFactory}"/&gt;
> &lt;/dynamic-preset&gt; (0 or more)
>&lt;extension&gt;
></pre>
></td></tr></table>
>
>Deprecated Extension Point
>
><table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor="#FFF1C1">
><pre>
>&lt;extension point="org.eclipse.wst.common.project.facet.core.facets"&gt;
> &lt;preset id="{string}"&gt;
> &lt;label&gt;{string}&lt;/label&gt; (optional)
> &lt;description&gt;{string}&lt;/description&gt; (optional)
> &lt;facet id="{string}" version="{string}"/&gt; (1 or more)
> &lt;/preset&gt; (0 or more)
>&lt;extension&gt;
></pre>
></td></tr></table>
>
>Java API Additions
>
><table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor="#E2E2E2">
><pre>
>interface org.eclipse.wst.common.project.facet.core.IPreset
>{
> enum Type { STATIC, DYNAMIC, USER_DEFINED }
> Type getType();
>}
>
>interface org.eclipse.wst.common.project.facet.core.IDynamicPreset extends IPreset
>{
> static final String CONTEXT_KEY_FIXED_FACETS;
> static final String CONTEXT_KEY_PRIMARY_RUNTIME;
> IPreset resolve( Map<String,Object> context );
>}
>
>interface org.eclipse.wst.common.project.facet.core.IPresetFactory
>{
> PresetDefinition createPreset( String presetId, Map<String,Object> context );
>}
>
>class org.eclipse.wst.common.project.facet.core.PresetDefinition
>{
> PresetDefinition( String label, String description, Set<IProjectFacetVersion> facets );
> String getLabel();
> String getDescription();
> Set<IProjectFacetVersion> getProjectFacets();
>}
>
>org.eclipse.wst.common.project.facet.core.FacetedProjectFramework
>{
> static final String DEFAULT_CONFIGURATION_PRESET_ID;
>}
></pre>
></td></tr></table>
>
>Deprecated Java API
>
><table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor=#FFF1C1>
><pre>
>interface org.eclipse.wst.common.project.facet.core.IPreset
>{
> boolean isUserDefined()
>}
></pre>
></td></tr></table>
>
></body>
></html>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta
  http-equiv="Content-Type"
  content="text/html; charset=iso-8859-1">
<title>Improvements to Presets</title>
</head>

<body>

<!--  ********************************************************************** -->
<p><font size="+1"><a name="presets">2. Improvements to Presets</a></font></p>
<!--  ********************************************************************** -->

<p>Significant improvements have been made to the presets facility for the 2.0 release. A new type of
preset, referred to as a dynamic preset, is now available. A dynamic preset uses an extender-supplied
factory to synthesize the preset definition on the fly based on the context in which it will be
used. The "old-style" declarative presets are still available and are now referred to as static
presets. Static presets have also been improved to allow them to extend other presets. A static
preset can even extend a dynamic preset.</p>

<p>There is also a new preset that's part of the framework. It's a dynamic preset with id of
"default.configuration" and whose contents are synthesized as follows:</p>

<ol>
  <li>If a runtime is selected, this preset will contain default facets as specified by
    IRuntime.getDefaultFacets(Set).</li>
  <li>If no runtime is selected, this preset will contain default versions for all of the fixed
    facets as specified by IProjectFacet.getDefaultVersion().</li>
</ol>

<p><u>New Extension Point</u></p>

<table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor="#E2E2E2">
<pre>
&lt;extension point="org.eclipse.wst.common.project.facet.core.presets"&gt;
  &lt;static-preset id="<i>{string}</i>" extends="<i>{string}</i>"&gt;
    &lt;label&gt;<i>{string}</i>&lt;/label&gt; <i>(optional)</i>
    &lt;description&gt;<i>{string}</i>&lt;/description&gt; <i>(optional)</i>
    &lt;facet id="<i>{string}</i>" version="<i>{string}</i>"/&gt; <i>(1 or more)</i>
  &lt;/static-preset&gt; <i>(0 or more)</i>
  &lt;dynamic-preset id="<i>{string}</i>"&gt;
    &lt;factory class="<i>{class:org.eclipse.wst.common.project.facet.core.IPresetFactory}</i>"/&gt;
  &lt;/dynamic-preset&gt; <i>(0 or more)</i>
&lt;extension&gt;
</pre>
</td></tr></table>

<p><u>Deprecated Extension Point</u></p>

<table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor="#FFF1C1">
<pre>
<font color="#7B7B7B">&lt;extension point="org.eclipse.wst.common.project.facet.core.facets"&gt;</font>
  &lt;preset id="<i>{string}</i>"&gt;
    &lt;label&gt;<i>{string}</i>&lt;/label&gt; <i>(optional)</i>
    &lt;description&gt;<i>{string}</i>&lt;/description&gt; <i>(optional)</i>
    &lt;facet id="<i>{string}</i>" version="<i>{string}</i>"/&gt; <i>(1 or more)</i>
  &lt;/preset&gt; <i>(0 or more)</i>
<font color="#7B7B7B">&lt;extension&gt;</font>
</pre>
</td></tr></table>

<p><u>Java API Additions</u></p>

<table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor="#E2E2E2">
<pre>
<font color="#7B7B7B">interface org.eclipse.wst.common.project.facet.core.IPreset
{</font>
    enum Type { STATIC, DYNAMIC, USER_DEFINED }
    Type getType();
<font color="#7B7B7B">}</font>

interface org.eclipse.wst.common.project.facet.core.IDynamicPreset extends IPreset
{
    static final String CONTEXT_KEY_FIXED_FACETS;
    static final String CONTEXT_KEY_PRIMARY_RUNTIME;
    IPreset resolve( Map<String,Object> context );
}

interface org.eclipse.wst.common.project.facet.core.IPresetFactory
{
    PresetDefinition createPreset( String presetId, Map<String,Object> context );
}

class org.eclipse.wst.common.project.facet.core.PresetDefinition
{
    PresetDefinition( String label, String description, Set<IProjectFacetVersion> facets );
    String getLabel();
    String getDescription();
    Set<IProjectFacetVersion> getProjectFacets();
}

<font color="#7B7B7B">org.eclipse.wst.common.project.facet.core.FacetedProjectFramework
{</font>
    static final String DEFAULT_CONFIGURATION_PRESET_ID;
<font color="#7B7B7B">}</font>
</pre>
</td></tr></table>

<p><u>Deprecated Java API</u></p>

<table cellpadding="10"><tr><td width="10">&nbsp;</td><td bgcolor=#FFF1C1>
<pre>
<font color="#7B7B7B">interface org.eclipse.wst.common.project.facet.core.IPreset
{</font>
    boolean isUserDefined()
<font color="#7B7B7B">}</font>
</pre>
</td></tr></table>

</body>
</html>

Actions: View

Attachments on bug 173546: 64952