8008662: Add @jdk.Exported to JDK-specific/exported APIs
Alan Bateman
Alan.Bateman at oracle.com
Sun Oct 6 20:03:34 UTC 2013
As a follow-up to Joe Darcy's rename of jdk.Supported to jdk.Exported,
I'd like to have another attempt at adding the annotation to a number of
JDK specific APIs that are long standing exported, documented and
supported APIs. Specifically, the following APIs:
- Java Debug Interface (com.sun.jdi)
- Attach API (com.sun.tools.attach)
- SCTP API (com.sun.nio.sctp)
- HTTP server API (com.sun.net.httpserver)
- Management extensions (com.sun.management)
- JConsole Plugin API (com.sun.tools.jconsole)
- JDK-specific API to JAAS (com.sun.security.auth)
- JDK-specific JGSS API (com.sun.security.jgss)
(The javadoc for each of these APIs is currently generated in the build)
The webrev with the proposed update is here:
http://cr.openjdk.java.net/~alanb/8008662/webrev.02/
As per the original webrev, I've added package-info.java to a number of
packages that didn't have any description. In a few cases, I've had to
rename the legacy package.html to package-info.java.
For the review then the intention is that @jdk.Exported be added to the
package-info and all public/protected types in these APIs. The only
exceptions are two cases where I've added @jdk.Exported(false),
specifically:
- com.sun.management.OSMBeanFactory as it clearly documents to stay away
- com.sun.security.auth.callback.DialogCallbackHandler as it for the
chop (see JEP 162)
Thanks,
Alan.
More information about the security-dev
mailing list