JDK-6857803 : Missing links to exceptions in javadoc for Class.getGeneric{Superclass, Interfaces}
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.lang:reflect
  • Affected Version: 7
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2009-07-07
  • Updated: 2012-09-28
  • Resolved: 2009-07-17
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 7
7 b66Fixed
Related Reports
Relates :  
JDK-4891872 - (reflect) Extend reflection to support generics, metadata and JSR201 features
Description
The javadoc for the two methods in java.lang.Class getGenericSuperclass and getGenericInterfaces are missing links to the two exceptions types

GenericSignatureFormatError
MalformedParameterizedTypeException

These methods are in the java.lang.reflect package and those types either need to be imported or those names fully qualified to geet the link to generate properly.
Comments
SUGGESTED FIX From http://hg.openjdk.java.net/jdk7/tl/jdk/rev/0a294c066e7a # HG changeset patch # User darcy # Date 1247008354 25200 # Node ID 0a294c066e7aaebc768fa48240fef40fdbfe2c3f # Parent 0cabe1192c8b8a1d11c5286627c2e3ee3ad4a428 6857803: Missing links to exceptions in javadoc for Class.getGeneric{Superclass, Interfaces} Reviewed-by: chegar --- a/src/share/classes/java/lang/Class.java Mon Jul 06 11:30:40 2009 -0700 +++ b/src/share/classes/java/lang/Class.java Tue Jul 07 16:12:34 2009 -0700 @@ -627,7 +627,7 @@ public final * * @return an array of {@code TypeVariable} objects that represent * the type variables declared by this generic declaration - * @throws GenericSignatureFormatError if the generic + * @throws java.lang.reflect.GenericSignatureFormatError if the generic * signature of this generic declaration does not conform to * the format specified in the Java Virtual Machine Specification, * 3rd edition @@ -673,12 +673,12 @@ public final * {@code Class} object representing the {@code Object} class is * returned. * - * @throws GenericSignatureFormatError if the generic + * @throws java.lang.reflect.GenericSignatureFormatError if the generic * class signature does not conform to the format specified in the * Java Virtual Machine Specification, 3rd edition * @throws TypeNotPresentException if the generic superclass * refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if the + * @throws java.lang.reflect.MalformedParameterizedTypeException if the * generic superclass refers to a parameterized type that cannot be * instantiated for any reason * @return the superclass of the class represented by this object @@ -795,14 +795,14 @@ public final * <p>If this object represents a primitive type or void, the * method returns an array of length 0. * - * @throws GenericSignatureFormatError + * @throws java.lang.reflect.GenericSignatureFormatError * if the generic class signature does not conform to the format * specified in the Java Virtual Machine Specification, 3rd edition * @throws TypeNotPresentException if any of the generic * superinterfaces refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if any of the - * generic superinterfaces refer to a parameterized type that cannot - * be instantiated for any reason + * @throws java.lang.reflect.MalformedParameterizedTypeException + * if any of the generic superinterfaces refer to a parameterized + * type that cannot be instantiated for any reason * @return an array of interfaces implemented by this class * @since 1.5 */
07-07-2009
EVALUATION A fine idea.
07-07-2009