1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
/*
* This program is free software; you can redistribute it and/or modify it under the
* terms of the GNU Lesser General Public License, version 2.1 as published by the Free Software
* Foundation.
*
* You should have received a copy of the GNU Lesser General Public License along with this
* program; if not, you can obtain a copy at http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
* or from the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*
* This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the GNU Lesser General Public License for more details.
*
* Copyright (c) 2007 - 2009 Pentaho Corporation and Contributors. All rights reserved.
*/
package org.pentaho.reporting.libraries.base.util;
import java.io.PrintStream;
import java.io.PrintWriter;
/**
* A baseclass for RuntimeExceptions, which could have parent exceptions. These parent exceptions
* are raised in a subclass and are now wrapped into a subclass of this Exception.
* <p/>
* The parents are printed when this exception is printed. This class exists mainly for
* debugging reasons, as with them it is easier to detect the root cause of an error.
*
* @author Thomas Morgner
*/
public class StackableRuntimeException extends RuntimeException
{
/**
* The parent exception.
*/
private Throwable parent;
private static final long serialVersionUID = -4378774171699885841L;
/**
* Creates a StackableRuntimeException with no message and no parent.
*/
public StackableRuntimeException()
{
super();
}
/**
* Creates an exception.
*
* @param message the exception message.
* @param ex the parent exception.
*/
public StackableRuntimeException(final String message, final Throwable ex)
{
super(message);
this.parent = ex;
}
/**
* Creates an exception.
*
* @param message the exception message.
* @param ex the parent exception.
*/
public StackableRuntimeException(final String message, final Exception ex)
{
super(message);
this.parent = ex;
}
/**
* Creates an exception.
*
* @param message the exception message.
*/
public StackableRuntimeException(final String message)
{
super(message);
}
/**
* Returns the parent exception (possibly null).
*
* @return the parent exception.
* @deprecated use the throwable instead.
*/
public Exception getParent()
{
if (this.parent instanceof Exception)
{
return (Exception) this.parent;
}
return null;
}
public Throwable getParentThrowable()
{
return parent;
}
/**
* Prints the stack trace to the specified stream.
*
* @param stream the output stream.
*/
public void printStackTrace(final PrintStream stream)
{
super.printStackTrace(stream);
if (getParentThrowable() != null)
{
stream.println("ParentException: ");
getParentThrowable().printStackTrace(stream);
}
}
/**
* Prints the stack trace to the specified writer.
*
* @param writer the writer.
*/
public void printStackTrace(final PrintWriter writer)
{
super.printStackTrace(writer);
if (getParentThrowable() != null)
{
writer.println("ParentException: ");
getParentThrowable().printStackTrace(writer);
}
}
/**
* Prints the stack trace to System.err.
*
* @noinspection UseOfSystemOutOrSystemErr
*/
public void printStackTrace()
{
synchronized (System.err)
{
printStackTrace(System.err);
}
}
}
|
