Default Facets Extension Point

org.eclipse.wst.common.project.facet.core.defaultFacets

This extension point is part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.

Used to specify which facets (and which versions of those facets) should be selected by default when a runtime that includes the specified runtime component is selected. Multiple extensions referring to the same runtime component (type and version) will be merged. This allows a party not affiliated with the runtime vendor to specify that a certain additional facet should be preselected when the runtime containing the specified runtime component is selected.

<!ELEMENT extension (default-facets)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT default-facets (runtime-component , facet+)>

Used to specify which facets (and which versions of those facets) should be selected by default when a runtime that includes the specified runtime component is selected. Multiple extensions referring to the same runtime component (type and version) will be merged. This allows a party not affiliated with the runtime vendor to specify that a certain additional facet should be preselected when the runtime containing the specified runtime component is selected.



<!ELEMENT runtime-component EMPTY>

<!ATTLIST runtime-component

id      CDATA #REQUIRED

version CDATA #REQUIRED>

Specifies the runtime component type id and version that these defaults are for.



<!ELEMENT facet EMPTY>

<!ATTLIST facet

id      CDATA #REQUIRED

version CDATA #REQUIRED>

Specifies project facet id and version



The following example declares facet1 (version 1.3) and facet2 (version 5.0) as default facets for runtime component MyRuntimeComponent.

<extension point=

"org.eclipse.wst.common.project.facet.core.defaultFacets"

>

<default-facets>

<runtime-component id=

"MyRuntimeComponent"

/>

<facet id=

"facet1"

version=

"1.3"

/>

<facet id=

"facet2"

version=

"5.0"

/>

</default-facets>

</extension>

Multiple plugins can contribute to the set of the default facets for a given runtime component. If the following example is combined with the first one, there will be three default facets associated with MyRuntimeComponent.

<extension point=

"org.eclipse.wst.common.project.facet.core.defaultFacets"

>

<default-facets>

<runtime-component id=

"MyRuntimeComponent"

/>

<facet id=

"facet3"

version=

"1.2"

/>

</default-facets>

</extension>