27 import java.lang.reflect.Method;
28
29 /**
30 * Thrown to indicate that a program has attempted to access an element of
31 * an annotation whose type has changed after the annotation was compiled
32 * (or serialized).
33 * This exception can be thrown by the {@linkplain
34 * java.lang.reflect.AnnotatedElement API used to read annotations
35 * reflectively}.
36 *
37 * @author Josh Bloch
38 * @see java.lang.reflect.AnnotatedElement
39 * @since 1.5
40 */
41 public class AnnotationTypeMismatchException extends RuntimeException {
42 private static final long serialVersionUID = 8125925355765570191L;
43
44 /**
45 * The {@code Method} object for the annotation element.
46 */
47 private final Method element;
48
49 /**
50 * The (erroneous) type of data found in the annotation. This string
51 * may, but is not required to, contain the value as well. The exact
52 * format of the string is unspecified.
53 */
54 private final String foundType;
55
56 /**
57 * Constructs an AnnotationTypeMismatchException for the specified
58 * annotation type element and found data type.
59 *
60 * @param element the {@code Method} object for the annotation element
61 * @param foundType the (erroneous) type of data found in the annotation.
62 * This string may, but is not required to, contain the value
63 * as well. The exact format of the string is unspecified.
64 */
65 public AnnotationTypeMismatchException(Method element, String foundType) {
66 super("Incorrectly typed data found for annotation element " + element
67 + " (Found data of type " + foundType + ")");
68 this.element = element;
69 this.foundType = foundType;
70 }
71
72 /**
73 * Returns the {@code Method} object for the incorrectly typed element.
74 *
75 * @return the {@code Method} object for the incorrectly typed element
76 */
77 public Method element() {
78 return this.element;
79 }
80
81 /**
82 * Returns the type of data found in the incorrectly typed element.
83 * The returned string may, but is not required to, contain the value
84 * as well. The exact format of the string is unspecified.
85 *
86 * @return the type of data found in the incorrectly typed element
87 */
88 public String foundType() {
89 return this.foundType;
90 }
91 }
|
27 import java.lang.reflect.Method;
28
29 /**
30 * Thrown to indicate that a program has attempted to access an element of
31 * an annotation whose type has changed after the annotation was compiled
32 * (or serialized).
33 * This exception can be thrown by the {@linkplain
34 * java.lang.reflect.AnnotatedElement API used to read annotations
35 * reflectively}.
36 *
37 * @author Josh Bloch
38 * @see java.lang.reflect.AnnotatedElement
39 * @since 1.5
40 */
41 public class AnnotationTypeMismatchException extends RuntimeException {
42 private static final long serialVersionUID = 8125925355765570191L;
43
44 /**
45 * The {@code Method} object for the annotation element.
46 */
47 private final transient Method element;
48
49 /**
50 * The (erroneous) type of data found in the annotation. This string
51 * may, but is not required to, contain the value as well. The exact
52 * format of the string is unspecified.
53 */
54 private final String foundType;
55
56 /**
57 * Constructs an AnnotationTypeMismatchException for the specified
58 * annotation type element and found data type.
59 *
60 * @param element the {@code Method} object for the annotation
61 * element, may be {@code null}
62 * @param foundType the (erroneous) type of data found in the annotation.
63 * This string may, but is not required to, contain the value
64 * as well. The exact format of the string is unspecified,
65 * may be {@code null}.
66 */
67 public AnnotationTypeMismatchException(Method element, String foundType) {
68 super("Incorrectly typed data found for annotation element " + element
69 + " (Found data of type " + foundType + ")");
70 this.element = element;
71 this.foundType = foundType;
72 }
73
74 /**
75 * Returns the {@code Method} object for the incorrectly typed element.
76 * The value may be unavailable if this exception has been
77 * serialized and then read back in.
78 *
79 * @return the {@code Method} object for the incorrectly typed
80 * element, or {@code null} if unavailable
81 */
82 public Method element() {
83 return this.element;
84 }
85
86 /**
87 * Returns the type of data found in the incorrectly typed element.
88 * The returned string may, but is not required to, contain the value
89 * as well. The exact format of the string is unspecified and the string
90 * may be {@code null}.
91 *
92 * @return the type of data found in the incorrectly typed element
93 */
94 public String foundType() {
95 return this.foundType;
96 }
97 }
|