1 /*

     2  * Copyright (c) 1996, 2005, 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 /*

    27  * (C) Copyright Taligent, Inc. 1996, 1997 - All Rights Reserved

    28  * (C) Copyright IBM Corp. 1996 - 1998 - All Rights Reserved

    29  *

    30  * The original version of this source code and documentation

    31  * is copyrighted and owned by Taligent, Inc., a wholly-owned

    32  * subsidiary of IBM. These materials are provided under terms

    33  * of a License Agreement between Taligent and Sun. This technology

    34  * is protected by multiple US and International patents.

    35  *

    36  * This notice and attribution to Taligent may not be removed.

    37  * Taligent is a registered trademark of Taligent, Inc.

    38  *

    39  */

    40 

    41 package java.util;

    42 

    43 /**

    44  * Signals that a resource is missing.

    45  * @see java.lang.Exception

    46  * @see ResourceBundle

    47  * @author      Mark Davis

    48  * @since       1.1

    49  */

    50 public

    51 class MissingResourceException extends RuntimeException {

    52 

    53     /**

    54      * Constructs a MissingResourceException with the specified information.

    55      * A detail message is a String that describes this particular exception.

    56      * @param s the detail message

    57      * @param className the name of the resource class

    58      * @param key the key for the missing resource.

    59      */

    60     public MissingResourceException(String s, String className, String key) {

    61         super(s);

    62         this.className = className;

    63         this.key = key;

    64     }

    65 

    66     /**

    67      * Constructs a <code>MissingResourceException</code> with

    68      * <code>message</code>, <code>className</code>, <code>key</code>,

    69      * and <code>cause</code>. This constructor is package private for

    70      * use by <code>ResourceBundle.getBundle</code>.

    71      *

    72      * @param message

    73      *        the detail message

    74      * @param className

    75      *        the name of the resource class

    76      * @param key

    77      *        the key for the missing resource.

    78      * @param cause

    79      *        the cause (which is saved for later retrieval by the

    80      *        {@link Throwable.getCause()} method). (A null value is

    81      *        permitted, and indicates that the cause is nonexistent

    82      *        or unknown.)

    83      */

    84     MissingResourceException(String message, String className, String key, Throwable cause) {

    85         super(message, cause);

    86         this.className = className;

    87         this.key = key;

    88     }

    89 

    90     /**

    91      * Gets parameter passed by constructor.

    92      *

    93      * @return the name of the resource class

    94      */

    95     public String getClassName() {

    96         return className;

    97     }

    98 

    99     /**

   100      * Gets parameter passed by constructor.

   101      *

   102      * @return the key for the missing resource

   103      */

   104     public String getKey() {

   105         return key;

   106     }

   107 

   108     //============ privates ============

   109 

   110     // serialization compatibility with JDK1.1

   111     private static final long serialVersionUID = -4876345176062000401L;

   112 

   113     /**

   114      * The class name of the resource bundle requested by the user.

   115      * @serial

   116      */

   117     private String className;

   118 

   119     /**

   120      * The name of the specific resource requested by the user.

   121      * @serial

   122      */

   123     private String key;

   124 }