001: /*
002: License $Id: TagtraumException.java,v 1.5 2003/09/13 04:59:56 hendriks73 Exp $
003:
004: Copyright (c) 2001-2005 tagtraum industries.
005:
006: LGPL
007: ====
008:
009: jo! is free software; you can redistribute it and/or
010: modify it under the terms of the GNU Lesser General Public
011: License as published by the Free Software Foundation; either
012: version 2.1 of the License, or (at your option) any later version.
013:
014: jo! is distributed in the hope that it will be useful,
015: but WITHOUT ANY WARRANTY; without even the implied warranty of
016: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
017: Lesser General Public License for more details.
018:
019: You should have received a copy of the GNU Lesser General Public
020: License along with this library; if not, write to the Free Software
021: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
022:
023: For LGPL see <http://www.fsf.org/copyleft/lesser.txt>
024:
025:
026: Sun license
027: ===========
028:
029: This release contains software by Sun Microsystems. Therefore
030: the following conditions have to be met, too. They apply to the
031: files
032:
033: - lib/mail.jar
034: - lib/activation.jar
035: - lib/jsse.jar
036: - lib/jcert.jar
037: - lib/jaxp.jar
038: - lib/crimson.jar
039: - lib/servlet.jar
040: - lib/jnet.jar
041: - lib/jaas.jar
042: - lib/jaasmod.jar
043:
044: contained in this release.
045:
046: a. Licensee may not modify the Java Platform
047: Interface (JPI, identified as classes contained within the javax
048: package or any subpackages of the javax package), by creating additional
049: classes within the JPI or otherwise causing the addition to or modification
050: of the classes in the JPI. In the event that Licensee creates any
051: Java-related API and distribute such API to others for applet or
052: application development, you must promptly publish broadly, an accurate
053: specification for such API for free use by all developers of Java-based
054: software.
055:
056: b. Software is confidential copyrighted information of Sun and
057: title to all copies is retained by Sun and/or its licensors. Licensee
058: shall not modify, decompile, disassemble, decrypt, extract, or otherwise
059: reverse engineer Software. Software may not be leased, assigned, or
060: sublicensed, in whole or in part. Software is not designed or intended
061: for use in on-line control of aircraft, air traffic, aircraft navigation
062: or aircraft communications; or in the design, construction, operation or
063: maintenance of any nuclear facility. Licensee warrants that it will not
064: use or redistribute the Software for such purposes.
065:
066: c. Software is provided "AS IS," without a warranty
067: of any kind. ALL EXPRESS OR IMPLIED REPRESENTATIONS AND WARRANTIES,
068: INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
069: PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED.
070:
071: d. This License is effective until terminated. Licensee may
072: terminate this License at any time by destroying all copies of Software.
073: This License will terminate immediately without notice from Sun if Licensee
074: fails to comply with any provision of this License. Upon such termination,
075: Licensee must destroy all copies of Software.
076:
077: e. Software, including technical data, is subject to U.S.
078: export control laws, including the U.S. Export Administration Act and its
079: associated regulations, and may be subject to export or import regulations
080: in other countries. Licensee agrees to comply strictly with all such
081: regulations and acknowledges that it has the responsibility to obtain
082: licenses to export, re-export, or import Software. Software may not be
083: downloaded, or otherwise exported or re-exported (i) into, or to a national
084: or resident of, Cuba, Iraq, Iran, North Korea, Libya, Sudan, Syria or any
085: country to which the U.S. has embargoed goods; or (ii) to anyone on the
086: U.S. Treasury Department's list of Specially Designated Nations or the U.S.
087: Commerce Department's Table of Denial Orders.
088:
089:
090: Feedback
091: ========
092:
093: We encourage your feedback and suggestions and want to use your feedback to
094: improve the Software. Send all such feedback to:
095: <feedback@tagtraum.com>
096:
097: For more information on tagtraum industries and jo!
098: please see <http://www.tagtraum.com/>.
099:
100:
101: */
102: package com.tagtraum.framework.util;
103:
104: import java.io.PrintStream;
105: import java.io.PrintWriter;
106:
107: /**
108: * Baseclass of all TagtraumExceptions.
109: *
110: * @author <a href="mailto:hs@tagtraum.com">Hendrik Schreiber</a>
111: * @version 1.1beta1 $Id: TagtraumException.java,v 1.5 2003/09/13 04:59:56 hendriks73 Exp $
112: */
113: public class TagtraumException extends Exception implements
114: I_TagtraumException {
115:
116: /**
117: * Source-Version
118: */
119: public static String vcid = "$Id: TagtraumException.java,v 1.5 2003/09/13 04:59:56 hendriks73 Exp $";
120:
121: /**
122: * Nested Exception.
123: */
124: private Throwable throwable;
125:
126: /**
127: * No-arg-constructor.
128: */
129: public TagtraumException() {
130: }
131:
132: /**
133: * TagtraumException with nested <code>Throwable</code>.
134: *
135: * @param aThrowable a nested <code>Throwable</code>
136: * @see #getThrowable()
137: */
138: public TagtraumException(Throwable aThrowable) {
139: setThrowable(aThrowable);
140: }
141:
142: /**
143: * TagtraumException with error message.
144: *
145: * @param aMessage an error message
146: * @see #getMessage()
147: */
148: public TagtraumException(String aMessage) {
149: super (aMessage);
150: }
151:
152: /**
153: * TagtraumException with nested <code>Throwable</code> and error message.
154: *
155: * @param aMessage an error message
156: * @param aThrowable a nested <code>Throwable</code>
157: * @see #getMessage()
158: * @see #getThrowable()
159: */
160: public TagtraumException(String aMessage, Throwable aThrowable) {
161: this (aMessage);
162:
163: setThrowable(aThrowable);
164: }
165:
166: /**
167: * Sets the nested <code>Throwable</code> of this <code>TagtraumException</code>.
168: *
169: * @param aThrowable the nested <code>Throwable</code>
170: */
171: public void setThrowable(Throwable aThrowable) {
172: this .throwable = aThrowable;
173: }
174:
175: /**
176: * Returns the nested <code>Throwable</code>.
177: */
178: public Throwable getThrowable() {
179: return throwable;
180: }
181:
182: /**
183: * Prints this <code>Throwable</code> and its backtrace to the
184: * standard error stream. This method prints a stack trace for this
185: * <code>Throwable</code> object on the error output stream that is
186: * the value of the field <code>System.err</code>. The first line of
187: * output contains the result of the {@link #toString()} method for
188: * this object. Remaining lines represent data previously recorded by
189: * the method {@link #fillInStackTrace()}. The format of this
190: * information depends on the implementation, but the following
191: * example may be regarded as typical:
192: * <blockquote><pre>
193: * java.lang.NullPointerException
194: * at MyClass.mash(MyClass.java:9)
195: * at MyClass.crunch(MyClass.java:6)
196: * at MyClass.main(MyClass.java:3)
197: * </pre></blockquote>
198: * This example was produced by running the program:
199: * <blockquote><pre>
200: *
201: * class MyClass {
202: *
203: * public static void main(String[] argv) {
204: * crunch(null);
205: * }
206: * static void crunch(int[] a) {
207: * mash(a);
208: * }
209: *
210: * static void mash(int[] b) {
211: * System.out.println(b[0]);
212: * }
213: * }
214: * </pre></blockquote>
215: *
216: * @see java.lang.System#err
217: */
218: public void printStackTrace() {
219: if (throwable != null)
220: throwable.printStackTrace();
221: super .printStackTrace();
222: }
223:
224: /**
225: * Prints this <code>Throwable</code> and its backtrace to the
226: * specified print stream.
227: *
228: * @param s <code>PrintStream</code> to use for output
229: */
230: public void printStackTrace(PrintStream s) {
231: if (throwable != null)
232: throwable.printStackTrace(s);
233: super .printStackTrace(s);
234: }
235:
236: /**
237: * Prints this <code>Throwable</code> and its backtrace to the specified
238: * print writer.
239: *
240: * @param s <code>PrintWriter</code> to use for output
241: * @since JDK1.1
242: */
243: public void printStackTrace(PrintWriter s) {
244: if (throwable != null)
245: throwable.printStackTrace(s);
246: super .printStackTrace(s);
247: }
248:
249: /**
250: * Returns a String representation of this exception.
251: */
252: public String toString() {
253: if (throwable != null) {
254: return super .toString()
255: + System.getProperty("line.separator")
256: + throwable.toString();
257: }
258:
259: return super.toString();
260: }
261:
262: }
|