001: /*--
002:
003: Copyright (C) 2002-2005 Adrian Price.
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 names "OBE" and "Open Business Engine" must not be used to
019: endorse or promote products derived from this software without prior
020: written permission. For written permission, please contact
021: adrianprice@sourceforge.net.
022:
023: 4. Products derived from this software may not be called "OBE" or
024: "Open Business Engine", nor may "OBE" or "Open Business Engine"
025: appear in their name, without prior written permission from
026: Adrian Price (adrianprice@users.sourceforge.net).
027:
028: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
029: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
030: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
031: DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
032: INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
033: (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
034: SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
035: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
036: STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
037: IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
038: POSSIBILITY OF SUCH DAMAGE.
039:
040: For more information on OBE, please see
041: <http://obe.sourceforge.net/>.
042:
043: */
044:
045: package org.obe;
046:
047: import java.io.PrintStream;
048: import java.io.PrintWriter;
049:
050: /**
051: * Base exception for all exceptions in the Open Business Engine.
052: *
053: * @author Anthony Eden
054: */
055: public class OBEException extends Exception {
056: // JDK1.4 introduced chained throwables, and printStackTrace() now traverses
057: // the chain to the root cause, printing all stack traces.
058: private static final boolean JDK1_4;
059: private static final String CAUSED_BY = "Caused by: ";
060:
061: private final Throwable _cause;
062:
063: static {
064: boolean jdk1_4;
065: try {
066: Throwable.class.getMethod("getCause", new Class[] {});
067: jdk1_4 = true;
068: } catch (NoSuchMethodException e) {
069: jdk1_4 = false;
070: }
071: JDK1_4 = jdk1_4;
072: }
073:
074: /**
075: * Construct a new OBEException.
076: */
077: public OBEException() {
078: _cause = null;
079: }
080:
081: /**
082: * Construct a new OBEException with the given message.
083: *
084: * @param message The message
085: */
086: public OBEException(String message) {
087: super (message);
088: _cause = null;
089: }
090:
091: /**
092: * Construct a new OBEException with the given nested error.
093: *
094: * @param t The nested error
095: */
096: public OBEException(Throwable t) {
097: super (t.getMessage());
098: _cause = t;
099: }
100:
101: /**
102: * Construct a new OBEException with the given messager and nested
103: * error.
104: *
105: * @param message The message
106: * @param t The nested error
107: */
108: public OBEException(String message, Throwable t) {
109: super (message);
110: _cause = t;
111: }
112:
113: /**
114: * Get the nested error.
115: *
116: * @return The nested error
117: */
118: public Throwable getCause() {
119: return _cause;
120: }
121:
122: public final void printStackTrace() {
123: printStackTrace(System.err);
124: }
125:
126: public final void printStackTrace(PrintStream stream) {
127: super .printStackTrace(stream);
128: // Only print causal stack traces if pre-JDK 1.4.
129: if (!JDK1_4) {
130: Throwable t = _cause;
131: while (t != null) {
132: stream.println(CAUSED_BY + t);
133: t.printStackTrace(stream);
134: if (t instanceof OBEException)
135: t = ((OBEException) t)._cause;
136: else
137: break;
138: }
139: }
140: }
141:
142: public final void printStackTrace(PrintWriter writer) {
143: super .printStackTrace(writer);
144: // Only print causal stack traces if pre-JDK 1.4.
145: if (!JDK1_4) {
146: Throwable t = _cause;
147: while (t != null) {
148: writer.println(CAUSED_BY + t);
149: t.printStackTrace(writer);
150: if (t instanceof OBEException)
151: t = ((OBEException) t)._cause;
152: else
153: break;
154: }
155: }
156: }
157: }
|