Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8000416

refactor javadoc to provide and use an abstraction for relative URIs

    XMLWordPrintable

Details

    • Enhancement
    • Resolution: Fixed
    • P4
    • 8
    • None
    • tools
    • b64
    • Not verified

    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).

      Attachments

        Issue Links

          Activity

            People

              jjg Jonathan Gibbons
              jjg Jonathan Gibbons
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: