6378701: (enum) Unclear purpose of EnumConstantNotPresentException
authordarcy
Fri Aug 21 11:31:18 2009 -0700 (6 months ago)
changeset 15783992a43bb0a5
parent 15775cd12b68d09b
child 1581fca3e1a178fd
6378701: (enum) Unclear purpose of EnumConstantNotPresentException
Reviewed-by: lancea, andrew, alanb
src/share/classes/java/lang/EnumConstantNotPresentException.java
src/share/classes/java/lang/TypeNotPresentException.java
src/share/classes/java/lang/annotation/AnnotationFormatError.java
src/share/classes/java/lang/annotation/AnnotationTypeMismatchException.java
src/share/classes/java/lang/annotation/IncompleteAnnotationException.java
src/share/classes/java/lang/reflect/AnnotatedElement.java
--- a/src/share/classes/java/lang/EnumConstantNotPresentException.java Thu Aug 20 08:48:29 2009 +0100
+++ b/src/share/classes/java/lang/EnumConstantNotPresentException.java Fri Aug 21 11:31:18 2009 -0700
@@ -28,8 +28,12 @@ package java.lang;
/**
* Thrown when an application tries to access an enum constant by name
* and the enum type contains no constant with the specified name.
+ * This exception can be thrown by the {@linkplain
+ * java.lang.reflect.AnnotatedElement API used to read annotations
+ * reflectively}.
*
* @author Josh Bloch
+ * @see java.lang.reflect.AnnotatedElement
* @since 1.5
*/
public class EnumConstantNotPresentException extends RuntimeException {
--- a/src/share/classes/java/lang/TypeNotPresentException.java Thu Aug 20 08:48:29 2009 +0100
+++ b/src/share/classes/java/lang/TypeNotPresentException.java Fri Aug 21 11:31:18 2009 -0700
@@ -35,8 +35,12 @@ package java.lang;
* <p>Note that this exception may be used when undefined type variables
* are accessed as well as when types (e.g., classes, interfaces or
* annotation types) are loaded.
+ * In particular, this exception can be thrown by the {@linkplain
+ * java.lang.reflect.AnnotatedElement API used to read annotations
+ * reflectively}.
*
* @author Josh Bloch
+ * @see java.lang.reflect.AnnotatedElement
* @since 1.5
*/
public class TypeNotPresentException extends RuntimeException {
--- a/src/share/classes/java/lang/annotation/AnnotationFormatError.java Thu Aug 20 08:48:29 2009 +0100
+++ b/src/share/classes/java/lang/annotation/AnnotationFormatError.java Fri Aug 21 11:31:18 2009 -0700
@@ -28,8 +28,12 @@ package java.lang.annotation;
/**
* Thrown when the annotation parser attempts to read an annotation
* from a class file and determines that the annotation is malformed.
+ * This error can be thrown by the {@linkplain
+ * java.lang.reflect.AnnotatedElement API used to read annotations
+ * reflectively}.
*
* @author Josh Bloch
+ * @see java.lang.reflect.AnnotatedElement
* @since 1.5
*/
public class AnnotationFormatError extends Error {
--- a/src/share/classes/java/lang/annotation/AnnotationTypeMismatchException.java Thu Aug 20 08:48:29 2009 +0100
+++ b/src/share/classes/java/lang/annotation/AnnotationTypeMismatchException.java Fri Aug 21 11:31:18 2009 -0700
@@ -30,8 +30,12 @@ import java.lang.reflect.Method;
* Thrown to indicate that a program has attempted to access an element of
* an annotation whose type has changed after the annotation was compiled
* (or serialized).
+ * This exception can be thrown by the {@linkplain
+ * java.lang.reflect.AnnotatedElement API used to read annotations
+ * reflectively}.
*
* @author Josh Bloch
+ * @see java.lang.reflect.AnnotatedElement
* @since 1.5
*/
public class AnnotationTypeMismatchException extends RuntimeException {
--- a/src/share/classes/java/lang/annotation/IncompleteAnnotationException.java Thu Aug 20 08:48:29 2009 +0100
+++ b/src/share/classes/java/lang/annotation/IncompleteAnnotationException.java Fri Aug 21 11:31:18 2009 -0700
@@ -30,8 +30,12 @@ package java.lang.annotation;
* an annotation type that was added to the annotation type definition after
* the annotation was compiled (or serialized). This exception will not be
* thrown if the new element has a default value.
+ * This exception can be thrown by the {@linkplain
+ * java.lang.reflect.AnnotatedElement API used to read annotations
+ * reflectively}.
*
* @author Josh Bloch
+ * @see java.lang.reflect.AnnotatedElement
* @since 1.5
*/
public class IncompleteAnnotationException extends RuntimeException {
--- a/src/share/classes/java/lang/reflect/AnnotatedElement.java Thu Aug 20 08:48:29 2009 +0100
+++ b/src/share/classes/java/lang/reflect/AnnotatedElement.java Fri Aug 21 11:31:18 2009 -0700
@@ -50,6 +50,11 @@ import java.lang.annotation.Annotation;
* java.lang.annotation.AnnotationTypeMismatchException} or an
* {@link java.lang.annotation.IncompleteAnnotationException}.
*
+ * @see java.lang.EnumConstantNotPresentException
+ * @see java.lang.TypeNotPresentException
+ * @see java.lang.annotation.AnnotationFormatError
+ * @see java.lang.annotation.AnnotationTypeMismatchException
+ * @see java.lang.annotation.IncompleteAnnotationException
* @since 1.5
* @author Josh Bloch
*/