View All Attachments for Bug 173546

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

Attachment #64952
Snippet from the What's New document	text/html	2007-04-25 20:02:45 EDT	4.38 KB	no flags	Details

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