01: /*
02: * $Header: /export/home/cvsroot/MyPersonalizerRepository/MyPersonalizer/Subsystems/Kernel/Sources/es/udc/mypersonalizer/kernel/util/exceptions/InstanceException.java,v 1.1.1.1 2004/03/25 12:08:38 fbellas Exp $
03: * $Revision: 1.1.1.1 $
04: * $Date: 2004/03/25 12:08:38 $
05: *
06: * =============================================================================
07: *
08: * Copyright (c) 2003, The MyPersonalizer Development Group
09: * (http://www.tic.udc.es/~fbellas/mypersonalizer/index.html) at
10: * University Of A Coruna
11: * All rights reserved.
12: *
13: * Redistribution and use in source and binary forms, with or without
14: * modification, are permitted provided that the following conditions are met:
15: *
16: * - Redistributions of source code must retain the above copyright notice,
17: * this list of conditions and the following disclaimer.
18: *
19: * - Redistributions in binary form must reproduce the above copyright notice,
20: * this list of conditions and the following disclaimer in the documentation
21: * and/or other materials provided with the distribution.
22: *
23: * - Neither the name of the University Of A Coruna nor the names of its
24: * contributors may be used to endorse or promote products derived from
25: * this software without specific prior written permission.
26: *
27: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
28: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
29: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
30: * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
31: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
33: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
36: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37: * POSSIBILITY OF SUCH DAMAGE.
38: *
39: */
40:
41: package es.udc.mypersonalizer.kernel.util.exceptions;
42:
43: /**
44: * Base class for all exceptions reporting problems with model
45: * instances.
46: *
47: * @author Daniel Fernandez
48: * @since 1.0
49: */
50: public abstract class InstanceException extends ModelException {
51:
52: /**
53: * Key of the instance which caused the exception, <code>null<code>
54: * by default.
55: */
56: private Object key = null;
57:
58: /**
59: * Name of the class to which the instance belongs, <code>null<code>
60: * by default.
61: */
62: private String className = null;
63:
64: /**
65: * Constructor for the Exception, initializing all fields.
66: *
67: * @param reason Description of the cause of the exception.
68: * @param key Key of the instance which caused the exception.
69: * @param className Name of the class to which the faulty
70: * instance belongs.
71: */
72: protected InstanceException(String reason, Object key,
73: String className) {
74: super (reason);
75: this .key = key;
76: this .className = className;
77: }
78:
79: /**
80: * Obtains the key of the instance which caused the exception.
81: *
82: * @return The instance's key.
83: */
84: public Object getKey() {
85: return key;
86: }
87:
88: /**
89: * Obtains the name of the class to which the instance which caused the
90: * exception belongs.
91: *
92: * @return the class name.
93: */
94: public String getClassName() {
95: return className;
96: }
97:
98: }
|