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

Provide supertypes of parameterized types with type params substituted.

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Fixed
    • Icon: P4 P4
    • 5.0
    • 5.0
    • tools
    • None
    • tiger
    • generic, sparc
    • generic, solaris_9


      The javadoc output produced by the standard doclet includes a
      chart showing (the transitive closures of) the superclasses and
      superinterfaces. For example, the doc for java.util.HashSet shows:

          java.lang.Object
            |_ java.util.AbstractCollection
      |_ java.util.AbstractSet
      |_ java.util.HashSet

          All Implemented Interfaces:
      Cloneable, Collection, Iterable, Serializable, Set

      The new generics-aware standard doclet adds type parameter information
      where it shows a class or interface's directly-extended classes and
      interfaces, but it does not have available to it all information
      that would be needed to add type parameter info to the above chart.

      A review of the docs generated by the generics-aware standard doclet
      concluded that it would be highly desirable to add type parameters to
      this chart. Although this is not 100% essential (the info can
      be deduced from the "direct" info that's already available), it can
      involve mental gymnastics to keep track of all the recursive type
      argument substitutions in complex cases.

       Proposal:
      Add new methods to the doclet API, giving doclets the information
      needed to add type parameter info where desired:

      Add to com.sun.javadoc.ParameterizedType:
          Type superclassType();
          Type[] interfaceTypes();

            sseligmasunw Scott Seligman (Inactive)
            sseligmasunw Scott Seligman (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: