8008662: Add @jdk.Supported to JDK-specific/supported API

Martin Buchholz martinrb at google.com
Fri Feb 22 14:06:52 UTC 2013

On Thu, Feb 21, 2013 at 6:16 PM, Joe Darcy <joe.darcy at oracle.com> wrote:

> However, the com.sun.* subpackages are a mix of APIs that are supported as
> described above as well as APIs that are not supported.

I was under the impression that the general rule was that all of com.sun.*
fell under the "jdk supported" umbrella, and the level of support was the
distinction between sun.com.* and sun.* .

In any case, it would be good if there was a single canonical place that
documented the various levels of support with subtle distinctions,
including java.* vs. javax.*, endorsed standards, com.sun.* vs. sun.* vs.
jdk.*, and recommendations for where non-Oracle vendor extensions should
go.  Is the jdk.Supported annotation itself part of Java SE?  Should
third-party vendor extensions that are "supported" for public use by the
third-party use jdk.Supported?  What about the X's in hotspot flags and the
java tools command line interfaces?

More information about the core-libs-dev mailing list