JDK-8000416 : refactor javadoc to provide and use an abstraction for relative URIs
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2012-10-04
  • Updated: 2013-06-07
  • Resolved: 2012-10-23
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 Availability Release.

To download the current JDK release, click here.
JDK 8
8 b64Fixed
Related Reports
Relates :  
JDK-8001664 - refactor javadoc to use abstraction to handle files
Relates :  
JDK-8000414 - Refactor javadoc to provide and use an abstraction for relative paths
Description
javadoc currently uses String to model relative URIs, typically building them by concatenating strings intended to represent path, query and fragment. But, the code is inconsistent about the way such strings are manipulated, breaking the implied invariants.

In addition, this has led to excessive overloading and extra parameters to pas around the component parts of the reference.

Although it would be possible to use URI, that is more flexible than is desirable, and does not have the ability to customize it to use other internal javadoc types.

It would be better to provide a custom simple abstraction to manage triples of (path, query, fragment).