What's New for 1.5.1?

This document describes the API changes that have been made in the Faceted Project Framework for WTP 1.5.1 release. Both Java API and extension point changes are covered. Note that the Faceted Project Framework API remains provisional for the 1.5.1 release. This means it will continue undergoing further significant changes in future release(s).

1. Specifying Default Facet Version
2. Wildcard Support in Version Expressions

1. Specifying Default Facet Version

It is now possible to specify the facet version that will be used by default when the facet is presented to the user. There are two ways to specify the default version. You can either specify a static default or you can implement the `IDefaultVersionProvider` interface. If a default version is not specified, the latest version will be used instead.

Extension Point Changes

    <extension point="org.eclipse.wst.common.project.facet.core.facets">
      <project-facet>
        <default-version version="{string}"/> (optional)
        <default-version provider="{class:org.eclipse.wst.common.project.facet.core.IDefaultVersionProvider}"/> (optional)
      </project-facet>
    <extension>

Java API Additions

    org.eclipse.wst.common.project.facet.core.IProjectFacet
    {
       IProjectFacetVersion getDefaultVersion();
    }

    org.eclipse.wst.common.project.facet.core.IDefaultVersionProvider
    {
       IProjectFacetVersion getDefaultVersion();
    }

2. Wildcard Support in Version Expressions

A wildcard character '*' can now be used in version expressions in order to match any version. Note that it is not possible to use the wildcard to match part of the version string.

Java API Additions

    org.eclipse.wst.common.project.facet.core.IVersionExpr
    {
       static final String WILDCARD_SYMBOL = "*";
    }