01: /* ====================================================================
02: The Jicarilla Software License
03:
04: Copyright (c) 2003 Leo Simons.
05: All rights reserved.
06:
07: Permission is hereby granted, free of charge, to any person obtaining
08: a copy of this software and associated documentation files (the
09: "Software"), to deal in the Software without restriction, including
10: without limitation the rights to use, copy, modify, merge, publish,
11: distribute, sublicense, and/or sell copies of the Software, and to
12: permit persons to whom the Software is furnished to do so, subject to
13: the following conditions:
14:
15: The above copyright notice and this permission notice shall be
16: included in all copies or substantial portions of the Software.
17:
18: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
22: CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23: TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24: SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25: ==================================================================== */
26: package org.jicarilla.container;
27:
28: /**
29: * A {@link JicarillaException} thrown by a {@link Resolver} if no instance can
30: * be found for a provided key.
31: *
32: * @author <a href="mail at leosimons dot com">Leo Simons</a>
33: * @version $Id: ResolutionException.java,v 1.3 2004/01/10 16:04:50 lsimons Exp $
34: */
35: public class ResolutionException extends JicarillaException {
36: /** The key for which no instance could be found. */
37: protected Object m_key;
38:
39: /**
40: * Construct a new <code>ResolutionException</code>
41: * instance.
42: *
43: * @param key the for which no instance could be found.
44: */
45: public ResolutionException(final Object key) {
46: super ("An instance for the key '" + key
47: + "' was requested, but none could be found!");
48: if (key == null)
49: throw new NullPointerException("key");
50: m_key = key;
51: }
52:
53: /**
54: * Retrieve the key for which no instance could be found.
55: *
56: * @return the key for which no instance could be found.
57: */
58: public Object getKey() {
59: return m_key;
60: }
61: }
|