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 */ MissingResourceException(String s, String className, String key)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} with 68 * {@code message}, {@code className}, {@code key}, 69 * and {@code cause}. This constructor is package private for 70 * use by {@code ResourceBundle.getBundle}. 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 */ MissingResourceException(String message, String className, String key, Throwable cause)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 */ getClassName()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 */ getKey()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 } 125