001: /*--
002:
003: Copyright (C) 2000-2003 Anthony Eden.
004: All rights reserved.
005:
006: Redistribution and use in source and binary forms, with or without
007: modification, are permitted provided that the following conditions
008: are met:
009:
010: 1. Redistributions of source code must retain the above copyright
011: notice, this list of conditions, and the following disclaimer.
012:
013: 2. Redistributions in binary form must reproduce the above copyright
014: notice, this list of conditions, and the disclaimer that follows
015: these conditions in the documentation and/or other materials
016: provided with the distribution.
017:
018: 3. The name "EdenLib" must not be used to endorse or promote products
019: derived from this software without prior written permission. For
020: written permission, please contact me@anthonyeden.com.
021:
022: 4. Products derived from this software may not be called "EdenLib", nor
023: may "EdenLib" appear in their name, without prior written permission
024: from Anthony Eden (me@anthonyeden.com).
025:
026: In addition, I request (but do not require) that you include in the
027: end-user documentation provided with the redistribution and/or in the
028: software itself an acknowledgement equivalent to the following:
029: "This product includes software developed by
030: Anthony Eden (http://www.anthonyeden.com/)."
031:
032: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
033: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
034: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
035: DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
036: INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
037: (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
038: SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
039: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
040: STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
041: IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
042: POSSIBILITY OF SUCH DAMAGE.
043:
044: For more information on EdenLib, please see <http://edenlib.sf.net/>.
045:
046: */
047:
048: package com.anthonyeden.lib;
049:
050: import java.io.PrintStream;
051: import java.io.PrintWriter;
052:
053: /** A chained runtime exception allows a parent exception to be specified
054: and accessible through the <code>getNestedError()</code> method
055: and will appear in stack traces.
056:
057: @author Anthony Eden
058: */
059:
060: public class ChainedRuntimeException extends RuntimeException {
061:
062: private Throwable nestedError;
063:
064: /** Create a new ChainedRuntimeException using the message of the nested
065: error as the exception message.
066:
067: @param nestedError The nested error
068: */
069:
070: public ChainedRuntimeException(Throwable nestedError) {
071: this (nestedError.getMessage(), nestedError);
072: }
073:
074: /** Create a new ChainedRuntimeException.
075:
076: @param message The message
077: @param nestedError The parent exception
078: */
079:
080: public ChainedRuntimeException(String message, Throwable nestedError) {
081: super (message);
082: this .nestedError = nestedError;
083: }
084:
085: /** Return the parent exception.
086:
087: @return The parent exception
088: */
089:
090: public Throwable getNestedError() {
091: return nestedError;
092: }
093:
094: /** Print the stack trace to System.err */
095:
096: public void printStackTrace() {
097: printStackTrace(System.err);
098: }
099:
100: /** Print the stack trace.
101:
102: @param out The output stream
103: */
104:
105: public void printStackTrace(PrintStream out) {
106: super .printStackTrace(out);
107: if (nestedError != null) {
108: out.println("Nested Exception:");
109: nestedError.printStackTrace(out);
110: }
111: out.flush();
112: }
113:
114: /** Print the stack trace.
115:
116: @param out The output writer
117: */
118:
119: public void printStackTrace(PrintWriter out) {
120: super .printStackTrace(out);
121: if (nestedError != null) {
122: out.println("Nested Exception:");
123: nestedError.printStackTrace(out);
124: }
125: out.flush();
126: }
127:
128: }
|