RootException


1   package org.enhydra.shark.api;
2   
3   import java.io.PrintStream  ;
4   import java.io.PrintWriter  ;
5   
6   /**
7    * This exception is base for all exceptions defined in Shark. It
8    * allows implementation of chain exceptions, and this implementation
9    * takes care if JDK1.3 or JDK1.4 is used.
10   *
11   * @author Vladimir Puskas
12   */
13  public class RootException extends Exception   {
14     
15     private Throwable   cause;
16     
17     /**
18      * Constructs a new exception with null as its detail message.
19      *
20      */
21     public RootException() {
22        super();
23     }
24     /**
25      * Constructs a new exception with the specified detail message.
26      *
27      * @param message the detail message.
28      *
29      */
30     public RootException(String   message) {
31        super(message);
32     }
33     
34     /**
35      * Constructs a new exception with the specified cause.
36      *
37      * @param  t the cause. A null value is permitted, and indicates that
38      * the cause is nonexistent or unknown.
39      *
40      */
41     public RootException(Throwable   t) {
42        super(t.getMessage());
43        try {
44           initCause(t);
45        } catch (Throwable   e) {}
46     }
47     
48     /**
49      * Constructs a new exception with the specified detail message and cause.
50      *
51      * @param message the detail message.
52      * @param  t the cause. A null value is permitted, and indicates that
53      * the cause is nonexistent or unknown.
54      */
55     public RootException(String   message, Throwable   t) {
56        super(message);
57        try {
58           initCause(t);
59        } catch (Throwable   e) {}
60     }
61     
62     /**
63      * Initializes the cause of this exception to the specified value.
64      *
65      * @param t the cause.
66      *
67      * @return a reference to this instance.
68      *
69      * @exception   IllegalArgumentException
70      * @exception   IllegalStateException
71      */
72     public Throwable   initCause(Throwable   t) throws IllegalArgumentException  , IllegalStateException   {
73        cause = t;
74        return this;
75     }
76     
77     
78     /**
79      * Returns the cause of this exception.
80      *
81      * @return   a cause for this exception if any, null otherwise
82      *
83      */
84     public Throwable   getCause() {
85        return cause;
86     }
87     
88     /**
89      * Method printStackTrace prints the stack trace to the <i>ps</i> PrintStream.
90      *
91      * @param ps PrintStream used for the output.
92      */
93     public void printStackTrace(PrintStream   ps) {
94        if (null != cause) {
95           cause.printStackTrace(ps);
96        }
97        super.printStackTrace(ps);
98     }
99     
100    /**
101     * Method printStackTrace prints the stack trace to the <i>pw</i> PrintWriter.
102     *
103     * @param pw PrintWriter used for the output.
104     */
105    public void printStackTrace(PrintWriter   pw) {
106       if (null != cause) {
107          cause.printStackTrace(pw);
108       }
109       super.printStackTrace(pw);
110    }
111    /**
112     * Method printStackTrace prints the stack trace to the standard error stream.
113     */
114    public void printStackTrace() {
115       printStackTrace(System.err);
116    }
117 }
118
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Free Books Free Magazines
Popular Tags