1 /* 2 * Copyright (c) 2004, 2008, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package java.lang.annotation; 27 28 /** 29 * Thrown when the annotation parser attempts to read an annotation 30 * from a class file and determines that the annotation is malformed. 31 * This error can be thrown by the {@linkplain 32 * java.lang.reflect.AnnotatedElement API used to read annotations 33 * reflectively}. 34 * 35 * @author Josh Bloch 36 * @see java.lang.reflect.AnnotatedElement 37 * @since 1.5 38 */ 39 public class AnnotationFormatError extends Error { 40 private static final long serialVersionUID = -4256701562333669892L; 41 42 /** 43 * Constructs a new <tt>AnnotationFormatError</tt> with the specified 44 * detail message. 45 * 46 * @param message the detail message. 47 */ AnnotationFormatError(String message)48 public AnnotationFormatError(String message) { 49 super(message); 50 } 51 52 /** 53 * Constructs a new <tt>AnnotationFormatError</tt> with the specified 54 * detail message and cause. Note that the detail message associated 55 * with <code>cause</code> is <i>not</i> automatically incorporated in 56 * this error's detail message. 57 * 58 * @param message the detail message 59 * @param cause the cause (A <tt>null</tt> value is permitted, and 60 * indicates that the cause is nonexistent or unknown.) 61 */ AnnotationFormatError(String message, Throwable cause)62 public AnnotationFormatError(String message, Throwable cause) { 63 super(message, cause); 64 } 65 66 67 /** 68 * Constructs a new <tt>AnnotationFormatError</tt> with the specified 69 * cause and a detail message of 70 * <tt>(cause == null ? null : cause.toString())</tt> (which 71 * typically contains the class and detail message of <tt>cause</tt>). 72 * 73 * @param cause the cause (A <tt>null</tt> value is permitted, and 74 * indicates that the cause is nonexistent or unknown.) 75 */ AnnotationFormatError(Throwable cause)76 public AnnotationFormatError(Throwable cause) { 77 super(cause); 78 } 79 } 80