1 /*
2 * Copyright (c) 1996, 2005, Oracle and/or its affiliates. All rights reserved.
3 * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
4 *
5 *
6 *
7 *
8 *
9 *
10 *
11 *
12 *
13 *
14 *
15 *
16 *
17 *
18 *
19 *
20 *
21 *
22 *
23 *
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 JDK1.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 }
125