8008662: Add @jdk.Supported to JDK-specific/supported API (original) (raw)

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