Maintenance Notice

The bugs.java.com site will be undergoing maintenance on 15th Dec 2017 21:00 PST to 16th Dec 2017 1:00 AM PST.
JDK-6748546 : javadoc API should be classloader-friendly
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 7
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2008-09-15
  • Updated: 2017-05-16
  • Resolved: 2011-07-15
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availabitlity Release.

To download the current JDK release, click here.
JDK 7
7 b38Fixed
Related Reports
Relates :  
Description
Internally, javadoc creates a URLClassLoader in which to instantiate doclets. This classloader is not given a parent class loader, and so does not honor the standard parent delegation scheme.

This means that if javadoc is invoked from a class that was itself loaded from a classloader (such as in the regression test harness, jtreg) the doclets loaded by javadoc will not interact correctly with the classes that invoked javadoc.

The fix is to allow javadoc to be invoked with a parent class loader, to be used when creating the javadoc class loader.

Comments
EVALUATION Yes, adding methods with classloader args allows javadoc to use jtreg samevm mode.
2008-09-16