/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*/
package java.lang.annotation;
/**
* Thrown to indicate that a program has attempted to access an element of
* 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 {
private static final long
serialVersionUID = 8445097402741811912L;
private
Class<? extends
Annotation>
annotationType;
private
String elementName;
/**
* Constructs an IncompleteAnnotationException to indicate that
* the named element was missing from the specified annotation type.
*
* @param annotationType the Class object for the annotation type
* @param elementName the name of the missing element
* @throws NullPointerException if either parameter is {@code null}
*/
public
IncompleteAnnotationException(
Class<? extends
Annotation>
annotationType,
String elementName) {
super(
annotationType.
getName() + " missing element " +
elementName.
toString());
this.
annotationType =
annotationType;
this.
elementName =
elementName;
}
/**
* Returns the Class object for the annotation type with the
* missing element.
*
* @return the Class object for the annotation type with the
* missing element
*/
public
Class<? extends
Annotation>
annotationType() {
return
annotationType;
}
/**
* Returns the name of the missing element.
*
* @return the name of the missing element
*/
public
String elementName() {
return
elementName;
}
}