     1 /*
     2  * Copyright (c) 2003, 2020, 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;
    27
    28 /**
    29  * Thrown when an application tries to access a type using a string
    30  * representing the type's name, but no definition for the type with
    31  * the specified name can be found.   This exception differs from
    32  * {@link ClassNotFoundException} in that {@code ClassNotFoundException} is a
    33  * checked exception, whereas this exception is unchecked.
    34  *
    35  * <p>Note that this exception may be used when undefined type variables
    36  * are accessed as well as when types (e.g., classes, interfaces or
    37  * annotation types) are loaded.
    38  * In particular, this exception can be thrown by the {@linkplain
    39  * java.lang.reflect.AnnotatedElement API used to read annotations
    40  * reflectively}.
    41  *
    42  * @author  Josh Bloch
    43  * @see     java.lang.reflect.AnnotatedElement
    44  * @since 1.5
    45  */
    46 public class TypeNotPresentException extends RuntimeException {
    47     @java.io.Serial
    48     private static final long serialVersionUID = -5101214195716534496L;
    49
    50     /**
    51      * The type name.
    52      */
    53     private String typeName;
    54
    55     /**
    56      * Constructs a {@code TypeNotPresentException} for the named type
    57      * with the specified cause.
    58      *
    59      * @param typeName the fully qualified name of the unavailable type
    60      * @param cause the exception that was thrown when the system attempted to
    61      *    load the named type, or {@code null} if unavailable or inapplicable
    62      */
    63     public TypeNotPresentException(String typeName, Throwable cause) {
    64         super("Type " + typeName + " not present", cause);
    65         this.typeName = typeName;
    66     }
    67
    68     /**
    69      * Returns the fully qualified name of the unavailable type.
    70      *
    71      * @return the fully qualified name of the unavailable type
    72      */
    73     public String typeName() { return typeName;}
    74 }