/*
* Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.lang.annotation;
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).
*
* @author Josh Bloch
* @since 1.5
*/
public class AnnotationTypeMismatchException extends RuntimeException {
/**
* The <tt>Method</tt> object for the annotation element.
*/
private final Method element;
/**
* The (erroneous) type of data found in the annotation. This string
* may, but is not required to, contain the value as well. The exact
* format of the string is unspecified.
*/
private final String foundType;
/**
* Constructs an AnnotationTypeMismatchException for the specified
* annotation type element and found data type.
*
* @param element the <tt>Method</tt> object for the annotation element
* @param foundType the (erroneous) type of data found in the annotation.
* This string may, but is not required to, contain the value
* as well. The exact format of the string is unspecified.
*/
public AnnotationTypeMismatchException(Method element, String foundType) {
super("Incorrectly typed data found for annotation element " + element
+ " (Found data of type " + foundType + ")");
this.element = element;
this.foundType = foundType;
}
/**
* Returns the <tt>Method</tt> object for the incorrectly typed element.
*
* @return the <tt>Method</tt> object for the incorrectly typed element
*/
public Method element() {
return this.element;
}
/**
* Returns the type of data found in the incorrectly typed element.
* The returned string may, but is not required to, contain the value
* as well. The exact format of the string is unspecified.
*
* @return the type of data found in the incorrectly typed element
*/
public String foundType() {
return this.foundType;
}
}