001: /**
002: * JOnAS: Java(TM) Open Application Server
003: * Copyright (C) 1999 Bull S.A.
004: * Contact: jonas-team@objectweb.org
005: *
006: * This library is free software; you can redistribute it and/or
007: * modify it under the terms of the GNU Lesser General Public
008: * License as published by the Free Software Foundation; either
009: * version 2.1 of the License, or any later version.
010: *
011: * This library is distributed in the hope that it will be useful,
012: * but WITHOUT ANY WARRANTY; without even the implied warranty of
013: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
014: * Lesser General Public License for more details.
015: *
016: * You should have received a copy of the GNU Lesser General Public
017: * License along with this library; if not, write to the Free Software
018: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
019: * USA
020: *
021: * Initial developer(s): ____________________________________.
022: * Contributor(s): Lutris Technologies Inc http://www.lutris.com
023: *
024: * --------------------------------------------------------------------------
025: * $Id: DeploymentDescException.java 4729 2004-05-11 08:07:50Z sauthieg $
026: * --------------------------------------------------------------------------
027: */package org.objectweb.jonas_lib.deployment.api;
028:
029: import java.io.PrintStream;
030: import java.io.PrintWriter;
031:
032: /**
033: * The DeploymentDesc exception uses the pattern defined by the Enhydra
034: * com.lutris.util.ChainedException
035: * The source has been temporary duplicated to prevent Jonas using
036: * from external dependencies.
037: * @author Christophe Ney
038: */
039: public class DeploymentDescException extends Exception {
040:
041: /**
042: * Cause of the exception
043: */
044: private Throwable cause;
045:
046: /**
047: * Construct an exception without anything
048: */
049: public DeploymentDescException() {
050: super ();
051: cause = null;
052: }
053:
054: /**
055: * Construct an exception without a specified cause.
056: *
057: * @param msg The message associated with the exception.
058: */
059: public DeploymentDescException(String msg) {
060: super (msg);
061: cause = null;
062: }
063:
064: /**
065: * Construct an exception with an associated causing exception.
066: *
067: * @param msg The message associated with the exception.
068: * @param cause The error or exception that cause this
069: * exception.
070: */
071: public DeploymentDescException(String msg, Throwable cause) {
072: super (msg);
073: this .cause = cause;
074: }
075:
076: /**
077: * Construct an exception from a causing exception.
078: *
079: * @param cause The error or exception that cause this
080: * exception. The message will be take be this object's
081: * messasge.
082: */
083: public DeploymentDescException(Throwable cause) {
084: super (cause.getMessage());
085: this .cause = cause;
086: }
087:
088: /**
089: * @return the message associated with this exception. If causes
090: * are included, they will be appended to the message.
091: */
092: public String getMessage() {
093: String msg = super .getMessage();
094: if (cause == null) {
095: return msg;
096: } else {
097: return msg + ": " + cause.getMessage();
098: }
099: }
100:
101: /**
102: * Gets the causing exception associated with this exception.
103: * @return The causing exception or null if no cause is specified.
104: */
105: public Throwable getCause() {
106: return cause;
107: }
108:
109: /**
110: * Prints this DeploymentDescException and its backtrace, and the causes
111: * and their stack traces to the standard error stream.
112: */
113: public void printStackTrace() {
114: super .printStackTrace();
115: if (cause != null) {
116: System.err.println();
117: System.err.println("*** Caused by:");
118: cause.printStackTrace();
119: }
120: }
121:
122: /**
123: * Prints this DeploymentDescException and its backtrace, and the causes
124: * and their stack traces to the e specified print stream.
125: * @param s print the trace on a specific print stream
126: */
127: public void printStackTrace(PrintStream s) {
128: super .printStackTrace(s);
129: if (cause != null) {
130: s.println();
131: s.println("*** Caused by:");
132: cause.printStackTrace(s);
133: }
134: }
135:
136: /**
137: * Prints this DeploymentDescException and its backtrace, and the causes
138: * and their stack traces to the e specified print writer.
139: * @param s print the trace on a specific print stream
140: */
141: public void printStackTrace(PrintWriter s) {
142: super .printStackTrace(s);
143: if (cause != null) {
144: s.println();
145: s.println("*** Caused by:");
146: cause.printStackTrace(s);
147: }
148: }
149: }
|