Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[wtp-dev] Notice of upcoming change in provisional api

This is a notice that a change will be released soon that has potential
to cause breakage to users of the faceted project framework's
provisional api. The change will be made to the HEAD code stream
affecting only the 2.0 release code line, so there will be plenty of
time for the downstream code to react if it is affected by this change. 

 

The change has two parts to it:

 

1. The api and extension points that have been deprecated during the
1.5.0 release have been removed. Information about exactly which api has
been deprecated and now removed can be found in the following section of
the WTP docs: Web Standard Tools Developer Guide -> Programmer's Guide
-> Faceted Project Framework -> New for 1.5. Ample notice has been made
given in the past regarding this.

 

2. In order to fix a performance issue described by
https://bugs.eclipse.org/bugs/show_bug.cgi?id=146321 some api changes
were necessary in order to remove the assumption embedded in the api
that facet version comparison is always done directly on version string.
The api change allowed the comparison information to be cached thereby
improving performance. The caching also allowed some api improvement to
take place because several methods no longer needed to throw exceptions.
I do not anticipate this change to cause problems for adopters as the
affected api is only infrequently used outside the framework itself. The
api usage scan did not produce any hits.

 

Both IProjectFacetVersion and IRuntimeComponentVersion now extend
Comparable.

 

The following methods no longer throw exceptions:

 

  IProjectFacet.getLatestVersion()

  IProjectFacet.getLatestSupportedVersion( IRuntime runtime )

  IProjectFacet.getSortedVersions( boolean ascending )

  IRuntimeComponentType.getLatestVersion()

  IRuntimeComponentType.getSortedVersions( boolean ascending )

 

The IVersionExpr.evaluate( String ) method has been replaced with
IVersionExpr.check( Comparable ) method.



- Konstantin

>>Register now for BEA World 2006 --- See http://www.bea.com/beaworld<<
_______________________________________________________________________
Notice:  This email message, together with any attachments, may contain
information  of  BEA Systems,  Inc.,  its subsidiaries  and  affiliated
entities,  that may be confidential,  proprietary,  copyrighted  and/or
legally privileged, and is intended solely for the use of the individual
or entity named in this message. If you are not the intended recipient,
and have received this message in error, please immediately return this
by email and then delete it.

Back to the top